Purchase invoice

Represents a vendor invoice (purchase invoice / AP bill): payable entry for a supplier with internal number, supplier invoice number (vendorInvoiceNumber), invoice and due dates, vendor, link to the purchase order (purchaseOrderId), currency, payment terms, lines with tax, and header totals. Used in AP flows, three-way match (PO–receipt–invoice), and financial ERP integration.

Full JSON example

{
  "id": "pi_5Cd8Ef1Gh4Ij7",
  "channel": "demoipaas",
  "createdAt": "2026-02-06T14:20:00+00:00",
  "updatedAt": "2026-02-06T14:20:00+00:00",
  "number": "PI-2026-00156",
  "status": "posted",
  "vendorInvoiceNumber": "FATT-XYZ-9920",
  "invoiceDate": "2026-02-05",
  "dueDate": "2026-03-22",
  "vendorId": "vend_SUPPLIER_XYZ",
  "purchaseOrderId": "po_3Bc6De9Fg2Hi5",
  "purchaseOrderNumber": "PO-2026-0045",
  "currency": "EUR",
  "paymentTerms": "Net 45",
  "lineItems": [
    {
      "position": 10,
      "itemId": "itm_RAW_STEEL_COIL",
      "description": "Bobina acciaio 2t",
      "quantity": 5,
      "unitPrice": 820,
      "taxRate": 22,
      "lineTotal": 4100
    }
  ],
  "subtotal": 4100,
  "taxTotal": 902,
  "grandTotal": 5002,
  "notes": "Allineare a ricezione merce"
}

Remarkable notes

• Totals must stay consistent with lines and tax rules on the destination; some ERPs recalculate tax and rounding.
• The purchaseOrderId link may be omitted for non-PO bills or credit notes—map per connector.
• vendorInvoiceNumber is often used for deduplication in bulk imports.