# 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.

Nov 16, 2026 · New

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-designs` — List the invoice designs of a company
- `POST /v1/companies/{company_id}/invoice-designs` — Create an invoice design
- `POST /v1/companies/{company_id}/invoice-designs/preview` — Preview 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}/default` — Make an invoice design the default
- `GET /v1/companies/{company_id}/invoice-designs/{invoice_design_id}/versions` — List 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}/compliance` — Get the compliance systems of a company
- `POST /v1/companies/{company_id}/compliance/systems/{system}/activate` — Activate a compliance system for a company
- `POST /v1/companies/{company_id}/compliance/systems/{system}/deactivate` — Deactivate a compliance system of a company
- `GET /v1/companies/{company_id}/invoices/{invoice_id}/compliance-submissions` — List the compliance submissions of an invoice
- `PUT /v1/accounts/{account_id}/members/{member_id}/grants` — Replace a member's company grants

## Where to go next

- [Branding and PDFs](/guides/branding-and-pdf)
- [List invoice designs](/invoice-designs/listCompanyInvoiceDesigns)
- [Get the compliance systems](/compliance/getCompanyCompliance)
- [Compliance submissions of an invoice](/invoices/listCompanyInvoiceComplianceSubmissions)
- [Replace a member's grants](/members/replaceAccountMemberGrants)
- [International customers](/verifactu/international-customers)

---

Full OpenAPI spec: https://docs.beel.es/api/openapi