Skip to content

Changelog

The Postman collection is continuously updated based on changes made to the API. Remember to regularly download the latest version of the collection and update it.

February 26, 2026

Added

Settings API

The GET /api/settings (ListSettings) and PATCH /api/settings (UpdateSettings) endpoints now support a new configuration node (product.skuGenerations) to provide more control over how product SKUs are generated in Shopify.

This new setting allows you to define an ordered list of fallback strategies for SKU generation (each defining a single strategy). When a product is synchronized, the connector will process this list in sequence, using the first strategy that produces a valid SKU.

Two strategies are available:

  • UNIQUE_IDENTIFIER_BASED: uses the value from another Mirakl product attribute (e.g., barcode, EAN, ISBN) as the SKU.
  • MIRAKL_PRODUCT_ID_BASED: generates a SKU using the internal Mirakl Product ID. This is the default behavior if no strategies are configured.

Example:

"product": {
  "skuGenerations": [
    {
      "strategy": "UNIQUE_IDENTIFIER_BASED",
      "attributeCode": "manufacturer_id"
    },
    {
      "strategy": "UNIQUE_IDENTIFIER_BASED",
      "attributeCode": "ean"
    },
    {
      "strategy": "MIRAKL_PRODUCT_ID_BASED",
      "prefix": "mp-"
    }
  ]
}

December 09, 2025

Added

Storefront API

  • GET /api/storefront/orders/accounting-documents (GetAccountingOrdersDocuments)
    Acts as a proxy for the Mirakl Platform API DR73 - Download accounting documents (Front).

  • GET /api/storefront/orders/documents (GetOrdersDocuments)
    Acts as a proxy for the Mirakl Platform API OR73 - Download one or multiple documents attached to one or multiple orders (Front).

December 05, 2025

Added

Storefront API

  • GET /api/storefront/evaluations/assessments (GetEvaluationsAssessments)
    Acts as a proxy for the Mirakl Platform API EV01 - List rating types on your platform (Front).