Catalog referentials

Lists brands. Filters: search, is_active, has_products, include_deleted, order_by, order_dir, page, page_size.

Retrieves a single brand.

Creates a brand.

Updates a brand.

Deletes a brand. Query permanent=true to bypass the soft-delete.

Lightweight typeahead search (q, limit) used to populate pickers.

Aggregate brand statistics / dashboard widgets.

CSV export/import and Odoo brand import.

Recomputes the cached product count for a brand (brand_id query param).

Unique brand code.

Brand name.

Official display name — overrides name for UI/exports.

Brand logo URL.

Brand website URL.

Brand description.

Whether the brand is active.

Lists known name aliases for a brand (e.g. supplier-specific spellings).

Adds an alias. Body: alias (required), source.

Removes an alias.

Detects likely duplicate brands. Query: min_similarity, limit.

Automatically merges brands that differ only by letter case.

Merges one or more source brands into a target brand, optionally creating aliases from the source names.

Lists past merges. Query: target_brand_id, page, page_size.

Matches a free-text brand name to an existing brand (used when ingesting supplier data).

Batch version of /brands/match.

Preview a merge before running it (nothing written), and undo a past merge.

Recompute duplicate pairs, accept the pairs above a similarity threshold, dismiss a pair, or restore a dismissed pair.

Brands to merge — deleted after the merge.

Brand to keep; receives the merged data.

Free-text reason, kept for audit.

Create aliases from the source brand names (default varies — pass explicitly).

Brand name to match.

Supplier code, used as matching context.

Correspondences between each shop's brands and your brand directory (read only), and the shops that have some.

Validate, reject, re-read correspondences, or link one to a brand of the directory. A validated correspondence is used when sending products to the shop.

CSV export and import of correspondences, with a preview that writes nothing.

Products whose brand differs from what was last sent to a shop (motifs: marque, correspondance), and preparing their sending.

Proposed brands for products (current brand, proposed brand, sources, score), best score first.

Recompute proposals (optionally with AI), accept or refuse them, and undo an accepted batch.

Create brands from the brand names found on products, after a preview.

Upload or remove a brand logo.

Manufacturer records for product safety (EU GPSR) and the default manufacturer of a brand; CSV import with preview (/brands/fabricants/import-csv/apercu, /import-csv), Amazon-based proposals (/brands/fabricants/propositions, /propositions/creer), coverage per brand (/brands/fabricants/marques) and linking one manufacturer to several brands (/brands/fabricants/{fabricant_id}/marques, with /apercu).

Lists taxonomies. Query: is_active.

Retrieves a taxonomy.

Re-syncs a taxonomy from its configured source.

Syncs and immediately runs auto-mapping against another taxonomy.

Exports the taxonomy tree as CSV.

Lists categories in a taxonomy. Filters: parent_id, level, search, is_active, flat (flatten the tree), page, page_size.

Retrieves a category.

Toggles the node's enabled flag. Body: { "is_active": true|false }.

Retrieves the subtree rooted at this category.

Typeahead search across a taxonomy. Query: q, taxonomy_source_id, limit, offset, source_code.

Dashboard widgets and aggregate stats.

Bulk-imports categories from a CSV file or a URL (body: ImportUrlRequest).

Preview of one change, nothing written. Body: type (required) — creer_taxonomie, modifier_taxonomie, supprimer_taxonomie, creer_categorie, renommer_categorie, deplacer_categorie, fusionner_categories, supprimer_categorie — plus taxonomy_id, category_id, parent_id (absent = root), cible_id (merge target), nom, actif as the change needs.

Applies the change: same body plus the empreinte returned by the preview. Journaled (who, when, before, after, impact); nothing is sent to shops.

Journal of applied changes, and undo of one change (409 CATEGORY_STRUCTURE_UNDO_CONFLICT if the tree changed since).

A taxonomy's tree as edited, and the differences between your tree and each shop's.

Lists per-locale translations of a category name.

Writes a translation (body: TaxonomyCategoryTranslationWrite).

Lists the attributes applicable to a category.

CRUD for taxonomy attributes (body AttributeCreate/AttributeUpdate: taxonomy_category_id, name, display_name, attribute_type, unit, is_required, is_filterable, sort_order).

Adds a selectable value to an attribute.

Reads/writes attribute-label translations. Query: scope, key.

Bulk-imports attributes.

Amazon Browse Node reference categories. Query: limit, offset, search.

Google Product Taxonomy reference categories. Query: limit, offset, category_id.

Lists mappings. Filters: source_taxonomy_id, target_taxonomy_id, status, mapping_type, page, page_size.

Creates a mapping. Body: source_category_id, target_category_id (required), mapping_type, confidence_score, status.

Approves/rejects a mapping (body: MappingStatusUpdate).

Deletes a mapping.

Runs automatic matching between two taxonomies. Body: source_taxonomy_id, target_taxonomy_id (required), min_confidence, limit.

Suggests mapping candidates for review. Query: taxonomy_source_id, limit.

Exports mappings as CSV.

Reconciles a taxonomy against its source, reporting drift. Query: source_id.

Lists a product's category assignments.

Assigns a product to a category. Body: taxonomy_category_id (required), assigned_by, confidence, is_primary.

Assigns many products to the same category at once. Body: product_ids, taxonomy_category_id (required), assigned_by, confidence, is_primary.

Removes an assignment.

Sets/unsets the primary flag for one assignment. Body: { "is_primary": true|false }.

Bulk-syncs product categories from Odoo.

Imports Odoo 18 product attributes into the taxonomy attribute model.

Lists suppliers. Filters: search, is_active, page, per_page.

Retrieves a supplier.

Creates a supplier. Body: name, code (required), contact_email, contact_phone, address, country, is_active.

Updates a supplier.

Deletes a supplier.

Deletes multiple suppliers at once. Body: { "supplier_ids": [...] }.

Shortcut list of active suppliers only, for pickers.

Aggregate supplier statistics and connector-automation status.

Validates a source connection before saving. Body: source_type, connection_config (required). A Google Drive source answers 422 SUPPLIER_INTEGRATION_ABSENT (Drive is not offered as a supplier source).

Reads/creates/updates a supplier together with its import/connector configuration in one call (UnifiedSupplierRequest / UnifiedSupplierUpdateRequest).

The supplier's catalog as last imported. Filters: search, ean, is_active, page, per_page.

Price history over time for the supplier (optionally scoped to product_id), with start_date/end_date.

Stock-level history, same filters as prices.

Import files received from this supplier. Filters: file_type, start_date, limit.

Sync run logs. Filters: status, operation, start_date, limit.

Aggregate stats for the supplier's import history.

Lists EAN resolutions awaiting or under review. Filters: page, per_page, status, supplier_code, search, sort_by, sort_order.

Updates a resolution. Body: resolved_ean, status, resolution_source.

Deletes a resolution record.

Lists tags. Filters: search, is_active, page, per_page.

Creates a tag. Body: name (required), description, color.

Creates multiple tags at once. Body: { "tags": [...] }.

Updates a tag (name, description, color, is_active).

Deletes a tag.

Merges one or more source tags into a target tag. Body: source_tag_ids, target_tag_id (required).