Return Causes

Return causes (CausaDevolucion / causas de devoluci├│n).

📄️ Get return cause by ID

Returns a single return cause by its primary key.

📄️ Update return cause

Full replacement of an existing return cause. Send the `If-Match` header for optimistic concurrency (accepted but ignored ÔÇö not versioned).

📄️ Delete return cause

Deletes a return cause. Send the `If-Match` header with the current ETag (accepted but ignored ÔÇö not versioned).

📄️ Merge-patch return cause

RFC 7396 merge-patch over `application/merge-patch+json`. Send only the fields you want to change; include a field with value `null` to remove it. Use the `If-Match` header for optimistic concurrency control.

📄️ List return causes

Returns a paginated list of return causes with envelope `{data, totalCount, skip, limit, hasMore}`. Supports optional RSQL `filter`, `sort` (default `name:asc`), `skip`/`limit` pagination and `modifiedAfter`/`modifiedBefore` bookends.

📄️ Create return cause

Creates a new return cause. Business logic runs in the legacy WAR via the internal commands gateway.

📄️ Prototype return cause for a creation form

Returns a non-persisted return cause pre-populated with backend defaults (`enabled=true`, current company, next `code`). Optional JSON hints: `companyId`, `copyFromId`. The response has no `id`, `version` or audit fields; call `POST /api/v2/return-causes` afterwards to persist.