Inbound | POST | /orders/outward

...

This API will create outward orders in Increff Omni. One payload will create only one order and one SKU can be present only once. The number of order items in an order should not be more than 2500.

Note: Please note that the Custom Order or Order Item attribute key must be added in the OMS UI using screen Custom order/ line Item Attribute, else it can result into failure of order creation in Increff OMS system.

In cases where the Custom order attribute key is not defined and custom order or order item attributes are part of the Inward/Outward order creation payloads then the order would move to FAILED status in CIMS.

Request

Code Block

breakoutMode	wide
language	json

{
  "parentOrderCode": "132PARENT-ORD-789",
  "locationCode": "Wid234WAREHOUSE-001",
  "orderCode": "H19304030003ORD-123456",
  "orderTime": "20202024-1002-16T2013T09:22:28.000+05:3045:00Z",
  "orderType": "SO/STO/RTV/RPOPO",
  "isPriorityonHold": false,
  "giftisPriority": falsetrue,
  "onHoldgift": falsetrue,
  "qcStatus": "PASS",
  "dispatchByTime": "20202024-1002-16T2015T14:22:28.000+05:3030:00Z",
  "startProcessingTime": "20202024-1002-16T2013T10:22:28.000+05:3000:00Z",
  "paymentMethod": "COD",
  "isSplitRequiredshippingAddress":false,
  "taxBreakupForms": [
    {
 
    "channelSkuIdname": "sky1Jane Smith",
      "baseSellingPricePerUnitline1": 100.8,
 "456 Oak Street",
    "taxItemFormsline2": ["Suite 789",
    "line3": "Tower  {
     D",
     "typephone": "CGST+1-555-987-6543",
          "rate"email": 1.2"jane.smith@example.com",
    "city": "Gotham",
    "taxPerUnitstate": 27.5"NY",
    "zip": "10001",
  }  "country": "United States"
  ]
    }
  ],
  "packType": "PIECE",
  "shippingAddressbillingAddress": {
    "name": "customerNameJohn Doe",
    "line1": "address123 lineMain 1Street",
    "line2": "addressApt line 2456",
    "line3": "addressBuilding line 3C",
    "cityphone": "Bengaluru+1-555-123-4567",
    "stateemail": "Karnatakajohn.doe@example.com",
    "zipcity": "560076Metropolis",
    "countrystate": "INDIACA",
    "emailzip": "email.com90001",
    "phonecountry": "9999999999United States"
  },
  "billingAddressorderItems": [
    {
      "namechannelSkuCode": "customerNameSKU-001",
      "line1orderItemCode": "ITEM-001"address,
line 1",     "line2quantity": "address2,
line 2",     "line3sellerDiscountPerUnit": "address line 3",3.00,
      "citychannelDiscountPerUnit": "Bengaluru",5.00,
      "statesellingPricePerUnit": "Karnataka",20.00,
      "zipshippingChargePerUnit": "560076"8.00,
      "countrygiftOptions": {
        "INDIAgiftwrapRequired": true,
        "emailgiftMessage": "email.comHappy Birthday!",
        "phonegiftChargePerUnit": "9999999999"2.50,
     },   "orderItemsgiftDocument": [
"gift_document.pdf",
   {       "channelSkuCodegiftDocumentFormat": "100005643"PDF"
      },
      "orderItemCodeminExpiry": "item1232025-01-01",
      "quantityorderItemCustomAttributes": {
 2,       "sellerDiscountPerUnitattribute1": 75"value1",
        "channelDiscountPerUnitattribute2": 150"value2",
        "sellingPricePerUnitattribute3": 1500"value3",
        "shippingChargePerUnitattribute4": 50"value4",
        "minExpiryattribute5": "2021-08-11value5",
        "giftOptionsattribute6": {"value6",
        "giftwrapRequiredattribute7": false"value7",
        "giftMessageattribute8": "value8",
        "giftChargePerUnitattribute9": 0"value9",
        "giftDocumentattribute10": "abcvalue10",
        "giftDocumentFormat"channelMetadata": {"key" : "PDFvalue"}
      }
    }
  ],
  "taxBreakupForms": [
    {
      "channelSkuCodechannelSkuId": "100005644SKU-001",
      "orderItemCodebaseSellingPricePerUnit": "item124"25.00,
      "quantitytaxItemForms": 2, [
        {
          "sellerDiscountPerUnittype": 50"VAT",
          "channelDiscountPerUnitrate": 100,8.5,
          "sellingPricePerUnittaxPerUnit": 1000, 2.13
        }
      ]
  "shippingChargePerUnit": 50, }
  ],
  "minExpirypackType": "2021-08-11PIECE",
  "isSplitRequired": true,
  "giftOptionsorderCustomAttributes": {
    "attribute1": "value1",
    "giftwrapRequiredattribute2": false"value2",
    "attribute3": "value3",
    "giftMessageattribute4": "value4",
    "attribute5": "value5",
    "giftChargePerUnitattribute6": 0"value6",
    "attribute7": "value7",
    "giftDocumentattribute8": "abcvalue8",
    "attribute9": "value9",
    "giftDocumentFormatattribute10": "PDFvalue10",
    "channelMetadata": {},
}     }"currency": "USD"
  ]}
}

