Products API
Complete API reference for Products endpoints.
Products API
Introduction to the Products API — why there is NO single response envelope, authentication, real pagination, `extend`, and stacked RBAC permissions.
Data model — Product and ProductVariant
Real, persisted shape of Product and ProductVariant per the Mongoose schema, with divergences from the public TS type and the domain's sub-shapes.
List and search products
Query the catalog with filters, free-text search, count, and existence by SKU — with real pagination and the ?extend= projection system.
Retrieve a product
Retrieve the full detail of a product by ID or SKU, related products by similarity, and the variants/options summary.
Create, update, and delete products
Create products, update them (including the implicit SKU rename), and delete them — with the warning that deletion is irreversible.
Variants and media
Read and update existing variants, upload images via presigned URL — and learn which parts of the product are only managed through a full PUT.
Channel publishing and T1 enrichment
Publish products to a sales channel (Shopify, MercadoLibre, Amazon, Walmart, T1...), check publishing status, and review T1/Sears/Sanborns linkage.
Bulk CSV import and export
Import and export your catalog via CSV in synchronous or asynchronous mode, with upfront validation, templates, and jobId progress tracking.
Bulk operations — rollback, Flow Editor, AI, and categorization
Roll back a bulk operation, validate and execute visual Flow Editor rules, transform products with AI, and categorize SKUs for a channel, with 207 Multi-Status support.
Materials, Supplies, and Bill of Materials (BOM)
Manage materials, supplies, bill of materials (BOM), and modifiers for manufacturing, costing, and inventory consumption during product preparation.
Vehicle compatibility (fitment)
Manage automotive compatibility catalogs and nodes (make, model, year) and check which products apply to a specific vehicle.
Collections
Manage product collections — hierarchical groupings for storefronts, commercial categorization, and manual or rule-based curation.
Categories
Query Fenicia's category tree, automatically classify products for SAT/CFDI and marketplaces, and manage category mappings by channel.
Error Catalog
Error codes for the Products domain — typed library errors, inline per-endpoint codes with no single convention, and what guarantees actually exist.