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

# Kokolo Integration

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

### Setup

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

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

Alternatively, search for Kokolo from the available integrations.

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

Enter your Kokolo User ID and Password and click to connect.

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

To find your Kokolo credentials, please contact your rep from Kokolo. **Order Desk support is not able to help with finding or resetting your Kokolo credentials**, as they are created and provided by Kokolo.

### Integration Settings

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

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

#### Environment

Select the environment the store is in, Production for live or Staging for test.

#### Default Mail Class

Choose the mail class you want Kokolo to use for orders.

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

#### After Import, Move To

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

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

#### Default Currency

Set your store’s currency here.

#### Product Settings

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

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

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

If the shipping methods you set up in your shopping cart(s) don’t match the shipping method names Kokolo uses, they won’t know what methods you intend for them to use. When this happens, the [default mail class applied above](#integration-settings) will be used instead for all of your orders.

To tell Kokolo what methods you want them to use, you will need to match your method names to theirs. This can be done in the shipping class match section. For detailed instructions on setting this up, please read through the [shipping class match](/guided-walkthroughs/shipping-fulfillment-and-returns/how-to-set-up-shipping-class-matches.md) guide.

### Sending Orders to Kokolo

Getting your orders ready to send to Kokolo 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 | Add your own shipping label to the order. Must be a JPG.                                                                                                                                     |

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.

#### Preparing Your Items

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

| Field Name                   | Field Description                              |
| ---------------------------- | ---------------------------------------------- |
| barcode                      | Set the barcode. Talk to Kokolo for specifics. |
| print\_sku                   | The style code for your apparel                |
| print\_url\_1, print\_url\_2 | Link to your artwork file.                     |
| size                         | Set the size of the produce.                   |
| color or colour              | Set the color of the product.                  |

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