Go to Dashboard

How can we help?

Popular articles Welcome to Gelato API! Getting Started Guide (Manual Orders) Getting Started Guide (Shopify integration) What hangers are a good fit for my poster size? How can I order a framed poster? What print products do you offer? Where can I find product dimensions? How can I check your product pricing? How does the sign-up promotion work? Can I claim back the VAT of my order? Why do I get charged VAT on some orders and not others? VAT on local printing and delivery within EU Where do you print locally? How quickly do you deliver? How do I estimate the pricing for shipping? Where can I find the flat rates for shipping? How do I see where a specific product is being printed? I receive an error message when I try to place an order. What should I do? Email Notification from Gelato: Order [123] is on hold - Action required Do you offer 24/7 customer support? What is you return policy and quality guarantee? How do I report a problem with my order? How do I place a manual order via the Gelato Dashboard? How do I check the order status in the Gelato Dashboard? How do I check shipping method and tracking in the Gelato Dashboard?

(For advanced users) Preparation for Automation Process

To be able to use Gelato's Automated Process for approving manual orders you will need:

  1. That the names of the files uploaded are based on Gelato's recommended file name structure
  2. An Amazon S3 Bucket to which you upload the files (how the files are uploaded there is covered in the next article) 

Preparing your files and file names

Each file needs to be named in a consistent pattern that our system can understand and process. The recommended pattern is {order_id}_{line_item_id}.<file-extension> where order id is the order id from your system (such as Shopify) and line_item_id is the position of the item in the order. In the image below the “Aurora Amazing” is #2 in the list and is, therefore, line_item_id = 2. Its file name should therefore be 1042_2.png.

Screenshot_2020-10-03_at_13.22.34.png

 

You can also use other structures such as {order_id}_PRINT_{line_item_id}.<file-extension>

The important part is that it is always the same. 

Some software that are used for approval flows in Shopify add file name additions such as “v2” or “v2_X” where X is a number indicating further iterations. For Gelato to be able to process these files need to be renamed before being sent to Gelato. If a file is sent to Gelato that doesn’t match with the pattern then that order and file will not be processed. 

For Gelato to be able to process the orders we will need the full file path, including the domain and folders, where we should look for your files. Here is an example based on the setup shown below for Amazon S3 bucket.  

https://gelato-demo.s3.eu-west-2.amazonaws.com/{order_id}_{line_item.id}.png

You should provide this file path to your account manager so it can be configured in our system.

Setting up an Amazon S3 bucket

Gelato needs to be able to access the files that are to be used in the automatic approval process via public URLs. Gelato can read your files from anywhere as long as they are publicly available and can be accessed in a structured way. If you do not have this today (for example if you use Google Drive or Dropbox as your primary cloud storage) then you can opt to setup an Amazon AWS account and use their S3 storage solution. Note that the below guide is a recommendation on how one type of setup can be done to create publicly available files that Gelato can access. However, Gelato takes no responsibility for your files as these are owned and hosted by you. You need to ensure that you have configured Amazon in way that adheres to your own security policies and who has access and who you share the file links with. 

Start by signing up to Amazon AWS. Once signed-up click to Sign-in to console. 

Screenshot_2020-10-10_at_14.24.10.png

Once signed-in type in 'S3' in the search field and select S3. 

Screenshot_2020-10-10_at_14.24.55.png

Then S3 is opened. Now you need a new bucket. The bucket is the location where your files will be stored. Click 'Create bucket'.

Screenshot_2020-10-10_at_14.25.05.png

Set a name and select which region you want your bucket to be in. 

Screenshot_2020-10-10_at_14.25.28.png

Click Next. You do not need to do any changes on Step 2. 

Screenshot_2020-10-10_at_14.25.39.png

In step 3 you need to deselect "Block all public access" and acknowledge that you understand what this means. Screenshot_2020-10-10_at_14.26.39.png

In step 4 review your settings and click 'Create bucket'.

Screenshot_2020-10-10_at_14.26.46.png

Your bucket is now created. Let's add a file to it manually. Go into the bucket and click 'Upload'. Follow the instructions and then open the file in the bucket. You will see a screen similar to the below. 

Note the Object URL path. Everything up until the file name is the domain and folder structure that you should include in your full file path for Gelato to process the orders. See the file name section for more info.

mceclip0.png

Now we need to get the access keys so that Integromat can send the files to the bucket. 

In the top right corner click on your user name and select 'My security credentials'.

Screenshot_2020-10-10_at_14.27.14.png

Choose to create a new access key under 'Access keys'

Screenshot_2020-10-10_at_14.27.28.png

Download your key file. It contains the Access key id and secret key needed to configure the S3 bucket in Integromat. 

Screenshot_2020-10-10_at_14.27.43.png

You are now done setting up your S3 bucket. You can now proceed to set up the file transfer to S3 in this article.

 

Common questions

If I have products that don't require a print file such as a frame or a hanger will the system understand there should be no print file for it?

Yes, for line items that are non-printable such as frames or hangers which don't require a print file the system will approve the order without any file. 

If you have an order with a poster and a frame as 2 line items then the system will look for the print file for the poster. Once the poster file is detected then the order will be approved and processed.

If you have an order that only has items that don't require a print file (examples being frames and hangers) then the order will be automatically approved immediately. 

Can I also use this on old orders that are not yet approved? 

Yes, you can. As long as the order status is "Pending approval", you have file names that are according to the file naming convention and that they are in the S3 bucket they will also be processed. 

Was this article helpful?
0 out of 0 found this helpful