Supplier Integration | Gelato

Supplier Integration | Gelato

Introduction

This article has been created to show how to setup the supplier integration Kornit X has built to connect to Gelato. 

Setup

To setup the Gelato supplier integration, please head to your company and within the advanced settings head to "Supplier Integrations" and click to enable the Gelato option. This has been shown below.

When setting this up you will need to set the "Customer ID" and "API Key" which will be provided to you by Gelato themselves when you the customer sets up an account with them.

Workflow

Orders for companies with Gelato enabled that are on the status of received will be sent to Gelato every hour. The following data will be sent out for each order:

$ curl -X POST \ 

   https://order.gelatoapis.com/v3/orders \ 

   -H 'Content-Type: application/json' \ 

   -H 'X-API-KEY: {{apiKey}}' \ 

   -d '{ 

        "orderReferenceId": "{{myOrderId}}", 

        "customerReferenceId": "{{myCustomerId}}", 

        "currency": "USD", 

        "shipmentMethodUid": "express", 

        "shippingAddress": { 

             "country": "US", 

             "companyName": "Example", 

             "firstName": "Paul", 

             "lastName": "Smith", 

             "addressLine1": "451 Clarkson Ave", 

             "addressLine2": "Brooklyn", 

             "state": "NY", 

             "city": "New York", 

             "postСode": "11203", 

             "email": "apisupport@gelato.com", 

             "phone": "123456789" 

         }, 

        "items": [ 

            { 

                "itemReferenceId": "{{myItemId1}}", 

                "productUid": "cards_pf_bx_pt_110-lb-cover-uncoated_cl_4-4_hor", 

                "fileUrl": "https://s3-eu-west-1.amazonaws.com/developers.gelato.com/product-examples/test_print_job_BX_4-4_hor_none.pdf", 

                "quantity": 100 

            }, 

            { 

                "itemReferenceId": "{{myItemId2}}", 

                "productUid": "cards_pf_5r_pt_100-lb-cover-coated-silk_cl_4-4_hor", 

                "fileUrl": "https://s3-eu-west-1.amazonaws.com/developers.gelato.com/product-examples/test_print_job_5R_4-4_hor_none.pdf", 

                "quantity": 30 

            } 

        ] 

    }' 

Regarding the "shippingMethodUid", by default Gelato will pick the cheapest option. Otherwise you can specify this to either "normal" or "express".