API Docs / Operations / Invoices / Create purchase invoice

Create purchase invoice

POST /tenants/{tenant}/purchase-invoices

Creates a purchase invoice for a contact. The number is allocated in sequence; whether VAT applies follows from the parties' VAT registration; totals and, on a purchase invoice, the CIS deduction and tax status (the subcontractor's) are computed. Payments are recorded separately, on the invoice's payments child.

Parameters

NameTypeDescription
tenant* path string

The tenant code (the organisation's URL stub)

The tenant code (the organisation's URL stub)

Request Body*

{
  "date": "2024-01-01T00:00:00Z",
  "dueDate": "2024-01-01T00:00:00Z",
  "yourReference": "string",
  "theirReference": "string",
  "isDomesticReverseCharge": false,
  "contact": "string",
  "lines": [
    {
      "type": "...",
      "description": "...",
      "quantity": "...",
      "amount": "...",
      "vatRate": "..."
    }
  ]
}

Responses

201 Created
400 Bad Request
application/problem+json
401 Unauthorized – Invalid or missing API key
403 Forbidden
application/problem+json