Skip to content

Accessories

Accessories link a source article to accessory articles that are fitted or ordered alongside it — an optional add-on, or a mandatory part. Pushing them lets Mercura suggest the right accessories when it matches a customer position against your catalogue.

You can:

  • POST /articles/accessories — bulk-upsert up to 100,000 accessory links in a single call. Async — returns a JobAck; poll GET /jobs/{job_id} for status. Each row upserts the (source_article_number, accessory_article_number) pair.
  • GET /articles/accessories — cursor-paginated list of your accessory links. Pass source_article_number to list one article's accessories, or modified_since on the first page to fetch only what changed.

Fields

  • multiplier — how many of the accessory are needed per unit of the source article (optional).
  • order — display order among a source article's accessories.
  • is_mandatorytrue marks a required part rather than an optional add-on.