Ir al contenido

España (SIGN ES)

Detalles
RegulaciónVerifactu y SII (nacional), TicketBAI (País Vasco) y NaTicket (Navarra)
RequisitosGeneración de XML de facturas, firma criptográfica y encadenamiento, envío en tiempo real a autoridades fiscales, generación de QR
Arquitectura APIAPI especializada — diseñada específicamente para España, utiliza la Management API para la configuración de la organización
Esfuerzo de integración2-4 semanas desde cero
Característica claveUna API que cubre los sistemas de fiscalización (TicketBAI, Verifactu, NaTicket) y el e-reporting (SII) mediante una sola integración

Verifactu, TicketBAI, NaTicket y SII — todo en una API

Sección titulada «Verifactu, TicketBAI, NaTicket y SII — todo en una API»

La complejidad del marco fiscal español proviene de la coexistencia del territorio común y los territorios forales, lo que crea múltiples sistemas de cumplimiento concurrentes. Los proveedores de software que comercializan productos en España deben garantizar el cumplimiento con cada sistema aplicable. SIGN ES los gestiona todos a través de una única API:

  • Verifactu — se aplica a nivel nacional en toda España según el Real Decreto 1007/2023. No se aplica a empresas ubicadas en el País Vasco o Navarra.
  • TicketBAI — se aplica en las tres provincias del País Vasco: Álava, Bizkaia y Gipuzkoa. Cada territorio tiene su propia autoridad fiscal.
  • NaTicket — se aplica en el territorio foral de Navarra.
  • SII — sistema nacional de declaración del IVA gestionado por la Agencia Estatal de Administración Tributaria (AEAT).

SIGN ES abstrae todos estos sistemas detrás de una única superficie de API. Especificas qué regulación aplica por contribuyente, y SIGN ES se encarga del resto.

Un signer representa el dispositivo de firma y contiene el certificado utilizado para firmar facturas y recibos. Dado que fiskaly es colaborador social de la Agencia Tributaria española, podemos proporcionar el certificado de firma sin que el contribuyente tenga que aportar su propio certificado.

Un client representa un terminal POS, un dispositivo de facturación, una aplicación u otro sistema emisor similar. Cada cliente está conectado a un signer. Los clientes tienen dos estados: ENABLED y DISABLED (establecer un cliente en DISABLED es irreversible).

Las invoices son el modelo de transacción principal en SIGN ES. Hay seis tipos:

  1. Factura simplificada — solo información del emisor, hasta 400 EUR (o 3.000 EUR para casos especiales como retail, restaurantes y parkings). La más común para recibos y tickets B2C.
  2. Factura completa — información del emisor y del receptor. La más común para B2B.
  3. Factura rectificativa — corrige un error en una factura emitida anteriormente. La corrección puede hacerse por sustitución o por diferencias.
  4. Factura de enriquecimiento — añade datos del receptor a una factura emitida anteriormente.
  5. Factura externa — importa facturas previas a la integración como referencia de corrección y no se envía a la autoridad fiscal.
  6. Factura de subsanación — subsana información incorrecta, principalmente debida a errores de integración, que no requiere legalmente una factura rectificativa.

Todos los tipos de factura excepto la factura externa se firman criptográficamente, se encadenan haciendo referencia al hash de la factura anterior y se envían en tiempo real a la autoridad fiscal pertinente. Las facturas externas son solo registros de referencia: no generan XML y no se transmiten.

EscenarioDuraciónNotas
Nueva integración2-6 semanasFlujo completo: configuración de org con Management API, certificados, signers, clients, firma de facturas y envío
Añadir Verifactu a TicketBAI existente~1 semanaMisma API, diferente indicador de regulación por contribuyente
Ya en API Unificada (FR/IT)2-4 semanasArquitectura de API diferente — SIGN ES usa la Management API, no el patrón Unified

Consulta la guía diseñada específicamente para clientes de SIGN DE. Puede simplificar considerablemente su esfuerzo de integración: Para clientes de SIGN DE.

  1. Crear tu organización

    Regístrese en fiskaly HUB y crea una organización gestionada para cada contribuyente a través de la Management API, o use directamente HUB.

  2. Configurar certificados

    Crea el certificado electrónico requerido. Hable con nuestro equipo si prefiere usar uno existente. Consulta certificado electrónico y certificado de dispositivo.

  3. Crear signers y clients

    Crea un signer (certificado de firma) y un client (terminal POS) por terminal, dispositivo POS, aplicación u otro dispositivo utilizado para emitir facturas.

  4. Crear facturas

    Crea tu primera factura. SIGN ES genera el XML, lo firma, lo encadena con la factura anterior y lo envía a la autoridad fiscal. La respuesta incluye la factura firmada y su estado de transmisión.

  5. Generar códigos QR

    Cada factura debe incluir un código identificador y un código QR en el recibo impreso/mostrado. Consulta cumplimiento de facturas.

Was this page helpful?