Examples Order Status

Besides getting order statuses via webhook calls, it is also possible to manually retrieve the order status for one or more orders (max 5 per call) via the `/order/status` endpoint. With this endpoint is also possible to fetch updates of orders placed via the Probo webshops.

Tip

Whenever you can, store the Probo order id (for instance, 1230273927) in your system. When you use the API, this id will be given back to you as part of the `supplier_order_number` property. Doing this will simplify getting the latest updates related to the order.

Breakdown.

To get the order status you need to supply an array with one or more objects. This object should contain one of the following properties.

Parameter
id Your order id
supplier_order_number The probo order id
reference The (API) reference supplied by you not recommended

Example with supplier order number id for a single order.

{
  "orders": [
    {
      "supplier_order_number": "1230273927"
    }
  ]
}

     

Example with supplier order number id for a single order.

{
  "orders": [
    {
      "id": "2134123412"
    }
  ]
}

     

Example with supplier order number for several orders

{
  "orders": [
    {
      "supplier_order_number": "1230273927"
    },
    {
      "supplier_order_number": "1220557240"
    },
    {
      "supplier_order_number": "1220555109"
    }
  ]
}

     

Pointers

If you want to poll the order status we have some pointers.

  • Please be aware of your rate limits whiles polling an order status.
  • Although possible to fetch up to 5 orders, fetching the status per order is advisable.
  • The recommended interval is 30 or 60 minutes.
  • If you have a high order volume rate, we advise the usage of callbacks/webhooks in favor of polling.
Further reading