Skip to main content

Order (receiving)

Wundermart sends this request to your endpoint. You develop and host it, handle the request, and return one of the responses below within 15 seconds.

{
    "uuid": "86d03911-33dd-4a1c-86e9-b3c9673dceda",
    "order_ref": 81722,
    "supplier_sequence": 123,
    "requested_delivery_date": "2026-02-15",
    "created": "2026-01-30T12:00:00.000Z",
    "confirm_by": "2026-01-30T12:30:00.000Z",
    "products": [
        { "name": "Heineken 33cl 24x", "article_number": "122334", "quantity_ordered": 2 },
        { "name": "Mars", "article_number": "838324", "quantity_ordered": 12 }
    ]
}

products is never empty: Wundermart doesn't send an order without lines.

Attributes

NameTypeDescription
uuidstring (UUID)Identifies the order. Use it in the Confirmation and Packing slip URLs.
order_refintegerWundermart's numeric order reference.
supplier_sequenceintegerOrder sequence number for your supplier account. Can be 0.
requested_delivery_datedate or nullRequested delivery date.
createddate-timeWhen the order was drafted. Can be considerably earlier than when it's sent.
confirm_bydate-timeDeadline for your confirmation: 30 minutes after the order is sent. Use this value rather than calculating from created.
products[].namestring or nullProduct name in English, for display only.
products[].article_numberstringYour article number. Used to match lines, including in the packing slip.
products[].quantity_orderedintegerQuantity ordered, in collo.

Responses

  • 2xx (201 preferred): order accepted. You can confirm it straight away by returning: 
    { "confirm": true }
    If confirm is missing or anything other than true, Wundermart waits for a call to the Confirmation endpoint.
  • 400: the payload is incorrect; the order could not be created.
  • 503: the payload is correct, but you can't accept new orders right now. Please also contact our support desk.
  • 500: something unexpected went wrong on your side.

If you return a response body, it must be valid JSON (or leave the body empty). Any other body is treated as a failed delivery, even with a 2xx status.

If the order can't be delivered (any non-2xx response, a timeout or an unreachable endpoint), Wundermart doesn't retry it straight away. The order moves to the next scheduled order moment for that shop, which can also move the requested delivery date.

No comments to display

Back to top