no

Parameter Name	Data Type	Description	Mandatory
`parentOrderCode`	String

Order identifier to map the parent order with child orders.

Represents code of parent order of the order	No
`locationCode`	String	Location code of warehouse from where this order will get fulfilled

no(

Note: Location code

should

must be provided in case the isSplitRequired field is false

and not provided when the isSplitRequired field is true.)

	No
`orderCode`	String	Unique code used by channel to identify the order

yes

Yes
`orderTime`	String	Time at which order

was

got placed

at the channel

by customer

(in UTC)

yes

Yes
`orderType`	String	Possible

value -

SO (Sales Order),
STO (Stock Transfer Order),
RTV (Return To Vendor), RPO(Replacement)
CROSS_DOCK

yes

values →

PO: Purchase Order

STO: Stock transfer Order

SO: Sales Order

RTV: Return to vendor

RO: Return Order

OPEN_PO/OPEN_RO: Open Purchase/Return Order

CRD: Crossdock

Yes

isPriority

Boolean

This flag is true in case order is

HIGH

having High priority than normal orders.

no

No
`gift`	Boolean	This flag is true in case order is a gift and needs to be gift wrapped.

no

No
`onHold`	Boolean	This flag is true in case order has to be kept on hold. Processing starts only after call is made to unhold the order

yes

Yes
`dispatchByTime`	String

SLA time before

Time by which the order

processing

is expected to

be completed

get dispatched

yes

Yes
`startProcessingTime`	String	Time

after

by which the order processing is

allowed in the fulfillment systemyes

expected to get started	Yes
`paymentMethod`	String

It signifies the payment mode using which customer has placed the order

Possible values

-

→ COD/NCOD

yes

Yes
`isSplitRequired`	Boolean	This flag is true when WMS has to split the order. If this variable is TRUE

,

then LocationCodeshould be send as NULL

yes

No

taxBreakupForms

Object[ ]

Tax break up for the items

(if this is sent,

al

all the fields of the object should be sent)

noyes

No
`taxBreakupForms.channelSkuId`	String

Channel Sku id

Unique code to identify SKU on channel	Yes
`taxBreakupForms.baseSellingPricePerUnit`	Double	Base selling price per unit of the

Sku

SKU

yes

Yes
`taxBreakupForms.taxItemForms`	Object[ ]	Distribution of tax with tax type

yes

No
`taxItemForms.type`	String	Type of tax applicable

yes

Yes
`taxItemForms.rate`	Double	Tax rate for this tax type

yes

Yes
`taxItemForms.taxPerUnit`	Double	Tax applicable for this type of tax per unit

yes

Yes
`packType`	String	Possible values

-

→ PIECE/BULK

no

No
`qcStatus`	String	Possible values

-

→ PASS, FAIL

By default value

:

will be PASS	Yes
`shippingAddress`	Object	Shipping address of the customer

yes

Yes
`shippingAddress.name`	String	Name of customer

yes

No
`shippingAddress.line1`	String	1st line of customer’s address

yes

No
`shippingAddress.line2`	String	2nd line of customer’s address

no

No
`shippingAddress.line3`	String	3rd line of customer’s address

no

No
`shippingAddress.city`	String	City of customer

yes

No
`shippingAddress.state`	String	State of customer

yes

No
`shippingAddress.zip`	String	ZIP/Pin code of customer

yes

Yes
`shippingAddress.country`	String	Country of customer

yes

Yes
`shippingAddress.email`	String	Email of customer

yes

No
`shippingAddress.phone`	String	Phone Number of customer

no

No
`billingAddress`	Object	Billing address of the customer

yes

Yes
`billingAddress.name`	String	Name of customer

yes

No
`billingAddress.line1`	String	1st line of customer’s address

yes

No
`billingAddress.line2`	String	2nd line of customer’s address

no

No
`billingAddress.line3`	String	3rd line of customer’s address

