Nykaa integration - open questions

1. The seller Id used for marking locations will be provided by Nykaa team? (Seller id is used to update inventory for a particular location.)

2. The inventory update we are sending will be absolute?

3. Is the successResponseCode = '0' ?

4. Partial cancellation is possible? If yes, in that case, will a new shipment/order be made?

5. We have 2 APIs to fetch order, 1 for dropship and 1 for JIT. Which one we will be using?

6. There are 2 APIs for invoice: generate invoice and then fetch invoice.

what is the purpose of all the below Nykaa integrations?

Open

Authentication:

1. Do we need different username and password for different locations? Who will be providing the credentials? - we will have parent location credentials which can be used to update inventory across all locations. SellerId: child vendor code

Inventory flow:

1. The seller Id used for marking locations will be provided by Nykaa team? (Seller id is used to update inventory for a particular location.) - can be taken from Nykaa panel

2. The inventory update we are sending will be absolute or not?

3. If for an sku the change in stock is only in GGN - need to add the

Order flow:

1. Do we need to fetch orders of Confirmed state or pending state? - need to confirm

2. when can we cancel the order? After packed/RTS Cancellation possible? - order can not be cancelled after invoice generation.

3. Is the selling price is tax inclusive or exclusive?

4. Mapping of price over the invoice?
   Order level: (Keys: OrderAmount, orderTaxAmount, shippingCharges, discountAmount, storeCredit, gvAmount, codCharge)
   Item level: lineAmount, lineTaxAmount, unitPrice, mrp, discountAmount, shippingCharge, codCharge

5. Can we only sync the unhold orders in Eshopbox? What are its consequences? - inventory will not get blocked, so need to pull hold orders as well.

6. Partial cancellation is possible? If yes, in that case, will a new shipment/order be made? - allowed

7. No Reject API in the document? order Acknowledgement API? - will be provided

8. If an order is rejected, and created with a different facility code, will the order no(channelOrderId) be different?

9. Can the order be partially fulfillable - yes (Can not be partially cancelled though) the order needs to be first rejected or accepted?

10. How do we know when the order is unhold?

11. order TAT? How do we get fulfillment tat of an order? - sla key in orderFetch API

12. Do we get a unique key with orders to identify for the payments? - orderNo can be used. Same as MagentoOrderNo

Pricing clarity (discount and all other cases)?

ChannelOrderId, customerOrderId for an order - orderNo key

13. If we want to generate invoice how do I get the below details:

invoiceNo, transporterName, TrackingNo,

And which API to use?

https://xxxxx/RestWS/api/sellerPanel/v3/generateInvoice
https://xxxxx/RestWS/api/sellerPanel/v3/fetchInvoice

Can we fetch the same invoice using the same API?

14. Do we get invoice and label together?

Returns:

1. Diff type of returnStatuses?

2. Can return be delivered in a diff location? i.e. If a order is shipped from BLR but he returned arrived at GGN? How can this be handled?

3. After which status can a return not be cancelled?

4. What are the diff values of returnType?

5. How do we know the diff between CIR and courier return?

6. How do we get return reason?

7. Case: When an order has 2 order_items with same sku, and we get a return for 1 item with tracking id: 1, and we get another return with tracking id:2, how do we differentiate that whether the new return received is for the old item or return is created on the new order_item.

8. If a return is lost in transit do we get an update for it?

9. Tracking ID for creating a return in our system is mandatory for us. Are we getting tracking IDs every time?

10. Are we getting return creation requests on item level or shipment level i.e. if we have to create a customer return on the order items of an order having multiple order items? Are there different tracking IDs for each return request of the order item in that order?

11. What happens if the return is canceled and a new return request is made? Does there exist a cancellation workflow for returns? If no, do we get multiple return req for the same order item with diff tracking id?
    Do the returnNo and tracking id change when a return is cancelled and created again?

12. Do we change the return tracking number at any point during the return flow i.e. delivered, in transit, etc? Are we getting the updates for the same?

13. Do all returns have a unique return id, which is the identifier of a return?

14. Is there any unique identifier for the return of an order which is having multiple quantities of the same SKUs? Is it a lineItemSequenceNumber or itemID? Is it unique?