...
| Code Block | ||
|---|---|---|
| ||
{
"awbNumber": "string",
"channelName": "string",
"consignmentNumber": "string",
"eventTime": "2023-06-30T03:32:58Z",
"billingAddress": {
"city": "Bangalore",
"country": "India",
"email": "abc@gmail.com",
"line1": "string",
"line2": "string",
"line3": "string",
"name": "string",
"phone": "9999999999",
"state": "Karnataka",
"zip": "560102"
},
"forwardOrderCode": "string",
"shippingAddress": {
"city": "Bangalore",
"country": "India",
"email": "abc@gmail.com",
"line1": "string",
"line2": "string",
"line3": "string",
"name": "string",
"phone": "9999999999",
"state": "Karnataka",
"zip": "560102"
},
"items": [
{
"channelDiscount": 0,
"channelSkuCode": "string",
"giftChargePerUnit": 0,
"imageUrls": [
"string"
],
"isExcess": true,
"itemCode": "string",
"posBundledSkuChildItemReturnPostings": [
{
"barcode": "string",
"channelSkuCode": "string",
"omsReturnItemId": 0,
"qcReason": "string",
"qcStatus": "PASS",
"returnOrderItemStatus": "CREATED"
}
],
"virtualSkuChildItemReturnPostings": [
{
"barcode": "string",
"channelSkuCode": "string",
"omsReturnItemId": 0,
"qcReason": "string",
"qcStatus": "PASS",
"returnOrderItemStatus": "CREATED"
}
],
"qcReason": "string",
"qcStatus": "PASS",
"returnOrderItemStatus": "CREATED",
"returnReason": "string",
"sellerDiscount": 0,
"sellingPricePerUnit": 0
}
],
"locationCode": "string",
"messageId": 0, "orderCustomAttributesreturnOrderItemAttributes": {
"attribute1": "1string",
"attribute10": "10string",
"attribute2": "2string",
"attribute3": "3string",
"attribute4": "4string",
"attribute5": "5string",
"attribute6": "6string",
"attribute7": "7string",
"attribute8": "8string",
"attribute9": "9string",
"channelMetadata": "string",
}
"currency": "string" }
}],
"paymentMethodlocationCode": "CODstring",
"returnCreationTimemessageId": "2023-06-30T03:32:58Z",0,
"returnOrderAttributes": {
"returnOrderCodeattribute1": "string",
"orderItemCustomAttributesattribute10": ["string",
"attribute2": "string",
{ "attribute3": "string",
"attribute4": "string",
"barcodeattribute5": "string",
"attribute6": "string",
"channelSkuCodeattribute7": "string",
"attribute8": "string",
"orderItemCodeattribute9": "string",
"channelMetadata": "string"
},
"orderItemCustomAttributesorderCustomAttributes": {
"attribute1": "1",
"attribute10": "10",
"attribute2": "2",
"attribute3": "3",
"attribute2attribute4": "24",
"attribute5": "5",
"attribute3attribute6": "36",
"attribute7": "7",
"attribute8": "8",
"attribute4attribute9": "49",
"attribute5"channelMetadata": "5string",
"currency": "string"
},
"attribute6paymentMethod": "6COD",
"returnCreationTime": "2023-06-30T03:32:58Z",
"attribute7returnOrderCode": "7string",
"orderItemCustomAttributes": [
{
"attribute8barcode": "8string",
"channelSkuCode": "string",
"attribute9orderItemCode": "9string",
"orderItemCustomAttributes": {
"channelMetadataattribute1": "string1",
"attribute10": "10",
} "attribute2": "2",
} ], "returnOrderTypeattribute3": "RETURN_TO_ORIGIN3",
"shipmentsattribute4": [
"4",
{ "awbNumberattribute5": "string5",
"deliveredAtattribute6": "2023-06-30T03:32:58Z6",
"externalInvoiceIdattribute7": "string7",
"externalInvoiceDateattribute8": "2023-06-30T03:32:58Z","8",
"generatedInvoiceDateattribute9": "2023-06-30T03:32:58Z9",
"generatedInvoiceIdchannelMetadata": "string",
"invoiceDocumentUrl": "string",
}
}
],
"irnreturnOrderType": "stringRETURN_TO_ORIGIN",
"shipments": [
"locationCode": "string", {
"packageSkuawbNumber": "string",
"qrCodedeliveredAt": "string2023-06-30T03:32:58Z",
"shipmentCodeexternalInvoiceId": "string",
"shipmentItemsexternalInvoiceDate": ["2023-06-30T03:32:58Z",
{
"generatedInvoiceDate": "2023-06-30T03:32:58Z",
"barcodegeneratedInvoiceId": "string",
"baseSellingPricePerUnitinvoiceDocumentUrl": 0"string",
"baseSellingPriceTotalirn": 0"string",
"locationCode": "string",
"channelSkuCodepackageSku": "string",
"qrCode": "string",
"netTaxAmountPerUnitshipmentCode": 0"string",
"shipmentItems": [
"netTaxAmountTotal": 0, {
"orderItemCodebarcode": "string",
"quantitybaseSellingPricePerUnit": 0,
"sellingPricePerUnitbaseSellingPriceTotal": 0,
"sellingPriceTotalchannelSkuCode": 0"string",
"shippingChargenetTaxAmountPerUnit": 0,
"taxItemsnetTaxAmountTotal": [0,
{
"orderItemCode": "string",
"ratequantity": 0,
"taxPerUnitsellingPricePerUnit": 0,
"taxTotalsellingPriceTotal": 0,
"typeshippingCharge": "string"0,
"taxItems": [
} ]{
} "rate": ]0,
"shippingLabelDocumentUrl": "string", "shipmentStatustaxPerUnit": "OPEN"0,
"transporter": "string"
} ], "virtualSkuDefinitionstaxTotal": [
{
"childSkus": [0,
{
"barcode"type": "string",
"channelSkuCode": "string", }
"qty": 0]
}
],
"virtualParentBarcodeshippingLabelDocumentUrl": "string",
"virtualParentChannelSkuIdshipmentStatus": "stringOPEN",
} "transporter": "string"
}
],
"bundledSkuDefinitionsvirtualSkuDefinitions": [
{
"childSkus": [
{
"barcode": "string",
"channelSkuCode": "string",
"qty": 0
}
],
"bundledParentBarcodevirtualParentBarcode": "string",
"bundledParentChannelSkuIdvirtualParentChannelSkuId": "string"
}
]
} |
...
Parameter Name
...
Data Type
...
Description
...
Mandatory
...
locationCode
...
String
...
Location code of the warehouse where the return order will be received.
...
yes
...
channelName
...
String
...
This is marketplace name
...
yes
...
forwardOrderCode
...
String
...
Unique code used by the channel to identify the forward order
...
yes
...
returnOrderCode
...
String
...
Unique code used by the channel to identify the return order
...
yes
...
messageId
...
Long
...
Unique Identifier of a notification ( for de-duplication)
...
Yes
...
paymentMethod
...
String
...
Possible values - COD, NCOD
...
yes
...
returnOrderType
...
String
...
Possible values- RETURN_TO_ORIGIN,CUSTOMER_RETURN,SELF_SHIP
...
yes
...
eventTime
...
ZonedDateTime
...
Time of event creation
...
yes
...
returnCreationTime
...
ZonedDateTime
...
Time of return order creation
...
Yes
...
items
...
Object[]
...
List of return items processed.
...
yes
...
items.itemCode
...
String
...
This is provided by the ERP to uniquely identify each order item.
...
yes
...
items.returnReason
...
String
...
Reason of return.
...
no
...
items.channelSkuCode
...
String
...
SKU code of return order item
...
yes
...
items.returnOrderItemStatus
...
String
...
Status of the item. Possible values :
CREATED, PROCESSING, MISSING, RECEIVED, CANCELLED,PARTIAL_MISSING_COMBO.
...
yes
...
items.qcStatus
...
String
...
The qcStatus of the return Item.
Possible values : PASS , FAIL
...
yes
...
items.qcReason
...
String
...
The reason due to which this return item has been market qc fail
...
no
...
items.imageUrls
...
String[]
...
It contains the list of urls of the images of the return items .It will only be populated in case that item has been marked as fail.
...
no
...
items.sellingPricePerUnit
...
Double
...
Selling price per unit of the item
...
yes
...
items.isExcess
...
Boolean
...
Flag to identify if the item is an excess item
...
no
...
items.virtualSkuChildItemReturnPostings
...
Object[]
...
List of virtual SKU child items
...
no
...
items.virtualSkuChildItemReturnPostings.omsReturnItemId
...
Long
...
Increff return item id of the child SKU
...
no
...
items.virtualSkuChildItemReturnPostings.returnOrderItemStatus
...
String
...
Possible values:
CREATED,PROCESSING,MISSING,PARTIAL_MISSING_COMBO,RECEIVED,CANCELLED
...
no
...
items.virtualSkuChildItemReturnPostings.channelSkuCode
...
String
...
Channel SKU code of the child SKU
...
no
...
items.virtualSkuChildItemReturnPostings.qcStatus
...
String
...
qc status of the child SKU
Possible values:
PASS,FAIL
...
no
...
items.virtualSkuChildItemReturnPostings.qcReason
...
String
...
qc reason of the child SKU
...
no
...
items.virtualSkuChildItemReturnPostings.barcode
...
String
...
barcode of the child SKU
...
yes
...
items.posBundledSkuChildItemReturnPostings
...
Object[]
...
List of bundled SKU child items
...
no
...
items.posBundledSkuChildItemReturnPostings.barcode
...
String
...
barcode of the child SKU
...
yes
...
items.posBundledSkuChildItemReturnPostings.channelSkuCode
...
Long
...
Channel SKU code of the child SKU
...
no
...
items.posBundledSkuChildItemReturnPostings.omsReturnItemId
...
String
...
Increff return item id of the child SKU
...
yes
...
items.posBundledSkuChildItemReturnPostings.qcReason
...
String
...
qc reason of the child SKU
...
no
...
items.posBundledSkuChildItemReturnPostings.qcStatus
...
String
...
qc status of the child SKU
...
yes
...
items.posBundledSkuChildItemReturnPostings.returnOrderItemStatus
...
String
...
Possible values:
CREATED,PROCESSING,MISSING,PARTIAL_MISSING_COMBO,RECEIVED,CANCELLED
...
yes
...
consignmentNumber
...
String
...
The consignment number associated with the return order
...
no
...
awbNumber
...
String
...
Return order AWB
...
no
...
virtualSkuDefinitions
...
Object[]
...
List of virtual sku definitions
...
no
...
virtualSkuDefinitions.virtualParentChannelSkuId
...
String
...
Channel SKU code of parent SKU
...
no
...
virtualSkuDefinitions.virtualParentBarcode
...
String
...
Barcode of parent SKU
...
no
...
virtualSkuDefinitions.childSkus
...
Object[]
...
List if child SKU associated with parent SKU
...
no
...
virtualSkuDefinitions.childSkus.channelSkuCode
...
String
...
Channel SKU code of child SKU
...
no
...
virtualSkuDefinitions.childSkus.qty
...
Integer
...
Quantity of child SKU, the parent SKU comprises of
...
no
...
virtualSkuDefinitions.childSkus.barcode
...
String
...
Barcode of child SKU
...
no
...
bundledSkuDefinitions
...
Object[]
...
List of bundled sku definitions
...
yes
...
bundledSkuDefinitions.bundledParentBarcode
...
String
...
Unique barcode of bundled Sku
...
no
...
bundledSkuDefinitions.bundledParentChannelSkuId
...
String
...
Unique identifier of bundled Sku at channel
...
yes
...
bundledSkuDefinitions.childSkus
...
Object[]
...
List of child SKUs
...
yes
...
childSkus.barcode
...
String
...
Unique barcode of child sku
...
no
...
childSkus.channelSkuCode
...
String
...
Unique identifier of child sku at channel
...
no
...
childSkus.qty
...
Integer
...
child sku quantity
...
no
...
shipments
...
Object[]
...
List of shipments in forward order
...
no
...
shipments.shipmentCode
...
String
...
Forward Shipment code
...
no
...
shipments.generatedInvoiceId
...
String
...
Invoice id generated for the Forward shipment
...
no
...
shipments.generatedInvoiceDate
...
ZonedDateTime
...
Invoice date generated for the Forward shipment
...
no
...
shipments.invoiceDocumentUrl
...
String
...
Url of the Forward invoice document
...
no
...
shipments.shippingLabelDocumentUrl
...
String
...
Url of the Forward shipping label doc
...
no
...
shipments.externalInvoiceId
...
String
...
Unique Forward invoice id provided by channel
...
no
...
shipments.externalInvoiceDate
...
ZonedDateTime
...
Forward Invoice date provided by channel
...
no
...
shipments.irn
...
String
...
IRN code of Forward shipment
...
no
...
shipments.qrCode
...
String
...
qr code of Forward shipment
...
no
...
shipments.shipmentStatus
...
String
...
Possible values:
OPEN,CLOSED,INVOICED,MANIFESTED,DISPATCHED,CANCELLED,DELIVERED
...
no
...
shipments.locationCode
...
String
...
Location code of Forwardshipment
...
no
...
shipments.shipmentItems
...
Object[]
...
List of Forward shipment items
...
yes
...
shipments.shipmentItems.channelSkuCode
...
String
...
Channel SKU code
...
yes
...
shipments.shipmentItems.orderItemCode
...
String
...
Order item code
...
yes
...
shipments.shipmentItems.netTaxAmountPerUnit
...
Double
...
Per unit tax applicable for the SKU.
...
yes
...
shipments.shipmentItems.netTaxAmountTotal
...
Double
...
Total tax applicable for the SKU
...
yes
...
shipments.shipmentItems.baseSellingPricePerUnit
...
Double
...
Per unit base selling price of the SKU
...
yes
...
shipments.shipmentItems.baseSellingPriceTotal
...
Double
...
Total base selling price of SKU
...
yes
...
shipments.shipmentItems.sellingPricePerUnit
...
Double
...
Per unit selling price of the SKU including tax
...
yes
...
shipments.shipmentItems.sellingPriceTotal
...
Double
...
Total selling price of the SKU
...
yes
...
shipments.shipmentItems.quantity
...
Integer
...
Quantity of the sku in the shipment item.
...
yes
...
shipments.shipmentItems.shippingCharge
...
Double
...
Shipping charge for a shipment item
...
no
...
shipments.shipmentItems.taxItems
...
Object[]
...
Distribution of tax with tax type
...
yes
...
shipments.shipmentItems.taxItems.type
...
String
...
Type of tax applicable
...
yes
...
shipments.shipmentItems.taxItems.rate
...
Double
...
Tax rate for this tax type
...
yes
...
shipments.shipmentItems.taxItems.taxPerUnit
...
Double
...
Tax applicable for this type of tax per unit
...
yes
...
shipments.shipmentItems.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
(Not sent when channel does not send these details eg: Amazon)
...
no
...
shippingAddress.line1
...
String
...
1st line of customer’s address
(Not sent when channel does not send these details eg: Amazon)
...
no
...
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
(Not sent when channel does not send these details eg: Amazon)
...
no
...
shippingAddress.state
...
String
...
State of customer
(Not sent when channel does not send these details eg: Amazon)
...
no
...
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
(Not sent when channel does not send these details eg: Amazon)
...
no
...
billingAddress.line1
...
String
...
1st line of customer’s address
(Not sent when channel does not send these details eg: Amazon)
...
no
...
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
(Not sent when channel does not send these details eg: Amazon)
...
no
...
billingAddress.state
...
String
...
State of customer
...
no
...
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
...
,
"bundledSkuDefinitions": [
{
"childSkus": [
{
"barcode": "string",
"channelSkuCode": "string",
"qty": 0
}
],
"bundledParentBarcode": "string",
"bundledParentChannelSkuId": "string"
}
]
} |
Parameter Name | Data Type | Description | Mandatory |
| String | Location code of the warehouse where the return order will be received. | yes |
| String | This is marketplace name | yes |
| String | Unique code used by the channel to identify the forward order | yes |
| String | Unique code used by the channel to identify the return order | yes |
| Long | Unique Identifier of a notification ( for de-duplication) | Yes |
| String | Possible values - COD, NCOD | yes |
| String | Possible values- RETURN_TO_ORIGIN,CUSTOMER_RETURN,SELF_SHIP | yes |
| ZonedDateTime | Time of event creation | yes |
| ZonedDateTime | Time of return order creation | Yes |
| Object[] | List of return items processed. | yes |
| String | This is provided by the ERP to uniquely identify each order item. | yes |
| String | Reason of return. | no |
| String | SKU code of return order item | yes |
| String | Status of the item. Possible values : CREATED, PROCESSING, MISSING, RECEIVED, CANCELLED, | yes |
| String | The qcStatus of the return Item. Possible values : PASS , FAIL | yes |
| String | The reason due to which this return item has been market qc fail | no |
| String[] | It contains the list of urls of the images of the return items .It will only be populated in case that item has been marked as fail. | no |
| Double | Selling price per unit of the item | yes |
| Boolean | Flag to identify if the item is an excess item | no |
| Object[] | List of virtual SKU child items | no |
| Long | Increff return item id of the child SKU | no |
| String | Possible values:
| no |
| String | Channel SKU code of the child SKU | no |
| String | qc status of the child SKU
| no |
| String | qc reason of the child SKU | no |
| String | barcode of the child SKU | yes |
| Object[] | List of bundled SKU child items | no |
| String | barcode of the child SKU | yes |
| Long | Channel SKU code of the child SKU | no |
| String | Increff return item id of the child SKU | yes |
| String | qc reason of the child SKU | no |
| String | qc status of the child SKU | yes |
| String | Possible values:
| yes |
| Object[] | Custom attributes of order item | no |
| Object | List of attributes for the order item | 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 | meta data fields as an object which is to be parsed at the channel’s end | no |
| Integer | child sku quantity | no |
| Object[] | List of shipments in forward order | no |
| String | Forward Shipment code | no |
| String | Invoice id generated for the Forward shipment | no |
| ZonedDateTime | Invoice date generated for the Forward shipment | no |
| String | Url of the Forward invoice document | no |
| String | Url of the Forward shipping label doc | no |
| String | Unique Forward invoice id provided by channel | no |
| ZonedDateTime | Forward Invoice date provided by channel | no |
| String | IRN code of Forward shipment | no |
| String | qr code of Forward shipment | no |
| String | Possible values:
| no |
| String | Location code of Forwardshipment | no |
| Object[] | List of Forward shipment items | yes |
| String | Channel SKU code | yes |
| String | Order item code | 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 for a shipment item | no |
| Object[] | Distribution of tax with tax type | yes |
| 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 (Not sent when channel does not send these details eg: Amazon) | no |
| String | 1st line of customer’s address (Not sent when channel does not send these details eg: Amazon) | no |
| String | 2nd line of customer’s address | no |
| String | 3rd line of customer’s address | no |
| String | City of customer (Not sent when channel does not send these details eg: Amazon) | no |
| String | State of customer (Not sent when channel does not send these details eg: Amazon) | no |
| 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 (Not sent when channel does not send these details eg: Amazon) | no |
| String | 1st line of customer’s address (Not sent when channel does not send these details eg: Amazon) | no |
| String | 2nd line of customer’s address | no |
| String | 3rd line of customer’s address | no |
| String | City of customer (Not sent when channel does not send these details eg: Amazon) | no |
| String | State of customer | no |
| String | ZIP/Pin code of customer | yes |
| String | Country of customer | yes |
| String | Email of customer | no |
| String | Phone Number of customer | no |
| Object | Custom attributes of the forward order | no |
| String | Custom attribute 1 | no |
| String | Custom attribute 2 | 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 | Currency | no |
| Object | meta data fields as an object which is to be parsed at the channel’s end | no |
| Object[] | Custom attributes of order item | no |
| Object | List of attributes for the order item | 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 | meta data fields as an object which is to be parsed at the channel’s end | no |
| String | Unique barcode of the order item | no |
| String | Unique sku code of the order item identifiable at channel’s end | no |
| String | Unique item code of the order item identifiable in omni | no |
| Object | Custom attributes of the forward order | no |
| String | Custom attribute 1 | no |
| String | Custom attribute 2 | 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 |
orderCustomAttributes.currency
String
Currency
no
| Object | meta data fields as an object which is to be parsed at the channel’s end | no |
| Object[] | Custom attributes of order item | no |
| Object | List of attributes for the order item | 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 | meta data fields as an object which is to be parsed at the channel’s end | no |
| String | Unique barcode of the order item | no |
| String | Unique sku code of the order item identifiable at channel’s end | no |
| String | Unique item code of the order item identifiable in omni | no |
Response
| Code Block |
|---|
Empty Body |
...