AJIO DROPSHIP

Discussion with Ajio Team:

High-level Questions:

1. If the order has 2 items having 2 unique order_item_ids then can we accept 1 item and reject the 2nd item?

   1. - Partial cancellation can happen. Yes, Partial Cancellation is allowed. Just send the corresponding item quantity as 0 in the acknowledgement API.

2. Is there a way of applying a filter of updated_AtFrom and updated_AtTo: Use case of this would be when I need to fetch cancelled orders in the last 15 minutes.

Points related to APIs:

1. Authorization 

 a. Need username and password to test the APIs: Closed

 b. Refresh token API is not given or do we have to use the same API to re-generate the access token?

 c. What's the expiry time of access token? - 30 mins

1. Get Products:

 a. API: /products

 i. What are the filters available in the API for ex: publishedStatus, pageNumber, created_at, updated_at - Published Status, sku

 ii. How many products will be available in single page? - Maximum 50 

1. Inventory Update:

 a. API: /updateInventory

 i. The sellable stock which we will be sending would be the adjustment inventory or absolute inventory? - Absolute inventory

 ii. There's no location_id provided in the request body of inventory update? Could you please tell us how are we going to update inventory if the seller is selling products from multiple locations? - Every location (POB) will have separate credentials. Inventory update to happen for each POB using those credentials.

 iii. How many skus can be pushed at once in the request of Update Inventory? - maximum 50

1. GET orders: 

 a. API: /orders/pendency

 i. We pull the orders and then we acknowledge the order whether we are going to accept/reject using below API:

1. If the order is partially fulfillable for ex 1 order having 2 items, now 1 item is fulfillable and the 2nd item is unfulfillable then do we have to cancel both the items? or can we just cancel the unfulfillable single item and fulfill the other item?

 Acknowledge Order Request Body:

 { "order_id": "string",

   "order_lines": [

     {

       "cancelled_quantity": 0,

       "confirmed_quantity": 0,

       "order_item_id": "string"

     }

   ],

   "status": "enum(Acknowledge, Cancel)"

 }

Send order quantity 1 for fulfillable item and 0 for unfulfillable item

b. API: /orders(Purchase Order API): Orders which are acknowledged

 i. What's the difference between order_date and po_date? - Order_date is when order is created in our system and PO_date when the B2B PO is generated

 ii. How many orders will be present in single page ? - Maximum 50

 iii. Is it possible to have unique po_number against the same order_id? Or there is 1 to 1 mapping? 1 to 1 mapping 

 iv. Is tax inclusive in the order pricing provided? - Yes we are providing both the details.

 v. Possible values for payment_method?  -  It will be string Possible Values - (PREPAID,COD,NONCOD)

 vi. Will there be any discount on any Purchase order?  if yes, how will we get to know as in the document discount information is not provided - Discount information will not be provided. Final PO will be provided after deducting discount and margin.

1. GET B2C Invoice:

 a. API: /orders/{order_id}/invoice/b2c

 i. In the given response in doc: only trackingId is provided, will we able to get invoiceNumber, carrierName as well in the response?  - You will receive a B2C invoice copy and you will receive carrier name and invoice number in the invoice copy.. PFA B2C document for reference.

1. Generate Shipping Label PDF:

 a. API: /shipment/label/pdf

 i. Response of this API is not provided in the doc. - This will be the shipment label PDF which needs to be printed on the shipment by the seller. PFA packing slip document for reference

 7. Generate Manifest:

 a. API: /manifest

 i. In the request, "carrier" is asked as a request parameter, will we able to get this every time when we are fetching Purchase order ? And if not, how do we get it? - Carrier will always be part of the PO . You need to use the same in manifest.

 ii. In the request, "weight" is asked a request parameter, is it a mandatory parameter? If yes, does it have to be accurate? And if the accurate value is not provided, will we able to generate Manifest? - It is not mandatory

Get Returns:

 a. API: /return

 i. Once we have fetched 1 return for an order let's say and that return is created at our end with TrackingId T1, is there any possibility that new Return will be created for the same SKU with TrackingId T2?(assuming the earlier return with Trackingid T1 is not yet cancelled,is this possible?) - Yes customer can raise multiple return. Assuming the forward order has 4 quantity of one SKU (Line item) . Now the customer can create return for 1 quantity of the SKU with return id R1 and tracking id T1. On the next day the customer can initiate return for 2 more quantities with return id R2 and tracking id T2. 

Open Points:

Q1. Can we accept the same items again later on once the inventory is available for the items that were unfulfillable before and we sent 0 order_qty while acknowledging? 

Q2. Will we get the actual shipping address and billing address when we will fetch the Purchase Order? or we will receive some dummy address?

eshopbox2@test.com/Jio1234@ 

Pob1: DV00311692 : connectionID: 2545

Pob2: DV00311689 : connectionID: 2546

Article1: 460420907001

Article2: 460420908001      

Article3: 460420909001      

Pl push inventory as below

1. 1000 Inventory for Article 1 and Article 2 against POB1

2. 1000 inventory for Article 3 against POB2.

PFB order for POB : DV00311692

S100180343

S100180344

S100180346

S100180345

PFB order for POB: DV00311689

S100180347

S100180348