2026-07 Voiding of other parked returns

On the 2026-07 API, when working with returns linked to the same original sale, any other parked returns for that sale are automatically voided in two situations.

Generating a parked return

Endpoint: POST /api/2026-07/sales/{sale_id}/actions/return

Before the new parked return is created, any existing parked returns against the same original sale are voided (state → voided).

🔒 Requires: sales:write, users:read scopes

Processing (completing) a return

Endpoint: PUT /api/2026-07/sales/{sale_id} (Update Sale)

When a parked return is completed, any other parked returns for the same original sale are voided.

🔒 Requires: sales:write scope

What is not affected

• Closed/completed returns for the same original sale are left unchanged.
• Only returns in the parked state are voided.
• This behaviour is specific to the 2026-07 date-based endpoints.

For the overall return workflow, see Sale returns.