Factuarea APIDevelopers
Added

Complete product catalog and price-list coverage

Manage product presentations, variants, supplier offers and price lists. Documents keep price snapshots and make repricing explicit.

The public API and MCP server now expose the complete catalog evolution surface.

  • Products distinguish product from service, use UNECE base units and keep quantities/stock at four decimals and conversion factors at six.
  • New REST subresources and thirteen MCP tools manage presentations, variants and supplier offers, including atomic preferred-offer selection.
  • A new Price Lists REST domain and its MCP counterpart manage customer/document pricing and effective-price resolution. At launch these tools were API-key only; v1.13.0 added OAuth consent.
  • Clients and sales/recurring documents carry price-list snapshots; existing_catalog_lines and future_lines_only make draft repricing explicit.
  • OpenAPI adds 18 schemas, five stable Pricing error codes and the price_lists:read / price_lists:write scopes. Price lists inherit the Products plan module.

Read Product catalog, Price lists and the MCP tool catalog.

New endpoints23

EndpointDescription
POST/v1/companies/{company}/price-listsCreate a price list
GET/v1/companies/{company}/price-listsList price lists
POST/v1/companies/{company}/products/{product}/presentationsCreate a product presentation
GET/v1/companies/{company}/products/{product}/presentationsList product presentations
POST/v1/companies/{company}/products/{product}/variantsCreate a product variant
GET/v1/companies/{company}/products/{product}/variantsList product variants
POST/v1/companies/{company}/products/{product}/supplier-offersCreate a supplier offer
GET/v1/companies/{company}/products/{product}/supplier-offersList supplier offers
DEL/v1/companies/{company}/price-lists/{priceList}Delete a price list
GET/v1/companies/{company}/price-lists/{priceList}Retrieve a price list
PATCH/v1/companies/{company}/price-lists/{priceList}Update a price list
DEL/v1/companies/{company}/price-lists/{priceList}/items/{item}Delete a price list item
DEL/v1/companies/{company}/products/{product}/presentations/{presentation}Delete a product presentation
PATCH/v1/companies/{company}/products/{product}/presentations/{presentation}Update a product presentation
DEL/v1/companies/{company}/products/{product}/variants/{variant}Delete a product variant
PATCH/v1/companies/{company}/products/{product}/variants/{variant}Update a product variant
DEL/v1/companies/{company}/products/{product}/supplier-offers/{offer}Delete a supplier offer
PATCH/v1/companies/{company}/products/{product}/supplier-offers/{offer}Update a supplier offer
GET/v1/companies/{company}/price-lists/{priceList}/itemsList price list items
POST/v1/companies/{company}/price-lists/{priceList}/itemsUpsert a price list item
GET/v1/companies/{company}/price-lists/optionsList active price list options
POST/v1/companies/{company}/price-lists/resolveResolve a catalog price
POST/v1/companies/{company}/products/{product}/supplier-offers/{offer}/preferredSet the preferred supplier offer