NewThe SII in Live, under contract
BeeL
Get startedMulti-NIFVeriFactuSIIRulesStripeAPI referenceChangelog

Invoice designs, compliance systems and replaceable member grants

Invoice designs per company and series, compliance systems with the SII under contract in Sandbox, line nature, replaceable member grants and Northern Ireland VAT numbers.


ChangelogNew

A design holds the template, accent colour, language, font, logo source and QR position of an invoice PDF. Each company has a default design, and a series can use its own with invoice_design_id (null uses the default). A change to a design creates a version: invoices issued from then on use it, issued ones keep theirs. The issued invoice reports the version it was rendered with in rendering.

A company now reports through a compliance system: VERIFACTU or SII. The SII is available under contract and for now only in Sandbox; in Live, activating it answers COMPLIANCE_SYSTEM_NOT_AVAILABLE. Each invoice lists where it stands with every system it is owed to in compliance, which is the source of truth for whether it reached the AEAT; the verifactu block only covers VeriFactu. invoice.compliance.updated is delivered when an entry changes.

The fields invoice_template_type, invoice_accent_color and invoice_language of the invoice customization are deprecated: reading returns the values of the default design, and writing changes that design, creating it when there is none. Nothing breaks for existing integrations.

What else changed

  • Invoice designs: create, read, change, delete, preview, list versions and set the default design of a company, with the privileged scopes invoice-designs:read and invoice-designs:write. A company holds at most 50 designs.
  • Compliance systems: GET /v1/companies/{company_id}/compliance shows the systems that apply, and activate and deactivate switch them. VeriFactu and the SII never apply on the same day. With the SII active, CNT-028, CNT-029 and TAX-025 apply.
  • On the invoice: compliance (one entry per system, with its status, system_status and stamps), rendering (design, version and language of the PDF) and the list of its submissions in compliance-submissions.
  • Nature of a line: the optional nature (GOODS or SERVICES) on invoice lines. It has no default: a line without it states neither.
  • Member grants in one call: PUT /v1/accounts/{account_id}/members/{member_id}/grants replaces the whole set of companies a MEMBER reaches, all or nothing. Granting one company at a time keeps working.
  • Northern Ireland: an EU VAT number (NIF_IVA) is also accepted with country GB and a number that starts with XI, intended for goods (CNT-021). A number that starts with GB is rejected.
  • New error codes starting with INVOICE_DESIGN_ and SII_, plus GRANT_COMPANY_DUPLICATED.

Endpoints

  • GET/v1/companies/{company_id}/invoice-designsList the invoice designs of a company
  • POST/v1/companies/{company_id}/invoice-designsCreate an invoice design
  • POST/v1/companies/{company_id}/invoice-designs/previewPreview an invoice design
  • GET/v1/companies/{company_id}/invoice-designs/{invoice_design_id}Get an invoice design
  • PATCH/v1/companies/{company_id}/invoice-designs/{invoice_design_id}Update an invoice design
  • DELETE/v1/companies/{company_id}/invoice-designs/{invoice_design_id}Delete an invoice design
  • PUT/v1/companies/{company_id}/invoice-designs/{invoice_design_id}/defaultMake an invoice design the default
  • GET/v1/companies/{company_id}/invoice-designs/{invoice_design_id}/versionsList the versions of an invoice design
  • GET/v1/companies/{company_id}/invoice-designs/{invoice_design_id}/versions/{version}Get a version of an invoice design
  • GET/v1/companies/{company_id}/complianceGet the compliance systems of a company
  • POST/v1/companies/{company_id}/compliance/systems/{system}/activateActivate a compliance system for a company
  • POST/v1/companies/{company_id}/compliance/systems/{system}/deactivateDeactivate a compliance system of a company
  • GET/v1/companies/{company_id}/invoices/{invoice_id}/compliance-submissionsList the compliance submissions of an invoice
  • PUT/v1/accounts/{account_id}/members/{member_id}/grantsReplace a member's company grants

Where to go next