Collections

Catalog collections (lineas de producto) ÔÇö segment which products are sold per branch.

📄️ Get collection by ID

Returns a single collection by its primary key. The response carries a strong `ETag` header with the current version.

📄️ Update collection

Full replacement of an existing collection. Send the `If-Match` header with the current ETag for optimistic concurrency control.

📄️ Delete collection

Deletes a collection. Send the `If-Match` header with the current ETag for optimistic concurrency control.

📄️ Merge-patch collection

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 collections

Returns a paginated list of collections with envelope `{data, totalCount, skip, limit, hasMore}`. Default sort is `name:asc`. Limit is capped at 200; skip is clamped to >= 0.

📄️ Create collection

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

📄️ Prototype collection for a creation form

Returns a non-persisted collection pre-populated with backend defaults. Optional hints include `companyId` and `copyFromId`. The response has no `id`, `version` or audit fields; call `POST /api/v2/collections` afterwards to persist it.