Invoice

Canonical representation of an invoice entity. Produced by ERP or billing systems on invoice lifecycle events (submitted, approved, paid, cancelled).

Properties

Field	Type	Description
invoiceId*	string	Unique invoice identifier as assigned by the source system
invoiceNumber	string	Human-readable invoice number (may differ from invoiceId)
issueDate	stringdate	Date the invoice was issued (ISO 8601)
dueDate	stringdate	Payment due date (ISO 8601)
status	enum	Current invoice status draftsubmittedapprovedpaidcancelled
supplierId	string	Identifier of the supplier or vendor
supplierName	string	Name of the supplier or vendor
customerId	string	Identifier of the customer being invoiced
customerName	string	Name of the customer being invoiced
totalAmount	objectMonetary Amount	Total invoice amount including taxes
amount*	number	The monetary value. Use the currency's standard decimal precision (e.g., 2 decimals for EUR/USD)
currency*	string	ISO 4217 currency code
taxAmount	objectMonetary Amount	Total tax amount
amount*	number	The monetary value. Use the currency's standard decimal precision (e.g., 2 decimals for EUR/USD)
currency*	string	ISO 4217 currency code
lineItems	array<object>	Individual line items on the invoice
description*	string	Description of the goods or services
quantity*	number	Quantity of items exclusiveMinimum: 0
unitPrice*	objectMonetary Amount	Price per unit
amount*	number	The monetary value. Use the currency's standard decimal precision (e.g., 2 decimals for EUR/USD)
currency*	string	ISO 4217 currency code
lineTotal	objectMonetary Amount	Total for this line (quantity x unitPrice)
amount*	number	The monetary value. Use the currency's standard decimal precision (e.g., 2 decimals for EUR/USD)
currency*	string	ISO 4217 currency code
billingAddress	objectAddress	Billing address
streetAddress	string	Street name, number, and any additional line (apt, suite, etc.)
city	string	City or locality name
stateOrProvince	string	State, province, region, or equivalent administrative division
postalCode	string	Postal or ZIP code
country*	string	ISO 3166-1 alpha-2 country code
paymentTerms	string	Payment terms (e.g., Net 30, Net 60)
purchaseOrderReference	string	Reference to the associated purchase order, if applicable