Create Marketplace SKU Mappings API (By ERP)(Beta)

Inbound | POST | /master/sku-listings

Summary

This API is used to create barcode to Channel (marketplace) SKU mappings by passing the channel name, provided the SKU master are already created for the channel.

Description

This API is designed to generate listings in Omni (SKU barcode to ChannelSku) mappings, and it is pertinent for any ERP system that intends to push mapping for any channel.
Upon execution, the API will provide a response containing both the success and failure lists of SKUs. The success list will encompass the SKUs for which the listings have been successfully created in the Increff system, while the failure list will include those SKUs for which listings were not created in Increff system due to validation failures.
The error message in response body will clarify the issue with the listings. For such SKUs, listing creation should be retried after rectification.

Request

{
  "channelName": "MarketplaceChannelAlias",
  "skuListings": [
    {
      "channelSkuCode": "ChannelSku1",
      "channelSerialNo": "ChannelSerialNo1",
      "barcode": "barcode1",
      "toleranceDays": 2
    },
    {
      "channelSkuCode": "ChannelSku2",
      "channelSerialNo": "ChannelSerialNo2",
      "barcode": "barcode2",
      "toleranceDays": null
    }
  ]
}

Parameter Name	Data Type	Description	Mandatory
`skuListings`	Object	List of the SKUs whose listings is to be created	Yes
`skuListings.channelSkuCode`	String	Unique identifier of SKU on channel’s end	Yes
`skuListings.channelSerialNo`	String	It’s the serial number of an SKU on channel	Yes
`skuListings.barcode`	String	unique identifier of SKU on client’s end	Yes
`skuListings.toleranceDays`	Integer	Number of days the SKU is tolerant, it is used to set minExpiry of the SKU	No
`channelName`	String	Channel whose listing is to be created	Yes

Response

{
  "successChannelSkus": [
    "ChannelSku1"
  ],
  "failureSkuListingCimsData": [
    {
      "channelSku": "ChannelSku2",
      "errorMessage": "Invalid Tolerance days"
    }
  ]
}

Parameter Name	Data Type	Description
`successChannelSkus`	Object	List of the skus whose listings were successfully created
`failureSkuListingCimsData`	Object	List of the skus whose listing creation failed
`failureSkuListingCimsData.channelSku`	String	The sku whose listing creation failed
`failureSkuListingCimsData.errorMessage`	String	Reason for listing creation failure