Page Comparison

...

This API is used to create B2C return orders in Omni. One order item represents only one quantity of an SKU. If there are multiple quantities of the same SKU then multiple order items should be created.

Request

Code Block

language	json

{
  "forwardOrderCode": "108",
  "returnOrderCode": "100078",
  "locationCode": "Wid234",
  "returnOrderTime": "2020-10-16T20:22:28.000+05:30",
  "returnOrderStatus" : "RETURN_CREATED",
  "expectedDate" : "2020-10-16T20:22:28.000+05:30",
  "orderItems": [
    {
      "itemCode": "I10098",
      "reason": "Different Size",
      "channelSkuCode": "10007345",
      "enableDoorStepQc": true
      "name" : "Name",
      "brand": "Brand1",
      "color": "Black",
      "category": "Footwear",
      "subCategory": "Shoe",
      "serialNumber": "100",
      "price" : 100.00,
      "finalAmountPaid" : 100.00,
      "imageUrl": "xyz",
      "storeCreditsUsed": 0.0,
      "subTaxItemData": [
        {
          "type": "type",
          "rate": 10,
          "taxPerUnit": 10,
          "taxTotal": 10
        }
      ]
    }
  ],
  "orderType": "CUSTOMER_RETURN",
  "awbNumber": "HYN402",
  "transporter": "transporter",
  "currencyCode": "INR",
  "regionType": "INDIAN",
  "returnReason": "damaged product",
  "sellerGstin": "29AADCP7081J1ZY",
  "consigneeGstin": "29AAHCT2518N1ZW",
  "shipmentDimension": {
    "breadth": 10,
    "height": 10,
    "length": 10,
    "weight": 1
  },
  "dropAddress": {
    "name": "customerName",
    "line1": "address line 1",
    "line2": "address line 2",
    "line3": "address line 3",
    "city": "Bengaluru",
    "state": "Karnataka",
    "zip": "560076",
    "country": "INDIA",
    "email": "email.com",
    "phone": "9999999999"
  },
  "pickupAddress": {
    "name": "customerName",
    "line1": "address line 1",
    "line2": "address line 2",
    "line3": "address line 3",
    "city": "Bengaluru",
    "state": "Karnataka",
    "zip": "560076",
    "country": "INDIA",
    "email": "email.com",
    "phone": "9999999999"
  },
  "orderDetails" : {
    "codValue": 0,
    "invoiceNumber": "INV-10",
    "invoiceTime": "20212020-0610-18T12:00:01Z16T20:22:28.000+05:30",
    "invoiceValue": 100.00,
    "isCod": false,
    "forwardShipmentNumber": "101"
  }
}

Parameter Name	Data Type	Description	Mandatory
`forwardOrderCode`	String	Forward order code for which return order is being created.	yes
`returnOrderCode`	String	Unique identifier provided by the channel for the return order being created.	yes
`locationCode`	String	Location code of the warehouse where the return order will be received.	yes
`returnOrderTime`	String	Time at which return order got placed by customer Format eg : `2020-10-16T20:22:28.000+05:30`	no
`returnOrderStatus`	String	The Status of the return order	no
`expectedDate`	String	Expected date of return Format eg : `2020-10-16T20:22:28.000+05:30`	no
`orderItems`	Object[]	Array of order items, order items represent each line of return order.	yes
`orderItems.itemCode`	String	Unique identifier provided by the channel for the return order item.	yes
`orderItems.reason`	String	Reason for return as given by the customer.	yes
`orderItems.channelSkuCode`	String	SKU code for return order item.	yes
`orderItems.name`	String	Name of the product	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*
`orderItems.brand`	String	Brand of the product	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*†
`orderItems.enableDoorStepQc`	Boolean	To enable door step qc by courier	No
`orderItems.color`	String	Color of the product	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*†
`orderItems.category`	String	Category of the product	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*†
`orderItems.subCategory`	String	Sub Category of the product	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*†
`orderItems.serialNumber`	String	Serial number of the product	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*†
`orderItems.price`	Double	Price of the product	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*
`orderItems.finalAmountPaid`	Double	Final amount paid for the product	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*
`orderItems.imageUrl`	String	Image url of the product

Conditional Yes(Mandatory if AWB integration needed with RMS)

No
`orderItems.storeCreditsUsed`	Double	Store credits for this line item

Conditional Yes(Mandatory if AWB integration needed with RMS)

