Ship order lines
Market availability: Global
Use this endpoint to ship an order by updating its shipping details. You must include the shipDateTime to record when the shipment occurred. This call updates the order's status to Shipped and triggers the customer charge.
Note: Orders must be acknowledged before shipping. Orders fulfilled by Walmart Fulfillment Services (WFS) cannot be shipped with this endpoint. Use the Create an inbound shipment order endpoint instead.
Endpoint
https://marketplace.walmartapis.com/v3/orders/{purchaseOrderId}/shippingSample request
This request marks an order line as shipped and includes required tracking information.
The carrierName field in trackingInfo must exactly match one of the supported carrier names. Refer to the Supported carrier names page for a full list of carrier names and ensure your value is accepted
curl --request POST \ --url https://marketplace.walmartapis.com/v3/orders/purchaseOrderId/shipping \ --header 'WM_GLOBAL_VERSION: 3.1' \ --header 'WM_MARKET: us' \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "orderShipment": { "processMode": "string", "orderLines": { "orderLine": [ { "lineNumber": "string", "shipFromCountry": "CA", "intentToCancelOverride": "string", "sellerOrderId": "string", "sellerOrderNo": "string", "orderLineStatuses": { "orderLineStatus": [ { "status": "Shipped", "asn": { "packageASN": "string", "palletASN": "string" }, "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "trackingInfo": { "shipDateTime": "2026-10-02T23:44:08.665Z", "carrierName": { "otherCarrier": "string", "carrier": "string" }, "methodCode": "string", "trackingNumber": "string", "trackingURL": "string", "packageStatus": "string", "shipmentNo": "string", "actualDeliveryDateTime": "2026-10-02T23:44:08.665Z" }, "returnCenterAddress": { "name": "string", "address1": "string", "address2": "string", "city": "string", "state": "string", "postalCode": "string", "country": "string", "dayPhone": "string", "emailId": "string" }, "currentTrackingInfo": { "trackingNumber": "string" } } ] } } ] }, "shipments": [ { "shipmentLines": [ { "primeLineNo": "string", "shipmentLineNo": "string", "quantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "shipFromCountry": "MX" } ], "carrier": "string", "trackingNumber": "string", "trackingURL": "string" } ] }
}
'Modify your code
- Replace
{purchaseOrderId}in the endpoint URL with the actual order ID. - Use a unique
WM_QOS.CORRELATION_IDfor each request. - Replace
WM_SEC.ACCESS_TOKENwith your valid access token obtained through authentication. - Adjust the
orderLinespayload as needed for your specific order. - The
shipDateTimeshould be written in the UNIX Epoch format (for example, 1478347200000. This is the number of milliseconds that have elapsed since January 1, 1970, 00:00:00 UTC).shipDateTimeis also supported in the following ISO 8601 formats in XML (however, JSON is not supported):- 2025-09-16T06:25:00Z (UTC time)
- 2025-09-16T06:25:00:05:00 (Offset from UTC)
- 2025-09-16T06:25:00.000Z (With fractional seconds)
Update an order after it ships
If you need to update shipping information after the order has already been marked as shipped, use the optional processMode parameter. This allows post-shipment updates to tracking details as long as:
- The update is made within 24 hours of the original shipment submission, or
- The update is made before the carrier’s first touch scan is registered with Walmart, whichever comes first
This is helpful if tracking numbers or carrier details need to be corrected after the original shipment update.
processMode value | Description | Required |
|---|---|---|
PARTIAL_UPDATE | Allows tracking updates after initial shipment | Optional |
Note: If you do not include processMode, the request is treated as a regular shipment update.
Sample response
application/json
200 - Sample 1-US
{ "order": { "purchaseOrderId": "129102916237229", "customerOrderId": "100001181176622", "customerEmailId": "[email protected]", "orderDate": 1769624177756, "shippingInfo": { "phone": "5103295632", "estimatedDeliveryDate": 1770235200000, "estimatedShipDate": 1769749200000, "methodCode": "Standard", "postalAddress": { "name": "Test buynow", "address1": "2476 Barlow Ave", "address2": null, "city": "San Jose", "state": "CA", "postalCode": "95122", "country": "USA", "addressType": "RESIDENTIAL" }, "carrierMethodName": null }, "orderLines": { "orderLine": [ { "lineNumber": "1", "item": { "productName": "Woodland Scenics MG759 Model Graphics Stripes Black Dry Transfer Decals", "sku": "00967044927635SKU", "condition": "New" }, "charges": { "charge": [ { "chargeType": "PRODUCT", "chargeName": "ItemPrice", "chargeAmount": { "currency": "USD", "amount": 20 }, "tax": null, "isDiscount": null, "discountType": null }, { "chargeType": "SHIPPING", "chargeName": "Shipping", "chargeAmount": { "currency": "USD", "amount": 1 }, "tax": null, "isDiscount": null, "discountType": null }, { "chargeType": "FEE", "chargeName": "Fee", "chargeAmount": { "currency": "USD", "amount": 0 }, "tax": { "taxName": "Prepaid MTS Surcharge 911, Prepaid MTS Surcharge 988, Prepaid MTS Surcharge Local", "taxAmount": { "currency": "USD", "amount": 1.82 } }, "isDiscount": null, "discountType": null } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "2" }, "statusDate": 1769668173000, "orderLineStatuses": { "orderLineStatus": [ { "status": "Shipped", "subSellerId": null, "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "2" }, "cancellationReason": null, "trackingInfo": { "shipDateTime": 1769668173000, "carrierName": { "otherCarrier": null, "carrier": "FedEx" }, "methodCode": "Standard", "carrierMethodCode": null, "trackingNumber": "101323906104", "trackingURL": "https://example.com/track?number=794644792798", "packageStatus": null, "actualDeliveryDateTime": null }, "returnCenterAddress": null, "sellerOrderId": null, "shipmentPackages": null } ] }, "refund": null, "fulfillment": { "fulfillmentOption": "DELIVERY", "shipMethod": "STANDARD", "storeId": null, "pickUpDateTime": 1769976000000, "pickUpBy": null, "shippingProgramType": "THREE_TO_FIVE_DAY", "shippingSLA": "3", "shippingConfigSource": "SELLER", "predictedShipNodeName": null } } ] }, "shipNode": { "type": "SellerFulfilled", "name": "lmpshipchecktemplate", "id": "758636536954859521" } }
}200 - Sample 2-MX
{ "order": { "purchaseOrderId": "609005296419679", "customerOrderId": "900000030239877", "customerEmailId": "[email protected]", "orderDate": 1740044217202, "shippingInfo": { "phone": "4086073423", "estimatedDeliveryDate": 1740772800000, "estimatedShipDate": 1740775800000, "postalAddress": { "name": "Jane Smith", "address1": "La Calma", "address2": "100", "address3": "PERIODISTA", "address4": "MIGUEL HIDALGO", "city": "CIUDAD DE MEXICO", "state": "DISTRITO FEDERAL", "postalCode": "11220", "country": "MX", "addressType": null }, "carrierMethodName": null }, "totalLines": "1", "totalQuantity": "2", "orderLines": { "orderLine": [ { "primeLineNumber": "1", "coLineNumber": "1", "item": { "upc": "00718802140481", "offerId": "570A6DB4E9AC33A5AFF318EBF08ACD88", "productName": "E2EAuto_07188021404816AccElectronics", "sku": "SKU-07188021404816", "condition": "New", "imageUrl": "https://example.com/images/mock-product-image.jpg", "unitPrice": { "currency": "MXN", "amount": 18 }, "unitPriceWithoutTax": { "currency": "MXN", "amount": 15.52 } }, "charges": { "charge": [ { "chargeType": "SHIPPING", "chargeAmount": { "currency": "MXN", "amount": 3.44 }, "tax": { "taxName": "SHIP_IVA_TAX", "taxAmount": { "currency": "MXN", "amount": 0.56 } }, "taxDetails": [ { "taxName": "SHIP_IVA_TAX", "taxAmount": { "currency": "MXN", "amount": 0.56 } } ], "isDiscount": null, "discountType": null }, { "chargeType": "PRODUCT", "chargeAmount": { "currency": "MXN", "amount": 31.04 }, "tax": { "taxName": "TOTAL_TAX", "taxAmount": { "currency": "MXN", "amount": 4.96 } }, "taxDetails": [ { "taxName": "TOTAL_TAX", "taxAmount": { "currency": "MXN", "amount": 4.96 } } ], "isDiscount": null, "discountType": null } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "2" }, "orderLineStatuses": { "orderLineStatus": [ { "status": "Shipped", "subSellerId": null, "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "2" }, "cancellationReason": null, "trackingInfo": null, "returnCenterAddress": null, "sellerOrderId": null, "shipmentPackages": null } ] }, "refund": null, "shippingMethod": "STANDARD", "soPrimeLineSubLineNo": "900000030239877-1-1", "promiseDeliveryDate": "2025-02-28T20:00:00.000+0000", "isMSIEnabled": "N", "seller": { "id": "10000012345", "name": "Sample Marketplace Account", "shipNodeType": "SellerFulfilled" }, "isWFSEnabled": "N", "fulfillmentType": "S2H" } ] }, "shipments": [ { "shipmentLines": [ { "primeLineNo": "1", "shipmentLineNo": "1", "quantity": { "unitOfMeasurement": "EACH", "amount": "2" }, "shipFromCountry": "MX" } ], "shipmentNo": "245e287c-571f-47fb-a9b9-81735b018abb", "status": "Shipped", "packageNo": "245e287c-571f-47fb-a9b9-81735b018abb", "isSellerOwnedShipment": "Y", "carrier": "MX-FDX-GROUND2 Sun", "trackingNumber": "987465364732", "shipmentAdditionalDate": { "expectedShipmentShippedDate": "2025-02-22T10:27:53.000+0000", "shipmentShippedDate": "2025-02-20T10:27:50.000+0000" }, "trackingURL": "https://example.com/track?number=794644792798" } ], "orderTotal": { "currency": "MXN", "amount": 40 } }
}200 - Sample 3-CA
{ "order": { "purchaseOrderId": "309006997003225", "customerOrderId": "701741532133507", "customerEmailId": "[email protected]", "orderDate": 1741532134508, "shippingInfo": { "phone": "6657555657", "estimatedDeliveryDate": 1742065200000, "estimatedShipDate": 1741672800000, "methodCode": "Standard", "postalAddress": { "name": "geetha kunchepu", "address1": "3354 Innes Road", "address2": null, "city": "Ottawa", "state": "ON", "postalCode": "K1C 1T1", "country": "CA", "addressType": "RESIDENTIAL" }, "carrierMethodName": null }, "orderLines": { "orderLine": [ { "lineNumber": "1", "shipFromCountry": "CA", "item": { "productName": "ANIMALPEDIGREEtwo", "sku": "EDF07661449630550" }, "charges": { "charge": [ { "chargeType": "PRODUCT", "chargeName": "ItemPrice", "chargeAmount": { "currency": "CAD", "amount": 401 }, "tax": { "taxName": "HST", "taxAmount": { "currency": "CAD", "amount": 52.13 } }, "isDiscount": false, "discountType": null }, { "chargeType": "SHIPPING", "chargeName": "SHIPPING", "chargeAmount": { "currency": "CAD", "amount": 2.5 }, "tax": { "taxName": "QST", "taxAmount": { "currency": "CAD", "amount": 0.38 } }, "isDiscount": false, "discountType": null }, { "chargeType": "PRODUCT", "chargeName": "ITEM_PRICE_AFTER_DISCOUNT", "chargeAmount": { "currency": "CAD", "amount": 401 }, "tax": { "taxAmount": { "currency": "CAD", "amount": 0 } }, "isDiscount": null, "discountType": null }, { "chargeType": "TAX", "chargeName": "TAX", "chargeAmount": { "currency": "CAD", "amount": 52.13 }, "tax": { "taxAmount": { "currency": "CAD", "amount": 0 } }, "isDiscount": false, "discountType": null } ] }, "orderLineQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "orderLineStatuses": { "orderLineStatus": [ { "status": "Shipped", "subSellerId": null, "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "1" }, "cancellationReason": null, "trackingInfo": { "shipDateTime": 1741811861000, "carrierName": { "otherCarrier": null, "carrier": "LETTERMAIL" }, "methodCode": "Standard", "carrierMethodCode": null, "trackingURL": null, "packageStatus": "Shipped", "shipmentNo": "fc5122b4-5ca0-4032-9b35-e5f7696950e8", "actualDeliveryDateTime": 16725225600000 }, "returnCenterAddress": null, "sellerOrderId": null, "shipmentPackages": null } ] }, "refund": null, "fulfillment": { "fulfillmentOption": "S2H", "shipMethod": "STANDARD", "storeId": null, "offerId": "46067EC8F029354ABC1668C9AFCCD106", "pickUpDateTime": null, "pickUpBy": null, "shippingProgramType": null, "predictedShipNodeId": "10011361291", "predictedShipNodeName": "seller.onboarding.test.ad.2008 - 10011361291 - MP" } } ] } }
}200 - Sample 4-CL
{ "order": { "purchaseOrderId": "P100716698", "customerOrderId": "4002529000079", "isWCPOrder": true, "orderDate": 1753185727000, "shippingInfo": { "phone": "+56567657687", "estimatedDeliveryDate": 1753455600000, "estimatedShipDate": 1753207200000, "methodCode": "STANDARD", "postalAddress": { "name": "user chile", "address1": "Rosario Sur", "address2": "615", "city": "Las Condes", "state": "Región Metropolitana", "country": "CL", "addressType": null }, "carrierMethodName": null }, "orderSummary": { "totalAmount": { "amount": 8873.83, "currency": "CLP" }, "orderSubTotal": [ { "subTotalType": "SHIPPING", "totalAmount": { "amount": 0, "currency": "CLP" } }, { "subTotalType": "TAX", "totalAmount": { "amount": 440.83, "currency": "CLP" } }, { "subTotalType": "PRODUCT", "totalAmount": { "amount": 8433, "currency": "CLP" } }, { "subTotalType": "DISCOUNT", "totalAmount": { "amount": 0, "currency": "CLP" } } ] }, "orderLines": { "orderLine": [ { "lineNumber": "1", "item": { "productName": "Plumbing item", "sku": "SKU-00341021017081" }, "charges": { "charge": [ { "chargeType": "PRODUCT", "chargeName": "ItemPrice", "chargeAmount": { "currency": "CLP", "amount": 2531 }, "tax": { "taxName": "IVA_TAX", "taxAmount": { "currency": "CLP", "amount": 160.33 } }, "isDiscount": null, "discountType": null }, { "chargeType": "COMMISSION", "chargeName": "Commission", "chargeAmount": { "currency": "CLP", "amount": 1265.04 }, "tax": { "taxAmount": { "currency": "CLP", "amount": 0 } }, "isDiscount": null, "discountType": null }, { "chargeType": "SHIPPING", "chargeName": "Shipping", "chargeAmount": { "currency": "CLP", "amount": 0 }, "tax": { "taxName": "SHIP_IVA_TAX", "taxAmount": { "currency": "CLP", "amount": 0 } }, "isDiscount": null, "discountType": null }, { "chargeType": "TAX", "chargeName": "TAX", "chargeAmount": { "currency": "CLP", "amount": 160.33 }, "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": "4" }, "statusDate": 1753207200000, "orderLineStatuses": { "orderLineStatus": [ { "status": "Shipped", "subSellerId": null, "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "4" }, "cancellationReason": null, "trackingInfo": { "shipDateTime": 1753555483000, "carrierName": { "otherCarrier": "Enviame", "carrier": null }, "methodCode": "STANDARD", "carrierMethodCode": null, "trackingNumber": "278855", "trackingURL": "https://example.com/track?number=794644792798", "packageStatus": null, "shipmentNo": "778505397_100085093", "actualDeliveryDateTime": null }, "returnCenterAddress": null, "sellerOrderId": null, "shipmentPackages": null }, { "status": "Cancelled", "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "3" }, "cancellationReason": "PRICE_ERROR", "trackingInfo": { "carrierName": { "otherCarrier": null, "carrier": null }, "methodCode": "STANDARD", "trackingURL": null, "packageStatus": null, "shipmentNo": null, "actualDeliveryDateTime": null }, "sellerOrderId": null, "shipmentPackages": null } ] }, "refund": null, "fulfillment": { "fulfillmentOption": "Seller", "shipMethod": "STANDARD", "storeId": "10011443481", "offerId": "C2A3F742E3AC370590C4065DEF4AAADB", "pickUpDateTime": null, "pickUpBy": null, "shippingProgramType": null, "predictedShipNodeId": "10011443481", "predictedShipNodeName": "Test Seller1750938211" } }, { "lineNumber": "2", "item": { "productName": "Footwear - testing", "sku": "SKU-00321360868131" }, "charges": { "charge": [ { "chargeType": "PRODUCT", "chargeName": "ItemPrice", "chargeAmount": { "currency": "CLP", "amount": 5902 }, "tax": { "taxName": "IVA_TAX", "taxAmount": { "currency": "CLP", "amount": 561 } }, "isDiscount": null, "discountType": null }, { "chargeType": "COMMISSION", "chargeName": "Commission", "chargeAmount": { "currency": "CLP", "amount": 4495.36 }, "tax": { "taxAmount": { "currency": "CLP", "amount": 0 } }, "isDiscount": null, "discountType": null }, { "chargeType": "SHIPPING", "chargeName": "Shipping", "chargeAmount": { "currency": "CLP", "amount": 0 }, "tax": { "taxName": "SHIP_IVA_TAX", "taxAmount": { "currency": "CLP", "amount": 0 } }, "isDiscount": null, "discountType": null }, { "chargeType": "TAX", "chargeName": "TAX", "chargeAmount": { "currency": "CLP", "amount": 561 }, "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": "2" }, "statusDate": 1753207200000, "orderLineStatuses": { "orderLineStatus": [ { "status": "Shipped", "subSellerId": null, "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "2" }, "cancellationReason": null, "trackingInfo": { "shipDateTime": 1753555476000, "carrierName": { "otherCarrier": "Enviame", "carrier": null }, "methodCode": "STANDARD", "carrierMethodCode": null, "trackingNumber": "278855", "trackingURL": "https://example.com/track?number=794644792798", "packageStatus": null, "shipmentNo": "778505396_100085092", "actualDeliveryDateTime": null }, "returnCenterAddress": null, "sellerOrderId": null, "shipmentPackages": null }, { "status": "Cancelled", "statusQuantity": { "unitOfMeasurement": "EACH", "amount": "2" }, "cancellationReason": "PRICE_ERROR", "trackingInfo": { "carrierName": { "otherCarrier": null, "carrier": null }, "methodCode": "STANDARD", "trackingURL": null, "packageStatus": null, "shipmentNo": null, "actualDeliveryDateTime": null }, "sellerOrderId": null, "shipmentPackages": null } ] }, "refund": null, "fulfillment": { "fulfillmentOption": "Seller", "shipMethod": "STANDARD", "storeId": "10011443481", "offerId": "65DA8EADAE3F3CD4A98A43158911D582", "pickUpDateTime": null, "pickUpBy": null, "shippingProgramType": null, "predictedShipNodeId": "10011443481", "predictedShipNodeName": "Test Seller1750938211" } } ] } }
}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" } ]
}application/problem+json
400 - SWW Label Failed - Hazmat Item Ineligible For USPS Priority Mail (Non-Retryable, LS-1010)
{ "type": "https://developer.walmart.com/errors/sww-label-failure", "title": "SWW label creation failed", "status": 400, "detail": "Your shipment contains dangerous goods or hazardous material that cannot be shipped with priority services. Select another service to ship this order, or submit a third-party tracking number.", "instance": "/v3/orders/{purchaseOrderId}/shipping"
}400 - SWW Label Failed - OOC Enrolled Seller Missing Required Fields (Non-Retryable, LH-4022)
{ "type": "https://developer.walmart.com/errors/sww-label-failure", "title": "SWW label creation failed", "status": 400, "detail": "A Ship With Walmart label cannot be generated for this shipment. The seller is enrolled in Out Of Country (Cross Border Trade) but required fields (Harmonized System code, country of origin, or product URL) are missing or are invalid. Correct the order details or submit a third-party tracking number.", "instance": "/v3/orders/{purchaseOrderId}/shipping"
}500 - SWW Label Failed — Carrier API Failure For This Cross Border Trade Order (Retryable, LS-3101)
{ "type": "https://developer.walmart.com/errors/sww-label-failure/retryable", "title": "SWW label creation failed — Retryable", "status": 500, "detail": "SWW label cannot be generated for this Cross Border Trade order due to a carrier API failure. This error may be transient so try again. If the error persists, submit a third-party tracking number.", "instance": "/v3/orders/{purchaseOrderId}/shipping"
}500 - SWW Label Failed - The Shipment Is Ineligible For The Cross Border Trade Carrier Label (Non-Retryable, LS-3101)
{ "type": "https://developer.walmart.com/errors/sww-label-failure/non-retryable", "title": "SWW label creation failed — Non-Retryable", "status": 500, "detail": "SWW label cannot be generated for this Cross Border Trade enrolled order. Eligible reasons: carrier ineligibility, hazmat restrictions, or shipment dimensions exceeding carrier limits. Submit a third-party tracking number.", "instance": "/v3/orders/{purchaseOrderId}/shipping"
}Result
If successful, the API returns an HTTP status: 200 OK along with a JSON object showing the updated order details. The specified order lines will now be in the Shipped status, confirming that the shipping details have been updated and the charge to the customer has been triggered.
Updated 2 days ago

