Add New Purchase Invoice

Production

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

POST

/purchase_invoices{format}

Creates a purchase invoice. The request must include a PurchaseOrder object and at least one PurchaseOrderItem. Required: PurchaseOrder.supplier_id; each item requires item, unit_price, and quantity. currency_code, the invoice number, store, branch, and totals are assigned automatically when omitted. Optional Payment entries and PurchaseOrderCustomField values may be sent. Send ?send=draft to save as a draft.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢202Accepted

application/json

Created

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://.daftra.com/api2/purchase_invoices.json' \
--header 'Accept: application/json' \
--header 'apikey: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "PurchaseOrder": {
        "supplier_id": 42,
        "currency_code": "USD",
        "date": "2024-01-15"
    },
    "PurchaseOrderItem": [
        {
            "item": "Widget",
            "unit_price": 10,
            "quantity": 5,
            "product_id": 101
        }
    ],
    "Payment": [
        {
            "amount": 50,
            "date": "2024-01-15",
            "payment_method": "cash"
        }
    ]
}'

Response Example

202 - Example 1

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

GET Single Purchase Invoice

Edit Purchase Invoices