> For the complete documentation index, see [llms.txt](https://eshop.gitbook.io/eshopbox-developers/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://eshop.gitbook.io/eshopbox-developers/advanced/failed-delivery-api.md). # Failed Delivery API ### Base URL `https://wms.eshopbox.com/api/v2/ndrResolution` ### Authentication This API uses Bearer Token authentication. Include the JWT token in the Authorization header. ### Request #### HTTPS Method `POST` #### Headers * `Authorization: Bearer ` - JWT authentication token * `Content-Type: application/json` - Specifies JSON request body #### Request Body (JSON) | Parameter | Type | Required | Description | | -------------------------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------ | | `actionSource` | string | Optional | Source of the resolution action | | `customerOrderNumber` | string | Yes | Customer's order number (e.g., "DR-903"). | | `resolutionCode` | string | Yes | NDR resolution code (e.g., "ACTF001") | | `trackingId` | string | Yes | Shipment tracking ID (e.g., "82616846149") | | `deferredDate` | string | Optional | New delivery date if deferred (yyyy-mm-dd). This is applicable only for ACTF002. (Example: 2025-06-14) | | `shippingDetails` | object | Optional | Updated shipping information | | `shippingDetails.name` | string | Optional | Recipient name. This is applicable for ACTF001, ACTF003 and ACTF004. | | `shippingDetails.email` | string | Optional | Recipient email. This is applicable for ACTF001, ACTF003 and ACTF004. | | `shippingDetails.currentAddress` | string | Optional | Original delivery address. This is applicable for ACTF001, ACTF003 and ACTF004. | | `shippingDetails.updatedAddress` | string | Optional | Updated delivery address. This is applicable for ACTF001, ACTF003 and ACTF004. | | `shippingDetails.landmark` | string | Optional | Nearby landmark for delivery. This is applicable for ACTF001, ACTF003 and ACTF004. | | `shippingDetails.notes` | string | Optional | Additional delivery instructions. This is applicable for ACTF001, ACTF003 and ACTF004. | | `contactPhoneNumber` | string | Yes | Contact phone number (e.g., "9692XXXXXX". You need to use the same phone number that is associated with the order. | | `remarks` | string | Optional | Additional remarks about the resolution | ### Resolution Codes Common NDR resolution codes include: | Code | Description | Customer Message | | --------- | -------------------------- | ------------------------------------------------------------------------------------------------------------ | | `ACTF001` | Reattempt delivery | I will request another delivery attempt (You can update your address and contact details.) | | `ACTF002` | Delivery rescheduled | I will choose a new delivery date. | | `ACTF003` | Cancel | I will cancel my order. | | `ACTF004` | Return to origin initiated | I will request another delivery attempt as I disagree with the courier mentioned reason for failed delivery. | ### Example Request ACTF001 (Reattempt delivery) ```json { "actionSource": "", "customerOrderNumber": "6308432675062", "resolutionCode": "ACTF001", "trackingId": "32346210357136", "deferredDate": "", "shippingDetails": { "name": "John Doe", "email": "johndoe@test.com", "currentAddress": "del, v3 floor, Delhi, Delhi, 110001", "updatedAddress": "House 111, v3 floor, Delhi, Delhi- 110001", "landmark": "", "notes": "" }, "contactPhoneNumber": "999999999", "remarks": "" } ``` #### Response ```json { "customerOrderNumber": "6308432675062", "orderItemID": "6308432675062-43527461", "resolutionCode": "ACTF002", "deferredDate": "", "shippingDetails": { "name": "John Doe", "email": "johndoe@test.com", "currentAddress": "del, v3 floor, Delhi, Delhi, 110001", "updatedAddress": "House 111, v3 floor, Delhi, Delhi- 110001", "landmark": "", "notes": "" }, "contactPhoneNumber": "9999999999", "trackingId": "32346210357136", "remarks": "", "timeline": "forwardTrackingTimeline", "clientEmail": "john@test.com", "actionSource": "" } ``` ### Example Request ACTF002 (Delivery rescheduled) ```json { "actionSource": "", "customerOrderNumber": "6308432675062", "resolutionCode": "ACTF002", "trackingId": "32346210357136", "deferredDate": "2025-05-14", "shippingDetails": { "name": "John Doe", "email": "johndoe@test.com", "currentAddress": "del, v3 floor, Delhi, Delhi, 110001", "updatedAddress": "House 111, v3 floor, Delhi, Delhi- 110001", "landmark": "", "notes": "" }, "contactPhoneNumber": "999999999", "remarks": "" } ``` #### Response ```json { "customerOrderNumber": "6308432675062", "orderItemID": "6308432675062-43527461", "resolutionCode": "ACTF002", "deferredDate": "2025-05-14", "shippingDetails": { "name": "John Doe", "email": "johndoe@test.com", "currentAddress": "del, v3 floor, Delhi, Delhi, 110001", "updatedAddress": "House 111, v3 floor, Delhi, Delhi- 110001", "landmark": "", "notes": "" }, "contactPhoneNumber": "9999999999", "trackingId": "32346210357136", "remarks": "", "timeline": "forwardTrackingTimeline", "clientEmail": "john@test.com", "actionSource": "" } ``` ### Example Request ACTF003 (Cancel) ```json { "actionSource": "", "customerOrderNumber": "6308432675062", "resolutionCode": "ACTF003", "trackingId": "32346210357136", "remarks": "cancel" } ``` #### Response ```json { "customerOrderNumber": "6308432675062", "orderItemID": "6308432675062-43527461", "resolutionCode": "ACTF003", "trackingId": "32346210357136", "remarks": "cancel", "timeline": "forwardTrackingTimeline", "clientEmail": "john@test.com", "actionSource": "", } ``` ### Example Request ACTF004 (Report false delivery attempt ) ```json { "actionSource": "", "customerOrderNumber": "6308432675062", "resolutionCode": "ACTF004", "trackingId": "32346210357136", "deferredDate": "", "shippingDetails": { "name": "John Doe ", "email": "johndoe@test.com", "currentAddress": "B BLOCK 1335 INDRA NAGAR LUCKNOW, , Lucknow, Uttar Pradesh, 226016", "updatedAddress": "B BLOCK 1335 INDRA NAGAR LUCKNOW, h, Lucknow, Uttar Pradesh- 226016", "landmark": "h", "notes": "" }, "contactPhoneNumber": "9999999999", "remarks": "Re attempt " } ``` #### Response ```json { "customerOrderNumber": "6308432675062", "orderItemID": "6308432675062-43527461", "resolutionCode": "ACTF004", "deferredDate": "", "shippingDetails": { "name": "John Doe ", "email": "johndoe@test.com", "currentAddress": "B BLOCK 1335 INDRA NAGAR LUCKNOW, , Lucknow, Uttar Pradesh, 226016", "updatedAddress": "B BLOCK 1335 INDRA NAGAR LUCKNOW, h, Lucknow, Uttar Pradesh- 226016", "landmark": "h", "notes": "" }, "contactPhoneNumber": "9999999999", "trackingId": "32346210357136", "remarks": "Re attempt ", "timeline": "forwardTrackingTimeline", "clientEmail": "john@test.com", "actorType": "seller", "actionSource": "", "actor": "john@test.com" } ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://eshop.gitbook.io/eshopbox-developers/advanced/failed-delivery-api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.