Skip to content
/
Reading orders

Reading orders

GET /orders and GET /orders/{order_id} return an order's matched line items plus order-specific metadata. Keyed by the request id — an order has a single result, so order_id == request_id. (Note: unlike a tender — which is now a nested chapters[] tree with id-only customer_id / project_id — an order returns a flat positions[] list and full customer / project objects.)

  • status — the order's workflow state: PROCESSING, NEEDS_REVIEW (metadata or line matches need a human), READY_TO_EXPORT, EXPORTED, ARCHIVED.
  • completed_at — when the order was last completed (finalised / exported), or null if it never was. Refreshed on every completion; drives the completion feed below.
  • customer — the resolved business partner (customer_id, name, address, contact person). project — object_number and name. request_custom_fields — organisation-defined custom fields on the request.
  • positions[] — one entry per line item. Each carries position_number, article_number (the catalogue match, when the line was matched), description, quantity, and unit. A line the agent could not match still appears, with its verbatim number / description and a null article_number.
  • order_metadata — the extracted order header: customer_reference (the customer's PO number), order_date, quote_number, project_number, requested_delivery_date, shipping_terms, contact_person, special_instructions, and the delivery_recipient / delivery_address (Warenempfänger) when different from the customer. Null while the order is still parsing.
  • erp_offer_id — the partner-side ERP order id when known (populated from your acknowledgement's external_id, or from a Mercura-managed ERP export).
  • acknowledgement — your last reported import outcome for this order (status, external_id, message, metadata, acknowledged_at), or null until you acknowledge it (see below).

Prices. Orders are a matching, not a pricing, workflow. Line items carry the matched article, quantity, and unit but no prices, so list_price / net_price / line_net / line_gross are null and totals are 0. The positions and order_metadata are the payload that matters. (The totals block is kept for shape-parity with tenders.)

Use modified_since on GET /orders for delta-sync catch-up scans.