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

# Avectous Integration

Order Desk can send orders directly to [Avectous](https://avectous.com/) for fulfillment, then send shipment details back into the original orders.

### 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 Avectous.

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

Alternatively, search for Avectous from the available integration search.

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

On the integration page, add your Avectous Username, Password, Company Code, Channel Code, and Warehouse Code to connect.

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

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

### Integration Settings

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FUiFFJV8QeaS0NLtiBlZ4%2Flegacy-6e31b955dd38e6fbd0d9.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 Avectous 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 Avectous from Order Desk. Typically this is set to Prepared, but any custom folder can be used.

#### After Shipment, Move To

Select the folder orders should be moved to when Avectous sends tracking details back to Order Desk. Typically this is set to Closed, but any custom folder can be used.

#### Shipping Account Number

Give this Notification URL to your account rep at Avectous so Order Desk can pull your shipment and tracking details back into your orders here and, if applicable, send them back to your shopping cart.

#### Automatically Send Imported Orders to Avectous

If you plan to automatically submit *every* order to Avectous for fulfillment, you can enable this setting. All orders will be sent as they come in to Order Desk.

If you have any other fulfillment services or will have any orders you *don’t* want to send to Avectous, keep this disabled. Use [rules](/guided-walkthroughs/rules-and-automations/how-to-work-with-rules.md) to submit orders to the appropriate vendor or fulfillment service instead.

#### Inventory Syncing

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

#### Sync Inventory

If you would like Avectous to send inventory reports to Order Desk, enable this setting. If enabled, your stock counts will be pulled into Order Desk on the interval selected in the next setting.

#### Sync Update Interval

If Sync Inventory is enabled, select the interval you would like Order Desk to pull in inventory updates from Avectous.

Options are Every Day, Every 8 Hours, Every 6 Hours, Every 4 Hours, Every 2 Hours, Every Hour and Every 15 Minutes.

#### Inventory Location Name

By default, inventory updates will add Avectous as the location name on each item updated. If you would like to override this to use a different name, add that here.

#### Product Settings

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

For more information on what these product settings in the Avectous 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%2FOpsLlSKP3elOeYsHZ5vA%2Flegacy-145992ebdc38d7f3e117.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 Avectous uses to ensure 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.

### Custom Details for Avectous

The following fields can be set as checkout data or order metadata to add or change the details that are sent to Avectous about the order.

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.

| Field Name         | Field Description                                                                                                                                                                          |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| OrderNumber        | Use to set the order number.                                                                                                                                                               |
| ChannelOrderNumber | Use to set the channel order number.                                                                                                                                                       |
| OrderType          | Default is SO                                                                                                                                                                              |
| ShippingAccount    | Default is the Shipping Account Number in your Avectous integration settings.                                                                                                              |
| ThirdPartyAccount  | Used for manually adding a different shipping account number to the order.                                                                                                                 |
| note\_\*           | Pass along up to 5 order notes.                                                                                                                                                            |
| note\_type\_\*     | Set note type. Default is **Warehouse**.                                                                                                                                                   |
| OHGT0x             | Generic field meant for general use. Any data that isn’t applicable to other available field names can be passed using this field. Up to 5 (e.g. OHGT01, OHGT02, etc.).                    |
| ERPGT0x            | Generic field meant for general use. Any data that isn’t applicable to other available field names can be passed using this field. Up to 5 (e.g. ERPGT01, ERPGT02, etc.).                  |
| EDIWhse            | Generic field meant for general use.                                                                                                                                                       |
| PONumber           | Set a PO number at Avectour. If this field isn’t provided, Order Desk will use the Order Number as the PO Number. If you’d prefer that the PO Number is blank, use the value **\_BLANK\_** |

#### Item Level Details

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

| Field Name | Field Description |
| ---------- | ----------------- |
| UOM        | Default is EA     |


---

# 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/avectous-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.