no

No
`billingAddress.city`	String	City of customer

yes

No
`billingAddress.state`	String	State of customer

yes

No
`billingAddress.zip`	String	ZIP/Pin code of customer

yes

Yes
`billingAddress.country`	String	Country of customer

yes

Yes
`billingAddress.email`	String	Email of customer

yes

No
`billingAddress.phone`	String	Phone Number of customer

no

No
`orderItems`	Object[]	List of items for which order is being placed

yes

Yes
`orderItems.channelSkuCode`	String	SKU code of order item on channel

yes

Yes
`orderItems.orderItemCode`	String	This is provided by the channel to uniquely identify each order item. This should be unique in an order

yes

Yes
`orderItems.quantity`	Integer	Quantity of SKU in the order placed

yes

Yes
`orderItems.sellerDiscountPerUnit`	Double	Discount given by seller on SKU per unit

no

No
`orderItems.channelDiscountPerUnit`	Double	Discount given by channel on SKU per unit

no

No
`orderItems.sellingPricePerUnit`	Double	Unit price of SKU including tax

yes

Yes
`orderItems.shippingChargePerUnit`	Double	Shipping charge on item per unit

no

No
`orderItems.minExpiry`	String	Minimum expiry date for the item to be shipped

no

No
`orderItems.giftOptions`	Object	Contains gift details of the item

no

No
`giftOptions.giftwrapRequired`	Boolean	To specify if gift wrap is required

yes

Yes
`giftOptions.giftMessage`	String	Gift message

no

No
`giftOptions.giftChargePerUnit`	Double	Gift charge on item per unit

no

No
`giftOptions.giftDocument`	String	Base64 encoded string

no

No

giftOptions.giftDocumentFormat

String

Possible values →

PDF

,

/ ZPL

,

/ PNG.

(To be populated if document is present

no

)	No
`orderItems.orderItemCustomAttributes`	Object	Custom attributes for an order Item	No
`orderItemCustomAttributes.attribute1`	String	Custom attribute 1	No
`orderItemCustomAttributes.attribute2`	String	Custom attribute 2	No
`orderItemCustomAttributes.attribute3`	String	Custom attribute 3	No
`orderItemCustomAttributes.attribute4`	String	Custom attribute 4	No
`orderItemCustomAttributes.attribute5`	String	Custom attribute 5	No
`orderItemCustomAttributes.attribute6`	String	Custom attribute 6	No
`orderItemCustomAttributes.attribute7`	String	Custom attribute 7	No
`orderItemCustomAttributes.attribute8`	String	Custom attribute 8	No
`orderItemCustomAttributes.attribute9`	String	Custom attribute 9	No
`orderItemCustomAttributes.attribute10`	String	Custom attribute 10	No
orderItemCustomAttributes.channelMetaData	Object	These are additonal fields which can be sent to Increff system and can be used in subsequent Posting workflows	No
`orderCustomAttributes`	Object	Custom attributes for an order	No
`orderCustomAttributes.attribute1`	String	Custom attribute 1	No
`orderCustomAttributes.attribute2`	String	Custom attribute 2	No
`orderCustomAttributes.attribute3`	String	Custom attribute 3	No
`orderCustomAttributes.attribute4`	String	Custom attribute 4	No
`orderCustomAttributes.attribute5`	String	Custom attribute 5	No
`orderCustomAttributes.attribute6`	String	Custom attribute 6	No
`orderCustomAttributes.attribute7`	String	Custom attribute 7	No
`orderCustomAttributes.attribute8`	String	Custom attribute 8	No
`orderCustomAttributes.attribute9`	String	Custom attribute 9	No
`orderCustomAttributes.attribute10`	String	Custom attribute 10	No
`orderCustomAttributes.channelMetaData`	Object	These are additonal fields which can be sent to Increff system and can be used in subsequent Posting workflows	No
`orderCustomAttributes.currency`	String	Currency	No

Response

Empty Body

Versions Compared

Old Version 9

New Version Current

Key

Inbound | POST | /orders/outward

Request

Response

HttpStatusCode

200

Page Comparison

Versions Compared

Old Version 9

New Version Current

Key

<span class="diff-html-removed" data-a11y-before="Start of deleted content" data-a11y-after="End of deleted content" id="removed-diff-0">[data-colorid=sau1np6dbo]{color:#006644} html[data-color-mode=dark] [data-colorid=sau1np6dbo]{color:#99ffdd}</span>Inbound | POST | /orders/outward

Request

Response

HttpStatusCode

200

Inbound | POST | /orders/outward