Lenguaje claro
Botones y estados en castellano de negocio: borrador, enviada, aceptada. Sin jerga técnica.
Facturación electrónica AEAT
Verifactu Facturación verificable para tu empresa WorkToCloud
Emite y registra facturas ante la AEAT con tu cuenta Manager. Empiezas en un entorno seguro de pruebas, revisas el flujo y pasas a producción cuando todo esté listo.
- Basic incluido en licencia
- Entorno de pruebas antes de Hacienda
- Panel, CRM y API
Pensado para tu día a día
Fácil, sin tecnicismos y listo en minutos
No hace falta ser informático ni conocer la AEAT al detalle. Practicas en un entorno seguro, compruebas que todo encaja y solo entonces envías a Hacienda.
Sin prisa a producción
Antes de facturar en real, usas un entorno de pruebas de la AEAT. Así detectas fallos de datos o de certificado con calma.
Sin curva técnica
Panel web para el día a día. La API y el Pack CRM son opcionales si más adelante quieres integrar.
Así se ve
El panel, de un vistazo
Facturas y estado AEAT en pantallas claras. Primero en entorno de pruebas; producción cuando tú lo decidas.
| Nº | Cliente | Importe | AEAT |
|---|---|---|---|
| F-2026/014 | Café del Puerto | 248,60 € | Aceptada |
| F-2026/013 | Taller Rueda Sur | 1.120,00 € | Aceptada |
| F-2026/012 | Clínica Alba | 86,90 € | Enviada |
1Crear factura
2Enviar a AEAT (pruebas)
3Revisar respuesta
Respuesta AEAT
Registro aceptado · huella a3f9…c21
Factura
F-2026/014
Café del Puerto · B12345678
- Base205,45 €
- IVA 21%43,15 €
- Total248,60 €
Estado
AEAT aceptada
Origen
Panel web
QR Verifactu
Puesta en marcha
Tres pasos para operar con Verifactu
-
Accede con tu cuenta Manager
Usa el email y la contraseña de WorkToCloud. Solo clientes con licencia activa.
-
Vincula empresa y certificado
Completa los datos fiscales y sube el certificado electrónico. Empiezas en un entorno seguro de pruebas.
-
Practica y pasa a producción
Recorre el flujo completo sin efecto fiscal real. Cuando te sientas cómodo, activas producción y envías a Hacienda con más seguridad.
Empieza cuando quieras
Si ya tienes licencia WorkToCloud, entra con tu cuenta Manager y completa el alta en el propio panel.
Cargando tu panel Verifactu…
Acceso WorkToCloud
Clientes registrados en WorkToCloud. Introduce las credenciales de tu cuenta Manager.
Vincular empresa a Verifactu
Tu cuenta WorkToCloud aún no está registrada aquí. Completa los datos fiscales para crear la cuenta. El certificado .p12 puedes subirlo ahora o más adelante (hasta entonces no podrás emitir ni hacer pruebas AEAT).
—
Empresa Verifactu
Certificado electrónico (.p12)
Necesario para pruebas demo, facturas y envío a la AEAT. Si aún estás tramitando el certificado, puedes subirlo más tarde.
Documentación legal
Registro de la primera aceptación de los documentos del servicio Verifactu.
- Sin aceptación registrada todavía.
Plantillas de factura
Elige el diseño de las facturas nuevas. Las ya emitidas conservan el diseño con el que se crearon. Verifct Basic incluye 2 plantillas; el resto forma parte de Verifct Pro.
Aplicaciones
Cada app es una línea de facturación (SIF) con su propio AppId, AppSecret y nº de instalación AEAT. El secret solo se muestra al crearla.
Con Verifct Basic solo puedes tener 1 aplicación. Más apps y mayor capacidad llegarán con Verifct Pro.
Guarda el AppSecret ahora (no se volverá a mostrar):
| Nombre | AppId | Estado | Modo | Último uso |
|---|
ID: —
Nº instalación AEAT: —
Numeración de facturas
Cada app tiene su propia serie. %n y solo con %Y. Se guarda al salir del campo.
Estado
Inactiva
Activa
Modo AEAT
Demo = preproducción Hacienda (cualquier origen). Real requiere pruebas demo de esta app y restringe orígenes.
Demo
Real
Orígenes autorizados
En modo real la API solo acepta estos orígenes. En demo no se aplica la restricción.
Límites de uso API
Límites de plataforma (hora y día). Si requiere aumentar los límites, al acercarse al 80 % del consumo podrá solicitar el aumento.
Pruebas demo por app
Apps en modo demo. Por defecto aparecen compactadas: pulsa el nombre para ver las pruebas. Las completadas se marcan con fecha; el icono ! solo aparece si hay errores.
Histórico de facturas
Pasa el ratón por Origen o AEAT para ver canal (API / Manual / Prueba demo) o huella.
| Fecha | Número | Tipo | Cliente | Total | Origen | App | AEAT |
|---|
Log de errores
Rechazos AEAT de facturas (p. ej. código 1239) y fallos del panel/API. No confundir con «Peticiones API».
Peticiones API
Registro de respuestas con error, orígenes no permitidos, rate limit y bloqueos. Las peticiones correctas no saturan este listado.
Blacklist de IP
IPs bloqueadas para tu empresa. También se añaden automáticamente ante abuso: origen denegado (≥12/10 min), rate limit (≥25/10 min), auth fallida (≥20/10 min) o muchos errores (≥40/5 min). Las globales de plataforma las gestiona WorkToCloud.
Qué significan F1, F2, R1, F3 y Anulación
En Verifactu cada documento lleva un código corto (F1, F2…). Indican qué tipo de factura estás emitiendo ante Hacienda.
F1 Factura completa
Es la factura “de toda la vida” a un cliente identificado: nombre, NIF/CIF y, normalmente, dirección. Sirve cuando el receptor necesita la factura para su contabilidad o para deducir el IVA.
Ejemplo: una agencia de marketing factura 2.000 € + IVA a Panadería López S.L. (CIF B12345678) por una campaña. Esa factura es F1.
F2 Factura simplificada
Es el ticket corto: no hace falta identificar al comprador con NIF. Se usa en ventas rápidas al público, con límites legales de importe (como en un TPV o un ticket de bar).
Ejemplo: una cafetería cobra 4,50 € por un café y un croissant. El ticket no lleva el NIF del cliente. Eso es F2.
R1 Factura rectificativa
Corrige una factura anterior que ya se emitió (importe, concepto, IVA…). La original no desaparece: queda en el historial y la rectificativa dice “esto cambia aquello”. Es lo habitual cuando te has equivocado o hay un abono parcial.
Ejemplo: emitiste una F1 de 121 € (100 + IVA) por un servicio, pero el cliente solo usó la mitad. Emites una R1 de −60,50 € que referencia la factura original. No hace falta “borrar” la primera.
F3 Sustitución de simplificada
Cuando alguien pide la factura “completa” a partir de un ticket F2 (por ejemplo, para presentar gastos en su empresa), emites una F3 que sustituye esa simplificada: ahora sí identifica al cliente.
Ejemplo: un cliente pide factura con NIF del ticket de 45 € del hotel. Generas una F3 que sustituye al F2 y ya aparece su CIF.
Anulación
Cancela un registro concreto ante Hacienda (como si esa factura no debiera haberse enviado). No es el camino habitual para corregir un importe: para eso está la rectificativa. La anulación encaja en casos muy concretos (por ejemplo, un ticket F2 duplicado o emitido por error el mismo día en un TPV). La normativa no limita la anulación al trimestre fiscal en curso; sí conviene hacerlo cuanto antes por la liquidación de IVA.
Ejemplo: el TPV imprimió dos veces el mismo ticket de 12 € por un fallo de red. Anulas el duplicado. Si en cambio cobraste de más y quieres devolver dinero, lo normal es una R1, no anular.
Resumen rápido
- Cliente con NIF y factura formal → F1
- Ticket sin NIF → F2
- Corregir o abonar una factura ya emitida → R1 (u otras R según el caso)
- Pasar un ticket a factura con NIF → F3
- Anular un envío erróneo concreto → Anulación (poco frecuente)
Preguntas frecuentes
Dudas técnicas, contables y de uso del panel o la API. Pulsa cada pregunta para ver la respuesta.
Ninguna FAQ coincide con ese texto.
Rechazos AEAT y correcciones
¿Qué significa el error AEAT 1239?
La Agencia Tributaria ha rechazado el bloque Destinatario (cliente): el NIF/CIF y/o la razón social no cuadran con el censo (NIF inválido, no censado, o nombre que no corresponde a ese NIF).
Si la AEAT rechaza la factura (p. ej. 1239), ¿debo anularla?
No. Un rechazo no es un alta aceptada. No hay obligación de emitir un registro de anulación “porque no se tramitó”. Lo correcto es corregir los datos y reenviar el mismo registro como subsanación.
La anulación sirve cuando el alta sí fue aceptada y quieres dejar sin efecto esa operación (p. ej. ticket duplicado).
¿Subsanación, rectificativa o anulación?
- Subsanación: el registro fue rechazado (o aceptado con errores) por un fallo de datos. Se reenvía el mismo registro corregido.
- Rectificativa (R1…): la factura ya era válida ante Hacienda y quieres corregir importe, conceptos, etc. La original no se borra.
- Anulación: cancelar un alta que sí quedó registrada y no debería haber existido.
¿Por qué veo el error en Facturas pero no en «Peticiones API»?
Los rechazos AEAT (códigos 1239, 2001…) viven en Errores → Errores y en el estado AEAT de cada factura. La subpestaña Peticiones API solo lista fallos HTTP de la API (IP no autorizada, rate limit, credenciales, blacklist…), no el detalle fiscal de la AEAT.
¿Puedo cambiar el diseño de la factura si ya envié alguna a Hacienda?
Sí para facturas futuras: la AEAT fija el registro, la huella, el QR y las menciones legales, no el diseño visual del PDF. Las facturas ya emitidas conservan la plantilla con la que se crearon; no se reescriben los PDF antiguos al cambiar de plantilla.
Panel: facturas, impuestos y plantillas
¿Qué impuestos puedo usar al crear una factura?
Por línea puedes elegir IVA (Península y Baleares), IGIC (Canarias) o IPSI (Ceuta y Melilla), con sus tipos habituales. También exenta (motivos E1–E6) o no sujeta.
¿F1 o F2 desde el panel?
- F1: factura completa con NIF/CIF del cliente.
- F2: simplificada (ticket), sin NIF del destinatario.
Elige el tipo según cómo factures en la realidad; Hacienda valida la coherencia del bloque Destinatario.
¿Cuántas plantillas tengo? ¿Qué es Verifct Pro?
Verifct Basic incluye 2 plantillas. El resto (más diseños, editor, límites ampliados, más de una app…) forma parte de Verifct Pro. Las facturas ya emitidas no cambian de plantilla al elegir otra.
¿Dónde veo la Política de Privacidad y las Condiciones?
En el registro / vinculación de la cuenta debes abrirlas y aceptarlas. En Mi Cuenta → Documentación queda el registro de esa primera aceptación (con enlace Ver). No se vuelven a pedir como botones «Abrir» en esa pantalla.
API, seguridad e IPs
¿Por qué me sale «Client IP is blocked»?
La IP está en la blacklist (manual o automática por abuso: muchos orígenes denegados, rate limit, auth fallida…). Las llamadas desde el propio panel (alta manual / demo) no deben bloquearse por IP: usan un token interno. Las llamadas externas con AppId/AppSecret sí respetan la blacklist y los orígenes autorizados en producción.
Demo vs producción: ¿qué cambia con la IP?
- Demo: puedes llamar desde casi cualquier IP; las facturas van a AEAT de preproducción.
- Real: la IP de tu servidor debe estar en orígenes autorizados y verificados de la app. Si no,
VF_IP_UNAUTHORIZED(401).
¿Puedo llamar a la API desde el navegador del cliente?
No es recomendable. El AppSecret quedaría expuesto. Llama siempre desde tu backend (PHP, Node, Java…).
¿Qué cabeceras necesito?
En cada petición: X-App-Id y X-App-Secret (o los mismos como query). La ruta debe incluir la versión, p. ej. /api/v1/invoices.
Tras crear una factura por API, ¿se envía sola a la AEAT?
El alta queda en cola del SIF. Debes invocar el flujo de process (o el que use tu integración) para remitírsela a la AEAT. En el panel, al emitir una factura manual, el process se dispara automáticamente.
Contabilidad y flujo de documentos
¿La factura rechazada cuenta como factura emitida para mi cliente?
A efectos Verifactu ante Hacienda, el registro no está aceptado. A efectos comerciales, si ya entregaste un PDF al cliente con datos erróneos, conviene corregir la documentación que le diste y, si la operación económica sigue viva, emitir la factura correcta (tras subsanar el registro o según tu procedimiento interno).
¿Puedo «borrar» una factura del histórico?
No. Los registros son inmutables. Se corrigen con subsanación, rectificativa o anulación, según el caso; el historial permanece auditable.
¿Puedo reutilizar el número de una factura anulada?
No. La anulación no libera el número: ese documento ya quedó registrado ante Hacienda (serie, número, fecha y huella). Debes continuar con el siguiente correlativo de la serie.
Si necesitas corregir importes o sustituir la operación, emite una factura rectificativa con otro número; no reutilices el de la anulada. Puede quedar un hueco en la numeración; eso es preferible a reutilizar un número ya enviado a la AEAT.
¿Cuándo uso F3?
Cuando un cliente pide factura completa a partir de un ticket F2 ya emitido: la F3 sustituye la simplificada e identifica al destinatario con NIF.
Apps, límites y demos
¿Cuántas apps puedo tener?
En Verifct Basic, normalmente una app. Más apps y cupos mayores entran en Verifct Pro (o solicitud de aumento de límite cuando te acerques al tope).
¿Para qué sirven las pruebas demo?
Validan el ciclo F1, F2, rectificativa, sustitución y anulación en entorno de prueba antes de pasar a producción. Los fallos de una prueba concreta se pueden filtrar en Errores.
* El contenido de estas FAQs —incluidas las referencias de carácter jurídico, fiscal, contable y de cumplimiento Verifactu / AEAT— se facilita a título meramente orientativo e informativo, elaborándose con la mayor diligencia y exactitud razonablemente posibles. No constituye asesoramiento profesional vinculante ni sustituye el criterio de un asesor fiscal, mercantil o jurídico cualificado. Worktocloud, S.L. y el servicio Verifactu WorkToCloud declinan toda responsabilidad por errores tipográficos, omisiones, ambigüedades, interpretaciones erróneas o defectos de redacción que pudieran derivar en una ejecución incorrecta del flujo de remisión de registros de facturación, en la omisión de pasos técnicos o procedimentales exigibles, o en cualquier perjuicio directo o indirecto derivado del uso de esta información. El obligado tributario permanece, en todo caso, como único responsable del cumplimiento normativo y de la integridad de los datos transmitidos.
Usar la API Verifactu WorkToCloud
La API vive en https://verifactu.worktocloud.es/api/v1/. Incluye siempre la versión (/v1/) en la ruta. La ruta antigua /verifactu.php/api/v1/… sigue funcionando.
Autenticación
Cada petición debe identificarse con las credenciales de una app de tu panel (Apps). Esas credenciales atan la llamada a tu empresa: solo verás y podrás operar sobre tus facturas, nunca las de otro cliente.
1. Obtén AppId y AppSecret
- En el panel, crea o abre una app.
- El AppId identifica la app de forma pública.
- El AppSecret es la clave privada: solo se muestra al crearla. Guárdalo en tu servidor; si lo pierdes, revoca la app y crea otra.
- No compartas el secret ni lo metas en código de navegador, apps móviles o repositorios públicos.
2. Envíalo en cada petición (elige una forma; ambas son válidas):
- Cabeceras (recomendado): más limpio y no deja el secret en logs de URL.
- Query: útil para pruebas rápidas con
curlo Postman.
Cabeceras (recomendado)
GET /api/v1/invoices HTTP/1.1 Host: verifactu.worktocloud.es X-App-Id: TU_APP_ID X-App-Secret: TU_APP_SECRET Accept: application/json
Query string
GET https://verifactu.worktocloud.es/api/v1/invoices?AppId=TU_APP_ID&AppSecret=TU_APP_SECRET
Ejemplo curl
curl -sS "https://verifactu.worktocloud.es/api/v1/invoices" \ -H "X-App-Id: TU_APP_ID" \ -H "X-App-Secret: TU_APP_SECRET" \ -H "Accept: application/json"
3. Demo vs real (y la IP)
- Demo / prueba: la app está en modo demo. Puedes llamar desde cualquier IP (útil para integrar). Las facturas van a AEAT de preproducción.
- Real / producción: la IP desde la que sale tu servidor debe estar en orígenes autorizados y verificados de esa app. Si no, la API responde
VF_IP_UNAUTHORIZED(HTTP 401). - Las llamadas deben hacerse desde tu backend (PHP, Java, etc.), no desde el navegador del cliente final, para no exponer el AppSecret.
Si fallan las credenciales verás códigos como VF_INVALID_CREDENTIALS o VF_APP_INACTIVE. Si falta /v1/ en la ruta: VF_API_VERSION_MISSING. El listado completo está en errores globales y en cada endpoint.
Endpoints
Pulsa un endpoint para expandir el detalle justo debajo (vuelve a pulsar para ocultarlo). En las rutas, {número} es el número de factura (p. ej. FAC2026-000001), no el id interno.
SDKs de ejemplo
Clientes listos para copiar en tu proyecto. Sustituye APP_ID / APP_SECRET por los de tu app. Base canónica: https://verifactu.worktocloud.es/api/v1.
Probar la API (simulador)
Prueba peticiones y respuestas sin llamar a la API real, sin guardar datos y sin enviar nada a Hacienda.
Respuesta simulada
Pulsa «Simular respuesta» para ver el resultado.
Panel de control
Visión global de Verifactu. Solo visible con StatusUser 3.
Peticiones API (7 días) por ruta
Tráfico API (14 días)
Ajustes de plataforma
Versión de API publicada, textos legales activos y credenciales OAuth hacia WorkToCloud. Vacío = valor de config.local.php.