Sales Order Posting
Outbound | POST | {Client’s URL}
...
Description
This API will call share the channel with sales order details.
Description
This API will call the channel Outward Order data with the ERP system with the details of sales orders which are completed in Increff Omni. This
The API calls will be triggered sent at a certain frequency from Increff Omni system to the channels.
List of Indian State Names: State Names (Indian)
We can send these posting on these triggers
...
OUTWARD_ORDER_CREATE,
...
ERP system.
ERP system is advised to implement idempotency on messageId
and shipmentCode
fields.
Info |
---|
|
Postings can be triggered on below event types:
OUTWARD_ORDER_CREATE
OUTWARD_ORDER_COMPLETE ,CANCEL
OUTWARD_ORDER_PARTIAL_CANCEL
Superset of Request Body
...
OUTWARD_ORDER_COMPLETE
OUTWARD_ORDER_SHIPMENT_DISPATCH
OUTWARD_ORDER_SHIPMENT_DELIVER
Request
Code Block | ||
---|---|---|
| ||
{ "partnerCode": "1100013090", "partnerLocationCode": "9", "locationCode": "IN132", "orderCode": "flipkart1234", "parentOrderCode": "flipkart1221", "isPriority": false, "channelName": "flipkart", "orderTime": "2020-10-16T20:22:28.000+00:00", "orderType": "SO/STO/RTV", "messageId": 12345, "paymentMethod": "COD", "eventType": "OUTWARD_ORDER_COMPLETE", "eventTime": "2020-10-16T20:22:28.000+00:00", "omsOrderId": 1234, "turnAroundTime": "2020-10-16T20:22:28.000+00:00", "virtualSkuDefinitions": [ { "virtualParentChannelSkuId": "abc1", "virtualParentBarcode": "bar1", "childSkus": [ { "channelSkuCode": "xyz", "qty": 2, "barcode": "bar23" }, { "channelSkuCode": "xyz1", "qty": 1, "barcode": "bar34" } ] } ], "isSplitRequiredbundledSkuDefinitions":"false", [ "shippingCharges": 20, "channelType" : "ERP", "orderItems": [ { { "orderItemCode": "item123", "channelSkuCodebundledParentBarcode": "1000889888string", "orderedQuantity": 2, "cancelledQuantity": 1, "channelDiscountbundledParentChannelSkuId": 50"string", "sellingPricePerUnit": 500, "giftChargePerUnit": 10, "sellerDiscountchildSkus": 5,[ "shippingCharge": 0 } ], "shipments": [ { "shipmentCode": "UIfd897", "locationCode":"loc1", "generatedInvoiceIdbarcode": "AR105044395string", "generatedInvoiceDate": "2020-10-16T20:22:28.000+00:00", "externalInvoiceId": "FK56556GH45", "externalInvoiceDatechannelSkuCode": "2020-10-16T20:22:28.000+00:00string", "invoiceDocumentUrl": "https://mybrand.com/invoice123.pdf", "shippingLabelDocumentUrl": "https://mybrand.com/sldoc.pdf", "irn": "a429746e55b844c9d2cb2a6f68997d1c2af29987cc834f3b52da45d1b0bc97c9", "qrCodeqty": "eyJhbGciPiJSUzI1NiIsImtpZCI6IkI4RDYzRUNCMThFQTVFNkY0QUKDM0Q1MjQ1NDNCMjI0NjY2OUIwRjgiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJ1TlkteTFqcVhtOUtyRDFTUlVPeUpHWnBzUGcifQ.eyJkYXRhIjoie1wiU2VsbGVyR3N0aW5cIjpcIjI5QUFPQ001MzI2SjFaWVwiLFwiQnV5ZXJHc3RpblwiOlwiMjlBQUJDUjE3MThFMVpMXCIsXCJEb2NOb1wiOlwiTUVhajIyLTIzLzUwNTlcIixcIkRvY1R5cFwiOlwiSU5WXCIsXCJEb2NEdFwiOlwiMTMvMTAvMjAyMlwiLFwiVG90SW52VmFsXCI6MTgxNy4wNCxcIkl0ZW1DbnRcIjoxLFwiTWFpbkhzbkNvZGVcIjpcIjYyMTE0MjkwXCIsXCJJcm5cIjpcImE0Mjk3NDZlMzRkODQ0YzlkMmNiMmE2ZjY4OTk3ZDFjMmFmMjM5ODdjYzgzNGYzYjUyZGE0NWQxYjBiYzk3YzlcIixcIklybkR0XCI6XCIyMDIyLTEwLTEzIDEyOjAxOjAwXCJ9IiwiaXNzIjoiTklDIn0.wvB7b15AnpdQdX_d0VZEyj9dL1qWDaOFPLRPrlV0V2XIu3cE3aQ3YtsWLnTnyrmtUlokpbkkE4folBQNhfzkCPlnODNxRPfpO-Kz9eyNpqcIEp-8TqvcDKXZ3PrBRqmNmner00AG_fVmmqT1HLiyKB2sqOnhqtCfQaQF-PGnqIOhal3PDxIMVt0WAtaQOIwwDA75dsjjnFHaZFPl9tFPR8A6Wrw4NhQH-7xhABKW3Z961a_rGmO6M3XP7jPHyYPW-QWMfTqwNXwxNdFgFePL5FloPiUipt2-g4FIplgm-YcN1xMvEQ2irAfzQwbnxi7UKz-jwOgM0Zy2BbburYgDvQ",0 "shipmentStatus":"DELIVERED", "shipmentItems": [ } { "channelSkuCode": "100000789702", ] "orderItemCode": "item123", } "netTaxAmountPerUnit": 60, ], "netTaxAmountTotalisSplitRequired": 120"false", "shippingCharges": 20, "channelType": "ERP", "baseSellingPricePerUnitorderItems": 500,[ { "baseSellingPriceTotalorderItemCode": 1000, "item123", "sellingPricePerUnitchannelSkuCode": 560"1000889888", "sellingPriceTotalorderedQuantity": 11202, "quantitycancelledQuantity": 21, "shippingChargePerUnitcustomerCancelledQty": 361, "channelDiscountsellerCancelledQty": 300, "taxItemssellerRejectQty": [0, "channelDiscount": 50, { "sellingPricePerUnit": 500, "typegiftChargePerUnit": "SGST"10, "sellerDiscount": 5, "rateshippingCharge": 60, "omsItemId": 123, "taxPerUnitbarcode": 30"barcode1", "orderItemCustomAttributes": { "taxTotalattribute1": 60"Value1", "attribute2": "Value2", }, "attribute3": "Value3", { "attribute4": "Value4", "typeattribute5": "CGSTValue5", "rate": 6"attribute6": "Value6", "taxPerUnit"attribute7": 30, "Value7", "taxTotalattribute8": 60"Value8", "attribute9": "Value9", } "channelMetadata": { "totalCashOnDeliveryFee": 0.0, ] }, "department": "HR", "paymentMethod": "ccavenue", "status": "processing" { }, "channelSkuCodeattribute10": "100000734701Value10", } "orderItemCode": "item124", } ], "netTaxAmountPerUnitshipments": 60,[ { "netTaxAmountTotalshipmentCode": 120"UIfd897", "baseSellingPricePerUnitlocationCode": 500"loc1", "baseSellingPriceTotal": 1000"generatedInvoiceId": "AR105044395", "sellingPricePerUnitgeneratedInvoiceDate": 560"2020-10-16T20:22:28.000+00:00", "sellingPriceTotalexternalInvoiceId": 1120, "FK56556GH45", "quantityexternalInvoiceDate": 2"2020-10-16T20:22:28.000+00:00", "shippingChargePerUnitinvoiceDocumentUrl": 36,"https://mybrand.com/invoice123.pdf", "channelDiscountshippingLabelDocumentUrl": 30"https://mybrand.com/sldoc.pdf", "taxItemsirn": ["a429746e55b844c9d2cb2a6f68997d1c2af29987cc834f3b52da45d1b0bc97c9", "qrCode": "eyJhbGciPiJSUzI1NiIsImtpZCI6IkI4RDYzRUNCMThFQTVFNkY0QUKDM0Q1MjQ1NDNCMjI0NjY2OUIwRjgiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJ1TlkteTFqcVhtOUtyRDFTUlVPeUpHWnBzUGcifQ.eyJkYXRhIjoie1wiU2VsbGVyR3N0aW5cIjpcIjI5QUFPQ001MzI2SjFaWVwiLFwiQnV5ZXJHc3RpblwiOlwiMjlBQUJDUjE3MThFMVpMXCIsXCJEb2NOb1wiOlwiTUVhajIyLTIzLzUwNTlcIixcIkRvY1R5cFwiOlwiSU5WXCIsXCJEb2NEdFwiOlwiMTMvMTAvMjAyMlwiLFwiVG90SW52VmFsXCI6MTgxNy4wNCxcIkl0ZW1DbnRcIjoxLFwiTWFpbkhzbkNvZGVcIjpcIjYyMTE0MjkwXCIsXCJJcm5cIjpcImE0Mjk3NDZlMzRkODQ0YzlkMmNiMmE2ZjY4OTk3ZDFjMmFmMjM5ODdjYzgzNGYzYjUyZGE0NWQxYjBiYzk3YzlcIixcIklybkR0XCI6XCIyMDIyLTEwLTEzIDEyOjAxOjAwXCJ9IiwiaXNzIjoiTklDIn0.wvB7b15AnpdQdX_d0VZEyj9dL1qWDaOFPLRPrlV0V2XIu3cE3aQ3YtsWLnTnyrmtUlokpbkkE4folBQNhfzkCPlnODNxRPfpO-Kz9eyNpqcIEp-8TqvcDKXZ3PrBRqmNmner00AG_fVmmqT1HLiyKB2sqOnhqtCfQaQF-PGnqIOhal3PDxIMVt0WAtaQOIwwDA75dsjjnFHaZFPl9tFPR8A6Wrw4NhQH-7xhABKW3Z961a_rGmO6M3XP7jPHyYPW-QWMfTqwNXwxNdFgFePL5FloPiUipt2-g4FIplgm-YcN1xMvEQ2irAfzQwbnxi7UKz-jwOgM0Zy2BbburYgDvQ", { "shipmentStatus": "DELIVERED", "typeawbNumber": "SGSTawb1", "shipmentItems": [ "rate": 6, { "taxPerUnitchannelSkuCode": 30, "100000789702", "taxTotalorderItemCode": 60"item123", }"netTaxAmountPerUnit": 60, "netTaxAmountTotal": 120, { "typebaseSellingPricePerUnit": "CGST"500, "baseSellingPriceTotal": 1000, "rate "sellingPricePerUnit": 6560, "sellingPriceTotal": 1120, "taxPerUnitquantity": 302, "taxTotalshippingChargePerUnit": 6036, "channelDiscount": 30, } "taxItems": [ ] } { ] } ], "shippingAddresstype": {"SGST", "name": "Customer's Name", "line1rate": "Line6, Address 1", "line2": "Line Address 2", "line3taxPerUnit": "Line Address 3",30, "city": "city", "statetaxTotal": "state",60 "zip": "zip", "country": "country", }, "email": "abc@gmail.com", { "phone": "9999999999" }, "billingAddress": { "nametype": "customerCGST", "line1": "address line 1", "line2rate": "address6, line 2", "line3": "address line 3", "citytaxPerUnit": "Bengaluru"30, "state": "Karnataka", "ziptaxTotal": "560076",60 "country": "INDIA", "email": "abc@gmail.com", } "phone": "9999999999" } } |
More request samples
Expand | ||
---|---|---|
| ||
Code Block | | |
| ||
Expand | ||
| ||
Code Block | | |
|
...
Parameter Name
...
Data Type
...
Description
...
Mandatory
...
partnerCode
...
String
...
This represents the partner to which order was shipped to.
If Order is of type SO/STO, this field represents customer’s code
If Order is of type RTV, this field represents vendor’s code
For Marketplaces Orders, this field will be having the erp channel name which is mapped in Assure
...
yes
...
partnerLocationCode
...
String
...
This represents the partner’s location to which order was shipped to.
If Order is of type SO/STO, this field represents customer location’s code
If Order is of type RTV, this field represents vendor location’s code
...
yes
...
isPriority
...
Boolean
...
Flag to identify wether an order is of priority or not
...
yes
...
locationCode
...
String
...
Warehouse location from which order was fulfilled
Yes
...
orderCode
...
String
...
Unique code used by the channel to identify order
...
yes
...
parentOrderCode
...
String
...
Parent order code which can be null or empty or some duplicate value across orders.
...
no
...
channelName
...
String
...
Channel name of the marketplace.
...
yes
...
orderTime
...
String
...
Time at which order was placed at the channel in UNIX (UTC)
...
yes
...
orderType
...
String
...
Can be - SO(Sales Order)/STO(Stock Transfer Order)/RTV(Return To Vendor), RPO(Replacement)
...
yes
...
messageId
...
Long
...
Unique Identifier of a notification (for De-duplication)
...
Yes
...
paymentMethod
...
String
...
Possible values - COD, NCOD
...
yes
...
orderItems
...
Object[]
...
List of order items
...
yes
...
orderItems.orderItemCode
...
String
...
This is provided by the channel to uniquely identify each order item.
...
yes
...
orderItems.channelskuCode
...
String
...
SKU code of order item
...
yes
...
orderItems.orderedQuantity
...
int
...
Ordered Quantity
...
yes
...
orderItems.cancelledQuantity
...
int
...
cancelledQuantity
...
yes
...
orderItems.sellingPricePerUnit
...
double
...
sellingPricePerUnit
...
yes
...
orderItems.giftChargePerUnit
...
Double
...
giftChargePerUnit
...
no
...
orderItems.channelDiscount
...
Double
...
Discount provided by channel per unit
...
no
...
orderItems.sellerDiscount
...
Double
...
Discount provided by seller per unit
...
no
...
eventType
...
String
...
Possible values : { OUTWARD_ORDER_CREATE,
OUTWARD_ORDER_CANCEL, OUTWARD_ORDER_COMPLETE ,
OUTWARD_ORDER_PARTIAL_CANCEL}
...
yes
...
eventTime
...
String
...
Time of event creation
...
yes
...
virtualSkuDefinitions
...
Object [ ]
...
List of virtual SKU definitions
...
no
...
virtualSkuDefinitions.virtualParentChannelSkuId
...
String
...
SKU code of virtual SKU
...
no
...
virtualSkuDefinitions.virtualParentBarcode
...
String
...
Barcode of parent SKU
...
no
...
virtualSkuDefinitions.childSkus
...
Object [ ]
...
List of child SKUs
...
no
...
childSkus.channelSkuCode
...
String
...
SKU code of child SKU
...
no
...
childSkus.qty
...
Integer
...
Quantity of child SKU
...
no
...
childSkus.barcode
...
String
...
Barcode of child SKU
...
no
...
isSplitRequired
...
Boolean
...
Flag to identify wether WMS had to split the order
...
yes
...
channelType
...
String
...
Enum with possible values:ERP,MARKETPLACE
...
no
...
shippingCharges
...
Double
...
Shipping charges
...
no
...
shipments
...
Object[]
...
List of shipments
...
yes
...
shipments.shipmentCode
...
String
...
Shipment code
...
yes
...
shipments.locationCode
...
String
...
Warehouse location from which shipment was fulfilled
...
no
...
shipments.generatedInvoiceId
...
String
...
Invoice id for the shipment
...
no
...
shipments.generatedInvoiceDate
...
String
...
Invoice date in the sample format mentioned
...
no
...
shipments.externalInvoiceId
...
String
...
External invoice id
...
no
...
shipments.externalInvoiceDate
...
String
...
External invoice date
...
no
...
shipments.invoiceDocumentUrl
...
String
...
Url of the invoice document
...
no
...
shipments.shippingLabelDocumentUrl
...
String
...
Url of the shipping label document
...
no
...
shipments.irn
...
String
...
IRN code
...
no
...
shipments.qrCode
...
String
...
QR code
...
no
...
shipments.shipmentStatus
...
String
...
Status of the shipment
...
no
...
shipments.shipmentItems
...
Object[]
...
Items belonging to this shipment
...
yes
...
shipmentItems.channelSkuCode
...
String
...
SKU code of order item
...
yes
...
shipmentItems.locationCode
...
String
...
Fulfillment Location
...
yes
...
shipmentItems.orderItemCode
...
String
...
This is provided by the channel to uniquely identify each order item.
...
yes
...
shipmentItems.netTaxAmountPerUnit
...
Double
...
Per unit tax applicable for the SKU.
...
yes
...
shipmentItems.netTaxAmountTotal
...
Double
...
Total tax applicable for the SKU
...
yes
...
shipmentItems.baseSellingPricePerUnit
...
Double
...
Per unit base selling price of the SKU
...
yes
...
shipmentItems.baseSellingPriceTotal
...
Double
...
Total base selling price of SKU
...
yes
...
shipmentItems.sellingPricePerUnit
...
Double
...
Per unit selling price of the SKU including tax
...
yes
...
shipmentItems.sellingPriceTotal
...
Double
...
Total selling price of the SKU
...
yes
...
shipmentItems.quantity
...
Integer
...
Quantity of the sku in the shipment item.
...
yes
...
shipmentItems.shippingChargePerUnit
...
Double
...
Shipping charge per unit for a shipment item
...
no
...
shipmentItems.channelDiscount
...
Double
...
Channel discount of item
...
no
...
shipmentItems.taxItems
...
Object
...
Distribution of tax with tax type
...
}
} |
Parameter Name | Data Type | Description | Mandatory |
| String | This represents the partner to which order was shipped to. If Order is of type SO/STO, this field represents customer’s code If Order is of type RTV, this field represents vendor’s code For Marketplaces Orders, this field will be having the erp channel name which is mapped in Increff Omni | Yes |
| String | This represents the partner’s location to which order was shipped to. If Order is of type SO/STO, this field represents customer location’s code If Order is of type RTV, this field represents vendor location’s code | Yes |
| Boolean | Flag to identify wether an order is of priority or not | Yes |
| String | Warehouse location from which order was fulfilled | Yes
|
| String | Unique code used by the channel to identify order | Yes |
| String | Parent order code which can be null or empty or some duplicate value across orders. | No |
| String | Channel name of the marketplace. | Yes |
| String | Time at which order was placed at the channel in UNIX (UTC) | Yes |
| String | Can be - SO(Sales Order)/STO(Stock Transfer Order)/RTV(Return To Vendor), RPO(Replacement) | Yes |
| Long | Unique Identifier of a notification (for De-duplication) | Yes |
| String | Possible values - COD, NCOD | Yes |
| String | Time of the event | Yes |
| String | Postings can be sent on the below triggers
| Yes |
| Long | Internal order id of OMS | No |
| ZonedDateTime | Turnaround time | No |
| Object[] | List of bundled sku definitions | No |
| String | Unique barcode of bundled Sku | No |
| String | Unique identifier of bundled Sku at channel | Yes |
| Object[] | List of child SKUs | Yes |
| String | Unique barcode of child sku | No |
| String | Unique identifier of child sku at channel | No |
| Integer | child sku quantity | No |
| Object[] | List of order items | Yes |
| String | This is provided by the channel to uniquely identify each order item. | Yes |
| String | SKU code of order item | Yes |
| int | Ordered Quantity | Yes |
| int | cancelledQuantity | Yes |
| double | sellingPricePerUnit | Yes |
| Integer | Customer cancelled quantity | No |
| Integer | Seller cancelled quantity | No |
| Double | giftChargePerUnit | No |
| Double | Discount provided by channel per unit | No |
| Double | Discount provided by seller per unit | No |
| Long | Internal item id of OMS | No |
| String | Barcode to identify a product | Yes |
| Object | Custom attributes for order items | No |
| String | Custom attribute 1 | No |
| String | Custom attribute 2 | No |
| String | Custom attribute 3 | No |
| String | Custom attribute 4 | No |
| String | Custom attribute 5 | No |
| String | Custom attribute 6 | No |
| String | Custom attribute 7 | No |
| String | Custom attribute 8 | No |
| String | Custom attribute 9 | No |
| String | Custom attribute 10 | No |
| Object | These are additonal fields which can be sent to Increff system and can be used in subsequent Posting workflows | No |
| Object | Custom attributes for an order | No |
| Objecg | These are additonal fields which can be sent to Increff system and can be used in subsequent Posting workflows | No |
| String | Currency | No |
| String | Custom attribute 1 | No |
| String | Custom attribute 2 | No |
| String | Custom attribute 3 | No |
| String | Custom attribute 4 | No |
| String | Custom attribute 5 | No |
| String | Custom attribute 6 | No |
| String | Custom attribute 7 | No |
| String | Custom attribute 8 | No |
| String | Custom attribute 9 | No |
| String | Custom attribute 10 | No |
| String | QR code | No |
| Integer | increff OMS shipment id | NO |
| String | Status of the shipment | No |
| String | AWB number of shipment | No |
| Object[] | Items belonging to this shipment | Yes |
| String | SKU code of order item | Yes |
| String | Fulfillment Location | Yes |
| String | This is provided by the channel to uniquely identify each order item. | Yes |
| Double | Per unit tax applicable for the SKU. | Yes |
| Double | Total tax applicable for the SKU | Yes |
| Double | Per unit base selling price of the SKU | Yes |
| Double | Total base selling price of SKU | Yes |
| Double | Per unit selling price of the SKU including tax | Yes |
| Double | Total selling price of the SKU | Yes |
| Integer | Quantity of the sku in the shipment item. | Yes |
| Double | Shipping charge per unit for a shipment item | No |
| Double | Channel discount of item | No |
| Object | Distribution of tax with tax type | Yes |
| Object | Shipment details | No |
| Double | Length of the shipment | No |
| Double | Breadth of the shipment | No |
| Double | Height of the shipment | No |
| Double | Weight of the shipment | No |
| Long | Id to uniquely identify a shipment | No |
| Integer | Count of all the items in the shipment | No |
| Object[] | Details of pack boxes | No |
| Double | Length of the pack box in consideration | No |
| Double | Breadth of the pack box in consideration | No |
| Double | Height of the pack box in consideration | No |
| Double | Weight of the pack box in consideration | No |
| Long | Id to uniquely identify a box | No |
| String | AWB number of the box | No |
| String | Remarks for the pack box | No |
| Object[] | Details of skus in a box | No |
| Long | Id to uniquely identify a sku in increff’s system | No |
| String | Id to uniquely identify a sku on client’s end | No |
| Integer | Count of a particular sku in a box | No |
| String | Irn generated on Govt. portal while e-invoicing |
No | ||
| String | QrCode generated on Govt. portal while e-invoicing |
No | ||
| String | Possible values: {OPEN,CLOSED, INVOICED, MANIFESTED, DISPATCHED, CANCELLED, DELIVERED} |
No | ||
| String | Type of tax applicable |
Yes | ||
| Double | Tax rate for this tax type |
Yes | ||
| Double | Tax applicable for this type of tax per unit |
Yes | ||
| Double | Total tax applicable for this type of tax |
Yes | ||
| Object | Shipping address of the customer |
Yes | ||
| String | Name of customer |
Yes | ||
| String | 1st line of customer’s address |
Yes | ||
| String | 2nd line of customer’s address |
No | ||
| String | 3rd line of customer’s address |
No | ||
| String | City of customer |
Yes | ||
| String | State of customer |
Yes | ||
| String | ZIP/Pin code of customer |
Yes | ||
| String | Country of customer |
Yes | ||
| String | Email of customer |
No | ||
| String | Phone Number of customer |
No | ||
| Object | Billing address of the customer |
Yes | ||
| String | Name of customer |
Yes | ||
| String | 1st line of customer’s address |
Yes | ||
| String | 2nd line of customer’s address |
No | ||
| String | 3rd line of customer’s address |
No | ||
| String | City of customer |
Yes | ||
| String | State of customer |
Yes | ||
| String | ZIP/Pin code of customer |
Yes | ||
| String | Country of customer |
Yes | ||
| String | Email of customer |
No | ||
| String | Phone Number of customer |
no
Response
Code Block | ||
---|---|---|
| ||
{
"hasError": false,
"errorMessage":"message"
} |
...
No |