/
FYND INTEGRATION

FYND INTEGRATION

Owned by Ajay Sharma
Last updated: Oct 11, 2022
2 min read

  1. Generate Auth Token :

For each location, there will be unique credentials details to generate Auth Token:

GET '{{oms_host}}/api/v1/{{aggregator}}/shipment/authToken?username={{x-integration-id}}&password= {{x-integration-token}}

Input fields:

  • aggregator

  • x-integration-id

  • x-integration-token

token is valid for 1 hour

open question :

we are assumning aggrigator name should be eshopbox only

how will seller (client) get this

  • x-integration-id

  • x-integration-token

  • location Id

2. Inventory push flow : https://quip.com/2C8TAn3EqmjL

Method: PUT
End Point : {{host}}/inventory/aggregators/api/v2/updateInventory
Request Header: (Mandatory)

  • API key: xxxx

[
{
"location_id": "raw_store1",
"sku": "W1G04182007709 GREY",
"quantity": 15
},
{
"location_id": "raw_store1",
"sku": "W2H07185100205 PINK",
"quantity": 15
}

Note :

  • The maximum data payload size per request is 500.

Open Question : do we get the Location Id while Set up of connection ?

any rate limit in inventory push

any block inventory used at Fynd ?

3. Create Order : https://quip.com/4B51ANqS0C4b

to get orders from fynd below API to be used:

{{oms_host}}/api/v2/{{aggregator}}/shipment?orderingChannel=FYND&orderStatus=CREATED&pageNumber=1&pageSize=100

open question:

what is the identifier in order response by which eshopbox will know who will assign the courier and shipping label? Eshopbox or fynd

what is the use of "thirdPartyShipping": true, in Response ?

marketplaceOrderId is cutomer order Number (order number visible to customer)? Need sample values for each channel

id & forward_id will always same ? what is the unique channelOrderId (unique identifier at Fynd) for each shipment ? sample values for each channel

4. order confirm / reject:

order confirm:If the new order got fulfilled in Eshopbox, Eshopbox will call confirm API of Fynd.

[
{
"orderId": "String",
"orderItems": [
{
"orderItemId": "String"
},{

"orderItemId": "String"

}
]

Open questions:

before confirm/ reject we also need to check the status of shipment in fynd, We need get Shipment API , its not mentioned in doc yet. if the status is canceled call the cancel API if Fynd.

orderId will be the marketplaceOrderId ?

can we partially accept/ reject the item in a shipment ?

Note * after push accepted to fynd: Note then no cancellation/ rejection  will happens.

4. Order Processing : Invoice will get generated by Fynd Always.

IN case Fynd will generate Shipping label

4.1 :Assign courier: In case Fynd will assign the courier and Shipping label:

call get courier API : {{oms_host}}/api/v2/{{aggregator}}/shipment/courierDetails

[
{
"orderId": "SH-20191112-5DCA68F60-1E7E5EE6F"
}

]

Open Question : orderId will be the marketplaceOrderId ? in case 2 shipments has same marketplaceOrderId how it will works ?

4.2 Mark Pack :

{{oms_host}}/api/v2/{{aggregator}}/shipment/pack

{
"orderId": "SH-20191112-5DCA68F60-1E7E5EE6F",
"orderItems": [
{
"orderItemId": "678944"
}
]
}

Open Question: Mark API will be called after the get Courier ?

4.3: Get Label : {{oms_host}}/api/v2/{{aggregator}}/shipment/labels

[
{
"orderId": "SH-20191112-5DCA68F60-1E7E5EE6F"
}
]

4.4 get Invoice: {{oms_host}}/api/v2/{{aggregator}}/shipment/invoice

[
{
"orderId": "SH-20191112-5DCA68F60-1E7E5EE6F"
}
]

4.5 Mark Dispatch : {{oms_host}}/api/v2/{{aggregator}}/shipment/dispatch

[{
"orderId": "string",
"orderItems": [
{
"orderItemId": "string"
},
{
"orderItemId": "string"
}
]
}]

 

In Case Eshopbox will generate the shipping label :

what are the API to be used to mark the order packed in Fynd with Eshopbox courier ?

 

Return:

we need return created/ accepted details from Fynd , not return_delivered

Return should be created in Eshopbox before reaching to Eshopbox warehouse.

Related content