> 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/blastramp-hq.md).

# Blastramp HQ

Order Desk can connect to your [Blastramp HQ](https://blastramp.com/) account and automatically download orders.

### Setup

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

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

Alternatively, search for Blastramp HQ from the available integration search.

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

Enter your Endpoint ID and API Key, then click Connect.

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

Please note, Order Desk can’t provide or recover your Blastramp HQ credentials. They must be provided by Blastramp HQ.

### Settings

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

#### Check for New Orders

Select how often you want Order Desk to download orders from Blastramp HQ.

#### Folder for New Orders

Select the folder where newly imported orders from Blastramp HQ should be placed.

#### Orders Status

Select the shipment status of the orders to be imported.

#### Sync Tracking Numbers

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

#### Sync Inventory

Enable this if you want Order Desk to sync your inventory counts back to Blastramp HQ. Updates will be sent automatically whenever stock levels change in Order Desk.

#### Order Prefix

If you would like to add an order prefix to your Blastramp HQ orders as they import to Order Desk, add that value here.

#### Country Filter

Use two digit country codes, separated by commas, to only import orders from specific countries.

Add a – to exclude orders from specific countries.

*Examples:*

**US,CA,MX** – only import orders for the United States, Canada and Mexico.

**-US,-CA,-MX** (or **-US,CA,MX**) – import all orders except for the United States, Canada and Mexico.

#### 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 Blastramp HQ, 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).

#### First Import Date

Set the date from which you would like orders to begin importing from Blastramp HQ.

#### Automatically Mark Orders Uploaded to Blastramp HQ

Enable to mark your Blastramp HQ orders as imported into our system automatically.

### Manual Imports

#### Manually Import Orders

You can manually import orders from Blastramp HQ 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 Blastramp HQ 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.

#### Manually Import Inventory Items

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

Click *Request Product Download* to pull inventory items from Blastramp HQ to Order Desk or *View Inventory Items* to see your available inventory items.

#### Sending Invoices and Shipments to Blastramp HQ

#### Order Level Details

The following details can be submitted with invoices and shipments as either checkout data or order metadata.

| Field Name | Field Description           |
| ---------- | --------------------------- |
| Width      | Specify width of shipment.  |
| Length     | Specify length of shipment. |
| Height     | Specify height of shipment. |

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/blastramp-hq.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.
