1. Help Center
  2. FAQs
  3. Marketplace Management API

API - Updating Orders with Tracking URL's

With Walmart's new requirements, a Tracking URL may be required to successfully update your unshipped orders on Walmart.

You can easily update your orders with tracking information and "Shipped" status via a PUT API call. These updates will trigger outbound updates to any sales channel and you can "quick fulfill" the order by sending the OrderTracking (Tracking number itself) and OrderService (i.e. Standard or Expedited), OrderCarrier  (i.e. USPS or Fedex). 

In order to send the TrackingURL you will need to use ShippingTracking, ShippingServiceActual, and ShippingCarrier as you are specifying a specific SKU that has been ordered. 

For more information, please review our articles pertaining to how to obtain your API Key and How to review our Open API documentation in our Knowledge Base. 

Walmart has recently made an adjustment to their order update process where if you send a Shipping Service that is not in their accepted carrier list, you must include a tracking URL at the same time.

Here is the official statement from Walmart:

These are the accepted Shipping Carriers for Walmart: 

  • Canada Post
  • DHL
  • FedEx
  • Globegistics Inc., (Asendia)
  • Purolator Inc.,
  • UPS
  • USPS

"You can only select Other from the dropdown if you are NOT using one of the supported carriers for the shipping methods listed above. If you choose Other, you will be required to provide the Tracking URL manually."

In summary, If you are not shipping out your orders with the above shipping carriers, you will need to include a Tracking URL with your order updates. 

Using our API, you can easily include the Tracking URL with your shipping updates. If you include the ShippingTrackingURL at the same time as your update, this will be included in the outbound feed. 

This is an example of how you can quickly fulfill an order with a PUT call (within the minimal required fields):

{

"SiteOrderID":"113-9762222-711111",
"Site":"Amazon",
"OrderStatus":"Shipped",
"OrderDetails":
[
{

"SiteItemID":"6925325555555",
"OrderStatus":"Shipped",
"DateShipped":"2021-05-20",
"QuantityShipped":4,
"ShippingServiceActual":"Standard",
"ShippingTracking":"123123123",
"ShippingTrackingUrl":"https:\/\/www.fedex.com\/apps\/fedextrack\/?tracknumbers=123123123",
"ShippingCarrier":"FedEx"}]

}

*A full PUT Order API call includes additional fields and if you are looking to update only specific SKU's in your order (when more then one SKU is purchased), this PUT call might differ slightly. You can review the full PUT call via our API page.

This is the field that you want to make sure is updated:

"ShippingTrackingUrl":"https:\/\/www.fedex.com\/apps\/fedextrack\/?tracknumbers=123123123",

Here are examples of what can be included with that update: 

FEDEX http://www.fedex.com/Tracking?tracknumbers=
UPS http://www.ups.com/WebTracking/track?loc=en_US
US Mail http://www.usps.com/shipping/trackan...rackandconfirm

 

Frequently Asked Questions: 

Can I update the Tracking URL manually within the user interface?

At this current time, we do not support the Tracking URL within the user interface. The only way we can interact with this field is via the API. We do hope to add this functionality in the future. 

You can update the order with the standard tracking number, shipping service, and shipping carrier via the Order Manager page. 

Do I need to include a Tracking URL with all of my order updates? 

This is only required for Walmart orders where your shipping carrier is outside of the options mentioned above. We have not seen the need to include tracking URLs for Amazon, eBay, or any other sales channel. 

Will I be notified by Marketplace Management if an order update fails to update Walmart?

If you submit an order update without a tracking URL, we will still attempt to send an order update to the sales channel. If that order update fails, there is not going to be a notification back to you that the update has failed. Technically, since the API call was successful, Marketplace Management did attempt to update the order on the sales channel. 

We do hope to expand our notifications in the future. As a short-term solution, you can re-submit your update with the URL attached or you can manually update the order on Walmart directly.