Purchase invoices
Purchase invoices
A purchase invoice is the incoming vendor invoice that creates an expense or an asset and a payable until it is paid. Purchase invoices drive VAT deduction and periodization decisions, and they are a core evidence object in bookkeeping review.
Ownership
Owner: bus invoices. This module is responsible for implementing write operations for this object and is the only module that should directly change the canonical datasets for it.
Secondary read-only use cases are provided by these modules when they consume this object for validation, matching, posting, or reporting:
bus attachments stores evidence references used by purchases. bus vat uses purchase VAT for period reporting, and bus reconcile matches payments to vendor invoices.
Actions
Record a purchase invoice registers incoming invoices as evidence and as the payable/VAT basis. Classify a purchase invoice creates posting intent split across accounts and VAT treatment decisions. Prepare purchase invoice postings turns that intent into balanced posting proposals for journal flow.
Properties
Core purchase-invoice fields are purchase_invoice_id, purchase_company_id, invoice_number, date, duedate, reference_number, and iban.
Amount and currency fields are total_sum, total_vat, total_sum_including_vat, and currency. Service-period fields are service_start_date and service_end_date.
Purchase invoices also use shared workflow and evidence fields. See accounting_status, evidence_status, and accounting_note.
Relations
A purchase invoice belongs to the workspace’s accounting entity and references one party (the supplier) via purchase_company_id.
A purchase invoice can have one or more purchase posting specifications that capture posting intent (accounts, VAT handling, and capitalizable lines) at the level where the booking decision is made.
A purchase invoice can be settled by one or more reconciliations that link a bank transaction to the invoice’s open item.
A purchase invoice can have zero or more documents (evidence) linked to it for audit navigation.