España (SIGN ES)
SIGN ES de un vistazo
Sección titulada «SIGN ES de un vistazo»| Detalles | |
|---|---|
| Regulación | Verifactu y SII (nacional), TicketBAI (País Vasco) y NaTicket (Navarra) |
| Requisitos | Generación de XML de facturas, firma criptográfica y encadenamiento, envío en tiempo real a autoridades fiscales, generación de QR |
| Arquitectura API | API especializada — diseñada específicamente para España, utiliza la Management API para la configuración de la organización |
| Esfuerzo de integración | 2-4 semanas desde cero |
| Característica clave | Una 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.
No necesita una integración separada por regulación. SIGN ES dirige cada flujo de factura conforme a la autoridad fiscal correcta según el territorio fiscal y las obligaciones del contribuyente.
Conceptos clave
Sección titulada «Conceptos clave»Signers
Sección titulada «Signers»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.
Clients
Sección titulada «Clients»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).
Invoices
Sección titulada «Invoices»Las invoices son el modelo de transacción principal en SIGN ES. Hay seis tipos:
- 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.
- Factura completa — información del emisor y del receptor. La más común para B2B.
- Factura rectificativa — corrige un error en una factura emitida anteriormente. La corrección puede hacerse por sustitución o por diferencias.
- Factura de enriquecimiento — añade datos del receptor a una factura emitida anteriormente.
- Factura externa — importa facturas previas a la integración como referencia de corrección y no se envía a la autoridad fiscal.
- 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.
Esfuerzo de integración
Sección titulada «Esfuerzo de integración»| Escenario | Duración | Notas |
|---|---|---|
| Nueva integración | 2-6 semanas | Flujo completo: configuración de org con Management API, certificados, signers, clients, firma de facturas y envío |
| Añadir Verifactu a TicketBAI existente | ~1 semana | Misma API, diferente indicador de regulación por contribuyente |
| Ya en API Unificada (FR/IT) | 2-4 semanas | Arquitectura de API diferente — SIGN ES usa la Management API, no el patrón Unified |
¿Ya es cliente de SIGN DE?
Sección titulada «¿Ya es cliente de SIGN DE?»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.
Primeros pasos
Sección titulada «Primeros pasos»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.
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.
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.
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.
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.
Documentación
Sección titulada «Documentación»Introducción
Descripción general de las regulaciones fiscales españolas y SIGN ES
Proceso de integración
Guía de integración completa de principio a fin
Cumplimiento de facturas
Formato de factura, códigos QR, códigos identificadores y reglas de colocación
Pérdida de conexión
Gestión de problemas de conectividad durante el envío en tiempo real
Glosario
Términos clave para el cumplimiento fiscal español
Was this page helpful?