Guides

Migrating from auto uploaders creation to generating uploaders manually

The option to automatically generate uploaders when placing an order will be retired at the end of Q3 2026 and will no longer be available. This page will give insights on how to switch to the standard method of uploader generation.

Uploader generation

Probo offered the option to automatically generate uploaders when placing an order.
When you use(d) this option, after you place an order this would be put in a different queue and would stay there until your customer has completed the uploaders. Then the order would be pushed to Probo.

If uploaders were not completed on time, this might result to issues on Probo side. Due to the complexity and the blackbox nature of this functionality, the option will be deprecated per the end of Q3 2026.

Migrating

The flow for your application will change a bit. At some point of in your flow, you will need to have a recent calculation_id for one or more products. This can be done after the product is added to the cart or is configured on your product page.

You can get a calculation_id via the /products/configure endpoint or the price endpoint

The configuration_id is used to generate the uploader(s) you will need.

Requesting an uploader

// POST uploaders/create
{
  "calculation_id": 92632586,
  "callback_url": "https://example.com/uploader-callback",
  "language": "nl"
}

Based on how many products there were in your calculation, you will receive a response with the uploaders per product. In this example, 2.

{
  "status": "ok",
  "message": "Uploaders created",
  "uploaders": [
    {
      "product_id": 1,
      "id": 11261013,
      "external_id": 8363848,
      "url": "https://print-uploader.com/init/11261013?token=197316687d6f0156f61102c826400496af926032fcf7d65208267b6dbed3c6d617a0bb730805d1c42996a0cf8cbcc58f76665fb09a92bf858943a35c93c0010a#nl"
    },
    {
      "product_id": 2,
      "id": 11261014,
      "external_id": 8363849,
      "url": "https://print-uploader.com/init/11261014?token=1d58a384399774f8de741ab4eb564eb9362cb001d048a98a7d4ec951b66a9694398fbe9c988222e410f261a89ab3c8eda8d887e01c9409be91c4c3b9d400c75c#nl"
    }
  ]
}

The id and external_id will be used in the order endpoint. The URL can be returned to the user for uploading the files. In the example below, you can see the change in the order endpoint.

{
  "products": [
    {
      "code": "banner-510",
      ...
      ],
      "uploaders": [
        {
          "id": 11261014,
          "external_id": 8363849
        }
      ]
    }
  ]
}

Gotchas

You cannot reuse an uploader session in different orders. Every uploader/product combination should be unique for a specific order

If an uploader does not have the status confirmed or processed, the order might not be produced on time. Use the callbacks to validate the correct statuses.