Skip to main content

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 a SalesChannelProductToSkuProductMappingData:
    • sales_channel_listing_id (string, required) — usually the Amazon seller_sku.
    • mapped_sku (string|null) — SKU.io products.sku to map to. Empty string is coerced to null (i.e. an unmap).
    • product_listing_id (int|null, optional) — existing product_listings row 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

OK

Response Headers
    Content-Type