Delivery updates
Market availability: Global
Overview
The Delivery Updates API allows Walmart Marketplace sellers to notify Walmart when a package gets delivered.
Endpoint
https://marketplace.walmartapis.com/v3/orders/{purchaseOrderId}/deliverFunction
Use this API to retrieve:
trackingNo:Tracking number associated with the package.eventTime:Date and time when the delivery event occurred.eventName:Name of the delivery event.purchaseOrderNo:Purchase order number associated with the package.packageNo:Package number associated with the shipment.
Request sample
curl --request POST \ --url https://marketplace.walmartapis.com/v3/orders/purchaseOrderId/deliver \ --header 'WM_GLOBAL_VERSION: 3.1' \ --header 'WM_MARKET: us' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "packages": [ { "trackingNo": "string", "eventTime": "string", "eventName": "string", "purchaseOrderNo": "string", "packageNo": "string" } ]
}
'Modify your code
Before sending the request, replace the placeholder values in the sample with information from the package you are updating.
- Replace the purchase order ID: Replace
purchaseOrderIdin the endpoint with the actual purchase order ID. - Set the Marketplace: Use the appropriate Marketplace value for the order you are updating.
- Replace the tracking number: Replace with the package's actual tracking number.
- Specify the delivery event time: Replace with the date and time associated with the delivery event.
- Specify the event name: Replace with the appropriate delivery event.
- Provide the purchase order number: Replace with the applicable purchase order number.
- Provide the package number: Replace with the package number associated with the shipment.
After replacing the placeholder values, send the POST request to submit the delivery update.
Response sample
application/json
200 - Sample 1-MX
{ "order": { "purchaseOrderId": "609027761234009", "customerOrderId": "900000050741801", "customerEmailId": "[email protected]", "orderDate": 1759521263715, "shippingInfo": { "phone": "4086637256", "estimatedDeliveryDate": 1760382000000, "estimatedShipDate": 1760372000000, "postalAddress": { "name": "alejandro lopez", "address1": "Periférico Boulevard Manuel Ávila Camacho 491", "address2": "491", "address3": "PERIODISTA", "address4": "MIGUEL HIDALGO", "city": "CIUDAD DE MEXICO", "state": "DISTRITO FEDERAL", "postalCode": "11220", "country": "MX", "addressType": null }, "carrierMethodName": null }, "totalLines": "1", "totalQuantity": "1", "orderLines": { "orderLine": [ { "primeLineNumber": "1", "coLineNumber": "1", "item": { "upc": "00281168944498", "offerId": "82836704AF603781A8D280DE0BAB495F", "productName": "iPhone 15 256 GB Blue June 11 creation 5 and Maintanace update via bulk", "sku": "sku_02811689444980", "condition": "New", "imageUrl": "https://example.com/images/mock-product-image.jpg", "unitPrice": { "currency": "MXN", "amount": 9850 }, "unitPriceWithoutTax": { "currency": "MXN", "amount": 8491.38 } }, "charges": { "charge": [ { "chargeType": "PRODUCT", "chargeAmount": { "currency": "MXN", "amount": 8491.38 }, "tax": { "taxName": "TOTAL_TAX", "taxAmount": { "currency": "MXN", "amount": 1358.62 } }, "taxDetails": [ { "taxName": "TOTAL_TAX", "taxAmount": { "currency": "MXN", "amount": 1358.62 } } ], "isDiscount": null, "discountType": null } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "orderLineStatuses": { "orderLineStatus": [ { "status": "Delivered", "subSellerId": null, "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "cancellationReason": null, "trackingInfo": null, "returnCenterAddress": null, "sellerOrderId": null, "shipmentPackages": null, "statusDate": "2025-10-06T17:37:40.000+0000" } ] }, "refund": null, "shippingMethod": "STANDARD", "soPrimeLineSubLineNo": "900000050741801-1", "promiseDeliveryDate": "2025-10-06T17:37:40.000+0000", "isMSIEnabled": "N", "seller": { "id": "10900075640", "name": "CBT test 1122", "shipNodeType": "SellerFulfilled" }, "isWFSEnabled": "N", "fulfillmentType": "S2H" } ] }, "shipments": [ { "shipmentLines": [ { "primeLineNo": "1", "shipmentLineNo": "1", "quantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "shipFromCountry": "MX" } ], "shipmentNo": "1fac0eab-30c5-40c7-8942-1a4b7ea8b32f", "status": "Shipment Delivered", "packageNo": "1fac0eab-30c5-40c7-8942-1a4b7ea8b32f", "isSellerOwnedShipment": "Y", "carrier": "Other", "trackingNumber": "1234", "shipmentAdditionalDate": { "expectedShipmentShippedDate": "2025-10-08T17:31:46.000+0000", "shipmentShippedDate": "2025-10-06T17:31:45.000+0000" }, "trackingURL": "https://example.com/track?number=794644792798" } ], "orderTotal": { "currency": "MXN", "amount": 9850 } }
}200 - Sample 2-CL
{ "order": { "purchaseOrderId": "P100724577", "customerOrderId": "5222544021015", "isWCPOrder": true, "orderDate": 1763520963000, "shippingInfo": { "phone": "+56932485348", "estimatedDeliveryDate": 1763917200000, "estimatedShipDate": 1763614800000, "methodCode": "STANDARD", "postalAddress": { "name": "testseller new", "address1": "Condell", "address2": "1490,test", "city": "Valparaíso", "state": "Valparaíso", "country": "CL", "addressType": null }, "carrierMethodName": null }, "orderSummary": { "totalAmount": { "amount": 3245, "currency": "CLP" }, "orderSubTotal": [ { "subTotalType": "SHIPPING", "totalAmount": { "amount": 2, "currency": "CLP" } }, { "subTotalType": "TAX", "totalAmount": { "amount": 518, "currency": "CLP" } }, { "subTotalType": "PRODUCT", "totalAmount": { "amount": 2725, "currency": "CLP" } }, { "subTotalType": "DISCOUNT", "totalAmount": { "amount": 0, "currency": "CLP" } } ] }, "orderLines": { "orderLine": [ { "lineNumber": "1", "item": { "productName": "SFS Bulk", "sku": "SKU_87969156287699" }, "charges": { "charge": [ { "chargeType": "PRODUCT", "chargeName": "ItemPrice", "chargeAmount": { "currency": "CLP", "amount": 2725 }, "tax": { "taxName": "IVA_TAX", "taxAmount": { "currency": "CLP", "amount": 518 } }, "isDiscount": null, "discountType": null }, { "chargeType": "COMMISSION", "chargeName": "Commission", "chargeAmount": { "currency": "CLP", "amount": 0 }, "tax": { "taxAmount": { "currency": "CLP", "amount": 0 } }, "isDiscount": null, "discountType": null }, { "chargeType": "SHIPPING", "chargeName": "Shipping", "chargeAmount": { "currency": "CLP", "amount": 2 }, "tax": { "taxName": "SHIP_IVA_TAX", "taxAmount": { "currency": "CLP", "amount": 0 } }, "isDiscount": null, "discountType": null }, { "chargeType": "TAX", "chargeName": "TAX", "chargeAmount": { "currency": "CLP", "amount": 518 }, "tax": { "taxAmount": { "currency": "CLP", "amount": 0 } }, "isDiscount": null, "discountType": null }, { "chargeType": "DISCOUNT", "chargeName": "DISCOUNT", "chargeAmount": { "currency": "CLP", "amount": 0 }, "tax": { "taxAmount": { "currency": "CLP", "amount": 0 } }, "isDiscount": null, "discountType": null } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "orderLineStatuses": { "orderLineStatus": [ { "status": "Delivered", "subSellerId": null, "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "cancellationReason": null, "trackingInfo": { "shipDateTime": 1763524831000, "carrierName": { "otherCarrier": null, "carrier": "Other" }, "methodCode": "STANDARD", "carrierMethodCode": null, "trackingNumber": "8388383", "trackingURL": "https://example.com/track?number=794644792798", "packageStatus": null, "shipmentNo": "778508675_100085721", "actualDeliveryDateTime": null }, "returnCenterAddress": null, "sellerOrderId": null, "shipmentPackages": null } ] }, "refund": null, "fulfillment": { "fulfillmentOption": "Seller", "shipMethod": "STANDARD", "storeId": "10011507049", "offerId": "A73985ACAC97365D82634C461CA13881", "pickUpDateTime": null, "pickUpBy": null, "shippingProgramType": null, "predictedShipNodeId": "10011507049", "predictedShipNodeName": "testsellerCL1026" } } ] } }
}400
{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.GMP_ORDER_API", "description": "Invalid request content.", "info": "Request content is not valid.", "severity": "ERROR", "category": "DATA" } ]
}401
{ "errors": [ { "code": "UNAUTHORIZED.GMP_ORDER_API", "description": "Unauthorized request.", "info": "Authentication failed. Verify your credentials.", "severity": "ERROR", "category": "APPLICATION" } ]
}403
{ "errors": [ { "code": "FORBIDDEN.GMP_ORDER_API", "description": "Access denied.", "info": "You do not have permission to perform this action.", "severity": "ERROR", "category": "APPLICATION" } ]
}404
{ "errors": [ { "code": "NOT_FOUND.GMP_ORDER_API", "description": "Resource not found.", "info": "The requested purchase order was not found.", "severity": "ERROR", "category": "DATA" } ]
}429
{ "code": "REQUEST_THRESHOLD_VIOLATED", "description": "Too many requests in a given amount of time.", "info": "You have exceeded the rate limit for this API. Retry after the time indicated in the Retry-After header.", "severity": "ERROR", "category": "SYSTEM", "causes": [], "errorIdentifiers": {}, "field": "RateLimitExceeded"
}500
{ "errors": [ { "code": "INTERNAL_SERVER_ERROR.GMP_ORDER_API", "description": "An internal server error occurred.", "info": "Retry the request. If the issue persists, contact support.", "severity": "ERROR", "category": "SYSTEM" } ]
}Result
A successful request returns HTTP 200 and the updated order.
The response may include the order's purchase order ID, customer order ID, shipping information, order lines, shipment details, tracking information, and order totals.
Error results
- 400 Invalid request content: Verify the request structure and values.
- 401 Unauthorized request: Verify authentication credentials.
- 403 Access denied: Verify that the application has permission to perform the operation.
- 404 Purchase order not found: Verify the purchase order ID.
- 429 Rate limit exceeded: Retry after the interval specified in the Retry-After header.
- 501 Internal server error: Retry the request. Contact support if the issue persists.
Next steps
- After implementing the Delivery Updates API, test your integration using a valid purchase order, package number, tracking number, event time, and delivery event.
- Verify that the returned order shows the expected Delivered status and that the shipment and tracking information are updated correctly.
- For unsuccessful requests, use the HTTP status code and error response to identify and correct request, authentication, authorization, purchase order, rate-limit, or server issues before retrying.
Updated about 1 hour ago
Did this page help you?

