Skip to main content
Download OpenAPI

Introduction

Welcome to the official A-Cube documentation dedicated to the Spanish market.

Use the A-Cube ES API to register Spanish taxpayers, turn every invoice they issue into a tamper-evident billing record (registro de facturación), report it to the Spanish Tax Agency (AEAT) under VERI*FACTU, and obtain the VERI*FACTU QR that makes the invoice verifiable.

VERI*FACTU is a fiscalization and e-reporting regime, not an e-invoicing one: nothing is delivered to your customer through A-Cube, and no invoice is exchanged over a network. You keep issuing and delivering the invoice yourself: the API takes it as input, builds and reports its fiscal record to AEAT, and returns the QR and verification data you must print on it.

Each company must first be registered with A-Cube as a legal entity, identified by its Spanish tax ID (NIF, NIE or CIF). Your application then submits the invoice as a structured Facturae 3.2.2 document. A-Cube validates it, builds the billing record, reports it to AEAT, and returns the record status together with the VERI*FACTU QR.

Integrating with our services lets you govern the whole process through three macro-stages:

  • Legal entity registration: registering and configuring the taxpayers whose invoices you fiscalize.
  • Billing record generation: each invoice you submit, including corrective invoices (facturas rectificativas), becomes a tamper-evident billing record (registro de alta), chained to the previous one through a hash (huella).
  • E-reporting to AEAT: every record is transmitted to AEAT automatically under the VERI*FACTU regime and tracked through its status, and you get back the QR to print on the invoice you deliver to your buyer.

What is VERI*FACTU​

VERI*FACTU is the Spanish anti-fraud regime for billing software. It requires every invoice to be produced by a compliant system that creates a tamper-evident billing record — chained to the previous one through a hash (huella) — and carries a QR code that lets anyone verify the invoice with AEAT. A-Cube operates as a remisión de registros de facturación system: it builds the records and sends them to AEAT on your behalf, so an integrated company issues verifiable invoices (facturas verificables) without running its own certified software.

The regime stems from the anti-fraud law Ley 11/2021, is developed by Real Decreto 1007/2023 (the VERI*FACTU Regulation) and its technical specification Orden HAC/1177/2024. Scope and dates are set by AEAT — see Spain mandate for who is in scope and how the obligation is phased in.

To get started:

  1. Register on the A-Cube API Platform to get your username and password for the authentication.
  2. Get a valid token, see here.
  3. Register the company (LegalEntity), see here.
  4. Prepare and send a new document, see here.
  5. Receive the uuid identifier for the newly created document in the response and store it.
  6. Read the AEAT outcome (status and errorReason) from that same response, or fetch it again later with GET /invoices/{uuid} — see Invoice lifecycle.

Environments​

  • sandbox is the environment where you can test the entire platform without paying at any time. The base URL is https://es-sandbox.api.acubeapi.com

  • production is the environment where real document issuance and tax reporting happen. The base URL is https://es.api.acubeapi.com

Authentication​

You can find all the information about the authentication here.

Choose the shortest path for what you need:​

Last updated on