More Request Samples
Sales Order Posting
Outbound | POST | {Client’s URL}
Summary
This API will call the channel with sales order details.
Description
This API will call the channel with the details of sales orders which are completed in Increff Omni. This will be triggered at a certain frequency from Increff Omni to the channels.
List of Indian State Names: State Names (Indian)
We can send these posting on these triggers
OUTWARD_ORDER_CREATE,
OUTWARD_ORDER_CANCEL,
OUTWARD_ORDER_COMPLETE ,
OUTWARD_ORDER_PARTIAL_CANCEL
Request
{ "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" } ] } ], "isSplitRequired": "false", "shippingCharges": 20, "channelType": "ERP", "orderItems": [ { "orderItemCode": "item123", "channelSkuCode": "1000889888", "orderedQuantity": 2, "cancelledQuantity": 1, "channelDiscount": 50, "sellingPricePerUnit": 500, "giftChargePerUnit": 10, "sellerDiscount": 5, "shippingCharge": 0, "omsItemId": 123, "barcode": "barcode1", "orderItemCustomAttributes": { "attribute1": "Value1", "attribute2": "Value2", "attribute3": "Value3", "attribute4": "Value4", "attribute5": "Value5", "attribute6": "Value6", "attribute7": "Value7", "attribute8": "Value8", "attribute9": "Value9", "attribute10": "Value10", "channelMetadata": { "totalCashOnDeliveryFee": 0.0, "department": "HR", "paymentMethod": "ccavenue", "status": "processing" } } } ], "shipments": [ { "shipmentCode": "UIfd897", "locationCode": "loc1", "generatedInvoiceId": "AR105044395", "generatedInvoiceDate": "2020-10-16T20:22:28.000+00:00", "externalInvoiceId": "FK56556GH45", "externalInvoiceDate": "2020-10-16T20:22:28.000+00:00", "invoiceDocumentUrl": "https://mybrand.com/invoice123.pdf", "shippingLabelDocumentUrl": "https://mybrand.com/sldoc.pdf", "irn": "a429746e55b844c9d2cb2a6f68997d1c2af29987cc834f3b52da45d1b0bc97c9", "qrCode": "eyJhbGciPiJSUzI1NiIsImtpZCI6IkI4RDYzRUNCMThFQTVFNkY0QUKDM0Q1MjQ1NDNCMjI0NjY2OUIwRjgiLCJ0eXAiOiJKV1QiLCJ4NXQiOiJ1TlkteTFqcVhtOUtyRDFTUlVPeUpHWnBzUGcifQ.eyJkYXRhIjoie1wiU2VsbGVyR3N0aW5cIjpcIjI5QUFPQ001MzI2SjFaWVwiLFwiQnV5ZXJHc3RpblwiOlwiMjlBQUJDUjE3MThFMVpMXCIsXCJEb2NOb1wiOlwiTUVhajIyLTIzLzUwNTlcIixcIkRvY1R5cFwiOlwiSU5WXCIsXCJEb2NEdFwiOlwiMTMvMTAvMjAyMlwiLFwiVG90SW52VmFsXCI6MTgxNy4wNCxcIkl0ZW1DbnRcIjoxLFwiTWFpbkhzbkNvZGVcIjpcIjYyMTE0MjkwXCIsXCJJcm5cIjpcImE0Mjk3NDZlMzRkODQ0YzlkMmNiMmE2ZjY4OTk3ZDFjMmFmMjM5ODdjYzgzNGYzYjUyZGE0NWQxYjBiYzk3YzlcIixcIklybkR0XCI6XCIyMDIyLTEwLTEzIDEyOjAxOjAwXCJ9IiwiaXNzIjoiTklDIn0.wvB7b15AnpdQdX_d0VZEyj9dL1qWDaOFPLRPrlV0V2XIu3cE3aQ3YtsWLnTnyrmtUlokpbkkE4folBQNhfzkCPlnODNxRPfpO-Kz9eyNpqcIEp-8TqvcDKXZ3PrBRqmNmner00AG_fVmmqT1HLiyKB2sqOnhqtCfQaQF-PGnqIOhal3PDxIMVt0WAtaQOIwwDA75dsjjnFHaZFPl9tFPR8A6Wrw4NhQH-7xhABKW3Z961a_rGmO6M3XP7jPHyYPW-QWMfTqwNXwxNdFgFePL5FloPiUipt2-g4FIplgm-YcN1xMvEQ2irAfzQwbnxi7UKz-jwOgM0Zy2BbburYgDvQ", "shipmentStatus": "DELIVERED", "awbNumber": "awb1", "shipmentItems": [ { "channelSkuCode": "100000789702", "orderItemCode": "item123", "netTaxAmountPerUnit": 60, "netTaxAmountTotal": 120, "baseSellingPricePerUnit": 500, "baseSellingPriceTotal": 1000, "sellingPricePerUnit": 560, "sellingPriceTotal": 1120, "quantity": 2, "shippingChargePerUnit": 36, "channelDiscount": 30, "taxItems": [ { "type": "SGST", "rate": 6, "taxPerUnit": 30, "taxTotal": 60 }, { "type": "CGST", "rate": 6, "taxPerUnit": 30, "taxTotal": 60 } ] }, { "channelSkuCode": "100000734701", "orderItemCode": "item124", "netTaxAmountPerUnit": 60, "netTaxAmountTotal": 120, "baseSellingPricePerUnit": 500, "baseSellingPriceTotal": 1000, "sellingPricePerUnit": 560, "sellingPriceTotal": 1120, "quantity": 2, "shippingChargePerUnit": 36, "channelDiscount": 30, "taxItems": [ { "type": "SGST", "rate": 6, "taxPerUnit": 30, "taxTotal": 60 }, { "type": "CGST", "rate": 6, "taxPerUnit": 30, "taxTotal": 60 } ] } ] } ], "shipmentDetails": { "length": 30.0, "breadth": 20.0, "height": 10.0, "weight": 5.0, "shipmentId": 12345, "totalItemQuantity": 50, "packboxDetailsList": [ { "length": 15.0, "breadth": 10.0, "height": 8.0, "weight": 2.0, "boxId": 1, "awbNumber": "AWB123", "packBoxRemarks": "Fragile items", "skuQuantityDataList": [ { "globalSkuId": 987, "clientSkuId": "SKU001", "count": 10 }, { "globalSkuId": 876, "clientSkuId": "SKU002", "count": 15 } ] } ] }, "shippingAddress": { "name": "Customer's Name", "line1": "Line Address 1", "line2": "Line Address 2", "line3": "Line Address 3", "city": "city", "state": "state", "zip": "zip", "country": "country", "email": "abc@gmail.com", "phone": "9999999999" }, "billingAddress": { "name": "customer", "line1": "address line 1", "line2": "address line 2", "line3": "address line 3", "city": "Bengaluru", "state": "Karnataka", "zip": "560076", "country": "INDIA", "email": "abc@gmail.com", "phone": "9999999999" }, "orderCustomAttributes": { "attribute1": "Value1", "attribute2": "Value2", "attribute3": "Value3", "attribute4": "Value4", "attribute5": "Value5", "attribute6": "Value6", "attribute7": "Value7", "attribute8": "Value8", "attribute9": "Value9", "attribute10": "Value10", "currency": "INR", "channelMetadata": { "totalCashOnDeliveryFee": 0.0, "department": "HR", "paymentMethod": "ccavenue", "status": "processing" } } }
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 |
| Long | Internal order id of OMS | no |
| ZonedDateTime | Turnaround time | 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 |
| 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 | This is an object which has some extra metadata fields which can be used by the ERP system | No |
| Object | Custom attributes for an order | No |
| Object | This is an object which has some extra metadata fields which can be used by the ERP system | 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 |
| 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
{ "hasError": false, "errorMessage":"message" }
HttpStatus : 200