2025
2025 Documentation Change Log
2 minute read
April
2025-04-22
- Added the Retry Playbook covering why and how you should implement appropriate retry polices when consuming APIs.
2025-04-16
- Added narrative about rate limiting and the HTTP response codes that can be experienced by consumers of the following APIs:
2025-04-15
- Added narrative about HTTP 503 responses and the associated
retry-afterheaders that can be experienced by consumers of the following APIs:
2025-04-14
- Updated the order creation guide to detail how email and SMS can be sent to sellers notifying them of a new order
- Updated the Webhook Event Matrix to detail that advert update events will fire for published adverts when a seller account is forced offline.
2025-04-07
- Added a playbook article that discusses the use of batching in GraphQL, and what things to consider if adopting it.
2025-04-03
- Added a new video on how to create orders in Marketplacer using the Operator API. We cover the following use cases:
- Basic example - covering core concepts
- Attaching external Ids
- Includes order retrieval using the external IDs
- Attaching metadata to line items
- Includes how this metadata can be surfaced in the Seller Portal
- Explicitly declaring Invoices
- Order Adjustments (Fees and Promotions)
- Creating Click and Collect Orders
March
2025-03-26
- Added a how to guide covering how to validate that products (adverts) have been successfully created. Guides available for both Operators and Sellers.
2025-03-06
- Added a how to guide covering product (advert) updates for both Operators and Sellers. The guides focuses in on how you can reference adverts and variants for updates, as well as covering the use of both
advertUpsertandvaraintUpdate.
2025-03-06
- Added a how to guide covering how to create multi-store orders
February
2025-02-07
- Added Golden Record-related events to the Webhook Event Matrix.
2025-02-07
- Added How to Update Option Values guide for both Seller and Operator APIs. This details how to leverage new functionality that allows for the partial update of Option Values - i.e. only supply the delta changes you need, as opposed to supplying all values (existing and new) to the update mutation call.