You can automatically sync orders from Orderchamp to your own fulfilment software.

Contact us at support@orderchamp.com so we can create an API token for you. With this token you can create a webhook which will call your endpoint every time an order is created or updated. We will post a minimal amount of information, you can then fetch the most recent version of the order through the API as shown below.

To automatically be notified of incoming orders or changes you can use a webhook. Make sure you only look at confirmed orders. Unconfirmed orders can still change and are often not paid. They should not be fulfilled. If you add a parameter template: INVOICING then we will add more order and invoice details to the webhook payload.

When a new order is created we'll execute the following request

When fetching orders please make sure you always filter for "confirmed" and "not cancelled" orders only. Confirmed orders are always paid and will generally no longer change.

Use the query below to fetch confirmed and uncancelled orders.

You can now fetch this order from the API using the request below. Please only request the fields you actually need.

For information on which fields you can fetch see the Order object type .

You can fulfil orders through the API. The order process goes as followed:

• A retailer places an order
• The supplier must confirm the order
  • Confirming an order means you have the requested products on stock
• You create one or multiple shipments for the products
• Per shipment you can choose a shipment method (ship yourself or use Orderchamp shipping)
• The retailer is notified about the shipment
• The order is marked as delivered & completed by the retailer

You can query our API for the orders in need of fulfilment, by passing the isFulfilled: false parameter.
In the query below we are fetching the most recent unfulfilled orders, and their products with the quantity we still need to ship.

You can also subscribe to the ORDER_CONFIRMED webhook to be automatically notified when an order has been confirmed, which usually means it is ready for fulfilment.

After you have fetched the order and the unshippedQuantity per product, you can now create a shipment.

After creating a shipment you can mark it as shipped and provide tracking details. If you have no tracking details you can use isTracked: false but it may take longer for the supplier to be paid out. You also need to specify the time you estimate it will take for the shipment to arrive at the retailer.

Ship with tracking number

Ship without tracking number

After you have placed all the products in a shipment and marked them as shipped, the order.status should now be set to AWAITING_DELIVERY. At this point the order is complete and in a few days will be marked as delivered by the retailer.

Order Portal only: We generally capture payments automatically via our partner Mollie. If you do capture payments yourself, you can manually mark orders as paid via the backoffice or the API. We do require a brief description on how the payment was captured, for your administration.

We automatically calculate a delivery date based on your lead time, available in order.estimatedDeliveryAt. If you want to update this delivery date you can do this via the backoffice or the API. By default we let the customer know by email.

Orders will contain invoices as soon as they have been paid, confirmed, or fulfilled. The moment of invoicing depends on the settings of the supplier. But you will be notified via a INVOICE_CREATED webhook, or can fetch the invoices from the order api. An invoice has a type, to describe the kind of invoice and between which parties. The different types can be found here: InvoiceType