CustomCat Integration

IN THIS GUIDE

Overview
Setup
Integration Settings
Product Settings
Shipping Class Match
Sending Orders to CustomCat
How to Determine the print_sku

Overview

Order Desk can pull your print on demand orders in from your shopping cart(s), sync your print details into them, and then submit them to CustomCat. As CustomCat fulfills the orders, the shipment details will be pulled back into Order Desk and sent back to the original shopping cart if your store is set up for it.

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

Setup

To enable the integration, click on Manage Integrations in the left sidebar. Under the Print on Demand tab, find and enable the CustomCat integration.

Once enabled, you will need to go back into your CustomCat account to get your API Key.

In CustomCat, at the bottom of the Account Settings page, you will see two API Keys, a Read/Write Key and a Read-Only Key. Copy the Read/Write Key and head back into Order Desk.

Enter your Read/Write API Key from CustomCat and click to connect.

Integration Settings

Order Submission Mode

If testing, select Sandbox. When you are ready to send real orders to CustomCat, switch this to Production.

Default Mail Class

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

If you need to apply specific methods for certain orders, match your method names to CustomCat's names in the Shipping Class Match section below.

After Import, Move To

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

You can use one of the default folders already in your store or create your own. Read the Working with Folders guide for more information.

After Shipment, Move To

Select the folder you want orders to be moved into as CustomCat sends back shipment details.

Use Embedded Image DPI

Enable this option to have CustomCat use the DPI embedded in your images rather than their default of 300 DPI.

Default Return Address

Set the default return address that CustomCat should use on your shipments.

If you need to customize the return address for certain orders, you can save different return addresses to your Store Settings and then use a rule to set the return address to specific orders. If a return address is not added to the order, the default address set here in the CustomCat settings will be used.

For information on adding additional return addresses and applying them to specific orders with a rule, read the Store Settings guide.

Product Settings

For more information on what the product settings within the CustomCat integration do, please read the Print on Demand Product Settings guide.

Shipping Class Match

If the shipping methods you set up in your shopping cart(s) don't match the shipping method names CustomCat uses, they won't know what methods you intend for them to use. When this happens, the default mail classes applied above will be used instead for all of your orders.

To tell CustomCat 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 guide.

Sending Orders to CustomCat

Initially, getting your orders ready to send to CustomCat is going to take some time before everything is in place for it to happen automatically. For detailed instructions on how to use Order Desk with your print on demand orders, please take a few moments to read the print on demand fulfillment guide.

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 The CustomCat code/SKU for the item to be printed on. This can either be the Product ID or the Catalog SKU ID. If using the Product ID, you must also use the size and color variations. See below for more details.
color The color variation of the product. This must be included if using the Product ID as the print_sku and should be removed if using the Catalog SKU ID as the print_sku.
size The size variation of the product. This must be included if using the Product ID as the print_sku and should be removed if using the Catalog SKU ID as the print_sku.
print_url Link to the artwork file for the front image. print_url_1 can also be used.
print_url_2 Link to the artwork file for the back image.
print_preview_1 Link to the mockup URL for the front image. If image is on the item metadata, it will be used for print_preview_1.
print_preview_2 Link to the mockup URL for the back image.
preset_id Use if you have a preset ID value to add to the item.
print_neck_label Use if you have a neck label code to add to the item.

CustomCat can accept either the Product ID or the Catalog SKU ID for the print_sku. Let's look at each of these to learn how to set them up on your items.

Product ID

The Product ID is the ID for the top level product, which can be found from the available product links in the integration settings. 

Because this ID is the same for multiple variants of the product, if you use this as the print_sku, you must also have the size and color variations added to your item so CustomCat will know which variant of the Product ID is being ordered. 

The variations can be found by clicking on the product name from the Available Products list. For example, Product ID 999 has these variants:

Using this as an example, if you want to order the Athletic Gold variant of this product, your item details should include:

print_sku|999
Color|Athletic Gold
Size|One Size

When the order is sent to CustomCat, Order Desk will use the Product ID and the variations to find the right Catalog SKU ID and pass that through to CustomCat for you.

If you get an error from CustomCat that the SKU doesn't exist or is out of stock, make sure your variations are added to the item and that they match exactly as they are listed in the catalog.

Catalog SKU ID

The other option for the print_sku is to use the Catalog SKU ID.

If you use this ID, you should not include the variations, as they are already indicated by the Catalog SKU ID. Using the same example as above:

If you want to order the Athletic Gold variant of the product, you only need print_sku|53376 for CustomCat to accept the order and know which product you are referring to:

If you use the Catalog SKU ID and get an error from CustomCat that they can't accept the order, double check that your variations are not it the item details.

Still need help? Contact Us Contact Us