No
`orderItems.subTaxItemData`	Object[]	List of sub tax items object	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*†
`subTaxItemData.type`	String	Type of tax applicable	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*†
`subTaxItemData.rate`	Double	Tax rate for this tax type	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*†
`subTaxItemData.taxPerUnit`	Double	Tax applicable for this type of tax per unit	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*†
`subTaxItemData.taxTotal`	Double	Total tax for this tax type	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*†
`orderType`	String	Type of return. Possible values - SELF_SHIP,CUSTOMER_RETURN,RETURN_TO_ORIGIN	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*
`awbNumber`	String	Courier tracking number.	If courier partner integration done via Increff, then can be ignored.

no

(Otherwise YES)
`transporter`	String	Courier partner name.

no

If courier partner integration done via Increff, then can be ignored.

(Otherwise YES)

currencyCode

String

Currency

Conditional Yes

(Mandatory if AWB integration needed with RMS)

*
`regionType`	String	Can take two values:INDIAN and INTERNATIONAL, specifying the region type of order	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*
`sellerGstin`	String	Seller GSTIN. If logisticAggregatorType=CLICKPOST, then this field is mandatory. If logisticAggregatorType=SHIPROCKET, then this field can be null	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*
`consigneeGstin`	String	Consignee GSTIN	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*†
`returnReason`	String	The reason due to which the order was returned	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*
`shipmentDimension`	Object	Package Dimensions	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*

shipmentDimension.breadth

Integer

Double	Breadth of package. Default value can be set as 1	yes
`shipmentDimension.height`

Integer

Double	Height of package. Default value can be set as 1	yes
`shipmentDimension.length`

Integer

Double	Length of package. Default value can be set as 1	yes
`shipmentDimension.weight`

Integer

Doubke

Weight of package. Default value can be set as

0.5

200	yes
`dropAddress`	Object	Shipping Address (Warehouse address)	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*
`dropAddress.name`	String	Name of Warehouse POC	Yes
`dropAddress.line1`	String	1st line of warehouse’s address	Yes
`dropAddress.line2`	String	2nd line of warehouse’s address	No
`dropAddress.line3`	String	3rd line of warehouse’s address	No
`dropAddress.city`	String	City of Warehouse	Yes
`dropAddress.state`	String	State of Warehouse	Yes
`dropAddress.zip`	String	ZIP/Pin code of Warehouse	Yes
`dropAddress.country`	String	Country of warehouse	Yes
`dropAddress.email`	String	Email of warehouse	Yes
`dropAddress.phone`	String	Phone Number of warehouse POC	Yes
`pickupAddress`	Object	Billing address of the customer	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*
`pickupAddress.name`	String	Name of customer	Yes
`pickupAddress.line1`	String	1st line of customer’s address	Yes
`pickupAddress.line2`	String	2nd line of customer’s address	No
`pickupAddress.line3`	String	3rd line of customer’s address	No
`pickupAddress.city`	String	City of customer	Yes
`pickupAddress.state`	String	State of customer	Yes
`pickupAddress.zip`	String	ZIP/Pin code of customer	Yes
`pickupAddress.country`	String	Country of customer	Yes
`pickupAddress.email`	String	Email of customer	Yes
`pickupAddress.phone`	String	Phone Number of customer	Yes
`orderDetails`	Object	Order Details	Conditional Yes

(Mandatory if AWB integration needed with RMS)

*
`orderDetails.codValue`	Double	If order is of type COD, then this should be greater than 0	Yes
`orderDetails.invoiceNumber`	String	Invoice Id of the order. If logisticAggregatorType=CLICKPOST, then this field is mandatory. If logisticAggregatorType=SHIPROCKET, then this field can be null	Conditional yes*
`orderDetails.invoiceTime`

Date

String	Invoice Time of the order. If logisticAggregatorType=CLICKPOST, then this field is mandatory. If logisticAggregatorType=SHIPROCKET, then this field can be null Format eg : `2020-10-16T20:22:28.000+05:30`	Conditional yes*
`orderDetails.invoiceValue`	Double	Invoice value	Yes
`orderDetails.isCod`	Boolean	True if the order is of COD type	Yes
`orderDetails.forwardShipmentNumber`	String	Forward Shipment Number	No

These fields are mandatory if courier partner integration needs to be done via Increff(ie. in cases where the channel does not have the AWB and transporter details and wants increff to fetch these details through the integration between increff and logistic aggregator)

*† These fields are dependant on the Courier partner being integrated with, if it is mandatory for the courier partner, then they must be sent.

Response

Empty Body

HttpStatus : 200

Versions Compared

Old Version 2

New Version Current

Key

Request

Response