Search product variants (document-form panel)
POST/api/v2/product-variants/search
Contextual SKU search for document forms. Matches name, description, barcode and reference ('*' = wildcard; exact barcode/reference matches first), extended to supplier price references when the company enables it. Applies the legacy eligibility rules: enabled products with a visible model state, company scope widened to the consolidated group when it shares products, zero-price exclusion on Venezuelan fiscal printer companies and, on the sales side, branch product lines, stock availability and lens blocking. Each row carries the company's searchable custom fields and base price list prices; request includeColumns=true once per form session to get the panel column metadata. Read-only. Prices are informational: lines are created through POST /api/v2/pricing/preview.
Request
Responses
- 200
- 400
- 401
- 403
- 500
Matching variants
Invalid request (unknown branch, missing q/barcode, ...)
Missing or invalid JWT (Bearer token).
Authenticated user cannot use the document forms nor view products
Unexpected server error. Includes legacy WAR failures that are not classified as 502 / 503 / 504.