API Version 2026-03-02

Changelog

• New field invoice_lines[].base_quantity (decimal, defaults to 1) to support Price Base Quantity (BT-149), where price represents the price per base_quantity units.
• New fields tax_currency_code (ISO 4217 string) and tax_amount_in_tax_currency (decimal) for Tax Accounting Currency (BT-6 & BT-111) dual currency support.
• New field bank_accounts[].is_default (boolean) to mark one bank account per company as the default.
• Directory lookup now returns 202 Accepted with a polling URL when a participant is found in Peppol SML but not yet in the local directory.
• POST /accounts/{account}/invoices, POST /accounts/{account}/invoices/import, POST /accounts/{account}/tax_reports, POST /accounts/{account}/tax_reports/import, and POST /accounts/{account}/contacts now return 201 Created instead of 200 OK.
• Contact is_provider now defaults to true when creating contacts via API.
• Field type_document renamed to type_code for document type codes across formats (Peppol, CII, KSeF, FatturaPA).
• Field payments_on_account is now visible in GET /invoices/{invoice}
• tin_scheme and cin_scheme are now returned as zero-padded 4-character strings (e.g., "0007" instead of 7).
• All deprecated fields from v2025-10-13 have been removed.
• taxcode query parameter removed from GET /accounts/{account}/invoices; use the query parameter with tin_value=<value> instead.
• Received Facturae invoices with correction_method: "01" now return the original value instead of incorrectly returning "02".
• Polish invoices in EUR with BT-6/BT-111 tax currency data now correctly derive the exchange rate for KSeF reporting.
• New response header X-B2B-API-Request-Id returned on every logged API request for end-to-end tracing.
• New read-only fields annulled_by_id and corrected_by_id (integer, nullable) on tax reports to reference the tax report that annulled or corrected the current one.
• New KSeF-specific fields on tax reports: payment_account_name (string), purchase_order_reference (string), sales_order_reference (string), and tax_inclusive_amount_before_allowances_and_charges (decimal).
• New fields tax_report_lines[].item_seller_identifier and tax_report_lines[].item_standard_identifier (string) on TicketBAI and KSeF tax report lines for seller-assigned and standard item identifiers.
• New endpoint DELETE /attachments/:id to delete an attachment.