Create SKU Masters API (Beta)

Inbound | POST | /master/articles

Summary

This API is used to create SKU masters in Omni.

Description

This API will create SKU masters in Omni.

Note : Single payload can contains upto 5000 SKU

Request

{
  "articleMasters": [
    {
      "clientSkuId": "clientSkuId",
      "channelSkuCode": "erpArticleCode1",
      "channelSerialNo": "serial1",
      "barcode": "barcode",
      "category": "category",
      "brand": "BrandFactory",  
      "styleCode": "erp article style", 
      "mrp": 1299, 
      "hsn": "hsn1234", 
      "imageUrl": "HTTP://www.mybrand.com/styl123.jpg", 
      "name": "product name", 
      "taxRule": "GST_3", 
      "size": "xl", 
      "color": "blue", 
      "channelToleranceDays": 3,
      "grnToleranceDays": 3,
      "returnToleranceDays": 3,
      "isPerishable": true, 
      "isSerialCodeRequired": true,
      "skuDimension": {
        "length": 20.2,
        "breadth": 20.2,
        "height": 20.2,
        "weight": 20.2
      },
      "skuAttributes": {
        "attribute1": "blue",
        "attribute2": "red",
        "attribute3": null,
        "attribute4": "13188913",
        "attribute5": "W857556A-19S",
        "attribute6": "FB512BKBK",
        "attribute7": "JMD11683",
        "attribute8": null,
        "attribute9": null,
        "attribute10": null,
        "attribute11": null,
        "attribute12": null,
        "attribute13": null,
        "attribute14": null,
        "attribute15": null
      },
      "isVirtual": false, 
      "isBundled":false,
      "virtualSkuDefinition": null
    },
    {
      "channelSkuCode": "erpArticleCode2",
      "barcode": "sku2",
      "category": "category",
      "brand": "brand1",
      "styleCode": "erp article style",
      "mrp": 1299,
      "hsn": "hsn1234",
      "imageUrl": "HTTP://www.mybrand.com/styl123.jpg",
      "name": "product name",
      "taxRule": "GST_APPAREL",
      "size": "xl",
      "color": "blue",
      "channelToleranceDays": 3,
      "grnToleranceDays": 3,
      "returnToleranceDays": 3,
      "isPerishable": true,
      "isSerialCodeRequired": false,
      "skuDimension": {
        "length": 20.2,
        "breadth": 20.2,
        "height": 20.2,
        "weight": 20.2
      },
      "skuAttributes": {
        "attribute1": "white",
        "attribute2": "pink",
        "attribute3": null,
        "attribute4": "13188914",
        "attribute5": "W857557A-18S",
        "attribute6": "FB613BKBK",
        "attribute7": "JMD11684",
        "attribute8": "1318",
        "attribute9": null,
        "attribute10": null,
        "attribute11": null,
        "attribute12": null,
        "attribute13": null,
        "attribute14": null,
        "attribute15": null
      },
      "isVirtual": true,
      "virtualSkuDefinition": {
        "virtualParentBarcode": "bar1",
        "childSkus": [
          {
            "channelSkuCode": "erpArticleCode3",
            "qty": 2,
            "barcode": "bar23"
          },
          {
            "channelSkuCode": "erpArticleCode1",
            "qty": 1,
            "barcode": "bar24"
          }
        ],
        "virtualParentChannelSkuId": "erpArticleCode2"
      }
    }
  ]
}

Parameter Name	Data Type	Description	Mandatory
`channelSkuCode`	String	Code used by channel to identify an SKU. Should be Unique. All Inventory updates, orders happen on this code.	yes
`clientSkuId`	String	SKU unique identifier to be created at Increff OMS.	yes
`channelSerialNo`	String	Second Unique code generated at channel for that sku	yes
`barcode`	String	Scannable code present on physical product that identifies an SKU uniquely	yes
`category`	String	Represents the broad category this product belongs to	no
`brand`	String	Brand of the sku	yes
`styleCode`	String	styleCode of the product	yes
`mrp`	Double	Maximum Retail Price of the product	yes
`hsn`	String	HSN code of the product	yes
`imageUrl`	String	Public image url of the product. This is used in warehouse at multiple stages to gain efficiency and accuracy	no
`name`	String	Name of the product	yes
`taxRule`	String	Rule used to compute tax as per Increff Omni Tax Rule Table	yes
`size`	String	Size of the product	no
`color`	String	Color of the product	no
`isPerishable`	boolean	Is the item perishable or not If product has expiration date then its considered as perishable. Default value = `false`	no
`channelToleranceDays`	Int	Valid for perishable products only. No of Days before getting expired upto which item can be used to fulfil orders created by ERP	no
`grnToleranceDays`	Int	Valid for perishable products only. System will provide validation at the time of GRN if products is getting expired in less the grn tolerance days	no
`returnToleranceDays`	Int	Valid for perishable products only. System will provide validation at the time of B2C return if products is getting expired in less the `returnToleranceDays` days	no
`skuAttributes`	Object [ ]	SKU Attributes of the product	no
`isVirtual`	boolean	set isVirtual = true to mark this SKU as a Virtual Combo SKU. Default value = `false`	no
`isBundled`	boolean	set isBundeld = true to mark this SKU as a Bundled SKU. Default value = `false`	no
`virtualSkuDefinition`	Object	Virtual combo SKU definition object which tell system what is the constituents SKUs for a given virtual SKU. Can be sent if isVirtual is set as true Can also be sent via a different API Not required if isVirtual=false Child SKUs should already be created Child SKU can not be virtual combos	no
`virtualSkuDefinition`.`virtualParentChannelSkuId`	String	Channel SKU code of parent SKu	no
`virtualSkuDefinition`.`virtualParentBarcode`	String	Barcode of parent SKU	no
`virtualSkuDefinition.childSkus`	Object[]	List of child SKU objects Mandatory if virtualSkuDefinition is sent	no
`childSkus.channelSkuCode`	String	Channel SKU code of child SKU Mandatory if childSkus is sent	no
`childSkus.quantity`	Integer	Number of child SKU constituted in given virtual SKU Mandatory if childSkus is sent	no
`childSkus.barcode`	String	Barcode of child SKU	no
`skuDimension`	Object	Dimensions of SKU	no
`skuDimension.length`	Double	Length of SKU in CMs	no
`skuDimension.breadth`	Double	Breadth of SKU in CMs	no
`skuDimension.height`	Double	Height of SKU in CMs	no
`skuDimension.weight`	Double	Weight of SKU in grams	no
`isSerialCodeRequired`	Boolean	Flag to specify wether the SKU can have a serial code or not Default value = `false`	no