/
Flipkart and Eshopbox integration

Flipkart and Eshopbox integration

Owned by Prateek Kaushik (Unlicensed)
Last updated: Nov 04, 2020
11 min read

This guide will outline step by step process how you can build an app on the Eshopbox platform to connect with Flipkart.

Before you Start

Webhook Triggers:

1. New Orders

This trigger starts the workflow when an order is placed on Flipkart, it will send a shipment created event to eshopbox. Refer to the Flipkart Shipment Created Event.

eventType: shipment_created

Sample Event:

{ "shipmentId": "", "eventType": "shipment_created", "locationId": "", "source": "flipkart", "timestamp": "",//ISO String "attributes": { "dispatcByDate": "DateTime", "dispatchAfterDate": "DateTime", "hold": false, "mps": false, "packagingPolicy": "GREEN_PACKAGE", "orderItems": [{ "fsn": "", "quantity": 0, "orderId": "", "orderItemId": "", "listingId": "", "hsn": "String", "sku": "", "title": "String", "paymentType": "", "cancellationGroupId": "", "isReplacement": false, "priceComponents": { "sellingPrice": 0, "totalPrice": 0, "shippingCharge": 0, "customerPrice": 0, "flipkartDiscount": 0 }, "orderDate": "DateTime", "status": "OrderItemState", "packageIds": [] }], "forms": [{ "name": "", "link": "", "automated": false }], "subShipments": [{ "subShipmentId": "", "packages": [{ "packageId": "", "packageTitle": "", "packageSku": "", "dimensions": { "length": 0, "breadth": 0, "height": 0, "weight": 0 } }] }] } }

2. Order Status Update

This trigger starts the workflow when there is any change in order status on Flipkart, it sends order status events to Eshopbox. Refer to the Flipkart Shipment Update Event.

eventType : shipment_packed, shipment_ready_to_dispatch, shipment_shipped, shipment_delivered,

{ "shipmentId": "", "eventType": "shipment_packed", "source": "flipkart", "timestamp": ISO time string, "attributes": { "status": "PACKED" } }

3. Order Cancelled

This trigger starts the workflow when an order is canceled on Flipkart, it will send a shipment canceled event to eshopbox. Refer to the Flipkart Shipment Cancel Event.

eventType: shipment_cancelled

{ "shipmentId": "", "eventType": "shipment_cancelled", "locationId": "", "source": "", "timestamp": ISO time string, "attributes": { "status": "CANCELLED", "orderItems": [{ "orderItemId": "", "quantity": , "reason": "", "subReason": "" }] } }

4. New Returns

This trigger starts the workflow when a return request is placed on Flipkart, it will send a return created event to eshopbox. Refer to the Flipkart Return Created Event.

eventType: return_created

{ "returnId" : "", "eventType" : "return_created", "source" : "", "timestamp" : "76250700__shipmentId", "locationId" : "", "attributes" : { "status" : "RETURN_CREATED", "returnItems" : [{ "returnId" : "", // primary identifier of the return "orderItemId" : "", // order item id against which this return is created "source" : "" , // possible values are courier_return, customer_return "action" : "" , "quantity" : , // item quantity in the return "orderDate" : "", // created date of the order "createdDate" : "", "updatedDate" : "", "courierName" : "", "reason" : "", "subReason" : "", "trackingId" : "", "shipmentId" : "", "comments" : "", "completionDate" : "", "replacementOrderItemId" : "", "productId" : "", "listingId" : "", "expectedDate" : "" // Date on which return is expected to be delivered to seller warehouse }] } }

5. Return Status Update/Return Cancelled

This trigger starts the workflow when there is any change in return status on Flipkart, it sends return status events to Eshopbox. Refer to Flipkart Return Update Event.

eventType: return_completed, return_cancelled

{ "returnId" : "", "eventType" : "return_cancelled", "source" : "", "locationId" : "", "timestamp" : ISO time string, "attributes" : { "returnItems" : [{ "orderItemId": "", // order item id for which this return is processed "expectedDate": "" // new expected date for the return }] } }

Polling Triggers

1. Order Updates

The API searches shipments using specific filters. Shipment can be filtered on the basis of its type (preDispatch, postDispatch, cancelled).

States:

  • preDispatch: APPROVED, PACKED, READY_TO_DISPATCH

  • postDispatch: SHIPPED, DELIVERED

  • cancelled: CANCELLED

 

To get the new orders/ order status change call Flipkart Search Shipments API.

API URL:

https://api.flipkart.net/sellers/v3/shipments/filter

Request Body:

{ "filter": { "serviceProfiles": [ "FBF" ], "states": [ "APPROVED" ], "orderDate": { "to": "2020-10-01T12:53:44.485Z", "from": "2020-10-01T06:53:44.485Z" }, "locationId": "LOC62a30c1d159845e09dfeef303f52cfb9", "type": "preDispatch" }, "pagination": { "pageSize": 20 }, "sort": { "field": "dispatchByDate", "order": "asc" }, "sellerId": "28dba0d580f6470" }

Response Body:

{ "hasMore": true, "nextPageUrl": "/v3/shipments/filter?next_token=ewogICJmaWx0ZXJUeXBlIiA6ICJwcmVEaXNwYXRjaCIsCiAgInNlbGxlcklkIiA6ICIyOGRiYTBkNTgwZjY0NzA4IiwKICAidG9rZW4iIDogImV3b2dJQ0p3WVhKaGJYTWlJRG9nZXdvZ0lDQWdJbVJwYzNCaGRHTm9YM1JwWlhKeklpQTZJRnNnSWxKRlIxVk1RVklpTENBaVJWaFFVa1ZUVXlJZ1hTd0tJQ0FnSUNKelpXeHNaWEpmYVdRaUlEb2dJakk0WkdKaE1HUTFPREJtTmpRM01EZ2lMQW9nSUNBZ0lteHZZMkYwYVc5dVgybGtJaUE2SUNKTVQwTTJNbUV6TUdNeFpERTFPVGcwTldVd09XUm1aV1ZtTXpBelpqVXlZMlppT1NJc0NpQWdJQ0FpYjNKa1pYSmZaR0YwWlNJZ09pQnVkV3hzTEFvZ0lDQWdJbVJwYzNCaGRHTm9YMko1WDJSaGRHVWlJRG9nYm5Wc2JDd0tJQ0FnSUNKa2FYTndZWFJqYUY5aFpuUmxjbDlrWVhSbElpQTZJRzUxYkd3c0NpQWdJQ0FpYzNSaGRHVnpJaUE2SUZzZ0luQmhlVzFsYm5SZllYQndjbTkyWldRaUlGMHNDaUFnSUNBaWMyaHBjRzFsYm5SZmRIbHdaWE1pSURvZ1d5QWlUazlTVFVGTUlpQmRMQW9nSUNBZ0ltMXZaR2xtYVdWa1gyUmhkR1VpSURvZ2JuVnNiQ3dLSUNBZ0lDSnpiM0owWDJacFpXeGtYekFpSURvZ0ltUnBjM0JoZEdOb1gySjVYMlJoZEdVaUxBb2dJQ0FnSW5OdmNuUmZiM0prWlhKZk1DSWdPaUFpWVhOaklpd0tJQ0FnSUNKbWNtOXRJaUE2SURBc0NpQWdJQ0FpYzJsNlpTSWdPaUF5TlFvZ0lIMHNDaUFnSW5CaFoybHVZWFJwYjI0aUlEb2dld29nSUNBZ0luQmhaMlZmYm5WdElpQTZJRElzQ2lBZ0lDQWljR0ZuWlY5emFYcGxJaUE2SURJd0NpQWdmU3dLSUNBaWMyOXlkQ0lnT2lCYklGMEtmUSIsCiAgInZpZXciIDogIm9yZGVyX2FwaS52My5zaGlwbWVudCIsCiAgInRlbXBsYXRlIiA6ICJvYXBpX3ByZV9kaXNwYXRjaCIKfQ", "shipments": [ { "shipmentId": "cd6fff34-368e-44dd-b747-d7fad8c84990", "dispatchByDate": "2020-09-28T12:00:00.000+05:30", "dispatchAfterDate": "2020-09-27T12:01:00.000+05:30", "updatedAt": "2020-09-20T15:44:12.000+05:30", "locationId": "LOC62a30c1d159845e09dfeef303f52cfb9", "hold": false, "mps": false, "packagingPolicy": "DEFAULT", "subShipments": [ { "subShipmentId": "SS-1", "packages": [ { "packageId": "PKGBRFF8H6TSRBXPABQIUPJI5", "packageSku": "BBAPLBB63792_L", "dimensions": { "length": 16, "breadth": 12, "height": 6, "weight": 0.23 } } ] } ], "orderItems": [ { "orderItemId": "11974521229403000", "orderId": "OD119745212294030000", "cancellationGroupId": "grp11974521229403000", "orderDate": "2020-09-20T15:43:49.000+05:30", "paymentType": "COD", "status": "APPROVED", "quantity": 1, "fsn": "BRFF8H6TSRBXPABQ", "sku": "BBAPLBB63792_L", "listingId": "LSTBRFF8H6TSRBXPABQIUPJI5", "hsn": "61071100", "title": "Blackberrys Men Brief L SP-INFLUENCE_Mustard", "packageIds": [ "PKGBRFF8H6TSRBXPABQIUPJI5" ], "priceComponents": { "sellingPrice": 416.0, "totalPrice": 452.0, "shippingCharge": 36.0, "customerPrice": 452.0, "flipkartDiscount": 0.0 }, "serviceProfile": "Seller_Fulfilment", "is_replacement": false } ], "forms": [], "shipmentType": "NORMAL" }, ] }

2. Returns

The Get Returns API provides order items details that are returned by the customer or by courier.

Refer to Flipkart Get Return API.

API Url:

http://api.flipkart.net/sellers/v2/returns

Header Parameters:

Flipkart Parameters

Sample Value

Flipkart Parameters

Sample Value

source

customer_return, courier_return

modifiedAfter(optional)

2020-09-28T11:47:23.377Z

createdAfter(optional)

2020-09-28T11:47:23.377Z

locationId
(optional)

LOC62a30c1d159845e09dfeef303f52cfb9

Response Body:

{ "hasMore": true, "nextUrl": "/returns/search/ewogICJmaWx0ZXIiIDogewogICAgInNlcnZpY2VfcHJvZmlsZSIgOiBudWxsLAogICAgInR5cGUiIDogWyAiY291cmllcl9yZXR1cm4iIF0sCiAgICAic2hpcG1lbnRfdHlwZXMiIDogbnVsbCwKICAgICJzaGlwbWVudF9zdGF0dXMiIDogbnVsbCwKICAgICJyZXR1cm5fc3RhdHVzIiA6IG51bGwsCiAgICAic2hpcG1lbnRfZXhwZWN0YXRpb25zIiA6IG51bGwsCiAgICAic2t1IiA6IG51bGwsCiAgICAicHJvbWlzZV9icmVhY2giIDogbnVsbCwKICAgICJhcHByb3ZlZCIgOiBudWxsLAogICAgInByb21pc2UiIDogbnVsbCwKICAgICJvdXRfZm9yX2RlbGl2ZXJ5IiA6IG51bGwsCiAgICAicmV0dXJuX2NvbXBsZXRlZCIgOiBudWxsLAogICAgInNoaXBtZW50X2NvbXBsZXRlZF9vbiIgOiBudWxsLAogICAgImNyZWF0ZWRfYWZ0ZXIiIDogbnVsbCwKICAgICJtb2RpZmllZF9hZnRlciIgOiBudWxsCiAgfSwKICAicGFnaW5hdGlvbiIgOiB7CiAgICAic3RhcnRpbmdfcGFnZSIgOiAyLAogICAgInBhZ2Vfc2l6ZSIgOiAyNQogIH0sCiAgInNvcnQiIDogbnVsbAp9", "returnItems": [ { "orderItemId": "11980720411507700", "locationId": "LOC62a30c1d159845e09dfeef303f52cfb9", "orderId": "OD119807204115077000", "quantity": 1, "orderDate": "2020-09-27T14:25:48.659Z", "createdDate": "2020-09-28T16:19:17+05:30", "courierName": null, "sellerId": "28dba0d580f64708", "returnId": "10101981454721753372", "status": "created", "type": "courier_return", "reason": "order_cancelled", "subReason": "mind_changed", "trackingId": "FMPC0883440212", "shipmentStatus": "in_transit", "shipmentId": null, "comments": "", "updatedDate": null, "approvedOn": null, "expectedDate": "2020-10-28T16:19:30.000", "serviceProfile": "NON_FBF", "services": [] } ] }

Actions:

1. Update Inventory Count

This action updates the inventory count in Flipkart when there is a change in the inventory in Eshopbox (addition/ removal)

Refer to Flipkart Update Inventory Endpoint.

API URL:

https://api.flipkart.net/sellers/listings/v3/update/inventory

Request Body

{ "<sku>": { "product_id": "<product_id>", "locations": [ { "id": "<location-id>", "inventory": 0 } ] } }

Response Body/Event Structure: 200 OK Response

{ "sku": { "status": "success|failure|warning", "errors": [ { "severity": "ERROR|WARNING", "code": "<code>", "description": "<description>" } ], "attribute_errors": [ { "severity": "ERROR|WARNING", "code": "<code>", "description": "<description>", "attribute": "<attribute>", "path": "<path-to-attribute>" } ] } }

2. Generate Shipping Label and Invoice

Once the shipment is created in Eshopbox send a packaging in progress request to Flipkart, for that send a POST request to generate shipping label.

Refer to Flipkart Label Generation API

API URL:

https://api.flipkart.net/sellers/v3/shipments/labels

Get labels Request Body JSON

{ "shipments": ["shipmentIds"], "shipmentId": "", "subshipments": [ { "subShipment": "", "dimensions": { "breadth": 0, "length": 0, "weight": 0, "height": 0 } ], "taxItems": [ { "taxRate": 0, "orderItemId": "string", "quantity": 0 } ], "invoices": [ { "orderId": "string", "invoiceNumber": "string", "invoiceDate": "2020-09-21" } ], "serialNumbers": [ { "serialNumbers": [ [ "string" ] ], "orderItemId": "string" } ], "locationId": "string", "shipmentId": "string" } ] }

Get labels Response Body JSON

{ "selectedGives":{ "shipments":[{ "shipmentId":"string", "processingStatus":"string", "errorCode":"string", "errorMessage":"string", }], } }

3. Mark Ready to Dispatch

Once the shipment is packed in Eshopbox mark the Ready to Dispatch event on Flipkart.

Refer to Flipkart Mark RTD API.

API URL:

https://api.flipkart.net/sellers/v3/shipments/dispatch

Request Body JSON

{ "params": "shipmentIds":"[<string>]", "locationId" :"string", }

Response Body JSON

{ "selectedGives": "shipments":[{ "shipmentId":"string", "processingStatus":"string", "errorCode":"string", "errorMessage":"string", }], }

4. Cancel Order API

To cancel a shipment on Flipkart send a POST request to Flipkart Cancel Order API.

API Url:

https://api.flipkart.net/sellers/v3/shipments/cancel

Request Body:

{ "shipments": { "shipmentId": "ID", "locationId": "Location", "cancellationGroupIds": "", "reason": "" } }

Cancellation reason should be one of the below(cannot_procure_item, not_enough_inventory, b2b_order)

Response body:

{ "shipments": { "shipmentId": "ID", "processingStatus": "SUCCESS or FAILURE", "errorCode": "", "errorMessage": "" } }

Searches:

1. Get shipment details

To Get shipment details call Flipkart Get Shipment Information API.

API URL:

https://api.flipkart.net/sellers/v3/shipments/{shipmentIds}

Response Body/Event Structure

{ "shipments": [ { "orderId": "string", "subShipments": [ { "shipmentDimensions": { "breadth": 0, "length": 0, "weight": 0, "height": 0 }, "subShipmentId": "string", "courierDetails": { "pickupDetails": { "vendorName": "string", "trackingId": "string" }, "deliveryDetails": { "vendorName": "string", "trackingId": "string" } } } ], "returnAddress": { "city": "string", "contactNumber": "string", "firstName": "string", "lastName": "string", "pinCode": "string", "state": "string", "addressLine2": "string", "stateCode": "string", "addressLine1": "string", "landmark": "string" }, "buyerDetails": { "lastName": "string", "firstName": "string" }, "shipmentId": "string", "locationId": "string", "billingAddress": { "city": "string", "contactNumber": "string", "firstName": "string", "lastName": "string", "pinCode": "string", "state": "string", "addressLine2": "string", "stateCode": "string", "addressLine1": "string", "landmark": "string" }, "deliveryAddress": { "city": "string", "contactNumber": "string", "firstName": "string", "lastName": "string", "pinCode": "string", "state": "string", "addressLine2": "string", "stateCode": "string", "addressLine1": "string", "landmark": "string" }, "sellerAddress": { "city": "string", "sellerName": "string", "pinCode": "string", "state": "string", "addressLine2": "string", "stateCode": "string", "addressLine1": "string", "landmark": "string" }, "orderItems": [ { "large": true, "dangerous": true, "fragile": true, "id": "string" } ] } ] }

2. Get Order Item Details

To get shipment details by order ids call Flipkart Get by orderIds API.

API URL:

https://api.flipkart.net/sellers/v3/shipments?orderIds={}

Get Order Items Request Body JSON

{ "params": { "orderItemIds":"string", } }

Get Order Items Response Body JSON

{ "shipmentId": "string", "dispatchByDate": "2020-09-23T14:11:34.022Z", "dispatchAfterDate": "2020-09-23T14:11:34.022Z", "updatedAt": "2020-09-23T14:11:34.022Z", "hold": "boolean", "locationId": "string", "packagingPolicy": "string", "orderItems": [ { "fsn": "string", "quantity": "number", "orderId": "string", "orderItemId": "string", "listingId": "string", "sku": "string", "cancellationGroupId": "string", "isReplacement": "boolean", "priceComponents": { "sellingPrice": "float", "totalPrice": "float", "shippingCharge": "float", "customerPrice": "float", "emi": "float", "flipkartDiscount": "float" }, "orderDate": "2020-09-23T14:11:34.022Z", "cancellationDate": "2020-09-23T14:11:34.022Z", "cancellationReason": "string", "cancellationSubReason": "string", "courierReturn": "boolean", "status": "string", "packageIds": [ "package1", "package2" ] } ], "forms": [ { "name": "string", "link": "string", "automated": "boolean", "status": "string" } ], "subshipments": [ { "subShipmentId": "string", "packges": [], "packageId": "string", "quantity": "integer", "packageTitle": "string", "packageSku": "string" } ] }

Automations:

1.Sync Products and Inventory

 

  • When a new product is added on Flipkart, then Product Listing will be updated.

  • Once Product Listing is updated, we will fetch it to create or update products on the Eshopbox workspace.

  • Then we need to check that whether the Eshopbox workspace consists of that product or not.

    • If it contains then it will overwrite the products on Eshopbox workspace.

    • If it does not, then create the product in the Eshopbox workspace.

  • Afterward, Check if there is a change in the Eshopbox inventory or not.

    • If there is a change, then send updated to Flipkart.

Tracking inventory updates:

When inventory is changed in Eshopbox, send updated to Flipkart.

 

  • Select the Inventory Level Change trigger from the Eshopbox app.

  • Select Update Inventory Count action from the Flipkart app.

  • Map the eshopbox trigger fields with your action fields. Refer the table for Eshopbox Trigger Fields:

Trigger app(Eshopbox) Fields

Action app(Flipkart) Fields

Trigger app(Eshopbox) Fields

Action app(Flipkart) Fields

productId

product_id

 

id

inventory

inventory

inventoryItemId

sku

2. Submit an order for fulfillment

  • When the order is created on Flipkart, it sends the shipment details to Eshopbox

  • After receiving shipment details, Eshopbox will create the order

  • After creating the order in Eshopbox, Hold status will be checked.

    • If the Hold status is True, then the status will remain on Hold

    • Else if the Hold status is False, a request will be sent to generate labels & invoices.

  • When the shipping labels and invoices are downloaded, the status will be changed to “PACKING_IN_PROGRESS“

  • Once the order is “PACKED“, an event will be sent to Eshopbox that the order is packed.

  • When the packed event is received by Eshopbox, then the status will be changed to “READY_TO_DISPATCH“ and the RTD event will be sent to Flipkart

  • After this event, when the RTD event is pushed then Eshopbox will download the Manifest.

  • When the manifest is downloaded then the Order will be shipped and delivered

 

Create Order In Eshopbox

When an order is created on Flipkart, create a new order in Eshopbox.

 

  • Select the Order created trigger from the Flipkart app.

  • Select get shipping details from the Flipkart app and map the trigger field with the input designer.

  • Select Create Order action from the Eshopbox app.

  • To map your trigger fields with action fields refer to the table and Eshopbox order endpoint.

Flipkart Trigger Response (Order Created)

Eshopbox Action (Create Order) Fields

Flipkart Trigger Response (Order Created)

Eshopbox Action (Create Order) Fields

eventType

No use

source

No use

version

No use

locationId

externalWarehouseId(with mapping)

timestamp

orderDate

attributes.dispatchByDate

expectedShipDate

attributes.dispatchAfterDate

need to discuss

attributes.updatedAt

externalcreatedAt

attributes.hold

onHold

attributes.mps

no use

attributes.subShipments[].subshipmentId

no use

attributes.subShipments[].packages

no use

attributes.packagingPolicy

no use

attributes.orderItems[].orderItemId

items[].lineItemSequenceNumber

attributes.orderItems[].orderId

vendorOrderNumber?

attributes.orderItems[].cancellationGroupId

no use

attributes.orderItems[].orderDate

no use

attributes.orderItems[].paymentType

paymentType

attributes.orderItems[].status

items[].status

attributes.orderItems[].quantity

items[].quantity

attributes.orderItems[].fsn

items[].asin

attributes.orderItems[].sku

items[].sku

attributes.orderItems[].listingId

items[].itemID

attributes.orderItems[].hsn

no use

attributes.orderItems[].title

items[].productName

attributes.orderItems[].packageIds

no use

attributes.orderItems[].priceComponents.sellingPrice

items[].mrp

attributes.orderItems[].priceComponents.totalPrice

items[].lineItemTotal

attributes.orderItems[].priceComponents.shippingCharge

items[].shippingCharges

attributes.orderItems[].priceComponents.customerPrice

items[].customerPrice

attributes.orderItems[].priceComponents.flipkartDiscount

items[].discount

attributes.orderItems[].is_replacement

need to discuss?

attributes.forms[].name

no use

attributes.forms[].link

no use

attributes.forms[].automated

no use

attributes.dispatchLocation

no use

shipmentId

customerOrderNumber

 

  • if(paymentType=COD) isCOD = 1, balanceDue = totalPrice

  • taxAmount = 0

  • shipMethod: STD

  • subtotal : sum of orderItems[].priceComponents.totalPrice

  • shipChargeAmount : sum of orderItems[].priceComponents.shippingcharge

  • orderTotal: subtotal +shipChargeAmount

  • thirdPartyShipping = false

  • email : dummy

  • country and country code

  • state and statecode (need to discuss)

Flipkart Action (Get Shipping Details)

Eshopbox Action (Create Order) Fields

Flipkart Action (Get Shipping Details)

Eshopbox Action (Create Order) Fields

shipments[].deliveryAddress.firstName

shippingAddress.customerName

shipments[].deliveryAddress.lastName

shippingAddress.customerName

shipments[].deliveryAddress.pincode

shippingAddress.postalCode

shipments[].deliveryAddress.city

shippingAddress.city

shipments[].deliveryAddress.addressLine1

shippingAddress.addressLine1

shipments[].deliveryAddress.addressLine2

shippingAddress.addressLine2

shipments[].deliveryAddress.state

shippingAddress.state

shipments[].deliveryAddress.contactNumber

shippingAddress.contactPhone

shipments[].billingAddress.firstName

billingAddress.customerName

shipments[].billingAddress.lastName

billingAddress.customerName

shipments[].billingAddress.pincode

billingAddress.postalCode

shipments[].billingAddress.city

billingAddress.city

shipments[].billingAddress.addressLine1

billingAddress.addressLine1

shipments[].billingAddress.addressLine2

billingAddress.addressLine2

shipments[].billingAddress.state

billingAddress.state

shipments[].billingAddress.contactNumber

billingAddress.contactPhone

 

Mark Packaging In Progress On Flipkart

 

When the shipment is created in Eshopbox send a POST request to Flipkart to generate a shipping label and invoice. Once the request is sent to Flipkart shipment status is changed to PACKAGING_IN_PROGRESS

Download Shipping Label

When the shipping label is ready to download, Flipkart will send a packed notification. When a packed notification is received in Eshopbox will save the shipping label.

Mark Ready to Dispatch On Flipkart

 

When Shipment is packed in Eshopbox, update the order status to Ready to Dispatch on Flipkart.

Mark Shipped Staus in Eshopbox

When the shipment is shipped in Flipkart update the shipment status in Eshopbox.

Mark shipment delivered Status in Eshopbox

When the shipment is delivered in Flipkart update the shipment status in Eshopbox.

3. Cancel Order in Eshopbox

Cancel Order in Eshopbox

Whenever an order is canceled on Flipkart, cancel the order in Eshopbox.

 

Flipkart Trigger Response(Cancel Order)

Flipkart Search Request(Find Order Item Details)

Flipkart Trigger Response(Cancel Order)

Flipkart Search Request(Find Order Item Details)

attributes.orderItems.orderItemID

orderItemID

Flipkart Trigger Response(Cancel Order)

Eshopbox Action Request(Cancel Order)

Flipkart Trigger Response(Cancel Order)

Eshopbox Action Request(Cancel Order)

 

externalChannelID(mapping with location Id)

shipmentId

customerOrderNumber

orderItems.reason

reason

orderItem.cancellationDate

cancellationTime

orderItems.orderItemID

items.lineItemSequenceNumber

orderItems.quantity

items.quantity

orderItems.subReason

items.remark

Flipkart Search Response(Find Order Item Details)

Eshopbox Action Request(Cancel Order)

Flipkart Search Response(Find Order Item Details)

Eshopbox Action Request(Cancel Order)

 

items.productName

orderItems. listingId

items.itemId

 

4. Returns

Create Return in Eshopbox

 

Get order Item details

Flipkart Trigger Response(Return Created)

Flipkart Action Request(Get Shipment Details)

Flipkart Trigger Response(Return Created)

Flipkart Action Request(Get Shipment Details)

attributes.returnItems[].shipmentId

shipmentId

Flipkart Trigger Response(Return Created)

Eshopbox Action Request(Create Return)

Flipkart Trigger Response(Return Created)

Eshopbox Action Request(Create Return)

returnId

customerReturnNumber

eventType

no use

source

no use

timestamp

return_request_date

locationId

mapping with warehouse

attributes.status

no use

attributes.returnItems[].returnId

no use

attributes.returnItems[].orderItemId

items[].lineItemSequenceNumber

attributes.returnItems[].source

no use

attributes.returnItems[].action

no use

attributes.returnItems[].quantity

items[].quantity

attributes.returnItems[].orderDate

no use

attributes.returnItems[].createdDate

no use

attributes.returnItems[].updatedDate

no use

attributes.returnItems[].courierName

 

attributes.returnItems[].reason

items[].returnReason

attributes.returnItems[].subReason

 

attributes.returnItems[].trackingId

 

attributes.returnItems[].shipmentId

 

attributes.returnItems[].comments

additionalInfo.comments

attributes.returnItems[].completionDate

 

attributes.returnItems[].replacementOrderItemId

 

attributes.returnItems[].productId

 

attributes.returnItems[].listingId

items[].itemID

attributes.returnItems[].expectedDate

 

 

externalChannelId(mapping flipkart location Id warehouseId)

Flipkart Trigger Response(Return Created)

Eshopbox Action Request(Create Return)

Flipkart Trigger Response(Return Created)

Eshopbox Action Request(Create Return)

shipments[].deliveryAddress.firstName

pickupAddress.customerName

shipments[].deliveryAddress.lastName

pickupAddress.customerName

shipments[].deliveryAddress.pincode

pickupAddress.postalCode

shipments[].deliveryAddress.city

pickupAddress.city

shipments[].deliveryAddress.addressLine1

pickupAddress.addressLine1

shipments[].deliveryAddress.addressLine2

pickupAddress.addressLine2

shipments[].deliveryAddress.state

pickupAddress.state

shipments[].deliveryAddress.contactNumber

pickupAddress.contactPhone

  • pickup_type: reverese

  • externalChannelId

  • customerOrderNumber

  • refundAmount

  • repaymentType

  • optional

  • pickupAddress

 

 

Related content