Map Products to SKU.io Products (Bulk)
PUT//:domain/api/amazon/:integrationInstance/products/map
Bulk-maps Amazon products to existing SKU.io products (or subscription_offering_id) in a single call. Used by the legacy import wizard.
Body (SalesChannelProductToSkuProductMappingCollectionData):
mapping(array, min 1) — each item is aSalesChannelProductToSkuProductMappingData:sales_channel_listing_id(string, required) — usually the Amazonseller_sku.mapped_sku(string|null) — SKU.ioproducts.skuto map to. Empty string is coerced to null (i.e. an unmap).product_listing_id(int|null, optional) — existingproduct_listingsrow to update.subscription_offering_id(int|null, optional) — map to a subscription offering instead of a product.
Validation: salesChannelProductMappingsValidation() enforces that FBA listings can only be mapped to standard, kit, or blemished product types, and that non-FBA listings additionally accept bundle. Returns HTTP 402 with an error message on violation.
Throws SalesChannelProductMappingException → HTTP 400 with the exception message.
Named route: amazon.products.map.
Request
Responses
- 200
OK
Response Headers
Content-Type