> 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/fulfillment-services/pdr-integration.md).

# PDR Integration

Order Desk can import orders from your shopping cart(s), apply custom information and then submit them to [PDR](http://www.pdrnj.com/) for fulfillment. When orders are shipped, the tracking details will be sent back to Order Desk and back to your shopping cart(s) if your store is set up for it.

This guide explains how to set up and use the PDR integration. For more details about what the Order Desk app is used for, please see the [Getting Started](/start-here/learn-the-basics.md) guide.

### Setup

To connect to PDR, click on the **Manage Integrations** link in the left sidebar and under the **Fulfillment** tab find and enable the PDR integration.

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

Enter your PDR user ID and password and click to connect.

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

### Integration Settings

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/57b0032590336059d4edf94f/images/691c58f7ecb1d71e00f4d0cd/file-UxAmbiGldS.png)

After you have connected the integration, you can apply any necessary details or preferences to the settings.

#### Mode

Select how you want Order Desk to connect to PDR. You can choose either FTP or SFTP for the connection.

After you have connected the integration, you can apply any necessary details or preferences to the settings.

#### Default Mail Class

Choose the shipping class you want PDR to use for your orders.

If you need to apply specific methods for certain orders, match your method names to the names PDR uses in the [Shipping Class Match section](#shipping-class-match) below.

#### After Import, Move To

Select the folder you want orders to be moved into after they are successfully sent to PDR.

You can use one of the default folders already in your store or create your own. Read the [Working with Folders](/start-here/getting-started-series/quick-start-overview.md#working-with-folders) guide for more information.

#### After Shipment, Move To

Select the folder you want orders to be moved into as PDR sends shipment details back to Order Desk.

#### Custom Field Name

Custom field to communicate with PDR any extra information you need to send with the order. Set the name of a checkout data field if you want the message in that field on an order to be sent to PDR.

If you are unfamiliar with checkout data, please read the [How to Work with Checkout Data](/guided-walkthroughs/orders-and-folders/how-to-work-with-checkout-data.md) guide.

#### Automatically Send Imported Orders To PDR

If selected, every order that is added to Order Desk will automatically be sent to PDR.

Select this setting only if all orders will be sent to PDR. If any orders will not be sent, or if you need a delay between when an order is imported into Order Desk and when it is sent to PDR do *not* select this.

#### Inventory Settings

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

#### Sync Inventory

Enable if you want your inventory stock counts to be pulled in from PDR.

For more information, see the [How to Work with Inventory Counts](/guided-walkthroughs/products-and-inventory/how-to-work-with-inventory-quantities.md#send-counts-tofrom-order-desk) guide.

#### Inventory Location Name

If you want to set a specific inventory location name for the products you have at PDR, set that name here. As PDR sends back reports, your custom name will be added as the location.

#### Shipment Settings

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

#### Check for Shipments

Select how frequently you’d like shipments to sync back to Order Desk.

#### Product Settings

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

For more information on what these product settings in the PDR integration are for and how to use them, read the [Fulfillment Integration Product Settings](/integration-setup-guides/fulfillment-services/fulfillment-integration-product-settings.md) guide.

#### Shipping Class Match

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

If the shipping methods you set up in your shopping cart(s) don’t match the shipping method names PDR uses, they won’t know what methods you intend for them to use. When this happens, the [default mail class applied above](#integration-settings) will be used instead for all of your orders.

To tell PDR what methods you want them to use, you will need to match your method names to theirs. This can be done in the shipping class match section. For detailed instructions on setting this up, please read through the [shipping class match](/guided-walkthroughs/shipping-fulfillment-and-returns/how-to-set-up-shipping-class-matches.md) guide.

#### Custom Details

PDR can accept certain custom details about your orders and your items, listed here.

#### Order Details

The following details can be submitted for an order as either checkout data or order metadata.

| Field Name   | Field Description                                                                                                                                 |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| GiftWrap     | Set any value (yes, 1, true, etc.) to tell PDR to use gift wrap. Do not use this field or leave it empty if you do not want PDR to use gift wrap. |
| SalesChannel | Free text area to communicate to PDR. Example: set wholesale for wholesale orders.                                                                |

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.

#### Item Details

The following fields can be set as variations or item metadata for each order item.

| Field Name | Field Description                                |
| ---------- | ------------------------------------------------ |
| GroupID    | Use to group certain parts of a bundle together. |

**FAQ**

#### When do shipments come in?

Order Desk checks for new shipment files once every 12 hours on the schedule set in your View Appointments page. If you do not see a shipment you expect to see, it’s possible the import appointment has not run yet. You can manually run the appointment to check for updates from PDR.

Make sure to also check the order in Order Desk to see if tracking has already been added to it. If tracking has been added, then PDR has updated the order already. If you aren’t seeing that update show up in your shopping cart, make sure **Sync Tracking** is enabled in your cart integration settings.

You can also check the Order History for the order to see if there were any problems with telling the shopping cart about the shipment. Some shopping carts will not accept a shipment update if the order has already been marked as fulfilled before PDR and Order Desk have had a chance to report the shipment details to the cart. Orders must remain unfulfilled in your shopping carts until Order Desk sends fulfillment details back to them.

#### Why isn’t Order Desk reporting the right inventory numbers from PDR?

Order Desk cannot change the details that PDR sends. The app reads the files from PDR and updates the information in your Order Desk store based on what those files say.

If you see any discrepancies between what is being reported in Order Desk and/or your shopping cart and what PDR has told you they have received and have in stock, this is typically due to a misunderstanding about what PDR considers in stock and reports back to Order Desk and what inventory has been received and is being processed but is not yet in stock. If in doubt, please contact PDR for more information.

#### How do I send the gift message to PDR?

The gift message will be applied to checkout data in Order Desk. Different shopping carts send the gift message through with a different field name, so first look at an order with a gift message and find out what the checkout data field name for that message is.

As an example, Shopify gift messages are called “Note”. To add the gift message to your PDR export template(s), you will need to add this same checkout data field name Note to the Gift Message field name in the [product settings](#product-settings).

#### Who is managing my account?

Order Desk support will gladly help you get your account set up and running to be able to communicate with PDR about your orders, but it will be up to you to learn how Order Desk works so you can monitor and manage your own account. This includes handling updates and special settings that fall outside of the initial setup done by Order Desk.

If you have any questions, feel free to contact Order Desk support for help, but ultimately this is your store and your responsibility.


---

# 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/fulfillment-services/pdr-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.
