Skip to end of banner
Go to start of banner

Outward Sales Posting API (For ERP systems)

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 17 Next »

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,
  "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
    }
  ],
  "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
            }
          ]
        }
      ]
    }
  ],
  "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

 OUTWARD_ORDER_COMPLETE
{
  "partnerCode": "Increff_FASHION",
  "partnerLocationCode": "2",
  "locationCode": "FMRW2021",
  "messageId": 19327,
  "orderCode": "16837253779671050215",
  "parentOrderCode": "NYK-12083161-5367312-1-1",
  "orderTime": "2023-04-16T20:22:28.000+00:00",
  "orderType": "SO",
  "paymentMethod": "COD",
  "isPriority": false,
  "channelName": "Increff_FASHION",
  "channelType": "MARKETPLACE",
  "orderItems": [
    {
      "orderItemCode": "23187157",
      "channelSkuCode": "8904328664321",
      "orderedQuantity": 1,
      "cancelledQuantity": 0,
      "channelDiscount": 1374,
      "sellerDiscount": 0,
      "sellingPricePerUnit": 2499,
      "giftChargePerUnit": 0,
      "shippingCharge": 0
    }
  ],
  "eventType": "OUTWARD_ORDER_COMPLETE",
  "eventTime": "2023-04-16T20:22:28.000+00:00",
  "shipments": [
    {
      "shipmentCode": "26719",
      "generatedInvoiceId": "16255",
      "generatedInvoiceDate": "2023-04-16T20:22:28.000+00:00",
      "invoiceDocumentUrl": "https://storage.googleapis.com/some_folder/INVOICE_AND_SHIPPING_LABEL/some_hash.pdf",
      "shippingLabelDocumentUrl": "https://storage.googleapis.com/some_folder/INVOICE_AND_SHIPPING_LABEL/some_hash.pdf",
      "externalInvoiceId": "26719",
      "externalInvoiceDate": null,
      "irn": "",
      "qrCode": "",
      "shipmentStatus": "DISPATCHED",
      "shipmentItems": [
        {
          "channelSkuCode": "8904328664321",
          "orderItemCode": "23187157",
          "channelDiscount": 1374,
          "netTaxAmountPerUnit": 120.54,
          "netTaxAmountTotal": 120.54,
          "baseSellingPricePerUnit": 2378.46,
          "baseSellingPriceTotal": 2378.46,
          "sellingPricePerUnit": 2499,
          "sellingPriceTotal": 2499,
          "quantity": 1,
          "shippingChargePerUnit": 0,
          "taxItems": [
            {
              "type": "IGST",
              "rate": 5.067985166872682,
              "taxPerUnit": 120.54,
              "taxTotal": 120.54
            }
          ]
        }
      ],
      "locationCode": "FMRW2021"
    }
  ],
  "shippingAddress": {
    "name": "Customer's Name",
    "line1": "Line Address 1",
    "line2": "Line Address 2",
    "line3": "Line Address 3",
    "city": "city",
    "state": "state",
    "zip": "560076",
    "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"
  },
  "virtualSkuDefinitions": [],
  "isSplitRequired": false,
  "shippingCharges": null
}

 OUTWARD_ORDER_CREATE
{
  "partnerCode": "MYNTRAV4",
  "partnerLocationCode": "206",
  "locationCode": "1100151058",
  "messageId": 5025311,
  "orderCode": "149f61d9-29a3-4ea45e-8f19-199723116098",
  "parentOrderCode": "149f61d9-29a3-4ea45e-8f19-199723116098",
  "orderTime": "2023-04-16T20:22:28.000+00:00",
  "orderType": "SO",
  "paymentMethod": "COD",
  "isPriority": false,
  "channelName": "MYNTRAV4",
  "channelType": "MARKETPLACE",
  "orderItems": [
    {
      "orderItemCode": "9376627566",
      "channelSkuCode": "SG0453",
      "orderedQuantity": 1,
      "cancelledQuantity": 0,
      "channelDiscount": null,
      "sellerDiscount": 374,
      "sellingPricePerUnit": 1121,
      "giftChargePerUnit": 0,
      "shippingCharge": null
    }
  ],
  "eventType": "OUTWARD_ORDER_CREATE",
  "eventTime": "2023-04-16T20:22:28.000+00:00",
  "shipments": [],
  "shippingAddress": {
    "name": "Customer's Name",
    "line1": "Line Address 1",
    "line2": "Line Address 2",
    "line3": "Line Address 3",
    "city": "city",
    "state": "state",
    "zip": "560076",
    "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"
  },
  "virtualSkuDefinitions": [],
  "isSplitRequired": false,
  "shippingCharges": null
}

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 Increff Omni

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

omsOrderId

Long

Internal order id of OMS

no

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

orderItems.omsItemId

Long

Internal item id of OMS

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.awbNumber

String

AWB number of 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

yes

irn

String

Irn generated on Govt. portal while e-invoicing

no

qrCode

String

QrCode generated on Govt. portal while e-invoicing

no

shipmentStatus

String

Possible values: {OPEN,CLOSED, INVOICED, MANIFESTED, DISPATCHED, CANCELLED, DELIVERED}

no

taxItems.type

String

Type of tax applicable

yes

taxItems.rate

Double

Tax rate for this tax type

yes

taxItems.taxPerUnit

Double

Tax applicable for this type of tax per unit

yes

taxItems.taxTotal

Double

Total tax applicable for this type of tax

yes

shippingAddress

Object

Shipping address of the customer

yes

shippingAddress.name

String

Name of customer

yes

shippingAddress.line1

String

1st line of customer’s address

yes

shippingAddress.line2

String

2nd line of customer’s address

no

shippingAddress.line3

String

3rd line of customer’s address

no

shippingAddress.city

String

City of customer

yes

shippingAddress.state

String

State of customer

yes

shippingAddress.zip

String

ZIP/Pin code of customer

yes

shippingAddress.country

String

Country of customer

yes

shippingAddress.email

String

Email of customer

no

shippingAddress.phone

String

Phone Number of customer

no

billingAddress

Object

Billing address of the customer

yes

billingAddress.name

String

Name of customer

yes

billingAddress.line1

String

1st line of customer’s address

yes

billingAddress.line2

String

2nd line of customer’s address

no

billingAddress.line3

String

3rd line of customer’s address

no

billingAddress.city

String

City of customer

yes

billingAddress.state

String

State of customer

yes

billingAddress.zip

String

ZIP/Pin code of customer

yes

billingAddress.country

String

Country of customer

yes

billingAddress.email

String

Email of customer

no

billingAddress.phone

String

Phone Number of customer

no

 

Response

{
    "hasError": false,
    "errorMessage":"message"
}

 

HttpStatus : 200

  • No labels