Financials pillar · v0.16.0
invoice-received InvoiceReceived
AP invoice received from a vendor.
$id · https://corpospec.com/schemas/v0.16.0/invoice-received.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| currency | IsoCurrency | yes | ISO 4217 currency code. |
| due_at | IsoDate | yes | ISO 8601 date (YYYY-MM-DD). |
| entity | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| id | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| lines | InvoiceLine[] | yes | |
| payment_terms | string | yes | |
| received_at | IsoDate | yes | ISO 8601 date (YYYY-MM-DD). |
| status | InvoiceStatus | yes | AR invoice status. |
| supplier_invoice_number | string | yes | Vendor's invoice number (recorded as-given). |
| total_gross | number | yes | |
| total_net | number | yes | |
| total_vat | number | yes | |
| vendor | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| document | PathRef? | — | |
| is_1099_reportable | boolean? | — | US 1099 reportability flag. |
| journal_entries | PathRef[] | — | |
| payment_method | PaymentMethod? | — | |
| payments | PaymentApplication[] | — | |
| vat_deductible | boolean? | — | Whether the input VAT on this invoice is deductible (DE Vorsteuerabzug per §15 UStG). |
| withholding_tax | WithholdingTaxDecl? | — |
Definitions
Shared types referenced within this schema.
InvoiceLine
One invoice line.
type: object
InvoiceRecognitionPattern
IFRS 15 / ASC 606 revenue-recognition pattern for an invoice line.
InvoiceStatus
AR invoice status.
enum: "draft", "issued", "partially_paid", "paid", "overdue", "written_off", "credit_noted"
IsoCurrency
ISO 4217 currency code.
pattern: ^[A-Z]{3}$
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
PathRef
Path-based cross-reference relative to .corpospec/ root.
Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
PaymentApplication
Application of a bank transaction to invoice settlement.
type: object
PaymentMethod
Payment method on an outbound AP invoice.
enum: "sepa", "swift", "card", "cash", "direct_debit", "other"
WithholdingTaxDecl
Withholding-tax declaration on an AP line (US 1099 / DE Bauabzug).
type: object
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.16.0/invoice-received.schema.json