> 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/fragrancex-integration.md).

# FragranceX Integration

Order Desk can send orders to [FragranceX](https://www.fragrancex.com/) for fulfillment, pull shipment details back into your orders and send the shipment info to your shopping carts, where applicable.

### Setup

To enable the integration, click on the **Manage Integrations** link in the Integrations menu in the left sidebar. Under the **Fulfillment** tab, find and enable FragranceX. Alternatively, search for FragranceX from the available integrations.

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

In the integration page, add your FragranceX API Access ID and Keyword and click to connect.

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

Please note that Order Desk isn’t able to help find or reset your credentials, as they can only be provided through FragranceX.

### Integration Settings

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

#### Default Mail Class

Choose the default mail class you want to use for your orders. This shipping class will be used for any orders sent to FragranceX that aren’t mapped to one of the mail classes they use.

To set up more than one shipping method, scroll down to the [Shipping Class Match](#shipping-class-match) section for instructions.

#### After Import, Move To

Select the folder orders should be moved to after they are sent to FragranceX from Order Desk. 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 orders should be moved to when FragranceX sends tracking details back to Order Desk.

#### Product Settings

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

For more information on what these product settings in the FragranceX 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%2FkPTlgvrE70kTzeelVsq5%2Flegacy-cf30a5c8e0fc0ecd9fec.png?alt=media)

Use the shipping class match feature to match as many different shipping methods as you offer to the specific shipping classes that FragranceX uses. This ensures your customers are getting the closest shipping option to what they selected at checkout.

For information on how to set up your shipping preferences, please see the [shipping class match](/guided-walkthroughs/shipping-fulfillment-and-returns/how-to-set-up-shipping-class-matches.md) guide.

### Sending Orders to FragranceX

#### Order Level Details

The following details can be submitted with an order as either checkout data or order metadata. For more information on what each field means, please talk to FragranceX.

| Field Name  | Field Description                                              |
| ----------- | -------------------------------------------------------------- |
| Dropship    | Default is 1. Set to 0 if your order is not being dropshipped. |
| GiftWrapped | Default is 0. Set to 1 if you’d like your order gift wrapped.  |

#### Item Level Details

The following can be set as item metadata or variations on the items in your orders.

| Field Name | Field Description                                                                                             |
| ---------- | ------------------------------------------------------------------------------------------------------------- |
| Comments   | Any information added in the comments field will be sent to FragranceX in the Extra6 field at the item level. |

If you are unfamiliar with how to add item metadata or variations to your items in Order Desk, see the [How to Work with Inventory Details](/guided-walkthroughs/products-and-inventory/how-to-work-with-inventory-details.md#store-extra-item-details-in-order-desk) 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/fulfillment-services/fragrancex-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.
