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.

Suggests brand matches for review. Query: limit.

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.

Lists brand names awaiting validation, typically created during a supplier import. Filters: status, search, supplier_code, order_by, order_dir, page, page_size.

Retrieves a single pending brand.

Resolves one pending brand: body action (e.g. assign to an existing brand_id, or create new), create_alias, notes.

Resolves several pending brands at once: body pending_ids, action, brand_id (for assign), create_alias.

Lists taxonomies. Query: is_active.

Creates a taxonomy (body: TaxonomySourceCreate — code, name, locale, source_type, sync_url, sync_method, sync_cron, is_active, config).

Retrieves a taxonomy.

Updates a taxonomy.

Deletes 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.

Creates a category. Body (CategoryCreate): name (required), external_id, slug, parent_id, is_active, sort_order, metadata.

Retrieves a category.

Updates a category (CategoryUpdate: name, external_id, slug, is_active, sort_order, metadata).

Deletes 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).

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.

Generic web/internal category tree. Query: limit, offset, parent_id, include_hierarchy.

Subtree, children, or ancestor chain for a reference category.

Reads/writes a reference category's translation.

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.

Imports mappings from the legacy category system.

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.

One-off migration of legacy category assignments into the taxonomy model.

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).

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).