> 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/amazon-retail-procurement-integration.md).

# Amazon Retail Procurement Integration

Order Desk can connect to [**Amazon Retail Procurement**](https://vendorcentral.amazon.com/) in your Amazon Vendor Central account to automatically download orders that need to be fulfilled. Once those orders are fulfilled, shipment details will be sent back to Amazon automatically.

### Setup

In Order Desk, click on **Manage Integrations** under the Integrations menu in the left sidebar. Under the **Shopping Carts** tab, find and enable Amazon Retail Procurement.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F2RMaK4Mcj46fq91Ym0Q6%2Flegacy-4c038e3ea0af977b97ce.png?alt=media)

Alternatively, search for *Amazon Retail Procurement* from the available integration search then click **Enable**.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FBd2VarVzyTsZZkvsRaLM%2Flegacy-baa662aedd93803a1329.png?alt=media)

Once enabled, click **Connect to Amazon** to make the connection. You’ll be redirected to your Amazon account page to select the necessary permissions.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FxaHr3JjEI8cBtb19iEld%2Flegacy-fba714573bd7a5655248.png?alt=media)

### Settings

Once connected, you can set your integration preferences.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FaIF1jMsF7QfbKC7tyNsm%2Flegacy-2d7533e3c464875d6bc8.png?alt=media)

#### Check for New Orders

Select how often you want Order Desk to download orders from Amazon Retail Procurement.

#### Download These Orders

Select the types of orders you want Order Desk to import from Amazon Retail Procurement.

#### Folder for New Orders

Select the folder where newly imported orders from Amazon Retail Procurement should be placed.

For more information about setting up folders, see the [**Working with Folders**](/start-here/getting-started-series/quick-start-overview.md#working-with-folders) guide.

#### Auto Accept Orders

If enabled, Order Desk will automatically send order acceptance for imported orders.

#### Sync Tracking Numbers

If the Sync Tracking Numbers setting is enabled, Order Desk will send the shipment information back to Amazon Retail Procurement automatically and update the orders there.

#### Submit Invoice

If enabled, Order Desk will automatically send invoices back to Amazon Retail Procurement after we’ve successfully sent shipment updates back there.

#### Include UPC Check Digit

If you’d like Order Desk to include the check digit along with the item SKU in your orders, you can enable this setting.

#### Ship From ID

Enter the Ship From ID to be used for shipment confirmation and invoices. You can find this information in your Amazon address book.

#### Remit To ID

Enter the Remit To ID to be used for shipment confirmation and invoices. You can find this information in your Amazon address book.

#### First Import Date

Set the date you’d like Order Desk to start importing orders from Amazon Retail Procurement. Any orders prior to the date set here won’t be imported.

#### Check For Order Cancelations

If enabled, Order Desk will check Amazon for order cancellations. If any items in an order have been canceled, we’ll set an item-level metadata field called **status** with the value **CANCELED**. These canceled items will also be logged in the order history.

If you’d like to take action when an order is canceled in Amazon Retail Procurement, you can use the *Order Canceled at Amazon Retail Procurement* rule event. [More details about that here](#rule-events).

#### Manually Import Orders

#### Manually Import Orders

You can manually import orders from Amazon Retail Procurement at any time. You can import orders by **Date** if you need to bring in multiple orders, or by a specific **Order ID** if you only need to import one order.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FenlqwVDATuR4Pq7ilFIk%2Flegacy-2c6d2f04acde1052cc6f.png?alt=media)

> **Tip: Importing Orders by Date**
>
> If Amazon Retail Procurement has a large number of orders in the selected date range, you may need to click the **Import** button a few times to bring them all in.

#### Custom Details

You can add extra details to your orders to control what gets sent to Amazon Retail Procurement on a per order basis.

The following fields can be added as checkout data or order metadata. 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.

| Field Name | Field Description                                             |
| ---------- | ------------------------------------------------------------- |
| ShipFrom   | Overrides the **Ship From ID** integration setting per order. |
| RemitTo    | Overrides the **Remit To ID** integration setting per order.  |

#### Amazon Retail Procurement Rules Reference

In addition to the [**general set of rule events and actions**](/resources/rules-reference-events-filters-and-actions.md) in Order Desk, Amazon Retail Procurement includes a number of rule events and actions that are specific to the integration. These aren’t found directly on the integration page. Instead, you’ll need to use the **Rule Builder** to access them.

If you’re new to using rules in Order Desk, we recommend starting with our [**How to Work With Rules**](/guided-walkthroughs/rules-and-automations/how-to-work-with-rules.md) guide.

#### Rule Events

In addition to the general rule events available for all orders, the following events are specific to Amazon Retail Procurement.

To find them, search for a *mazon retail procurement* in the **Event** dropdown menu in the **Rule Builder**:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F95HMBh3OmfhPfBl8haPe%2Flegacy-72382945bd71ee61228f.png?alt=media)

| Event                                           | Description                                                                              |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------- |
| Order Acknowledged at Amazon Retail Procurement | Triggers when an order acknowledgment is successfully sent to Amazon Retail Procurement. |
| Shipment Confirmed at Amazon Retail Procurement | Triggers when a shipment confirmation is successfully sent to Amazon Retail Procurement. |
| Invoice Submitted to Amazon Retail Procurement  | Triggers when an invoice is successfully submitted to Amazon Retail Procurement.         |
| Order Canceled at Amazon Retail Procurement     | Triggers when an order is canceled in Amazon Retail Procurement.                         |

#### Rule Actions

Amazon Retail Procurement also supports specific rule actions that you can apply to your orders. These can be found in the **Actions** dropdown by searching for a *mazon retail procurement*:

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FijgKpSYMFGkJ4k7s4j2t%2Flegacy-139cb52beccc1ee316d6.png?alt=media)

| Action                                         | Description                                                                                                                                                                                                                                                                                                                             |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Acknowledge Order at Amazon Retail Procurement | Sends an acknowledgment request to Amazon for an order. You can choose from three acknowledgment types: **Accepted**, **Backordered**, or **Rejected**. If the acknowledgment type is set to **Accepted** and the request is successful, it can trigger the [Order Acknowledged at Amazon Retail Procurement](#rule-events) rule event. |


---

# 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/amazon-retail-procurement-integration.md?ask=<question>&goal=<endgoal>
```

`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.