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
Superset of Request Body
{ "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", "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 } ], "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", "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 } ] } ] } ], "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" } }
More request samples
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 Assure | 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 |
| 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 |
| String | Possible values : { OUTWARD_ORDER_CREATE, OUTWARD_ORDER_CANCEL, OUTWARD_ORDER_COMPLETE , OUTWARD_ORDER_PARTIAL_CANCEL} | yes |
| String | Time of event creation | yes |
| Object [ ] | List of virtual SKU definitions | no |
| String | SKU code of virtual SKU | no |
| String | Barcode of parent SKU | no |
| Object [ ] | List of child SKUs | no |
| String | SKU code of child SKU | no |
| Integer | Quantity of child SKU | no |
| String | Barcode of child SKU | no |
| Boolean | Flag to identify wether WMS had to split the order | yes |
| String | Enum with possible values: | no |
| Double | Shipping charges | no |
| Object[] | List of shipments | yes |
| String | Shipment code | yes |
| String | Warehouse location from which shipment was fulfilled | no |
| String | Invoice id for the shipment | no |
| String | Invoice date in the sample format mentioned | no |
| String | External invoice id | no |
| String | External invoice date | no |
| String | Url of the invoice document | no |
| String | Url of the shipping label document | no |
| String | IRN code | no |
| String | QR code | no |
| String | Status of the 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 |
| 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