Welcome to the guide on integrating Gelato Connect with Cloudprinter. This integration enables seamless communication between the two platforms, allowing you to receive orders from Cloudprinter and process them efficiently through GelatoConnect. Follow these straightforward steps to set up the integration and start handling Cloudprinter orders within minutes or hours (Vs months)
There are 3 steps to receive and process Cloudprinter orders with GelatoConnect:
Set up API integration to enable communication.
Add Cloudprinter’s product catalog to GelatoConnect.
Configure production workflows for seamless processing.
Step 1: API Integration
The first step is to connect the systems via API. This ensures orders and updates can flow between GelatoConnect and Cloudprinter.
Create Production and Signals interfaces in Cloudprinter:
In your Cloudprinter account, create a Production interface called "GelatoConnect API - Dev": Select template "Your own API". In the Host field, just specify "www.gelato.com", and in the IP addresses field, specify "184.169.223.162". Configure the rest per Cloudprinter's help instructions. Set this up to be in "test mode" and low priority so live orders don't start going through this connection
In your Cloudprinter account, create a Signals interface called "GelatoConnect Signals - Dev". Set this up to be low priority, as it is just for testing
Create Customer "Cloudprinter" in GelatoConnect:
Log in to GelatoConnect.
Navigate to the Customers section in the left-hand menu.
Click Create Customer and name the customer Cloudprinter.
Select Apply Preset for Cloudprinter to load the settings automatically.
In the popup shown, copy and paste the API keys from the Production and Signals interfaces that you created in Cloudprinter in step 1.
Authorize Communication:
GelatoConnect will generate an endpoint host when you input the API keys in the pop-up
Copy this endpoint and paste it into the Production interface "Host" field (replacing the dummy host name "www.gelato.com" you added in step 1).
Create shipping method mapping:
Create a lookup in GelatoConnect to map Cloudprinter Shipping methods to Gelato shipping methods. Use the instructions here to setup lookups. The file at the bottom of this article contains Cloudprinter shipping method UIDs and the Shipping methods they map to in GelatoConnect.
Within your order submission template you may need to replace the following row at the bottom of the template:
"shipmentMethodUid": {{ order.shipping.method|js }},with:
"shipmentMethodUid": {{ lookups({"alias": order.shipping.method}, strict=False, default="")|js }},where "alias" links to the template field set as {{alias}} within your lookup.
Once completed, the systems are synchronized. The necessary API endpoints for tasks like submitting and updating orders are pre-configured, ensuring automatic communication.
Step 2: Setting Up Cloudprinter Products
Next, you'll import Cloudprinter’s product catalog into GelatoConnect.
1. Access Product Models:
Go to the Products section in the left-hand menu and click Product Models.
Click Add from Catalog > Add from Customer, and select Cloudprinter.
2. Download Reference Files from Cloudprinter:
In a new tab, log into your Cloudprinter account.
Navigate to Product Catalog > Download References.
Download the two required files: Products Reference and Options Reference.
3. Upload the Reference Files into GelatoConnect:
Drag and drop the downloaded files into the upload area in GelatoConnect.
GelatoConnect will display all the products your Cloudprinter account is configured for.
4. Select Product Categories:
Review the product list (it will vary depending on your Cloudprinter account).
Choose the categories you plan to produce (e.g., letterheads, brochures, etc.).
5. Map Paper Types:
Select the appropriate paper types for each product.
If you have special agreements with Cloudprinter for custom stock, you can adjust the mapping here.
Otherwise, we recommend using the default mappings.
6. Generate Products and Variants:
Click Continue to generate the selected product models.
GelatoConnect will automatically create products with mapped attributes and internal product UIDs for production.
Once complete, you can view the created product and inspect details like paper mapping, finishing options, and product UIDs.
Step 3: Configuring Production Workflows
Finally, set up or update workflows to match your production capabilities.
Access Production Configuration:
Use the Production Configuration tool in GelatoConnect to define production steps (e.g., printing, lamination, binding) for each product category (e.g., business cards, stitched books).
Ensure that all Cloudprinter formats have a production configuration that is defined and active
For details guidance and a video on setting up production configuration, please check the relevant step in the onboarding guide here.
Step 4: Activate live orders from Cloudprinter
Create test orders through Cloudprinter's Test Center or by coordinating directly with the Cloudprinter team. Test the order receipt and file to ensure it is ready to produce.
Send shipping rate cards to Cloudprinter
Request the editable Cloudprinter rate card file from your GelatoConnect Implementation Manager
Fill it out and send your updated shipping rates to Cloudprinter at the start of onboarding (and annually after carrier rate changes).
Inform Cloudprinter's team about the testing process and get their consent to switch live orders to GelatoConnect.
Switch to receiving live orders in GelatoConnect:
Create a new Production interface called "GelatoConnect API - Prod". Use the same parameters as the "GelatoConnect API - Dev" connection made earlier, but use the highest priority and "Live mode" to receive the live orders.
Change any previous production interfaces to "Test mode" so orders don't go there anymore.
Create a new Signals interface called "GelatoConnect Signals - Prod". Use the same parameters as the "GelatoConnect Signals - Dev" connection made earlier, but use the highest priority to use it for live orders
📝 Not what you needed?
Help us improve this article, send us an email to [email protected] — please include the article title.