> For the complete documentation index, see [llms.txt](https://help.orderdesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orderdesk.com/integration-setup-guides/sales-channels/walmart-integration.md). # Walmart Integration Order Desk can connect to your United States, Canada or Mexico Walmart Marketplace account or to your United States Walmart Drop Ship Vendor (DSV) account, then download and acknowledge your orders. As orders are fulfilled, shipment details will be sent back to Walmart. ### Setup > Please note that Canada DSV and Mexico DSV are not supported at this time. You can connect to either Walmart Marketplace or Walmart DSV with the Walmart integration. If you need to connect to both, you will first have to create a second Order Desk store to set up a second Walmart integration. Instructions for creating a new store can be found [here](/guided-walkthroughs/using-order-desk/how-to-manage-multiple-stores-on-one-account.md). To enable the integration in Order Desk, click on **Manage Integrations** in the left sidebar. Under the **Shopping Carts** tab, look for and enable the Walmart integration. ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/57b0032590336059d4edf94f/images/625d93195d4a56595bbfa73e/file-M64XMyVaO1.png) Once enabled, you can choose whether to connect directly to your Walmart account from within Order Desk or connect manually with your API keys. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FprmPT463oeFTiDbmCSQi%2Flegacy-d04770e05c94f8d7b5a0.png?alt=media) #### Connect Automatically With Walmart To connect automatically, click the **Connect to Walmart** button. You’ll be redirected to your Walmart account login screen if you aren’t already logged in. Enter your credentials and log in. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FkAwP7lOKIuQWt8XxkL8N%2Flegacy-1e57b0670bab2705d87f.png?alt=media) On the next screen, you’ll be asked to give Order Desk the necessary permissions to access your Walmart account: ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F8eFl05L0Hwv5ml7SP8YB%2Flegacy-73a34e218c5227891a90.png?alt=media) Click **Authorize**, and Walmart will redirect you back to Order Desk with the integration connected. Continue with the rest of the setup on the [integration settings page](#integration-settings). #### Connect to Walmart Manually To connect to Walmart manually, click the **Connect With Your Own API Keys Instead** option. This will take you to a page where you can choose the country and account type. Follow the instructions below based on whether you’re connecting to a Marketplace or DSV account. #### Marketplace Instructions ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/57b0032590336059d4edf94f/images/607f0b09f8c0ef2d98df440b/file-moeYCe9aQ6.png) To retrieve your API Keys, please login to the [Walmart Developer Center](https://developer.walmart.com/#/generateKey) and click on the API Keys page. Under the **My API Key** section, copy the Client ID and Client Secret keys and paste them into Order Desk. #### DSV Instructions ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/57b0032590336059d4edf94f/images/65ceb1ffc5625b1953dde399/file-oE62diNw0n.png) To connect a Walmart DSV account, login to the [Walmart Supplier Center](https://supplier.walmart.com/) and follow these steps: 1. Click on **Settings** in the upper right corner. 2. Click on Distribution Facility to find your Distributor ID. 3. Click on **API Keys** to locate your Client ID and Client Secret. Order Desk can only download from a single Distributor ID in a single store. If you need to download from a second Distributor ID, you will need to create a second Order Desk store. ### Integration Settings Once connected, set your download preferences so Order Desk knows which orders you want imported. > **TIP** > > Depending on your connected marketplace region, some of these settings may or may not be available. ![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/57b0032590336059d4edf94f/images/6968f7568db8ae717640fcac/file-EMEV11sTyJ.png) #### Check For New Orders Select how often you want orders to be downloaded, up to one hour. Walmart requires new orders to be acknowledged within one hour of being placed. If an order has a status of **Ready for Shipment** (or **Released**) when it is imported from Walmart, Order Desk will automatically attempt to acknowledge the order in Walmart for you. > **TIP** > > If you want Order Desk to acknowledge all Walmart orders regardless of their status, you can consider creating a rule to do so: > > * ***Rule Type:*** *Order Rule* > * ***Event:*** *Order Is Imported* > * ***Filter:*** *Order Source Equals Walmart* > * ***Action:*** *Acknowledge at Walmart* > > [**Check out this guide**](/guided-walkthroughs/rules-and-automations/how-to-work-with-rules.md) to learn more about working with rules. #### Orders to Download Select which orders you want Order Desk to download. If an order is not yet released and in Walmart’s “Created” status, it will not be downloaded. #### Ship Node Type Specify which types of orders you would like to import from Walmart (Seller Fulfilled, WFS Fulfilled, or 3PL Fulfilled). This option is only available when you’ve connected the integration as a Marketplace account. #### Folder for New Orders Select the folder where newly imported orders from Walmart should be placed. For more information, see the [Working with Folders](/start-here/getting-started-series/quick-start-overview.md#working-with-folders) guide. #### Sync Inventory Enable to have Order Desk send your inventory numbers to Walmart. By default the unit of measurement for these updates will be EACH. If you need to have a different unit, set go into the inventory item(s) here in Order Desk and add item metadata called “uom” with the value set as your custom unit of measurement. Please note, Walmart DSV requires the GTIN for your items in place of the SKU. The GTIN can be passed to Walmart DSV in your item metadata using the field name **gtin**. For more information on Order Desk inventory, see the [How to Work with Inventory Details](/guided-walkthroughs/products-and-inventory/how-to-work-with-inventory-details.md) guide. #### Order Number Format Select which number should be the order ID in Order Desk. If you select Combo, the order number will combine both numbers in this format: #### Customer Order Number-PO Number #### Fulfillment Lag Time (CA Marketplace Only) This is the number of days you expect it to take from when you receive an order until you plan to ship it. The default number is set to 2 days. Edit this if you expect a different time frame for your fulfillment, as Walmart requires this data from each store and will expect you to meet your own time frame. #### Distributor ID (DSV Only) If you need to change your Distributor ID, do so here. #### Order Prefix If you need your order numbers to have a prefix on them when they are imported into Order Desk, set that prefix here. #### First Import Date Any orders placed before the date set here will not import into Order Desk. #### Ship From Country Sets the shipping country of origin when submitting fulfillment details back to Walmart. #### Inventory Location Filter If you only want to download specific orders, you can use the Inventory Location Filter field to specify which ones you want. Enter multiple locations separated by a comma. The inventory location name must match exactly as it is on your inventory items in Order Desk. When importing new orders from Walmart, Order Desk will look at the SKUs on the items and compare to the SKUs in your inventory here. Any orders with items for a location that isn’t listed in this field will not be imported. For this to work, your inventory must be added to Order Desk. The inventory Location should be set on each item. For details, please see [How to Add Inventory](/start-here/getting-started-series/quick-start-orders-and-inventory.md#working-with-inventory) and [How to Store Extra Item Details](/guided-walkthroughs/products-and-inventory/how-to-work-with-inventory-details.md#store-extra-item-details-in-order-desk). #### Check for Canceled Orders Enable this setting if you want Order Desk to check Walmart for orders that have been canceled. This check will run twice a day. If an order that has already been downloaded into Order Desk has since been canceled, a new event will run in Order Desk (Walmart Order Canceled), and the admin of the store will be emailed a notification. You can use the Walmart Order Canceled event to set up rules to take action on these canceled orders. No actions will be taken on these orders *unless* there is a rule to do so, though the email notification to the admin will happen automatically and does not need a rule. As an example, you may want to move the orders into the Canceled Folder. If you aren’t familiar with rules, please see the [Rule Builder](/guided-walkthroughs/rules-and-automations/how-to-work-with-rules.md) guide. If the order has already been sent for fulfillment, you will need to follow up with your fulfillment service to make sure it gets canceled in time. This is typically a manual process and cannot be done automatically by Order Desk or with a rule. For more information, please see the [How to Cancel an Order](/guided-walkthroughs/orders-and-folders/how-to-cancel-an-order.md) guide. #### Check for Returned Orders (US Marketplace only) If enabled, Order Desk will check three times a day for initiated order returns with Walmart. If any are found, they will be noted with order and item metadata. Item metadata may include the walmart\_returned\_reason and walmart\_returned\_quantity fields. Order metadata may include the walmart\_returned, walmart\_return\_order\_id, walmart\_return\_tracking\_number, walmart\_all\_items\_returned and walmart\_return\_order\_id\_first fields. Use the **Walmart Order Returned** [rule event](/guided-walkthroughs/rules-and-automations/how-to-work-with-rules.md) to have Order Desk take action on returned orders. #### Manually Import Orders ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FbCf9rOsXdHouMMNT3aZt%2Flegacy-1e9c86561baeb3ad7e33.png?alt=media) Order Desk can download orders manually if you click the **Import Recent Orders** button. Orders will download based on the [Orders to Download setting](#integration-settings). If you need to pull in orders with a different status, change your setting first, then manually download orders. You can also import a single order by using the **Order ID** option. ### Special Features The following fields can be set as checkout data or order metadata to your Walmart orders. | Field Name | Field Value | | ------------------- | ---------------------------------------------------------------------------------------------------- | | ship\_from\_country | Manually overrides the country value set in the [integration settings](#integration-settings) above. | If you are unfamiliar with checkout data, see the [How to Work with Checkout Data](/guided-walkthroughs/orders-and-folders/how-to-work-with-checkout-data.md) guide. --- # 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://help.orderdesk.com/integration-setup-guides/sales-channels/walmart-integration.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.