Products

Resolve a catalog selection

Resolve a partial or complete catalog selection into the combination that would be sold, with its price and open choices.

A read that persists nothing; an incomplete selection returns 200 with status and pending_option_groups.
Sending two values of the same group returns 422.

post/companies/{company}/products/{product}/resolve-selection

Request

Base URL: https://api.factuarea.com/v1
URL: https://api.factuarea.com/v1/companies/{company}/products/{product}/resolve-selection
Auth: one of:
- HTTP bearer
- API key in header X-API-Key

Path parameters

companystring uuid required

Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).

productstring uuid required

Public identifier (UUID v7) of the product.

Headers

Factuarea-Versionstring date

Example:2026-06-01

Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.

Request body

variant_idstring uuid nullable

presentation_idstring uuid nullable

Response

Example response

{
  "data": {
    "object": "resolved_catalog_selection",
    "product_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a09",
    "mode": "allow_list",
    "status": "resolved",
    "compatible": true,
    "complete": true,
    "variant_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b22",
    "presentation_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b21",
    "configuration_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8c40",
    "configuration_name": "Superior · Garrafa de 5 L · Calidad: Superior",
    "configuration_signature": "b1f0c3d2e4a5968778695a4b3c2d1e0fb1f0c3d2e4a5968778695a4b3c2d1e0f",
    "configuration_price": "21.5000",
    "option_adjustment_total": "2.0000"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.