Add New Purchase Order

Production

https://{{subdomain}}.daftra.com/api2

POST

/purchase_orders{format}

Creates a new purchase order.

Send a PurchaseOrder object together with a PurchaseOrderItem array; optionally include a Payment object to record an immediate payment and a PurchaseOrderCustomField array. The only hard-required fields are PurchaseOrder.supplier_id and, for each line item, item, quantity and unit_price; most other fields are defaulted automatically (currency, date, number, store, branch).

The document type and payment_status are set server-side and any client values for them are ignored. Whether the order is saved as a draft is controlled by the send query parameter, not a body field.

On success the endpoint returns HTTP 202 with { "result": "successful", "code": 202, "id": <new id> }.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢202Accepted

application/json

Purchase order created. The body carries the new purchase order id only.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://.daftra.com/api2/purchase_orders.json?send=undefined' \
--header 'Accept: application/json' \
--header 'apikey: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "PurchaseOrder": {
        "supplier_id": 45,
        "currency_code": "USD",
        "date": "30/06/2026"
    },
    "PurchaseOrderItem": [
        {
            "item": "Widget",
            "quantity": 10,
            "unit_price": 100,
            "product_id": 12
        }
    ]
}'

Response Example

202 - Example 1

{
    "result": "successful",
    "code": 202,
    "id": 123
}

GET Single Purchase Order

Edit Purchase Order