Orders (Buyer)

Overview

As a buyer, you can retrieve your purchase orders from Consentio and create new orders on behalf of buyers via the promoted order endpoint. This enables importing purchase orders from external procurement systems into Consentio.

Endpoints

Method	Endpoint	Description
GET	/v2/partner/{workspaceID}/order	Get orders by date range
POST	/v2/partner/{workspaceID}/promoted-order	Create order on behalf of buyer

Retrieving Purchase Orders

Fetch orders using GET /order with kind=purchase and a date range (from, to in RFC3339). Optionally filter by status (accepted, pending, canceled, incomplete).

The response includes the counterpart_id, external_id, and external_status fields from the buyer's perspective.

Creating Promoted Orders

Create an order on behalf of a buyer. Provide the buyer's email and the order details (items, delivery method, dates). If the email doesn't match an existing Consentio user, an unregistered user is created automatically.

This is useful for:

• Importing orders from an external procurement or e-commerce system
• Automating recurring orders
• Creating orders for buyers who don't use the Consentio interface directly

Integration Workflow

Order Import (External System to Consentio)

sequenceDiagram
    participant Proc as Procurement System
    participant API as Consentio API

    Proc->>API: POST /promoted-order
{ buyer_email, order }
    API-->>Proc: 201 Created (order with Consentio IDs)

    Note over API: Buyer is notified

    Proc->>API: GET /order?kind=purchase&from=...&to=...
    API-->>Proc: Purchase orders with status updates

1. POST /promoted-order with the buyer email and order details
2. Consentio creates the order and notifies the buyer
3. GET /order (kind=purchase) to retrieve order status updates