Skip to main content

Export new orders

Find orders that have not been exported yet and mark them as exported after the receiving system confirms receipt.

Step 1: Search for unexported orders​

Endpoint​

POST /v2/orders/search?expands=ORDER_ITEMS,ADDRESSES

Request​

{
  "status": ["NEW"],
  "exportStatuses": []
}

Response​

{
  "items": [
    {
      "id": 20106,
      "uuid": "019d1f2a-6cbb-7590-9f18-bf40ce127ec4",
      "status": "NEW",
      "type": "dropshipment",
      "email": "customer@example.com",
      "currency": "EUR",
      "language": "NL",
      "date": "2026-03-24T09:26:07.333Z",
      "postageData": {
        "method": "DELIVERY",
        "taxPercentage": 21,
        "gross": 5.99,
        "net": 7.25,
        "tax": 1.26,
        "partialDeliveryAllowed": "N",
        "overruled": "N"
      },
      "paymentData": {
        "net": 0,
        "gross": 0,
        "tax": 0,
        "taxPercentage": 21,
        "method": "ACCOUNT",
        "status": "UNKNOWN",
        "overruled": "N"
      },
      "total": {
        "gross": 105.97,
        "net": 128.23,
        "tax": 22.26,
        "discountValue": 0,
        "discountType": "N"
      },
      "items": [
        {
          "productId": 408,
          "sku": "#117",
          "name": "voorbeeld artikel",
          "quantity": 2,
          "originalPrice": 49.99,
          "price": 49.99,
          "priceTotal": 99.98,
          "taxPercentage": 21,
          "taxCode": "H",
          "id": 30539,
          "orderId": 20106
        }
      ],
      "addresses": [
        {
          "type": "invoice",
          "firstName": "Jan",
          "lastName": "de Vries",
          "company": "Voorbeeld B.V.",
          "street": "Keizersgracht",
          "number": "100",
          "postalCode": "1015AA",
          "city": "Amsterdam",
          "country": "NL"
        },
        {
          "type": "delivery",
          "firstName": "Jan",
          "lastName": "de Vries",
          "company": "Voorbeeld B.V.",
          "street": "Keizersgracht",
          "number": "100",
          "postalCode": "1015AA",
          "city": "Amsterdam",
          "country": "NL"
        }
      ],
      "userId": 174112,
      "exportedAt": null,
      "exportStatus": "",
      "exportMessage": null
    }
  ],
  "itemsFound": 720,
  "offset": 12,
  "page": 1,
  "pages": 60,
  "start": 1,
  "end": 12
}

Step 2: Mark the order as exported​

After the receiving system has processed the order, update it with export metadata so it does not appear in the next export run.

Endpoint​

PATCH /v2/orders/id/{id}

Request​

PATCH /v2/orders/id/20106
{
  "exportedAt": "2026-03-24T10:00:00.000Z",
  "exportMessage": "ERP order id = 12355",
  "exportStatus": "exported"
}

Response​

{
  "id": 20106,
  "status": "NEW",
  "exportedAt": "2026-03-24T10:00:00.000Z",
  "exportStatus": "exported",
  "exportMessage": "ERP order id = 12355"
}

How it works​

The search filter exportStatuses: [] matches orders where no export status has been set. After you process each order, update it with exportStatus, exportedAt and exportMessage. The next search run will exclude these orders because they no longer have an empty export status. Use the expands query parameter to include order items and addresses in the search response so you get all the data you need in a single call.

See also​