> 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/print-on-demand/prima-integration.md).

# Prima Integration

Order Desk can import orders from your shopping cart(s), sync in your print details and then automatically send them on to [Prima](https://www.primaprinting.com.au/) for fulfillment. When orders are shipped, the tracking details will be sent back to Order Desk automatically.

### Setup

To connect to Prima, click on the **Manage Integrations** link under the **Integrations** menu in the left sidebar, and under the **Print on Demand** tab find and enable Prima.

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

Alternatively, search for Prima from the available integration search.

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

Enter your Prima vendor ID to enable the connection.

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

### Integration Settings

Once connected, you’ll have some shipment and integration settings to adjust per your preferences.

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/57b0032590336059d4edf94f/images/6900d1fc5e54145f690e6f77/file-WIyEBbYbcU.png)

#### Mode

Select whether you need the connection to be Live or Test mode.

#### Default Shipping Method

Select the default shipping method you want Prima to use. The shipping method you select will be used for all orders where the method on the order does not match any of Prima’s known shipping method names.

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

#### Pending Folder

Select the folder you want orders to be moved into after they are sent to Prima and are in *Pending* status there.

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 Acceptance, Move To

Select the folder you want orders to be moved into after they’ve been accepted in Prima.

#### After Shipment, Move To

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

#### If Canceled, Move To

Select the folder orders should be moved to if they are canceled at Prima.

#### Product Settings

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

For more information on what these product settings within the Prima integration are for, please refer to the [Print on Demand Product Settings](/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-integration-product-settings.md) guide.

#### Shipping Class Match

To match your shopping cart shipping method names to Prima’s shipping method names, you will need to use shipping class matches. This will allow you to tell Prima what the shipping method name you have on your orders, set in your shopping cart, should be sent as.

If your shipping method name does not match their shipping method name exactly, your default mail class will be used instead.

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

### Sending Orders to Prima

Getting your orders ready to send to Prima takes some setup time. For a detailed walkthrough of how to use Order Desk with your print on demand orders, please take a few moments to read through the [Print on Demand Fulfillment](/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-fulfillment.md) guide.

#### Preparing Your Orders

The following fields can be set as checkout data or order metadata to specify what gets sent to Prima.

| Field Name          | Field Description                                                                                                                                                                                                                         |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Currency            | Set the currency. Default is AUD.                                                                                                                                                                                                         |
| component\_code\_1  | Set the component code for the order if required. Use component\_code\_1 and component\_code\_2. Please note this is not the same as the component code for the item.                                                                     |
| component\_type\_1  | Set the component type for the order if required. Use component\_type\_1 and component\_type\_2. Please note this is not the same as the component type for the item.                                                                     |
| component\_label\_1 | Set the component label for the order if required. Use component\_label\_1 and component\_label\_2. If empty, the corresponding component code values will be used. Please note this is not the same as the component label for the item. |

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.

#### Preparing Your Items

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

| Field Name       | Field Description                                                                                                                                                                                                                      |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| print\_sku       | The Prima product code.                                                                                                                                                                                                                |
| print\_url       | The URL of your artwork file. For multi-print items, use print\_url\_1 and print\_url\_2.                                                                                                                                              |
| print\_location  | Location of the print on the product. For multi-print items, use print\_location\_1 and print\_location\_2 to correlate with the print\_urls. If not entered, we will use TEXT here. You may need to enter COVER at times if directed. |
| component\_code  | Use only if item has component parts. Can use component\_code\_1 through component\_code\_5.                                                                                                                                           |
| component\_type  | Use only if item has component parts. Can use component\_type\_1 through component\_type\_5.                                                                                                                                           |
| component\_label | Use only if item has component parts. Can use component\_label\_1 through component\_label\_5. If empty, the corresponding component\_code value will be used.                                                                         |

### Related Articles

* Print On Demand Fulfillment


---

# 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/print-on-demand/prima-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.
