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

# Blackfish Integration

Order Desk can import orders from your shopping cart(s), sync in your print details and then automatically send them on to [Blackfish](https://www.blackfishgroup.co.uk/) for fulfillment. When orders are shipped, the tracking details will be sent back to Order Desk and back to your shopping cart if your store is set up for it.

This guide explains how to set up and use the Blackfish integration.

### Setup

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

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

Alternatively, search for Blackfish from the available integration search.

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

Enter your FTP credentials from Blackfish and click to connect.

![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FUGPIcw6W5bEZw87bhMxf%2Flegacy-cc4df570bb1583c2e79a.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 Blackfish.

### Integration Settings

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

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

#### After Import, Move To

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

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 after Blackfish sends shipment details back to Order Desk.

#### Send Item Variation and Metadata to Blackfish

Check this option to send item variation and metadata to Blackfish with your orders.

#### Send Order Metadata to Blackfish

Check this option to send order metadata to Blackfish with your orders.

#### Product Settings

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

For more information on what these product settings within the Blackfish 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.

### Sending Orders to Blackfish

Getting your orders ready to send to Blackfish will take some set up time. For a detailed walkthrough of how to use Order Desk with your Print on Demand orders, please read through our [Print on Demand Fulfillment](/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-fulfillment.md) guide.

#### Preparing Your Orders

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

| Field Name    | Field Description                                                                                                                                                                            |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| PackingSlip   | URL for the PDF to be included as the packing slip with the order. Details [here](/guided-walkthroughs/templates-emails-and-order-documents/how-to-create-pdf-files-for-order-documents.md). |
| ShippingLabel | Link to the shipping label.                                                                                                                                                                  |

#### Preparing Your Items

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

| Field Name     | Field Description                                                                                                              |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| print\_sku     | Blackfish product code.                                                                                                        |
| print\_url     | Link to the artwork file. For multi-print items, use print\_url\_1 through print\_url\_5.                                      |
| print\_preview | Link to preview of artwork. If no print\_preview is set but there is an image field, that will be sent through as the preview. |
| size           | The size of the product.                                                                                                       |
| color          | The color of the product.                                                                                                      |


---

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