# Factura básica Source: https://apidocs.kubifactu.com/api-reference/facturas/examples/basic Generación de un nuevo registro de facturación ## Encabezados HTTP ```http Headers HTTP theme={"dark"} Accept: application/json X-Qbikode-ClientApiKey: API-KEY de la empresa ``` ```bash cURL theme={"dark"} curl -H 'Accept: application/json' \ -H 'X-Qbikode-ClientApiKey: API-KEY de la empresa' \ … ``` ## Cuerpo JSON de la petición Se trata de la remisión de un registro de facturación de alta de una factura ordinaria por un total de `121.00€`, con un concepto por valor de `100.00€` + IVA del `21.00%`. ```json JSON theme={"dark"} { "sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7", "invoice_type_key": "F1", // Factura (art. 6, 7.2 y 7.3 del RD 1619/2012) "sender_data": { "company_name": "Empresa emisora de ejemplo", "tax_id_number": "J27290840" }, "recipients": [ { "company_name": "Empresa receptora de ejemplo", "tax_id_number": "B99014037" } ], "full_invoice_number": "2026-000001", "fiscal_year": 2026, "issue_date": "2026-01-01", "operation_description": "Factura ordinaria por entrega de mercancías.", "total_quota": 21.00, "total_amount": 121.00, "tax_breakdown": [ { "tax_type_key": "01", // Impuesto sobre el Valor Añadido (IVA) "vat_tax_regime_key": "01", // Operación de régimen general "operation_type_key": "S1", // Operación Sujeta y No exenta - Sin inversión del sujeto pasivo "tax_base": 100.00, "tax_rate": 21.00, "tax_quota": 21.00 } ] } ``` # Factura básica en diferido Source: https://apidocs.kubifactu.com/api-reference/facturas/examples/basic-deferred Generación de un nuevo registro de facturación en diferido ## Encabezados HTTP ```http Headers HTTP theme={"dark"} Accept: application/json X-Qbikode-ClientApiKey: API-KEY de la empresa ``` ```bash cURL theme={"dark"} curl -H 'Accept: application/json' \ -H 'X-Qbikode-ClientApiKey: API-KEY de la empresa' \ … ``` ## Cuerpo JSON de la petición Se trata de la remisión de un registro de facturación de alta en modo DFERIDO de una factura ordinaria por un total de `121.00€`, con un concepto por valor de `100.00€` + IVA del `21.00%`. La petición se debe hacer a la URL `…/api/invoices/deferred`. ```json JSON theme={"dark"} { "callback_url": "https://www.miservidor.com/kubifactu/callbacks/invoiceresult", // URL que apunta a tu servidor "sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7", "invoice_type_key": "F1", // Factura (art. 6, 7.2 y 7.3 del RD 1619/2012) "sender_data": { "company_name": "Empresa emisora de ejemplo", "tax_id_number": "J27290840" }, "recipients": [ { "company_name": "Empresa receptora de ejemplo", "tax_id_number": "B99014037" } ], "full_invoice_number": "2026-000001", "fiscal_year": 2026, "issue_date": "2026-01-01", "operation_description": "Factura ordinaria por entrega de mercancías.", "total_quota": 21.00, "total_amount": 121.00, "tax_breakdown": [ { "tax_type_key": "01", // Impuesto sobre el Valor Añadido (IVA) "vat_tax_regime_key": "01", // Operación de régimen general "operation_type_key": "S1", // Operación Sujeta y No exenta - Sin inversión del sujeto pasivo "tax_base": 100.00, "tax_rate": 21.00, "tax_quota": 21.00 } ] } ``` # Factura básica a extranjero UE Source: https://apidocs.kubifactu.com/api-reference/facturas/examples/basic-foreign Generación de un nuevo registro de facturación a una empresa extranjera de la UE ## Encabezados HTTP ```http Headers HTTP theme={"dark"} Accept: application/json X-Qbikode-ClientApiKey: API-KEY de la empresa ``` ```bash cURL theme={"dark"} curl -H 'Accept: application/json' \ -H 'X-Qbikode-ClientApiKey: API-KEY de la empresa' \ … ``` ## Cuerpo JSON de la petición Se trata de la remisión de un registro de facturación de alta de factura ordinaria por un total de `100.00€`, con un concepto por valor de `100.00€` exento por el artículo 21 a una empresa extranjera de la UE. ```json JSON theme={"dark"} { "sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7", "invoice_type_key": "F1", "sender_data": { "company_name": "Empresa emisora de ejemplo", "tax_id_number": "J27290840" }, "recipients": [ { "company_name": "Empresa extranjera de prueba", "other_country_code": "DE", "other_tax_id_type_key": "03", "other_tax_id_number": "L74JF44L2" } ], "full_invoice_number": "2026-000022", "fiscal_year": 2026, "issue_date": "2026-01-03", "operation_description": "Factura ordinaria por entrega de mercancías.", "total_quota": 0, "total_amount": 100.00, "tax_breakdown": [ { "tax_type_key": "01", // Impuesto sobre el Valor Añadido (IVA) "vat_tax_regime_key": "02", // Exportación "exemption_cause_key": "E2", // Exenta por el artículo 21 "tax_base": 100.00 } ] } ``` # Factura básica a extranjero fuera de la UE Source: https://apidocs.kubifactu.com/api-reference/facturas/examples/basic-foreign-non-eu Generación de un nuevo registro de facturación a una empresa extranjera de fuera de la UE ## Encabezados HTTP ```http Headers HTTP theme={"dark"} Accept: application/json X-Qbikode-ClientApiKey: API-KEY de la empresa ``` ```bash cURL theme={"dark"} curl -H 'Accept: application/json' \ -H 'X-Qbikode-ClientApiKey: API-KEY de la empresa' \ … ``` ## Cuerpo JSON de la petición Se trata de la remisión de un registro de facturación de alta de factura ordinaria por un total de `100.00€`, con un concepto por valor de `100.00€` exento por el artículo 25 a una empresa extranjera de fuera de la UE. ```json JSON theme={"dark"} { "sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7", "invoice_type_key": "F1", "sender_data": { "company_name": "Empresa emisora de ejemplo", "tax_id_number": "J27290840" }, "recipients": [ { "company_name": "Empresa extranjera de prueba", "other_country_code": "CL", "other_tax_id_type_key": "03", "other_tax_id_number": "76123456K" } ], "full_invoice_number": "2026-000022", "fiscal_year": 2026, "issue_date": "2026-01-03", "operation_description": "Factura ordinaria por entrega de mercancías.", "total_quota": 0, "total_amount": 100.00, "tax_breakdown": [ { "tax_type_key": "01", // Impuesto sobre el Valor Añadido (IVA) "vat_tax_regime_key": "02", // Exportación "exemption_cause_key": "E5", // Exenta por el artículo 25 "tax_base": 100.00 } ] } ``` # Subsanación Source: https://apidocs.kubifactu.com/api-reference/facturas/examples/correction Generación de un nuevo registro de subsanación > [!WARNING] > > Se puede subsanar cualquier dato al que el reglamento de facturación no imponga la emisión de una factura rectificativa. ## Encabezados HTTP ```http Headers HTTP theme={"dark"} Accept: application/json X-Qbikode-ClientApiKey: API-KEY de la empresa ``` ```bash cURL theme={"dark"} curl -H 'Accept: application/json' \ -H 'X-Qbikode-ClientApiKey: API-KEY de la empresa' \ … ``` ## Cuerpo JSON de la petición Para subsanar un registro debemos enviar el campo `correction_key` con el valor `S`. Este registro pasará a ser considerado el correcto. > [!NOTE] > > Esta es la subsanación que corresponde cuando la factura **ya está registrada en la AEAT**: omite `previous_rejection_key` o envíalo con el valor `N`. Si envías `previous_rejection_key = X` y en KubiFACTU consta el alta de la factura registrada en la AEAT, la API rechaza la petición con HTTP `422`. Ver [¿Cuándo no debo subsanar con rechazo previo X?](/faq#¿cuándo-no-debo-subsanar-con-rechazo-previo-x) ```json JSON theme={"dark"} { "sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7", "invoice_type_key": "F1", "correction_key": "S", "sender_data": { "company_name": "Empresa emisora de ejemplo", "tax_id_number": "J27290840" }, "recipients": [ { "company_name": "Empresa receptora de ejemplo", "tax_id_number": "B99014037" } ], "full_invoice_number": "2026-000018", "fiscal_year": 2026, "issue_date": "2026-01-03", "operation_description": "Factura ordinaria por entrega de mercancías.", "total_quota": 21.00, "total_amount": 121.00, "tax_breakdown": [ { "tax_type_key": "01", "vat_tax_regime_key": "01", "operation_type_key": "S1", "tax_base": 100.00, "tax_rate": 21.00, "tax_quota": 21.00 } ] } ``` # Subsanación con registro previo rechazado Source: https://apidocs.kubifactu.com/api-reference/facturas/examples/correction-no-previous Generación de un nuevo registro de subsanación cuando Veri*Factu ha rechazado el alta original ## Encabezados HTTP ```http Headers HTTP theme={"dark"} Accept: application/json X-Qbikode-ClientApiKey: API-KEY de la empresa ``` ```bash cURL theme={"dark"} curl -H 'Accept: application/json' \ -H 'X-Qbikode-ClientApiKey: API-KEY de la empresa' \ … ``` ## Cuerpo JSON de la petición Para subsanar un registro que ha sido rechazado anteriormente por Veri\*Factu, y que por tanto no está registrado en la AEAT, debemos enviar el campo `correction_key` con el valor `S` y el campo `previous_rejection_key` con el valor `X`. El resto de campos del registro se pueden mantener idénticos al original. > [!NOTE] > > Un fallo técnico en el envío no es un rechazo. En ese caso no se subsana: [se reenvía el mismo registro](/faq#¿qué-debo-hacer-si-no-puedo-enviar-un-registro-porque-verifactu-tiene-problemas-técnicos-de-conexión-o-no-ha-superado-las-validaciones-básicas-de-verifactu) sin modificarlo. > [!WARNING] > > Con `previous_rejection_key = X` se declara que la factura **no está registrada en la AEAT**. Si en KubiFACTU existe un alta de la misma factura (mismo número y mismo ejercicio o fecha de expedición, en la misma empresa cliente) que ya está registrada en la AEAT o que sigue pendiente de envío, la API rechaza la petición con HTTP `422`. Si la factura ya está registrada y necesitas corregirla, utiliza una [subsanación ordinaria](/api-reference/facturas/examples/correction) con `previous_rejection_key = N`. Si el alta sigue pendiente, espera a conocer su resultado. [Más información](/faq#¿cuándo-no-debo-subsanar-con-rechazo-previo-x). ```json JSON theme={"dark"} { "sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7", "invoice_type_key": "F1", "correction_key": "S", "previous_rejection_key": "X", "sender_data": { "company_name": "Empresa emisora de ejemplo", "tax_id_number": "J27290840" }, "recipients": [ { "company_name": "Empresa receptora de ejemplo", "tax_id_number": "B99014037" } ], "full_invoice_number": "2026-000018", "fiscal_year": 2026, "issue_date": "2026-01-03", "operation_description": "Factura ordinaria por entrega de mercancías.", "total_quota": 21.00, "total_amount": 121.00, "tax_breakdown": [ { "tax_type_key": "01", "vat_tax_regime_key": "01", "operation_type_key": "S1", "tax_base": 100.00, "tax_rate": 21.00, "tax_quota": 21.00 } ] } ``` ## Respuesta de error si la AEAT ya tiene la factura Si el alta original de la factura ya está registrada en la AEAT, la API responde con HTTP `422` e indica el ID en KubiFACTU del registro existente. En el endpoint de lotes, la clave del error es `invoices..previous_rejection_key`. ```json JSON theme={"dark"} { "data": { "error": { "message": "The given data was invalid.", "errors": { "previous_rejection_key": [ "AEAT already holds this invoice, so previous_rejection_key cannot be X. To correct the registered record, send the correction with previous_rejection_key N. Existing invoice ID: [9db6bb78-6799-4abb-b9a0-22d127c543ed]." ] }, "details": { "request_id": "9ded9e2c-d59e-4432-a926-652cbcfac365" } } } } ``` # Factura con IPSI Source: https://apidocs.kubifactu.com/api-reference/facturas/examples/ipsi Generación de un registro de facturación con un desglose IPSI admitido por la API ## Encabezados HTTP ```http Headers HTTP theme={"dark"} Accept: application/json X-Qbikode-ClientApiKey: API-KEY de la empresa ``` ```bash cURL theme={"dark"} curl -H 'Accept: application/json' \ -H 'X-Qbikode-ClientApiKey: API-KEY de la empresa' \ … ``` ## Cuerpo JSON de la petición Ejemplo ficticio de una factura simplificada por `104.00`, con base imponible de `100.00` e IPSI del `4.00%`. Usa una de las claves de régimen IPSI admitidas por la API; este ejemplo no representa cobertura completa de todos los regímenes IPSI. ```json JSON theme={"dark"} { "sif_id": "00000000-0000-4000-8000-000000000001", "invoice_type_key": "F2", "sender_data": { "company_name": "Empresa emisora de ejemplo", "tax_id_number": "NIF-EMISOR-EJEMPLO" }, "full_invoice_number": "2026-IPSI-000001", "fiscal_year": 2026, "issue_date": "2026-10-06", "operation_description": "Factura simplificada de ejemplo sujeta a IPSI.", "total_quota": 4.00, "total_amount": 104.00, "tax_breakdown": [ { "tax_type_key": "02", "ipsi_tax_regime_key": "01", "operation_type_key": "S1", "tax_base": 100.00, "tax_rate": 4.00, "tax_quota": 4.00 } ] } ``` # Factura en rectificativa por diferencias Source: https://apidocs.kubifactu.com/api-reference/facturas/examples/rectificative-differences Generación de una factura rectificativa por diferencias ## Encabezados HTTP ```http Headers HTTP theme={"dark"} Accept: application/json X-Qbikode-ClientApiKey: API-KEY de la empresa ``` ```bash cURL theme={"dark"} curl -H 'Accept: application/json' \ -H 'X-Qbikode-ClientApiKey: API-KEY de la empresa' \ … ``` ## Cuerpo JSON de la petición Esta factura rectifica y aplica una diferencia de importes a una factura anterior (`2026-000008`) de `100.00€` en la base imponible y de `21.00€` en el IVA aplicado. * El campo `invoice_type_key` utiliza el valor `R1` (Factura Rectificativa (Error fundado en derecho y Art. 80 Uno Dos y Seis LIVA)). * El campo `rectificative_type_key` tiene el valor `I`. * **NO se incluyen** los campos `rectified_tax_base` y `rectified_tax_quota`. * Se incluye la agrupación `rectified_invoices`. ```json JSON theme={"dark"} { "sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7", "invoice_type_key": "R1", "sender_data": { "company_name": "Empresa emisora de ejemplo", "tax_id_number": "J27290840" }, "recipients": [ { "company_name": "Empresa receptora de ejemplo", "tax_id_number": "B99014037" } ], "full_invoice_number": "2026-000015", "fiscal_year": 2026, "issue_date": "2026-01-03", "operation_description": "Factura rectificativa.", "rectificative_type_key": "I", "rectified_invoices": [ { "tax_id_number": "J27290840", "full_invoice_number": "2026-000008", "issue_date": "2026-01-02" } ], "total_quota": 21.00, "total_amount": 121.00, "tax_breakdown": [ { "tax_type_key": "01", "vat_tax_regime_key": "01", "operation_type_key": "S1", "tax_base": 100.00, "tax_rate": 21.00, "tax_quota": 21.00 } ] } ``` # Factura en rectificativa por sustitución Source: https://apidocs.kubifactu.com/api-reference/facturas/examples/rectificative-substitution Generación de una factura rectificativa por sustitución ## Encabezados HTTP ```http Headers HTTP theme={"dark"} Accept: application/json X-Qbikode-ClientApiKey: API-KEY de la empresa ``` ```bash cURL theme={"dark"} curl -H 'Accept: application/json' \ -H 'X-Qbikode-ClientApiKey: API-KEY de la empresa' \ … ``` ## Cuerpo JSON de la petición Esta factura rectifica y sustituye a una factura anterior (`2026-000008`) que tenía como base imponible `200.00€` y un IVA total de `42.00€`. La nueva factura tendrá una base imponible de `100.00€` y un IVA total de `21.00€`. * El campo `invoice_type_key` utiliza el valor `R1` (Factura Rectificativa (Error fundado en derecho y Art. 80 Uno Dos y Seis LIVA)). * El campo `rectificative_type_key` tiene el valor `S`. * Se incluyen los campos `rectified_tax_base` y `rectified_tax_quota`. * Se incluye la agrupación `rectified_invoices`. ```json JSON theme={"dark"} { "sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7", "invoice_type_key": "R1", "sender_data": { "company_name": "Empresa emisora de ejemplo", "tax_id_number": "J27290840" }, "recipients": [ { "company_name": "Empresa receptora de ejemplo", "tax_id_number": "B99014037" } ], "full_invoice_number": "2026-000014", "fiscal_year": 2026, "issue_date": "2026-01-03", "operation_description": "Factura rectificativa.", "rectificative_type_key": "S", "rectified_tax_base": 200.00, "rectified_tax_quota": 42.00, "rectified_invoices": [ { "tax_id_number": "J27290840", "full_invoice_number": "2026-000008", "issue_date": "2026-01-02" } ], "total_quota": 21.00, "total_amount": 121.00, "tax_breakdown": [ { "tax_type_key": "01", "vat_tax_regime_key": "01", "operation_type_key": "S1", "tax_base": 100.00, "tax_rate": 21.00, "tax_quota": 21.00 } ] } ``` # Factura simplificada Source: https://apidocs.kubifactu.com/api-reference/facturas/examples/simplified Generación de una factura simplificada ## Encabezados HTTP ```http Headers HTTP theme={"dark"} Accept: application/json X-Qbikode-ClientApiKey: API-KEY de la empresa ``` ```bash cURL theme={"dark"} curl -H 'Accept: application/json' \ -H 'X-Qbikode-ClientApiKey: API-KEY de la empresa' \ … ``` ## Cuerpo JSON de la petición El campo `invoice_type_key` utiliza el valor `F2` (Factura Simplificada y Facturas sin identificación del destinatario art. 6.1.d RD 1619/2012) y no se incluyen destinatarios (`recipients`) de la factura. ```json JSON theme={"dark"} { "sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7", "invoice_type_key": "F2", "sender_data": { "company_name": "Empresa emisora de ejemplo", "tax_id_number": "J27290840" }, "full_invoice_number": "2026-000010", "fiscal_year": 2026, "issue_date": "2026-01-03", "operation_description": "Factura simplificada por entrega de mercancías.", "total_quota": 42.00, "total_amount": 242.00, "tax_breakdown": [ { "tax_type_key": "01", "vat_tax_regime_key": "01", "operation_type_key": "S1", "tax_base": 200.00, "tax_rate": 21.00, "tax_quota": 42.00 } ] } ``` # Factura en sustitución de simplificada Source: https://apidocs.kubifactu.com/api-reference/facturas/examples/simplified-substitution Generación de una factura en sustitución de simplificada ## Encabezados HTTP ```http Headers HTTP theme={"dark"} Accept: application/json X-Qbikode-ClientApiKey: API-KEY de la empresa ``` ```bash cURL theme={"dark"} curl -H 'Accept: application/json' \ -H 'X-Qbikode-ClientApiKey: API-KEY de la empresa' \ … ``` ## Cuerpo JSON de la petición * El campo `invoice_type_key` utiliza el valor `F3` (Factura emitida en sustitución de facturas simplificadas facturadas y declaradas). * Se incluyen los destinatarios (`recipients`) de la factura. * Se incluye la agrupación `substituted_invoices`. ```json JSON theme={"dark"} { "sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7", "invoice_type_key": "F3", "sender_data": { "company_name": "Empresa emisora de ejemplo", "tax_id_number": "J27290840" }, "recipients": [ { "company_name": "Empresa receptora de ejemplo", "tax_id_number": "B99014037" } ], "full_invoice_number": "2026-000012", "fiscal_year": 2026, "issue_date": "2026-01-03", "operation_description": "Factura ordinaria por entrega de mercancías.", "substituted_invoices": [ { "tax_id_number": "J27290840", "full_invoice_number": "2026-000010", "issue_date": "2026-01-03" } ], "total_quota": 42.00, "total_amount": 242.00, "tax_breakdown": [ { "tax_type_key": "01", "vat_tax_regime_key": "01", "operation_type_key": "S1", "tax_base": 200.00, "tax_rate": 21.00, "tax_quota": 42.00 } ] } ``` # Conceptos básicos Source: https://apidocs.kubifactu.com/basic-concepts Conceptos básicos sobre el funcionamiento de Veri*Factu a través de KubiFACTU ## Servidores > [!WARNING] > > El servidor de producción estará disponible cuando Veri\*Factu habilite su propio servidor de producción. Las URL base de los servidores de producción y de pruebas son las siguientes: * Servidor de producción: `https://api.kubifactu.com` * Servidor de pruebas: `https://devapi.kubifactu.com` ## Autentificación Para poder procesar registros de facturación, nuestra API requiere que se identifique a la empresa emisora mediante **API-KEY**: se trata de una clave que es necesario incluir en los encabezados HTTP de las peticiones. Esta clave se puede encontrar en nuestro panel dentro de la ficha de cada empresa. Consulta la [referencia de la API](/openapi-reference/enviar-registro-de-facturación) para saber cómo incluir el encabezado HTTP de identificación de la empresa. Las empresas se pueden dar de alta bien desde el panel web (sección *Empresas*) o bien [vía API](/openapi-reference/crear-una-nueva-empresa). ## Certificados La firma de las comunicaciones con la AEAT debe firmarse con un certificado autorizado. Nosotros hacemos las veces de intermediarios, con lo que no es necesario tener un certificado para cada empresa cliente que emite registros de facturación a la AEAT. Además, **cada intermediario puede optar por usar su propio certificado** (en lugar del nuestro) para la firma de las comunicaciones. Para ello, el intermediario debe estar [registrado como apoderado o colborador social en la AEAT](https://sede.agenciatributaria.gob.es/Sede/ayuda/consultas-informaticas/colaboracion-social-ayuda-tecnica/alta-gestion-censo-colaboradores-sociales.html), concretamente en la sección de [alta y gestión en el censo de colaboradores sociales](https://www1.agenciatributaria.gob.es/wlpl/TOCS-COLA/identificaAlta.faces). ## Los registros de facturación Los registros de facturación son los envíos que se hacen a Veri\*Factu (AEAT) para el **alta, subsanación y anulación de facturas**. ## Obligatoriedad del envío de las facturas a Veri\*Factu y QR Salvo en el caso de los [registros de facturación diferidos](#registros-de-facturación-diferidos), el **registro de facturación** se genera en el momento en que la los datos de la factura son remitidos a nuestro sistema. Tras la generación del registro de facturación este se envía a Veri\*Factu (AEAT) para su validación y registro. > [!WARNING] > > La factura debe ser entregada al receptor (ya sea en versión impresa o digital) con un **QR de cotejo** que le permita verificar que la factura ha sido correctamente remitida a la AEAT. Junto al QR deberá aparecer la frase **«Factura verificable en la sede electrónica de la AEAT» o «VERI\*FACTU»**, que deberá tener un tipo de letra y tamaño bien visibles, similares a los del resto de datos de la factura. El código QR deberá tener un tamaño entre **30x30 y 40x40 milímetros**. > [!NOTE] > > El QR de cotejo lo genera nuestro servicio una vez recibida y procesada la factura adecuadamente. ## Registros de facturación diferidos La Agencia Estatal de Administración Tributaria (AEAT) impone ciertos límites al número de solicitudes que un obligado tributario (un CIF/NIF de empresa) puede realizar en un período de tiempo determinado. Actualmente, el límite predeterminado es de una solicitud cada 60 segundos. Para gestionar esto, proporcionamos dos campos de respuesta, `next_request_waiting_time` y `next_request_datetime`, que indican el tiempo de espera necesario antes de enviar otra solicitud. En caso de que se emitan múltiples registros de facturación en el margen de tiempo especificado, ofrecemos una función de **envío de registros de facturación en diferido**. En tales casos, nuestro sistema genera los datos mínimos esenciales requeridos, como códigos QR y otros elementos necesarios, para los registros de facturación. Sin embargo, en lugar de enviarlos inmediatamente a la AEAT, espera hasta que hayan transcurrido los márgenes de tiempo especificados por la AEAT para el emisor respectivo. El envío de registros de facturación en diferido se realiza utilizando los mismos datos que en los registros de facturación no-diferidos, pero apuntando a URLs diferentes. Por ejemplo: * URL de **alta** de facturas **no-diferidas**: `…/api/invoices` * URL de **alta** de facturas **diferidas**: `…/api/invoices/deferred` * URL de **anulación** de facturas **no-diferidas**: `…/api/invoices/{ID}/cancel` * URL de **anulación** de facturas **diferidas**: `…/api/invoices/{ID}/deferredcancel` Una vez el registro se ha enviado y se ha obtenido la respuesta de la AEAT, se envía la información de respuesta en formato JSON a la URL indicada en el campo `callback_url` indicado en la petición de alta o anulación de registro de facturación. Para más información consulta las correspondientes APIs de envíos y anulaciones de facturas. Un mismo registro puede generar más de un callback, por ejemplo tras una consulta o un reenvío. Correlaciona cada callback por `id` y procésalo de forma idempotente. > [!WARNING] > > En el caso de un registro de facturación "normal" se obtiene el resultado de aceptación por parte de la AEAT **de forma inmediata**, mientras que para un registro de facturación en diferido **se debe esperar** a que nuestro sistema haga el envío y se procese la respuesta de la AEAT. En este punto el registro puede ser *aceptado*, *aceptado con errores* o *rechazado*. > [!TIP] > > Si la empresa cliente no necesita emitir registros de facturación por debajo de los márgenes de tiempo indicados por la AEAT (por defecto, un registro cada 60 segundos), es más simple y directo emitir registros de facturación "normales", es decir, NO DIFERIDOS, ya que la validación por parte de la AEAT se realiza de forma directa, sin esperas ni procesos de callback. Un envío inmediato que falla y deja la cadena esperando también recibe callbacks: KubiFACTU lo reintenta por su cuenta y cada reintento llama a `callback_url` si la petición lo incluía. Con los registros diferidos, los reintentos generan callbacks adicionales del mismo registro. Ver [¿Qué es la recuperación automática de envíos?](/faq#¿qué-es-la-recuperación-automática-de-envíos) ## Sistemas informáticos de facturación (SIF) Cada registro de facturación que KubiFACTU envía a la AEAT incluye los datos del **Sistema Informático de Facturación (SIF)** con el que se ha generado: su nombre, su identificador, su versión, su número de instalación y la razón social y el NIF de su productor. En KubiFACTU esos datos se guardan en un SIF, y en cada petición eliges qué SIF usar. ### El SIF con el que empiezas Al darte de alta como intermediario, KubiFACTU crea automáticamente un **SIF de intermediario** con el nombre y el NIF de tu empresa. Con ese SIF puedes enviar los registros de facturación de todas tus empresas cliente. No necesitas crear ninguno más para empezar. ### Cómo se usa El SIF **no se asocia a ninguna empresa** en el panel. En cada petición indicas: * La empresa emisora, con su API-KEY en el encabezado `X-Qbikode-ClientApiKey`. * El SIF, con su UUID en el campo `sif_id`. El `sif_id` es el UUID que aparece en la columna **Identificador** del listado del menú **SIFs** del panel. Es distinto en el servidor de pruebas y en el de producción. ### Datos del productor La razón social y el NIF del SIF (`company_name` y `tax_id_number` en la API) identifican a su **productor**: la entidad que desarrolla el sistema de facturación con el que la empresa emite sus facturas y que firma su declaración responsable. No son los datos de la empresa emisora. Si integras tu ERP con KubiFACTU, el productor suele ser quien desarrolla ese ERP, normalmente tú como intermediario. Por eso el SIF que se crea al darte de alta lleva los datos de tu empresa. La empresa cliente solo es la productora si desarrolla su propio software de facturación. ### Tipos de SIF | | SIF de intermediario | SIF de empresa | | - | - | - | | Empresas con las que se puede usar | Cualquiera de tus empresas cliente | Solo la empresa a la que pertenece. Con otra, la API rechaza la petición con HTTP `422` | | Dónde se crea | Panel, menú **SIFs** | Panel, pestaña **SIFs** de la empresa, o [vía API](/openapi-reference/nuevo-sif-de-empresa) | | `TipoUsoPosibleMultiOT` e `IndicadorMultiplesOT` en el XML | `S` | `N` | ## Encadenamiento (trazabilidad) y SIFs La trazabilidad se refiere a que se pueda garantizar que no hay "huecos" o "saltos" en la secuencia de generación de los registros de facturación correspondientes a las facturas expedidas utilizando un determinado **Sistema Informático de Facturación (SIF)**, así como que dicha secuencia se corresponde con la de la fecha y hora de generación empleadas. Los registros de facturación se encadenan de forma independiente para cada empresa emisora dentro de cada SIF. Es decir, **existe una única cadena de registros de facturación por cada pareja de SIF y empresa emisora**. KubiFACTU calcula el encadenamiento en el servidor a partir de los registros que ya ha procesado para esa pareja. Tu integración no necesita saber cuál fue la factura anterior. La pareja de SIF y empresa también determina qué registros esperan cuando uno se atasca. Si un registro está pendiente de envío o su resultado es incierto, los siguientes de la misma empresa y el mismo SIF esperan: en los envíos síncronos, la API devuelve HTTP `409` con el código `E-INVOICE-SUBMISSION-BLOCKED`; en los diferidos, quedan en cola. Ver [¿Qué ocurre si intento enviar el siguiente registro mientras el anterior sigue pendiente?](/faq#¿qué-ocurre-si-intento-enviar-el-siguiente-registro-mientras-el-anterior-sigue-pendiente) ### Empresas distintas: basta con un SIF La Ferretería López y la Panadería Ruiz son empresas cliente del mismo intermediario y envían sus facturas con el mismo SIF de intermediario. Cada una tiene su propia cadena. Si una factura de la ferretería se queda pendiente porque la AEAT no responde, la panadería sigue enviando con normalidad. No necesitas un SIF por empresa: un registro atascado de una empresa nunca bloquea a otra. ### Una empresa con varios puntos de facturación: puede compensar separar SIFs Tienda Sol factura con el mismo CIF en dos locales, Centro y Puerto. * **Con un solo SIF**, los dos locales comparten cadena. Si una factura del local Centro se queda pendiente porque la AEAT no responde, las siguientes del local Puerto también esperan hasta que se resuelva. Eso puede tardar bastante más que la espera habitual entre envíos. * **Con un SIF por local**, cada local tiene su propia cadena. Una incidencia en el local Centro no retrasa las facturas del local Puerto. Separar SIFs no permite enviar más rápido. La [espera entre envíos](#registros-de-facturación-diferidos) que fija la AEAT va por empresa, así que los dos locales la comparten igualmente. Además, los números de factura tienen que ser únicos dentro de la empresa aunque uses SIFs distintos: cada local necesita su propia serie, por ejemplo `C-2026-000001` y `P-2026-000001`. ## Rectificaciones, subsanaciones y anulaciones 1. Si los errores detectados **tras la emisión** están previstos en el Reglamento de Obligaciones de Facturación (ROF), aprobado por el Real Decreto 1619/2012, deberá efectuarse su rectificación de acuerdo con el procedimiento que indique el ROF según el tipo de error de que se trate, lo que implica expedir nueva/s factura/s rectificativas de la factura original errónea, en la/s que se pondrán los códigos de los campos de RF qué le/s corresponda/n de entre los que se detallan en la OM HAC/1177/2024. 2. Si los errores detectados tras la emisión NO están contemplados en el ROF, pero afectan a campos del registro de facturación (RF) generado al emitir la factura (que, digamos, "no se ven" en la factura impresa, es decir, son campos "internos", como ciertas codificaciones tributarias), se debe corregir la factura original (esos datos "internos" de la misma) y se debe generar un RF de alta de subsanación de esa factura donde conste ya la nueva información que proceda. Por lo que se refiere al concepto de **subsanación**, este se produce cuando se detecta un error en algún dato del RF cuyo "arreglo" no suponga tener que emplear el procedimiento de rectificación de la factura según el ROF. En este caso, bastará con "reparación o subsanación" de los datos erróneos que había en del registro original mediante la generación de un nuevo registro de alta de subsanación (que tendrá ya los datos correctos). 3. Si los errores detectados tras la emisión NO están contemplados en el ROF ni afectan a campos del registro de facturación (RF) generado al emitir la factura, se corrige la factura original sin que sea preciso generar un nuevo RF de ningún tipo. 4. Si se considera que "toda la factura" en sí misma está mal o no debería haberse emitido, siempre que para solucionarlo no deba emplearse algún procedimiento (de rectificativa u otro) previsto en el ROF, se podrá "anular" generando para ello un RF de anulación. Con carácter general, todas las facturas emitidas, en la medida en que respondan a operaciones realmente efectuadas (como es el caso habitual) **no pueden anularse**. En el caso de que exista alguna diferencia entre lo facturado y la realidad, por ejemplo, que por un defecto de cantidades o de calidades, o por otras razones, y se deba modificar su importe, procederá la emisión de una factura rectificativa, en los términos que establece el ROF (Reglamento de Obligaciones de Facturación, aprobado por el Real Decreto 1619/2012) y la Ley y Reglamento del IVA. Esa rectificación, con carácter general, puede realizarse por medio de la sustitución de la factura inicial por una nueva factura o bien por la modificación de la factura inicial. ## ¿Qué debo hacer si no puedo enviar un registro porque Veri\*Factu me lo ha rechazado? En estos casos hay que emitir una [subsanación con registro previo rechazado](/api-reference/facturas/examples/correction-no-previous). Para subsanar un registro que ha sido rechazado anteriormente por rechazo de Veri\*Factu debemos enviar el campo `correction_key` con el valor `S` y el campo `previous_rejection_key` con el valor `X`. El resto de campos del registro se pueden mantener idénticos al original. > [!WARNING] > > No envíes `previous_rejection_key = X` si la AEAT ya tiene registrada la factura o si su alta sigue pendiente de envío: la API lo rechaza con HTTP `422`. Ver [¿Cuándo no debo subsanar con rechazo previo X?](/faq#¿cuándo-no-debo-subsanar-con-rechazo-previo-x) # Actualizaciones Source: https://apidocs.kubifactu.com/changelog Registro de actualizaciones de la documentación **2026-10-28** Recuperación automática de envíos * KubiFACTU reintenta automáticamente los envíos de altas y anulaciones que dejan la cadena esperando, también en KubiBAI. Consulta los detalles en la [FAQ de recuperación automática de envíos](/faq#¿qué-es-la-recuperación-automática-de-envíos). **2026-10-22** Actualización documental * Las respuestas de error que documentan `details.request_id`, como los errores de validación (HTTP 422), lo devuelven ahora también en producción. Es un UUID que identifica la petición; inclúyelo al contactar con soporte. Antes, en producción, `details` llegaba como `null`. * Corregida la respuesta documentada para una API-KEY no válida (HTTP 403): no incluye `code` ni `http_code`, y `details` es siempre `null`, porque la API-KEY se rechaza antes de asignar el identificador de la petición. `code` solo aparece en los errores que lo documentan, como `E-INVOICE-SUBMISSION-BLOCKED`. **2026-10-20** Actualización documental * Los registros diferidos que esperan detrás de un registro fallido o con resultado incierto de la misma empresa cliente y SIF se envían ahora con `affected_by_incidence_key = S`, aunque se crearan con `N`. KubiFACTU los marca cuando ese registro se reenvía o una consulta aclara su resultado. Antes salían con el valor con el que se crearon, y la AEAT podía aceptarlos con errores (código 2004) por el retraso. Ver [la FAQ](/faq#¿qué-ocurre-con-los-registros-diferidos-que-esperan-detrás-de-un-registro-fallido). * El campo `affected_by_incidence_key` aparece ahora en la referencia del [envío de registros de facturación](/openapi-reference/enviar-registro-de-facturación). La API ya lo aceptaba. **2026-10-19** Actualización documental * Retirada de la [FAQ](/faq) y del [endpoint de reenvío](/openapi-reference/reenviar-registro-de-facturación) la mención a reintentos automáticos de los envíos fallidos: KubiFACTU no los ofrece. Para recuperar un envío fallido o con resultado incierto, consulta el registro y, si procede, solicita su reenvío. * Tras un [reenvío](/openapi-reference/reenviar-registro-de-facturación), `vf_response_body` y `vf_error_descriptions` reflejan solo la última respuesta de la AEAT, igual que tras el envío inicial. Antes, un reenvío rechazado anteponía la respuesta y los errores nuevos a los del intento anterior. * Un timeout identificable activa ahora la [conciliación obligatoria](/faq#¿qué-significa-conciliación-obligatoria), tanto en los envíos directos como en los diferidos: KubiFACTU consulta el registro en la AEAT por sí mismo, sin reenviarlo. Mientras no obtiene un resultado definitivo, el [reenvío](/openapi-reference/reenviar-registro-de-facturación) de ese registro devuelve HTTP 409 con motivo `pending_reconciliation`. Antes, el timeout no activaba la conciliación y el reenvío por API no se bloqueaba. * Tras un timeout, `vf_response_body` queda vacío (`null`) porque la AEAT no llegó a responder; el error de conexión sigue en `vf_error_descriptions`. Cuando una [consulta](/openapi-reference/consultar-registro-de-facturación-con-veri*factu), automática o solicitada, obtiene un resultado definitivo, `vf_error_descriptions` refleja solo ese resultado: vacío si la AEAT confirma el registro o no lo encuentra, o su código y descripción si lo rechaza o lo acepta con errores. Antes conservaba los errores técnicos previos bajo «ERRORES ANTERIORES». **2026-10-08** Actualización documental * Los errores SOAP causados por el NIF o el nombre del obligado a emitir o del representante (códigos 4104, 4105, 4107, 4109, 4115, 4116, 4117, 4123 y 4124) pasan a guardarse como rechazo: `vf_post_status = success` y `vf_record_registration_status = failed`, en lugar de `failure`. Ya no se pueden reenviar ni bloquean los siguientes registros del SIF; se corrigen con una subsanación `correction_key = S` y `previous_rejection_key = X`. El resto de errores SOAP no cambia. Consulta la [FAQ](/faq#¿qué-ocurre-si-veri-factu-no-identifica-el-nif-o-el-nombre-del-emisor). * Documentado el nuevo error HTTP 422 en `previous_rejection_key` de los endpoints de creación (normales, diferidos, lotes y KubiBAI): una subsanación con `correction_key = S` y `previous_rejection_key = X` se rechaza si en KubiFACTU consta el alta de la misma factura registrada en la AEAT o pendiente de envío, porque la AEAT la rechazaría como registro duplicado (código 3000). Para corregir una factura ya registrada se usa `previous_rejection_key = N`. Consulta la [FAQ](/faq#¿cuándo-no-debo-subsanar-con-rechazo-previo-x) y el [ejemplo de subsanación con registro previo rechazado](/api-reference/facturas/examples/correction-no-previous). **2026-10-06** Actualización documental * Añadido el soporte documentado para desgloses IPSI: las nuevas peticiones con `tax_type_key: "02"` requieren `ipsi_tax_regime_key`, y las combinaciones incompatibles pueden responder con HTTP 422. La omisión de esta clave se avisa en la AEAT hasta el 31/12/2026 y se rechaza desde el 01/01/2027. Consulta la [FAQ](/faq) y el [ejemplo de factura IPSI](/api-reference/facturas/examples/ipsi). **2026-10-05** Actualización documental * Aclarado en la [FAQ](/faq) el flujo del panel para envíos Failure / Unknown: el primer clic comprueba el estado en la AEAT y, sólo tras un SinDatos válido, un segundo clic permite confirmar el reenvío. Se detallan sus diferencias con la API. * Documentado el bloqueo por conciliación obligatoria en el [endpoint de reenvío](/openapi-reference/reenviar-registro-de-facturación): HTTP 409 con motivo `pending_reconciliation` y el UUID del propio registro. Se mantienen los motivos de bloqueo por registros anteriores y la distinción entre timeout, resultado incierto y rechazo explícito. * Aclarado el significado del campo `csv` (Código Seguro de Verificación) en las respuestas y callbacks de registros de facturación: un `csv` vacío no implica que el registro no esté acreditado, porque la AEAT no lo devuelve en consultas posteriores. Para conocer el estado hay que usar `vf_record_registration_status`. Más detalle en la [FAQ](/faq). **2026-10-04** * La respuesta de `GET /api/invoices` ([listar registros de facturación con filtros](/openapi-reference/listar-registros-de-facturación-con-filtros)) incluye los totales almacenados `total_quota` y `total_amount`, y el desglose fiscal completo `tax_breakdown` en cada elemento de `data`. Los campos del desglose sin valor se devuelven como `null`. Los registros de anulación incluyen ambos totales a `0` y `tax_breakdown: []`. **2026-09-02** v1.1.12 * `tax_breakdown` pasa a ser el nombre canónico del desglose fiscal en los envíos normales y diferidos, en cada factura de los lotes (`invoices.*.tax_breakdown`) y en los endpoints KubiBAI (`invoice_data.tax_breakdown`). El nombre anterior, `lines`, continúa admitiéndose como alias de retrocompatibilidad, pero las nuevas integraciones deben utilizar `tax_breakdown`. **2026-06-30** v1.1.11 * Las respuestas actuales de registros de facturación y callbacks dejan de incluir los campos inline/Base64 `qr_image` y `xml_contents`. Para acceder a la imagen QR y al XML del registro de facturación deben usarse los campos `qr_image_url` y `xml_url`. Este cambio NO afecta a usuarios registrados antes de junio de 2026 y que se hayan mantenido activos en el sistema. **2026-05-18** v1.1.10 * Nuevos endpoints para [descargar el XML del registro de facturación](/openapi-reference/descargar-xml-del-registro-de-facturación) y [descargar la imagen QR del registro de facturación](/openapi-reference/descargar-imagen-qr-del-registro-de-facturación). Las respuestas de registros de facturación y callbacks incluyen los campos `xml_url` y `qr_image_url` para acceder a estos recursos usando el header `X-Qbikode-ClientApiKey`. **2026-02-03** v1.1.9 * Nuevo endpoint para [subir documentos de autorización e identidad](/openapi-reference/subir-documentos-de-autorización) de empresas cliente. Este endpoint permite a los intermediarios que no usan su propio certificado digital subir documentos de autorización firmados y documentos de identidad del representante legal. **2025-12-18** v1.1.8 * Se ha añadido un nuevo endpoint para [reenviar facturas](openapi-reference/reenviar-registro-de-facturación). Este endpoint es útil para registros que fallaron **por un problema técnico de conexión** (timeout, error del servidor o falta de respuesta) en el envío inicial. Se puede leer más al respecto en [nuestra FAQ](/faq#¿qué-debo-hacer-si-no-puedo-enviar-un-registro-porque-veri-factu-tiene-problemas-técnicos-de-conexión). * Las respuestas de los registros de facturación incluyen el campo `vf_response_body` con la respuesta devuelta por Veri\*factu. * El endpoint para [listar registros de facturación con filtros](openapi-reference/listar-registros-de-facturación-con-filtros) acepta un nuevo parámetro boolean `with_problems` para filtrar registros de facturación que hayan tenido cualquier tipo de problema en el registro de Veri\*Factu. **2025-12-12** v1.1.7 * Se ha añadido un nuevo endpoint para [eliminar SIFs](/openapi-reference/eliminar-sif). **2025-11-27** v1.1.6 * Se ha incluido una aclaración sobre el límite de 12 entradas del campo `tax_breakdown` y sobre cómo se deben agrupar los conceptos. **2025-10-21** v1.1.5 * Se ha incluido una aclaración sobre [cómo se debe actuar cuando no se puede enviar un registro porque Veri\*Factu lo ha rechazado](/basic-concepts#¿qué-debo-hacer-si-no-puedo-enviar-un-registro-porque-veri-factu-me-lo-ha-rechazado%3F). **2025-10-20** v1.1.4 * Las respuestas que incluyen datos de registros de facturación (altas, anulaciones, etc.) incluyen el campo `sif_id`. * La respuesta del [endpoint para consultar la validez de un NIF/CIF](/openapi-common/consultar-la-validez-de-un-nifcif) devuelve también si el NIF en cuestión es de persona física o de persona jurídica. **2025-10-17** v1.1.3 * Añadido [endpoint para listar registros de facturación con filtros](/openapi-reference/listar-registros-de-facturación-con-filtros). **2025-10-17** v1.1.3 * Añadido [endpoint para obtener datos de una empresa](/openapi-reference/obtener-datos-de-empresa). **2025-10-15** v1.1.3 * Añadido campo [`client_invoice_id`](/openapi-reference/enviar-registro-de-facturación#body-client-invoice-id) a la creación de registros de facturación para poder espcificar el identificador único de la factura **dentro del sistema del cliente** y poder hacer referencia a ella en sucesivas consultas sobre la factura. **2025-10-10** v1.1.2 * Documentación con [indicaciones para el paso al entorno de producción](/toproduction) para consultar la validez de un NIF/CIF. **2025-09-29** v1.1.1 * Nuevo [endpoint para consulta NIF/CIF con el Web Service de Calidad de datos identificativos de la AEAT](/openapi-common/consultar-la-validez-de-un-nifcif) para consultar la validez de un NIF/CIF. **2025-09-24** v1.1.1 * Nuevo [endpoint para buscar registros de facturación por año fiscal y número de factura](/openapi-common/buscar-registros-de-facturación). * Se han añadido más campos a la respuestas de registros de facturación: `issue_date`, `created_at` y `csv` (Código Seguro de Verificación). **2025-08-25** v1.1.1 * Nuevo parámetro [use\_batched\_callbacks](openapi-reference/enviar-registro-de-facturación#body-use-batched-callbacks) para procesar los callbacks de las facturas en grupo en lugar de hacerlo de una en una. **2025-08-11** v1.1.0 * Nuevo [endpoint para obtener el estado de un registro de facturación](/openapi-reference/consultar-registro-de-facturación-con-veri*factu) haciendo previamente una consulta a Veri\*Factu. * Nuevo [endpoint para el envío de facturas en lote](/openapi-reference/enviar-registros-de-facturación-en-lote) disponible en **entorno de pruebas**. **2025-07-22** v1.0.1 * Soporte para creación de SIFs de empresa con datos extranjeros. **2025-07-16** v1.0.0 * Corrección en documentación del campo `vat_tax_regime_key` al dar de alta registros de facturación. **2025-06-06** v0.2.3 * Información adicional sobre [rectificaciones, subsanaciones y anulaciones](/basic-concepts#rectificaciones%2C-subsanaciones-y-anulaciones). **2025-05-20** v0.2.2 * Se ha añadido el campo `record_type` a la información de los registros de facturación que devuelve la API. **2025-04-25** v0.2.1beta * Nevo endpoint para obtener información de un factura concreta. * La información sobre registros de facturación incluye el campo `xml_contents` con los contenidos del XML enviado a Veri\*Factu. **2025-04-08** v0.2.0beta * Información referente a los [registros de facturación en diferido](/basic-concepts#registros-de-facturación-diferidos). * Nuevos endpoints para el envío de registros de facturación en diferido de **creación** y de **anulación**. **2025-04-01** v0.1.1beta En las respuestas para los envíos de nuevos registros de facturación y anulaciones de facturas se añaden los campos `next_request_waiting_time` y `next_request_datetime` para indicar el tiempo de espera desde la última petición y la fecha y hora a la que se puede realizar otro envío para la empresa cliente. **2025-03-26** v0.1.0beta Ya no es necesario gestionar certificados por cada empresa cliente. KubiFactu hace las veces de intermediario con lo que ya no es necesario enviar la contraseña de certificado en las peticiones. Los endpoints de actualización de datos de empresas han sido actualizados para obviar la información referente al certificado. **2025-03-25** v0.0.1beta En la respuesta del endpoint ***Enviar registro de facturación*** los campos `qr_value` y `qr_image` pueden ser `null`. Esto ocurre cuando la factura ha sido rechazada por VeriFactu. **2025-01-08** v0.0.1beta Versión inicial de la documentación en fase Beta. # Preguntas frecuentes Source: https://apidocs.kubifactu.com/faq Preguntas frecuentes sobre el funcionamiento de Veri*Factu a través de KubiFACTU ## ¿Qué datos deben incluirse en la factura se entrega al cliente? La factura debe ser entregada al receptor (ya sea en versión impresa o digital) con un QR de cotejo que le permita verificar que la factura ha sido correctamente remitida a la AEAT. Junto al QR deberá aparecer la frase **«Factura verificable en la sede electrónica de la AEAT»** o **«VERI\*FACTU»**, que deberá tener un tipo de letra y tamaño bien visibles, similares a los del resto de datos de la factura. El código QR deberá tener un tamaño entre **30x30 y 40x40 milímetros**. ## ¿Necesito crear un SIF para cada empresa? No. Al darte de alta, KubiFACTU crea un SIF de intermediario que puedes usar con todas tus empresas cliente. No hay que asociarlo a ninguna empresa: en cada petición indicas la empresa emisora con su API-KEY y el SIF con `sif_id`. Cada pareja de empresa y SIF tiene su propia cadena, así que un registro atascado de una empresa no bloquea a las demás aunque compartan SIF. Un SIF adicional puede compensar cuando una misma empresa factura desde varios puntos, por ejemplo dos locales, y quieres que una incidencia en uno no retrase las facturas del otro. Ver [Sistemas informáticos de facturación (SIF)](/basic-concepts#sistemas-informáticos-de-facturación-sif) y [Encadenamiento (trazabilidad) y SIFs](/basic-concepts#encadenamiento-trazabilidad-y-sifs). ## ¿Qué debo hacer si cuando Veri\*Factu "rechaza" una de mis facturas? En estos casos hay que emitir una [subsanación CON registro previo rechazado](/api-reference/facturas/examples/correction-no-previous). Para subsanar un registro que ha sido ***rechazado*** anteriormente por Veri\*Factu debemos enviar el campo `correction_key` con el valor `S` y el campo `previous_rejection_key` con el valor `X`. También deberán modificarse los campos que deban ser corregidos. > [!WARNING] > > Solo debe utilizarse la subsanación cuando la AEAT haya ***rechazado*** o ***aceptado con errores*** el registro de forma explícita. Ver [valores posible para `vf_record_registration_status`](/openapi-reference/enviar-registro-de-facturación#response-data-vf-record-registration-status-one-of-0). > [!WARNING] > > No envíes `previous_rejection_key = X` si la AEAT ya tiene registrada la factura o si su alta sigue pendiente de envío: la API lo rechaza con HTTP `422`. Ver [¿Cuándo no debo subsanar con rechazo previo X?](#¿cuándo-no-debo-subsanar-con-rechazo-previo-x) ### Caso de ejemplo Dado la secuencia de facturas F4 → F5 → F6, donde cada factura se genera encadenada a la anterior. El resultado del envío es: * F4: **Aceptada**, encadenada a la factura del emisor anteriormente procesada por el SIF. Probablemente la F3. * F5: **Recibida, pero rechazada** (no queda registrada en la AEAT). Encadenada a F4. * F6: **Aceptada**. Encadenada a F5. F6 apunta a F5, aunque F5 no exista en la AEAT como registro válido, al haber sido rechazado. Esto es válido y está contemplado por el sistema, ya que la AEAT entiende que F5 existió pero fue rechazada y que se ha subsanado o se va a subsanar como indicamos a continuación. En este punto hay que generar un **registro de subsanación por rechazo previo** de F5 con: * `previous_rejection_key = X` * `correction_key = S` El registro de subsanación de F5 se encadena al último registro válido del emisor, existente en el SIF en ese momento. En este ejemplo sería F6. ### ¿Cuándo no debo subsanar con rechazo previo X? Con `previous_rejection_key = X` se declara que la factura **no está registrada en la AEAT**. Si la AEAT ya tiene un alta o una anulación de esa factura, rechaza la subsanación como registro duplicado (código 3000). Para evitarlo, KubiFACTU comprueba si ya existe un alta de la misma factura (mismo número y mismo ejercicio o fecha de expedición, en la misma empresa cliente) y rechaza la petición con HTTP `422` y el error en `previous_rejection_key` (`invoices..previous_rejection_key` en los lotes) en estos casos: * **El alta original ya está registrada en la AEAT** (`vf_record_registration_status` = `success`, `accepted_with_errors` o `cancelled`). No envíes `X`: si necesitas corregir su contenido, envía una [subsanación ordinaria](/api-reference/facturas/examples/correction) con `correction_key = S` y `previous_rejection_key = N` (u omitido). * **El alta original sigue pendiente de envío.** Espera a conocer su resultado, mediante el `callback_url` o [consultando el registro](/openapi-reference/consultar-registro-de-facturación-con-veri*factu), y decide después cómo subsanarla. La subsanación con `X` sigue admitiéndose cuando el alta original fue **rechazada** (`failed`), **no está registrada** (`not_registered`) o no existe en KubiFACTU. ## ¿Qué debo hacer cuando Veri\*Factu "acepta con errores" una de mis facturas? En estos casos hay que emitir una subsanación ordinaria, es decir, una [subsanación SIN registro previo rechazado](/api-reference/facturas/examples/correction). Para subsanar un registro que ha sido ***aceptado con errores*** por Veri\*Factu debemos enviar el campo `correction_key` con el valor `S` y **hay que obviar** el campo `previous_rejection_key` (o enviarlo con el valor `N`). También deberán modificarse los campos que deban ser corregidos. > [!WARNING] > > Solo debe utilizarse la subsanación cuando la AEAT haya ***rechazado*** o ***aceptado con errores*** el registro de forma explícita. Ver [valores posible para `vf_record_registration_status`](/openapi-reference/enviar-registro-de-facturación#response-data-vf-record-registration-status-one-of-0). ### Caso de ejemplo Dado la secuencia de facturas F4 → F5 → F6, donde cada factura se genera encadenada a la anterior. El resultado del envío es: * F4: **Aceptada**, encadenada a la factura del emisor anteriormente procesada por el SIF. Probablemente la F3. * F5: **Aceptada con errores** (queda registrada en la AEAT). Encadenada a F4. * F6: **Aceptada**. Encadenada a F5. En este punto hay que generar un **registro de subsanación** de F5 con: * `correction_key = S` El registro de subsanación de F5 **es un registro independiente del de alta** y se encadena al último registro válido del emisor, existente en el SIF en ese momento. En este ejemplo sería F6. ## ¿Qué debo hacer si no puedo enviar un registro porque VeriFactu tiene problemas técnicos de conexión o no ha superado las validaciones básicas de VeriFactu? Si el envío falla por un problema técnico de conexión con Veri\*Factu o por no superar sus validaciones básicas, **no debes modificar el registro ni generar otra alta o anulación de la misma factura**. El reenvío del mismo registro conserva su UUID, identidad, huella y encadenamiento originales. La excepción son los errores en el NIF o el nombre del emisor o del representante: reenviar no los resuelve y se tratan como un rechazo. Ver [¿Qué ocurre si Veri\*Factu no identifica el NIF o el nombre del emisor?](#¿qué-ocurre-si-veri-factu-no-identifica-el-nif-o-el-nombre-del-emisor) `vf_post_status = failure` indica un fallo de envío o una respuesta de error; **no demuestra por sí solo que la AEAT no haya recibido el registro**. Un timeout identificable se guarda con `vf_post_status = failure` y `vf_record_registration_status = unknown`, tanto en los envíos directos como en los diferidos, y activa la [conciliación obligatoria](#¿qué-significa-conciliación-obligatoria): KubiFACTU consulta el registro en la AEAT por sí mismo y, mientras no obtiene un resultado definitivo, el reenvío queda bloqueado. No se reclasifican masivamente los registros históricos. ### ¿Qué es la recuperación automática de envíos? KubiFACTU reintenta por su cuenta los envíos que dejan esperando la cadena de una empresa cliente y un SIF. Se aplica a altas y anulaciones, tanto inmediatas como diferidas, también en KubiBAI. Ante un fallo temporal, no necesitas consultar ni reenviar el registro. Si hay dudas sobre si la AEAT lo recibió, KubiFACTU lo comprueba antes de reenviarlo. Mientras se resuelve la incidencia, los siguientes registros de la misma cadena [esperan su turno](#¿qué-ocurre-si-intento-enviar-el-siguiente-registro-mientras-el-anterior-sigue-pendiente). Puedes seguir la recuperación mediante el objeto `recovery` y los callbacks. El estado `resolved` indica que la recuperación ha terminado; el resultado de la AEAT se consulta en `vf_record_registration_status`. Si el registro pasa a `attention`, necesita intervención. Revisa el motivo indicado, corrige la causa y solicita el [reenvío del mismo registro](/openapi-reference/reenviar-registro-de-facturación). No modifiques el registro ni generes otra alta o anulación de la misma factura. Si necesitas ayuda, contacta con [soporte@kubifactu.com](mailto:soporte@kubifactu.com). KubiFACTU avisa por correo al intermediario cuando hace falta intervenir o la incidencia se prolonga. Los registros históricos que no están en recuperación automática (`recovery: null`) y mantienen bloqueada la cadena requieren consulta y reenvío manual. Para los campos de la respuesta y los callbacks, consulta la [referencia de la API](/openapi-reference/enviar-registro-de-facturación) y las [diferencias con KubiBAI](/kubibai-differences#fallos-de-envío-en-el-alta-inmediata). ### ¿Cómo compruebo el resultado desde el panel? Tras un timeout, la conciliación obligatoria se encarga de comprobar el resultado. Si aun así un registro queda con el envío en **Failure** y el registro en **Unknown**, sin conciliación obligatoria pendiente, por ejemplo un registro histórico, el botón de reenvío conserva su visibilidad, pero requiere dos acciones separadas: 1. En el primer clic, la confirmación dice **«Sí, comprobar estado»**. Sólo consulta a la AEAT; no reenvía. 2. Si la consulta confirma el registro con su identidad y huella, actualiza su estado y evita el reenvío. Si devuelve un **SinDatos válido**, guarda **«No registrado»** (`not_registered`) y permite confirmar el reenvío mediante un segundo clic. Por ejemplo, la factura histórica F5 está en Failure / Unknown sin conciliación pendiente. Pulsas reenviar y confirmas «Sí, comprobar estado». Si la AEAT confirma F5, el proceso termina sin otro envío. Si responde SinDatos válido, revisas el nuevo estado «No registrado» y vuelves a pulsar reenviar para confirmar el envío del mismo registro. Si la consulta falla, es ambigua, carece de huella o no coincide con el registro consultado, **no se reenvía** y se mantiene la necesidad de comprobación. Un rechazo confirmado se guarda como rechazo; no equivale a aceptación y debe seguir el [procedimiento de subsanación por rechazo](/api-reference/facturas/examples/correction-no-previous). El segundo clic comprueba de nuevo el estado actual, la conciliación, el tiempo de espera y la cadena. Si el registro ya se ha resuelto entretanto, no se realiza un reenvío innecesario. El reenvío web sigue disponible para **root, owner y cliente**, dentro de su ámbito. El botón independiente de consulta sólo es visible para root y owner; el cliente conserva la consulta directa de registros de su empresa y la comprobación mediante el flujo de reenvío. ### ¿Qué cambia para las integraciones por API? El flujo de dos clics pertenece al panel. La API mantiene su autenticación mediante `X-Qbikode-ClientApiKey` y sus operaciones de [consulta](/openapi-reference/consultar-registro-de-facturación-con-veri*factu) (`GET /api/invoices/{invoiceId}/query`) y [reenvío](/openapi-reference/reenviar-registro-de-facturación) (`GET /api/invoices/{invoiceId}/resubmit`). La API de reenvío no impone la comprobación previa del panel para `failure` + `unknown` sin conciliación pendiente. Ante ese resultado incierto, consulta el mismo registro antes de decidir reenviarlo. Tras un timeout identificable, en cambio, el reenvío devuelve HTTP 409 con motivo `pending_reconciliation` hasta que la conciliación termina. Los envíos iniciales directos y los reenvíos consultan el registro en el momento, y los envíos diferidos, poco después. Si esa consulta no obtiene un resultado definitivo, KubiFACTU la repite periódicamente con un número limitado de intentos. También puedes consultar tú el registro: una consulta con resultado definitivo levanta el bloqueo. Un mismo registro puede generar más de un callback, por ejemplo tras una consulta o un reenvío. Correlaciona cada callback por `id` y procésalo de forma idempotente. #### Seguimiento de la recuperación automática * Las respuestas incluyen siempre el campo `recovery`: el alta inmediata y la diferida, el listado `GET /api/invoices`, `GET /api/invoices/{invoiceId}`, la consulta, el reenvío, las anulaciones (`/cancel` y `/deferredcancel`), sus equivalentes de KubiBAI y los callbacks. Va relleno en los registros que sigue la recuperación y vale `null` en el resto; si vale `null`, puedes ignorarlo. La respuesta de `POST /api/invoices/batch` no lo incluye. * KubiFACTU llama a `callback_url` con cada cambio que producen los intentos automáticos: un nuevo `retry`, el paso a `attention` o el final de la recuperación. No llama por el resultado que ya devuelve la propia petición. Por eso `callback_url` también sirve en los envíos inmediatos. * Tras un timeout, si la consulta no obtiene un resultado definitivo, KubiFACTU la repite en los siguientes intentos de la recuperación. * El reenvío de un registro en recuperación se admite en `retry`, en `attention` y en `pending` si el registro ya se envió. En `processing`, en `resolved` y en un diferido que aún espera su primer envío devuelve HTTP `422`. Mientras la conciliación está pendiente devuelve HTTP `409` con motivo `pending_reconciliation`. * La consulta de un registro en recuperación solo genera un callback si cambia el resultado o el estado de `recovery`. ### ¿Qué significa conciliación obligatoria? Conciliar significa **comprobar qué recibió la AEAT antes de permitir otro envío**. Mientras esa comprobación esté pendiente, el reenvío manual queda bloqueado tanto en el panel como en la API. Se aplica cuando existe la marca interna `recovery_reconciliation_pending` o cuando un registro histórico tiene envío `success` y estado `unknown`. Un timeout identificable la activa; los duplicados 3000/3001 y las respuestas inutilizables o desconocidas pueden exigirla. En la API, el bloqueo del propio registro devuelve **HTTP 409**, con `data.error.code = E-INVOICE-SUBMISSION-BLOCKED`, `data.error.errors.reason = pending_reconciliation`, `data.error.errors.blocking_invoice_id = UUID del propio registro` y `data.error.details = null`. Consulta su estado y revisa el resultado antes de volver a solicitar el reenvío; una comprobación fallida o inconcluyente no levanta el bloqueo. > [!WARNING] > > La incertidumbre técnica no es un rechazo explícito. Sólo debe utilizarse la subsanación cuando la AEAT haya **rechazado** o **aceptado con errores** el registro de forma explícita. Ver [valores posibles para `vf_record_registration_status`](/openapi-reference/enviar-registro-de-facturación#response-data-vf-record-registration-status-one-of-0). ### ¿Qué ocurre si intento enviar el siguiente registro mientras el anterior sigue pendiente? Antes de crear un nuevo registro mediante `POST /api/invoices` (envío síncrono), KubiFACTU comprueba la cadena de la **misma empresa cliente y el mismo SIF**. Si un registro anterior está pendiente de envío o de confirmar su resultado, la API devuelve [HTTP `409` con el código `E-INVOICE-SUBMISSION-BLOCKED`](/openapi-reference/enviar-registro-de-facturación). Por ejemplo, en la secuencia A → B → C: * **A** ha sido aceptado por AEAT. * **B** se ha enviado, pero un timeout deja incierto si AEAT lo recibió. * El cliente intenta crear **C** mediante `POST /api/invoices`. La API devuelve `data.error.errors.reason = unresolved_submission` y `data.error.errors.blocking_invoice_id = ID de B`. **C no se crea, no se envía a AEAT y no queda en cola**. KubiFACTU consulta y reintenta B por su cuenta. Usa el ID de B para [obtener sus datos](/openapi-reference/obtener-registro-de-facturación) (`GET /api/invoices/{invoiceId}`) y sigue su estado en `recovery.status` o mediante su `callback_url`. Vuelve a solicitar C cuando B esté en `resolved`. Si B pasa a `attention`, desbloquéalo como se indica en [¿Qué es la recuperación automática de envíos?](#¿qué-es-la-recuperación-automática-de-envíos). Si el registro anterior todavía no se ha enviado, el motivo es `pending_submission`. El bloqueo por `unresolved_submission` también se mantiene mientras esté pendiente la conciliación de un reenvío duplicado. Un **rechazo explícito definitivo** de AEAT es distinto de un resultado incierto y no bloquea por sí solo todos los registros posteriores. El motivo del `409` es `pending_submission` mientras el registro anterior está en `pending` y `unresolved_submission` mientras está en `retry`, `processing` o `attention`. Si un registro histórico bloquea la cadena y tiene `recovery: null`, consulta su estado en la AEAT y solicita el reenvío del mismo registro si no llegó, conservando su identidad, huella y encadenamiento. ### ¿Qué ocurre con los registros diferidos que esperan detrás de un registro fallido? Los envíos diferidos no se bloquean al crearlos: el registro se crea y queda en cola. Si un registro anterior de la misma empresa cliente y SIF falló o tiene un resultado incierto, los diferidos posteriores esperan a que se resuelva y salen más tarde de lo normal. La fecha y hora de generación de esos registros no cambia, porque forma parte de su huella. Cuando un registro llega con retraso, la AEAT puede aceptarlo con errores por la diferencia entre esa fecha y su propia hora (código 2004). El artículo 16.4 de la Orden HAC/1177/2024 obliga a indicar en el envío que una incidencia retrasó la remisión. Por eso, antes de enviarlos, KubiFACTU cambia a `S` el campo [`affected_by_incidence_key`](/openapi-reference/enviar-registro-de-facturación) de los diferidos que esperaban, aunque se crearan con `N`. Lo hace cuando el registro que falló se [reenvía](/openapi-reference/reenviar-registro-de-facturación) o cuando una [consulta](/openapi-reference/consultar-registro-de-facturación-con-veri*factu) aclara su resultado. Por ejemplo, en la secuencia diferida A → B → C: * El envío de **A** falla por un problema de conexión. * **B** y **C** se crean después y quedan en cola detrás de A. * KubiFACTU reintenta A por su cuenta con `Incidencia = S` y marca B y C con `S`. Los dos salen después con `Incidencia = S`. Un registro diferido que solo espera su turno en la cola, sin un fallo anterior, conserva el valor con el que se creó. No necesitas reenviar ni consultar A. Los registros diferidos históricos con `recovery: null` conservan el valor con el que se crearon si esperan detrás de un registro en recuperación automática. ## ¿Qué ocurre si Veri\*Factu no identifica el NIF o el nombre del emisor? La AEAT comprueba que el NIF y el nombre o razón social del obligado a emitir (`sender_data`) y, si se informa, del representante, coinciden con su censo. Si no coinciden, rechaza la remisión completa con un error SOAP, por ejemplo: ``` Codigo[4104].Error en la cabecera: el valor del campo NIF del bloque ObligadoEmision no está identificado. ``` Estos errores (códigos 4104, 4105, 4107, 4109, 4115, 4116, 4117, 4123 y 4124) se guardan como un **rechazo**: * `vf_post_status = success` y `vf_record_registration_status = failed`, con el detalle en `vf_error_descriptions`. * El registro **no se puede reenviar**: el reenvío manda los mismos datos y volvería a fallar. * El registro **no bloquea** los siguientes registros del SIF. Para corregirlo: 1. Revisa con tu cliente el NIF y el nombre o razón social tal como constan en la AEAT. Si el NIF de la empresa cliente es erróneo, corrígelo primero en la empresa cliente. 2. Envía una [subsanación con registro previo rechazado](/api-reference/facturas/examples/correction-no-previous) (`correction_key = S` y `previous_rejection_key = X`) con los datos corregidos. > [!NOTE] > > Un alta normal con el mismo número de factura se rechaza como duplicada. Usa siempre la subsanación. Los demás errores SOAP (técnicos, de certificado o de formato del mensaje) siguen dejando `vf_post_status = failure`: se resuelven reenviando el mismo registro. ## ¿Un CSV vacío significa que el registro no está acreditado? No. El campo `csv` (Código Seguro de Verificación) **no es un indicador del estado del registro**. La AEAT emite el CSV en la respuesta a la remisión y acredita la remisión, no cada registro individual. Según la documentación técnica de la AEAT «Sistemas Informáticos de Facturación» (v1.0.3, apartado 6.4.4), el CSV debe guardarlo el SIF en el momento del alta y **no puede recuperarse mediante consultas posteriores**. Por eso un registro aceptado puede tener `csv` vacío (`null`). Ocurre, por ejemplo, cuando el resultado del envío no llegó (timeout o respuesta ilegible) y se confirmó después con una [consulta de estado](/openapi-reference/consultar-registro-de-facturación-con-veri*factu). > [!WARNING] > > Para saber si un registro está acreditado, usa el estado del registro (`vf_record_registration_status`), no la presencia del `csv`. Ver [valores posibles para `vf_record_registration_status`](/openapi-reference/enviar-registro-de-facturación#response-data-vf-record-registration-status-one-of-0). ### ¿Qué CSV recibe cada registro en un envío diferido por lote? Todos los registros del mismo envío comparten el mismo CSV, **también los rechazados**. Solo se omite cuando la AEAT rechaza todos los registros del envío. ### ¿Qué pasa con el CSV si reenvío un registro? Un reenvío no borra un CSV que el registro ya tenga guardado cuando la nueva respuesta de la AEAT no incluye uno, por ejemplo ante un registro duplicado, o cuando el envío falla sin respuesta. Si la nueva respuesta trae un CSV, este sustituye al anterior. ## Hay un límite de 12 líneas (conceptos) para las facturas. ¿Qué debo hacer si un cliente emite facturas con más de 12 líneas? La lista de los conceptos facturados deben agruparse por **condición fiscal completa**. En ese sentido, el número máximo de líneas es de 12. > [!WARNING] > > Esta agrupación responde a la condición fiscal de la operación, y no puede realizarse únicamente por tipo impositivo. En las peticiones con `tax_type_key: "02"` (IPSI), debe usarse `ipsi_tax_regime_key` en lugar de las claves de IVA o IGIC. La API admite los tipos y claves enumerados en la referencia; esto no implica cobertura completa de todos los impuestos ni regímenes IPSI. ``` CONDICIÓN FISCAL COMPLETA = tax_rate + vat_tax_regime_key, ipsi_tax_regime_key o igic_tax_regime_key (según `tax_type_key`) + equalization_tax_rate (si aplica) ``` A modo de ejemplo, indicar lo siguiente: ### Caso 1: Factura con todas las líneas al 21% Si las líneas al 21% se acogen a regímenes diferentes, deben generarse múltiples agrupaciones en el desglose, cada una con su combinación única de `tax_rate` + `vat_tax_regime_key` o `igic_tax_regime_key` + `equalization_tax_rate` (si aplica). Ejemplo válido: * Línea 1: 21%, régimen general * Línea 2: 21%, régimen criterio de caja El desglose debe contener dos entradas distintas, ambas con tipo 21%, pero con claves de régimen diferentes. ### Caso 2: Factura con líneas al 21% y al 10% Se pueden informar más de una clave de régimen por cada tipo impositivo, siempre que existan líneas que lo justifiquen. Ejemplo válido: * Línea 1: 21%, régimen general * Línea 2: 21%, régimen especial agencias * Línea 3: 10%, régimen general El desglose incluirá tres agrupaciones: 1. 21% + régimen general 2. 21% + régimen especial agencias 3. 10% + régimen general ## ¿Cómo se debe aplicar una retención por IRPF a una factura entre profesionales? En las facturas, a menudo se incluyen menciones, detracciones, adiciones o cantidades que no forman parte de la información **fiscalmente obligatoria** de una factura. A título de ejemplo, podemos mencionar: el recargo financiero (al igual que ocurre con los importes suplidos), la retención por garantía decenal, los suplidos o, en este caso, la retención de IRPF. Todos estos importes, aunque se incluyen en la factura por su evidente importancia, no son importes "propios" de la factura, razón por la que no afectan a la base ni a la cuota de IVA, ni al "Importe Total" . Se trata de cantidades que alteran el **"total a pagar"** añadiendo o restando cantidades, pero no el **"importe total factura"**. Por ello cuando sea preciso incluirlos en la factura, **esa parte NO integrará el registro de facturación**. A este respecto, a modo de consejo o recomendación, para facilitar la comprensión de este matiz al cliente que reciba la factura, se podrían incluir ambos importes en la factura: "Importe total factura" (que es el que aparece en el QR tributario) y "Total a pagar", debidamente diferenciados. ## ¿Cómo informar una factura con IPSI? Para las nuevas peticiones con `tax_type_key: "02"`, informa `ipsi_tax_regime_key` con una de las claves admitidas (`01`, `08`, `11`, `18`, `19` o `20`) y omite `vat_tax_regime_key` e `igic_tax_regime_key`. La referencia de la API describe el alcance concreto de cada clave; no debe interpretarse como cobertura completa de todos los regímenes IPSI. La documentación técnica de la AEAT «Sistemas Informáticos de Facturación», versión 1.2.2 de 08/04/2026, apartado 3.1.3 y punto 15.6, admite estas seis claves ([PDF de validaciones y errores](https://www.agenciatributaria.es/static_files/AEAT_Desarrolladores/EEDD/IVA/VERI-FACTU/Validaciones_Errores_Veri-Factu.pdf)). La AEAT indica que la omisión de la clave se avisa hasta el 31/12/2026 y se rechaza desde el 01/01/2027. KubiFACTU validará el campo requerido y las combinaciones incompatibles desde esta actualización, que pueden producir una respuesta HTTP 422. # Qué es KubiFACTU Source: https://apidocs.kubifactu.com/introduction KubiFACTU es un servicio web diseñado para **simplificar y optimizar** el procesamiento de registros de facturación conforme al estándar **Veri\*Factu**, garantizando el cumplimiento normativo con la Agencia Estatal de Administración Tributaria (AEAT). Nuestra solución ofrece una **API REST moderna y basada en estándares**, que facilita la integración con sistemas empresariales mediante el uso de peticiones JSON. Además, KubiFACTU gestiona de manera automatizada el **control de encadenamiento y trazabilidad** de los registros de facturación, una exigencia clave de Veri\*Factu para asegurar la transparencia y autenticidad de los datos. Con KubiFACTU, las empresas pueden centralizar y agilizar sus operaciones de facturación, reduciendo la complejidad técnica y asegurando un cumplimiento normativo sólido. # Diferencias con KubiBAI Source: https://apidocs.kubifactu.com/kubibai-differences Diferencias principales con respecto al funcionamiento de KubiBAI ## Certificados La firma de las comunicaciones con la AEAT debe firmarse con un certificado autorizado. Nosotros hacemos las veces de intermediarios, con lo que no es necesario tener un certificado para cada empresa cliente que emite registros de facturación a la AEAT. Además, **cada intermediario puede optar por usar su propio certificado** (en lugar del nuestro) para la firma de las comunicaciones. Para ello, el intermediario debe estar registrado como **apoderado o colborador social** en la AEAT. ## Sistemas Informáticos de Facturación Consulta [Sistemas informáticos de facturación (SIF)](/basic-concepts#sistemas-informáticos-de-facturación-sif) y [Encadenamiento (trazabilidad) y SIFs](/basic-concepts#encadenamiento-trazabilidad-y-sifs). ## Campos del JSON de registros de Facturación Aunque se ha tratado de mantener una estructura de JSON similar a la utilizada en KubiBAI, los requisitos de VeriFactu han obligado a añadir nuevos campos y modificar algunos de los ya existentes. Una de las estructuras que más cambios ha sufrido es la que especifica el desglose fiscal (`invoice_data.tax_breakdown`), que en Veri\*Factu, además de ser obligatoria, presenta requisitos muy diferentes a los de TicketBAI. Recomendamos consultar detenidamente la sección [API desde KubiBAI](/openapi-kubibai-reference/enviar-registro-de-facturación) de esta documentación para identificar los campos que se conservan (y sus valores aceptados) y los que son nuevos con respecto a KubiBAI. ## Fallos de envío en el alta inmediata `POST /api/invoices` responde HTTP `200` con el objeto `recovery` cuando el envío falla. El alta inmediata de KubiBAI (`POST /api/invoicing/invoices`) responde HTTP `500` sin `recovery` cuando el envío falla con un error de conexión, una respuesta ilegible, un error al generar el XML o un error inesperado. El registro entra igualmente en la recuperación automática: para conocer su estado, [obtén el registro](/openapi-kubibai-reference/obtener-registro-de-facturación) (`GET /api/invoicing/invoices/{invoiceId}`). La anulación inmediata de KubiBAI responde igual que la de la API principal: si el envío falla, HTTP `200` con el objeto `recovery`. Ver [¿Qué es la recuperación automática de envíos?](/faq#¿qué-es-la-recuperación-automática-de-envíos) # Buscar registros de facturación Source: https://apidocs.kubifactu.com/openapi-common/buscar-registros-de-facturación /api-reference/openapi/openapi-common.yaml get /api/invoices/search?fiscal_year={fiscal_year}&full_invoice_number={full_invoice_number} Obtiene una lista de registros de facturación que cumplan con los criterios indicados en los parámetros. # Consultar la validez de un NIF/CIF Source: https://apidocs.kubifactu.com/openapi-common/consultar-la-validez-de-un-nifcif /api-reference/openapi/openapi-common.yaml get /api/id-query?nif={nif}&name={name} Hace un consulta al **Web Service de Calidad de datos identificativos** de la AEAT para validar la existencia de un NIF/CIF. # Anular registro de facturación Source: https://apidocs.kubifactu.com/openapi-kubibai-reference/anular-registro-de-facturación /api-reference/openapi/openapi-kubibai.yaml post /api/invoicing/invoices/{invoiceId}/cancel Anulación de un registro de facturación. Si se considera que "toda la factura" en sí misma está mal o no debería haberse emitido, siempre que para solucionarlo no deba emplearse algún procedimiento (de rectificativa u otro) previsto en el Reglamento de Obligaciones de Facturación (ROF), se podrá anular, generando para ello un registro de facturación de anulación. # Anular registro de facturación en diferido Source: https://apidocs.kubifactu.com/openapi-kubibai-reference/anular-registro-de-facturación-en-diferido /api-reference/openapi/openapi-kubibai.yaml post /api/invoicing/invoices/{invoiceId}/deferredcancel Anulación de un registro de facturación en diferido. # Consultar registro de facturación con Veri*Factu Source: https://apidocs.kubifactu.com/openapi-kubibai-reference/consultar-registro-de-facturación-con-veri*factu /api-reference/openapi/openapi-kubibai.yaml get /api/invoicing/invoices/{invoiceId}/query Obtiene el estado de un registro de facturación haciendo previamente una consulta a Veri*Factu. Se llama a la URL de callback del registro si se incluyó en el momento de su alta. [Ver formato de la llamada de callback](enviar-registro-de-facturación#body-callback-url). La respuesta de este endpoint contiene el estado de la factura actualizado correspondiente al que hay registrado en la AEAT. # Descargar imagen QR del registro de facturación Source: https://apidocs.kubifactu.com/openapi-kubibai-reference/descargar-imagen-qr-del-registro-de-facturación /api-reference/openapi/openapi-kubibai.yaml get /api/invoices/{invoiceId}/qr-image Descarga la imagen PNG del código QR indicada por el campo `qr_image_url` de las respuestas de factura y callbacks. La petición debe hacerse con el header HTTP `X-Qbikode-ClientApiKey`. # Descargar XML del registro de facturación Source: https://apidocs.kubifactu.com/openapi-kubibai-reference/descargar-xml-del-registro-de-facturación /api-reference/openapi/openapi-kubibai.yaml get /api/invoices/{invoiceId}/xml Descarga el XML del registro de facturación indicado por el campo `xml_url` de las respuestas de factura y callbacks. La petición debe hacerse con el header HTTP `X-Qbikode-ClientApiKey`. # Enviar registro de facturación Source: https://apidocs.kubifactu.com/openapi-kubibai-reference/enviar-registro-de-facturación /api-reference/openapi/openapi-kubibai.yaml post /api/invoicing/invoices Generación de un nuevo registro de facturación. # Enviar registro de facturación en diferido Source: https://apidocs.kubifactu.com/openapi-kubibai-reference/enviar-registro-de-facturación-en-diferido /api-reference/openapi/openapi-kubibai.yaml post /api/invoicing/invoices/deferred Generación de un nuevo registro de facturación en diferido. # Obtener registro de facturación Source: https://apidocs.kubifactu.com/openapi-kubibai-reference/obtener-registro-de-facturación /api-reference/openapi/openapi-kubibai.yaml get /api/invoicing/invoices/{invoiceId} Obtener información sobre un registro de facturación. > Este endpoint **no hace consulta a Veri*Factu**; los datos se devuelven directamente desde nuestra base de datos. # Anular registro de facturación Source: https://apidocs.kubifactu.com/openapi-reference/anular-registro-de-facturación /api-reference/openapi/openapi.yaml post /api/invoices/{invoiceId}/cancel Anulación de un registro de facturación. Si se considera que "toda la factura" en sí misma está mal o no debería haberse emitido, siempre que para solucionarlo no deba emplearse algún procedimiento (de rectificativa u otro) previsto en el Reglamento de Obligaciones de Facturación (ROF), se podrá anular, generando para ello un registro de facturación de anulación. Si el envío de la anulación falla y deja la cadena esperando, la respuesta incluye `recovery` relleno y KubiFACTU reintenta la anulación por su cuenta. # Anular registro de facturación en diferido Source: https://apidocs.kubifactu.com/openapi-reference/anular-registro-de-facturación-en-diferido /api-reference/openapi/openapi.yaml post /api/invoices/{invoiceId}/deferredcancel Anulación de un registro de facturación en diferido. # Consultar registro de facturación con Veri*Factu Source: https://apidocs.kubifactu.com/openapi-reference/consultar-registro-de-facturación-con-veri*factu /api-reference/openapi/openapi.yaml get /api/invoices/{invoiceId}/query Obtiene el estado de un registro de facturación haciendo previamente una consulta a Veri*Factu. Se llama a la URL de callback del registro si se incluyó en el momento de su alta. [Ver formato de la llamada de callback](enviar-registro-de-facturación#body-callback-url). La consulta sólo actualiza el registro solicitado cuando el resultado permite confirmar su identidad y huella, o confirma que no está registrado mediante un SinDatos válido. Una consulta fallida o inconcluyente no confirma la aceptación ni permite dar por resuelta una conciliación pendiente. Un rechazo confirmado se conserva como rechazo. La AEAT no devuelve el CSV en las consultas, así que una consulta nunca lo informa ni lo recupera. Si confirma un registro cuyo resultado de envío no llegó, el registro queda con su estado actualizado y el campo `csv` vacío. Usa `vf_record_registration_status` para saber si el registro está acreditado. [Leer más en la FAQ](/faq). Si el registro es un diferido que todavía no se ha enviado, el endpoint no consulta a la AEAT y devuelve los datos guardados. La consulta de un registro en recuperación solo llama a la URL de callback si cambia el resultado o el estado de `recovery`. Si la consulta confirma que la AEAT tiene el registro, la recuperación termina (`resolved`). Si la AEAT responde que no lo tiene, el registro queda en `retry` y KubiFACTU lo reenvía en el siguiente intento. # Crear una nueva empresa Source: https://apidocs.kubifactu.com/openapi-reference/crear-una-nueva-empresa /api-reference/openapi/openapi.yaml post /api/clientcompanies Registro de una nueva empresa en el sistema. # Descargar imagen QR del registro de facturación Source: https://apidocs.kubifactu.com/openapi-reference/descargar-imagen-qr-del-registro-de-facturación /api-reference/openapi/openapi.yaml get /api/invoices/{invoiceId}/qr-image Descarga la imagen PNG del código QR indicada por el campo `qr_image_url` de las respuestas de factura y callbacks. La petición debe hacerse con el header HTTP `X-Qbikode-ClientApiKey`. # Descargar XML del registro de facturación Source: https://apidocs.kubifactu.com/openapi-reference/descargar-xml-del-registro-de-facturación /api-reference/openapi/openapi.yaml get /api/invoices/{invoiceId}/xml Descarga el XML del registro de facturación indicado por el campo `xml_url` de las respuestas de factura y callbacks. La petición debe hacerse con el header HTTP `X-Qbikode-ClientApiKey`. # Editar empresa Source: https://apidocs.kubifactu.com/openapi-reference/editar-empresa /api-reference/openapi/openapi.yaml post /api/clientcompanies/{companyId} Edición de los datos de una empresa. # Eliminar SIF Source: https://apidocs.kubifactu.com/openapi-reference/eliminar-sif /api-reference/openapi/openapi.yaml delete /api/sifs/{sifId} Elimina un SIF de intermediario o de empresa. A partir de ese momento, las peticiones que indiquen ese `sif_id` se rechazan con un error de validación. Si después creas otro SIF, tendrá un UUID nuevo y sus registros formarán una cadena nueva para cada empresa. # Enviar registro de facturación Source: https://apidocs.kubifactu.com/openapi-reference/enviar-registro-de-facturación /api-reference/openapi/openapi.yaml post /api/invoices Generación y envío síncrono de un nuevo registro de facturación. Antes de crear el registro, la API comprueba la cadena de la misma empresa cliente y el mismo SIF. Si existe un registro anterior pendiente de envío o de resolver su resultado, devuelve HTTP `409` con el código `E-INVOICE-SUBMISSION-BLOCKED`. El nuevo registro no se crea, no se envía a AEAT y no queda en cola. Si el envío falla y deja la cadena esperando, la respuesta incluye `recovery` relleno y KubiFACTU reintenta el registro por su cuenta. Los reintentos llaman a `callback_url` si la petición lo incluía. El `409` del siguiente registro se mantiene hasta que la recuperación termine. > [!NOTE] > > `lines` continúa admitiéndose como alias de retrocompatibilidad, sin una fecha de retirada prevista. Las nuevas integraciones deben utilizar `tax_breakdown`. No envíes ambas propiedades en una misma factura, ya que la petición será rechazada y el error de validación se devolverá en las dos claves. En los lotes, cada factura puede utilizar individualmente la propiedad canónica o el alias. En los endpoints KubiBAI, ambas propiedades se incluyen dentro de `invoice_data`. # Enviar registro de facturación diferido Source: https://apidocs.kubifactu.com/openapi-reference/enviar-registro-de-facturación-diferido /api-reference/openapi/openapi.yaml post /api/invoices/deferred Generación de un nuevo registro de facturación diferido. # Enviar registros de facturación en lote Source: https://apidocs.kubifactu.com/openapi-reference/enviar-registros-de-facturación-en-lote /api-reference/openapi/openapi.yaml post /api/invoices/batch Registra entre 1 y 500 registros de facturación que **serán procesados en diferido**. La respuesta confirma la recepción del lote, pero no incluye los identificadores ni el resultado individual de los registros. Tampoco confirma su aceptación por Veri*Factu. El resultado de cada registro se obtiene posteriormente mediante la URL indicada en su campo `callback_url` o consultando el registro de facturación. Si algún registro no supera la validación, la respuesta contiene los errores indexados según su posición en el array, por ejemplo, `invoices.0.sif_id`. ### Resultado mediante callback El campo `callback_url` se configura individualmente en cada elemento de `invoices`. Cuando los registros han sido procesados, KubiFACTU agrupa los resultados de una misma empresa cliente y URL de callback, y realiza una petición `POST` con contenido `application/json`. El cuerpo del callback siempre es un array y puede contener uno o varios registros. Un callback no tiene por qué corresponder exactamente con el lote original, por lo que la integración debe correlacionar cada resultado mediante `id` o `client_invoice_id`, sin depender de su posición en el array. Un mismo registro puede llegar en más de un callback, así que procesa cada resultado de forma idempotente. `recovery` va relleno en los elementos de los registros que sigue la recuperación automática, y los reintentos automáticos generan callbacks adicionales del mismo registro: cada nuevo `retry`, el paso a `attention` y el final de la recuperación (`resolved`). `recovery.status = resolved` no significa que la AEAT haya aceptado el registro: el resultado está en `vf_record_registration_status`. Ejemplo de callback de un registro en recuperación automática: ```json [ { "id": "7d76c4a6-6603-4fc6-946a-8b9ffcc93480", "client_invoice_id": "FACTURA-2026-0042", "record_type": "creation", "sif_id": "0995c42c-6708-44fb-bfbf-b363a5fe873e", "sender_company_name": "Ferretería Ejemplo, S.L.", "sender_tax_id_number": "B12345678", "fiscal_year": 2026, "full_invoice_number": "F-2026-0042", "fingerprint": "8f3d7aa5530f5f6c3a96a5c8a9516a7fd9ce90b9bf3b60375682d8b45ca72867", "csv": "CSV-DE-EJEMPLO", "vf_post_status": "success", "vf_record_registration_status": "success", "has_warnings": false, "vf_error_descriptions": null, "vf_response_body": "PHhtbD5SZXNwdWVzdGEgZGUgZWplbXBsbzwveG1sPg==", "qr_value": "https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQR?nif=B12345678&numserie=F-2026-0042&fecha=01-09-2026&importe=121.00", "qr_image_url": "https://devapi.kubifactu.com/api/invoices/7d76c4a6-6603-4fc6-946a-8b9ffcc93480/qr-image", "xml_url": "https://devapi.kubifactu.com/api/invoices/7d76c4a6-6603-4fc6-946a-8b9ffcc93480/xml", "recovery": { "status": "resolved", "reason_code": null, "message": "Automatic recovery has finished. Check the registration status for the result.", "attempts": 1, "next_attempt_at": null } } ] ``` El contrato completo de cada elemento se detalla en el campo `callback_url` de la petición. Este callback es independiente de la respuesta HTTP inmediata del endpoint. # Estado del servicio Veri*Factu Source: https://apidocs.kubifactu.com/openapi-reference/estado-del-servicio-veri*factu /api-reference/openapi/openapi.yaml get /api/verifactu/health Obtiene el estado actual del servicio Veri*Factu de la AEAT. Este endpoint devuelve información sobre la disponibilidad del servicio, incluyendo el código de estado HTTP de la última comprobación y cualquier mensaje de error si el servicio no está disponible. # Listar registros de facturación con filtros Source: https://apidocs.kubifactu.com/openapi-reference/listar-registros-de-facturación-con-filtros /api-reference/openapi/openapi.yaml get /api/invoices Obtiene un listado **paginado** de registros de facturación pertenecientes a la empresa autenticada. Cada elemento incluye una **versión reducida** de la información que se obtiene en consultas individuales o cuando se crean nuevos registros de facturación, con los totales almacenados y el desglose fiscal completo. Además se devuelve una sección `meta` para la gestión de la paginación. El valor devuelto en `meta.next_page_cursor` sirve para solicitar la siguiente página y `meta.prev_page_cursor` para retroceder. Si `meta.has_more` es `false`, no hay más elementos. # Nuevo SIF de empresa Source: https://apidocs.kubifactu.com/openapi-reference/nuevo-sif-de-empresa /api-reference/openapi/openapi.yaml post /api/clientcompanies/{companyId}/sifs Crea un SIF de empresa. Solo se puede usar para enviar registros de facturación de esa empresa: con otra, la API rechaza la petición con un error de validación. En el XML declara `N` en `TipoUsoPosibleMultiOT` e `IndicadorMultiplesOT`. Para usar un mismo SIF con varias empresas cliente, usa un SIF de intermediario. Los SIFs de intermediario se crean desde el panel web. Consulta [Sistemas informáticos de facturación (SIF)](/basic-concepts#sistemas-informáticos-de-facturación-sif). # Obtener datos de empresa Source: https://apidocs.kubifactu.com/openapi-reference/obtener-datos-de-empresa /api-reference/openapi/openapi.yaml get /api/clientcompanies/{companyId} Devuelve los datos de la empresa. # Obtener lista de empresas Source: https://apidocs.kubifactu.com/openapi-reference/obtener-lista-de-empresas /api-reference/openapi/openapi.yaml get /api/clientcompanies Devuelve un listado de empresas con posibilidad de aplicar filtros. # Obtener operaciones de una empresa Source: https://apidocs.kubifactu.com/openapi-reference/obtener-operaciones-de-una-empresa /api-reference/openapi/openapi.yaml get /api/clientcompanies/{companyId}/requests Devuelve el número de operaciones realizadas por una empresa en un año y mes determinados. # Obtener registro de facturación Source: https://apidocs.kubifactu.com/openapi-reference/obtener-registro-de-facturación /api-reference/openapi/openapi.yaml get /api/invoices/{invoiceId} Obtener información sobre un registro de facturación. > Este endpoint **no hace consulta a Veri*Factu**; los datos se devuelven directamente desde nuestra base de datos. # Obtener SIFs de empresa Source: https://apidocs.kubifactu.com/openapi-reference/obtener-sifs-de-empresa /api-reference/openapi/openapi.yaml get /api/clientcompanies/{companyId}/sifs Obtiene los SIFs de empresa de la empresa indicada. No incluye los SIFs de intermediario, que se pueden usar con cualquier empresa cliente y no pertenecen a ninguna. Consulta [Sistemas informáticos de facturación (SIF)](/basic-concepts#sistemas-informáticos-de-facturación-sif). # Reenviar registro de facturación Source: https://apidocs.kubifactu.com/openapi-reference/reenviar-registro-de-facturación /api-reference/openapi/openapi.yaml get /api/invoices/{invoiceId}/resubmit Reenvía un registro de facturación a Veri*Factu sin volver a generarlo. Este endpoint es útil para registros que fallaron **por un problema técnico de conexión** (timeout, error del servidor o falta de respuesta) en el envío inicial. Ante un resultado incierto, consulta el estado del mismo registro antes de decidir reenviarlo. Un timeout identificable se guarda como `vf_post_status = failure` y `vf_record_registration_status = unknown` y activa la conciliación obligatoria: KubiFACTU consulta el registro en la AEAT por sí mismo. La conciliación obligatoria bloquea el reenvío con HTTP 409 y motivo `pending_reconciliation` hasta aclarar el resultado: se aplica a la marca interna `recovery_reconciliation_pending` y al caso de envío `success` con registro `unknown`, incluidos registros históricos. Un timeout identificable la activa; los duplicados 3000/3001 y las respuestas inutilizables o desconocidas pueden exigirla. El UUID de bloqueo puede ser el propio registro; los bloqueos por registros anteriores de la misma empresa cliente y SIF mantienen los motivos `pending_submission` y `unresolved_submission`. El flujo de comprobar el estado y confirmar el reenvío en dos clics corresponde al panel, no a este endpoint. La API conserva sus operaciones y autenticación y no impone la comprobación previa del panel para `failure` + `unknown` sin conciliación pendiente. Tras un timeout, los envíos iniciales directos y los reenvíos consultan el registro en el momento, y los envíos diferidos, poco después; si la consulta no obtiene un resultado definitivo, se repite periódicamente con un número limitado de intentos. [Leer más en la FAQ](/faq). Si el registro ya tiene un CSV guardado, el reenvío no lo borra cuando la nueva respuesta de la AEAT no incluye uno (por ejemplo, ante un registro duplicado) ni cuando el envío falla sin respuesta. Un CSV nuevo sí sustituye al anterior. Se llama a la URL de callback del registro si se incluyó en el momento de su alta. ### Registros en recuperación automática KubiFACTU reintenta el registro por su cuenta y no hace falta reenviarlo. El reenvío manual sirve sobre todo para desbloquear un registro en `attention` después de corregir la causa. Según `recovery.status`: - `retry` y `attention`: se admite el reenvío. Si vuelve a fallar por una causa temporal, KubiFACTU retoma los reintentos automáticos. - `pending`: se admite solo si el registro ya se envió. Un diferido que todavía espera su primer envío devuelve HTTP `422`. - `processing` y `resolved`: devuelve HTTP `422`. Mientras la conciliación del registro está pendiente, devuelve HTTP `409` con motivo `pending_reconciliation`. # Subir documentos de autorización Source: https://apidocs.kubifactu.com/openapi-reference/subir-documentos-de-autorización /api-reference/openapi/openapi.yaml post /api/clientcompanies/{companyId}/authorization-documents Sube documentos de autorización y/o identidad para una empresa cliente. Este endpoint permite subir uno o ambos documentos simultáneamente: - Solo documento de autorización - Solo documento de identidad - Ambos documentos a la vez - Documento de autorización con indicador de firma digital del cliente (`authorization_document_has_digital_signature`) El campo `authorization_document_has_digital_signature` puede enviarse junto con `authorization_document`. Si se sube solo `identity_document`, este indicador no aplica. **Nota:** Este endpoint solo está disponible para intermediarios que NO usen su propio certificado digital. # Inicio rápido Source: https://apidocs.kubifactu.com/quickstart Ejemplo de envío de una factura ordinaria básica ## Encabezados HTTP ```http Headers HTTP theme={"dark"} Accept: application/json X-Qbikode-ClientApiKey: API-KEY de la empresa ``` ```bash cURL theme={"dark"} curl -H 'Accept: application/json' \ -H 'X-Qbikode-ClientApiKey: API-KEY de la empresa' \ … ``` ## Cuerpo JSON de la petición Este ejemplo muestra de la remisión de una factura ordinaria por un total de `121.00€`, con un concepto por valor de `100.00€` + IVA del `21.00%`. En `sif_id` va el UUID de tu SIF. Al darte de alta, KubiFACTU crea un SIF de intermediario que puedes usar con todas tus empresas cliente; su UUID aparece en la columna **Identificador** del menú **SIFs** del panel y es distinto en pruebas y en producción. Ver [Sistemas informáticos de facturación (SIF)](/basic-concepts#sistemas-informáticos-de-facturación-sif). ```json Body theme={"dark"} { "sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7", "invoice_type_key": "F1", // Factura (art. 6, 7.2 y 7.3 del RD 1619/2012) "sender_data": { "company_name": "Empresa emisora de ejemplo", "tax_id_number": "J27290840" }, "recipients": [ { "company_name": "Empresa receptora de ejemplo", "tax_id_number": "B99014037" } ], "full_invoice_number": "2026-000001", "fiscal_year": "2026", "issue_date": "2026-01-01", "operation_description": "Factura ordinaria por entrega de mercancías.", "total_quota": 21.00, "total_amount": 121.00, "tax_breakdown": [ { "tax_type_key": "01", // Impuesto sobre el Valor Añadido (IVA) "vat_tax_regime_key": "01", // Operación de régimen general "operation_type_key": "S1", // Operación Sujeta y No exenta - Sin inversión del sujeto pasivo "tax_base": "100.00", "tax_rate": "21.00", "tax_quota": "21.00" } ] } ``` ```bash cURL theme={"dark"} curl -X "POST" "https://kubifactu.kubicode.test/api/invoices" \ -H 'Accept: application/json' \ -H 'Content-Type: text/plain; charset=utf-8' \ -H 'X-Qbikode-ClientApiKey: API-KEY de la empresa' \ -d $'{ "sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7", "invoice_type_key": "F1", "sender_data": { "company_name": "Empresa emisora de ejemplo", "tax_id_number": "J27290840" }, "recipients": [ { "company_name": "Empresa receptora de ejemplo", "tax_id_number": "B99014037" } ], "full_invoice_number": "2026-000001", "fiscal_year": "2026", "issue_date": "2026-01-01", "operation_description": "Factura ordinaria por entrega de mercancías.", "total_quota": 21.00, "total_amount": 121.00, "tax_breakdown": [ { "tax_type_key": "01", "vat_tax_regime_key": "01", "operation_type_key": "S1", "tax_base": "100.00", "tax_rate": "21.00", "tax_quota": "21.00" } ] }' ``` # Paso a producción Source: https://apidocs.kubifactu.com/toproduction Pasos a seguir para pasar al entorno de producción Este documento detalla los pasos necesarios para pasar del **entorno de pruebas** al **entorno de producción** en la plataforma **KubiFACTU**, conforme a la normativa de la AEAT y a la *Resolución de 18 de diciembre de 2024 (BOE-A-2024-27600)*. ## Declaración responsable Se recomienda ofrecer a vuestros clientes una **declaración responsable** que confirme el cumplimiento de los requisitos técnicos y legales exigidos por la AEAT. > **Nota:** > El modelo oficial de declaración responsable publicado por la AEAT se puede descargar desde [ESTE ENLACE](https://sede.agenciatributaria.gob.es/static_files/Sede/Tema/IVA/Verifactu/EjemplosDeclaracionResponsable\(V0.5.1\).pdf). > Este documento no requiere presentación previa, pero debe conservarse a disposición de la Agencia Tributaria en caso de requerimiento. ## Otorgamiento de representación ### Si se usa el certificado de KubiFACTU (Qbikode Solutions, S.L.) Si vais a utilizar **nuestro certificado de colaborador social** para la presentación de registros de facturación ante la AEAT, cada uno de vuestros clientes deberá: 1. Firmar [el documento de otorgamiento de representación](https://api.kubifactu.com/files/representacion.pdf) (modelo oficial de la AEAT). 2. Adjuntar una copia de su documento identificativo (DNI, CIF o equivalente). 3. Remitirnos ambos documentos a [soporte@kubifactu.com](mailto:soporte@kubifactu.com). > **Importante:** > El modelo oficial **no puede ser modificado**, salvo para completar los datos identificativos solicitados. > Se trata de un documento normalizado aprobado por la AEAT, y su alteración invalidaría la autorización. ### Uso de vuestro propio certificado Si optáis por actuar con **vuestro propio certificado de colaborador social**, deberéis obtener de vuestros clientes una **autorización equivalente**, pero indicando **vuestros datos** como representantes en el modelo. ## Alta en el entorno de producción Acceded a la URL [https://api.kubifactu.com/](https://api.kubifactu.com/). 1. Registrad vuestra cuenta en el entorno de producción. 2. Completad los **datos de domiciliación SEPA**, necesarios para la emisión de las facturas mensuales correspondientes al uso del servicio. ## Consideraciones sobre el entorno de producción El entorno de producción parte **desde cero**, por lo que: * Las **API Keys** y **SIFs** serán **nuevos**. * No se conservarán los datos del entorno de pruebas. ## Soporte Para cualquier duda o asistencia técnica, contactad con el equipo de soporte de **KubiFACTU** a través de [soporte@kubifactu.com](mailto:soporte@kubifactu.com).