Factura electrónica y reporte del TDD en Eslovaquia
Guía para integrar la API de B2Brouter y cumplir con la obligación eslovaca de factura electrónica y de reporte desde tu propio sistema.
A partir del 1 de enero de 2027, cada sujeto pasivo de IVA registrado en Eslovaquia debe emitir facturas electrónicas estructuradas para sus suministros B2B nacionales y enviarlas por la red Peppol. El punto de acceso también debe reportar los datos de cada factura a la Administración Financiera (Finančná správa, FS) como Tax Data Document (TDD). B2Brouter lo hace por ti: envías los datos de la factura por la REST API, y B2Brouter genera la factura Peppol BIS 3, la entrega al comprador, y genera y envía el TDD.
| Qué hace B2Brouter por ti | Detalles |
|---|---|
| Punto de acceso Peppol | Entrega tus facturas al punto de acceso del comprador (C2 → C3) y recibe tus facturas (C3 → C2) |
| Registro en Peppol | Publica tu empresa como participante Peppol 0245:<DIČ> |
| Generación de documentos | Envías JSON, y B2Brouter genera la factura o el abono Peppol BIS Billing 3.0 |
| Reporte del TDD | Genera el TDD de cada factura que se debe reportar y lo envía al punto de acceso de la FS (C5) |
| Respuesta de la FS | Recibe el Message Level Status (MLS) de la FS y actualiza el estado del TDD |
| Archivo legal | Conserva las facturas, los TDD y las respuestas MLS durante los 10 años que exige la ley |
El camino hasta tu primera factura: crea la cuenta con el IČ DPH → comprueba el Tax Report Setting sk → activa Peppol → crea un contacto → emite la factura → sigue el TDD.
Contexto normativo: la Ley 385/2025 Coll. modifica la ley eslovaca del IVA (222/2004 Coll.). A partir del 1 de enero de 2027, un sujeto pasivo de IVA emite facturas electrónicas (EN 16931) para los suministros nacionales a empresas y personas jurídicas establecidas en Eslovaquia, y las envía por un servicio de entrega certificado (un punto de acceso Peppol). El proveedor y el cliente reportan los datos de la factura a la Administración Financiera en un plazo de cinco días, a través del servicio de entrega. Todos los sujetos pasivos y personas jurídicas nacionales deben poder recibir facturas electrónicas. A partir del 1 de julio de 2030, se aplican las reglas definitivas: reporte por transacción de los suministros nacionales y transfronterizos, y fin de la declaración de control (control statement).
¿Para quién es esta guía?
Sección titulada «¿Para quién es esta guía?»eDocExchange: empresas que conectan su ERP o software de contabilidad a B2Brouter. Creas la cuenta una vez (interfaz web o API) y después emites las facturas y sigues su ciclo de vida por la API.
eDocSync: proveedores de software que ofrecen el cumplimiento eslovaco a sus propios clientes. Creas las cuentas de tus clientes por la API, emites sus facturas y sigues su ciclo de vida. Tus clientes no necesitan acceso a B2Brouter.
Las funciones eslovacas son las mismas en los dos modelos.
Antes de empezar
Sección titulada «Antes de empezar»Entornos
Sección titulada «Entornos»| Entorno | API de B2Brouter | Uso |
|---|---|---|
| Producción | https://api.b2brouter.net | Facturas reales y TDD reales |
| Sandbox | https://api.b2brouter.net con una API key test_ | Pruebas del flujo completo, con una red Peppol simulada y una FS simulada |
Credenciales de la API
Sección titulada «Credenciales de la API»La autenticación usa una API key estática en la cabecera HTTP X-B2B-API-Key. Genérala en la interfaz de B2Brouter, en Desarrolladores → API Keys. Indica también X-B2B-API-Version en cada petición.
¿Es la primera vez que usas la API? Empieza por la introducción a la API: entornos, API key y primera petición.
Identificadores eslovacos
Sección titulada «Identificadores eslovacos»Una empresa eslovaca tiene tres identificadores. Cada uno tiene su lugar en B2Brouter:
| Identificador | Formato | Esquema | Dónde va | Qué activa |
|---|---|---|---|---|
| IČ DPH (número de IVA) | SK + 10 dígitos | tin_scheme: 9950 | TIN de la cuenta y de los contactos | Reporte del TDD (automático) |
| DIČ (número fiscal) | 10 dígitos | "0245" | Identificador Peppol (pin_scheme, pin_value) | Participante Peppol 0245:<DIČ> |
| IČO (número de empresa) | 8 dígitos | cin_scheme: "0158" | CIN (número de empresa) de la cuenta | Nada por sí solo |
- Los 10 dígitos del IČ DPH son el DIČ:
SK2022222222tiene el DIČ2022222222. - El IČO es siempre un número de empresa (
cin_scheme), nunca un TIN. - El Peppol eslovaco identifica a cada participante con el DIČ (
0245). El IČ DPH (9950) no es un identificador Peppol válido en Eslovaquia.
Crea la cuenta de la empresa
Sección titulada «Crea la cuenta de la empresa»Crea la cuenta con POST /accounts. Para el reporte del TDD eslovaco, la cuenta necesita:
| Campo | Valor |
|---|---|
country | "sk" |
tin_scheme, tin_value | 9950, SK<DIČ> |
cin_scheme, cin_value | "0158", el IČO (opcional) |
address, city, postalcode | la dirección de la empresa |
curl --request POST \ --url https://api.b2brouter.net/accounts \ --header 'X-B2B-API-Key: {YOUR_API_KEY}' \ --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \ --header 'Content-Type: application/json' \ --data '{ "account": { "name": "Príklad s.r.o.", "country": "sk", "currency": "EUR", "tin_scheme": 9950, "tin_value": "SK3000000003", "cin_scheme": "0158", "cin_value": "30000009", "address": "Testovacia 1", "city": "Bratislava", "postalcode": "81101", "email": "billing@example.sk" } }'El Tax Report Setting sk
Sección titulada «El Tax Report Setting sk»B2Brouter crea el Tax Report Setting sk automáticamente cuando una cuenta en Eslovaquia tiene un IČ DPH (9950): al crear la cuenta, o al añadir el IČ DPH más tarde. No tienes que crearlo tú.
Para consultarlo, usa GET /accounts/{ACCOUNT_ID}/tax_report_settings:
{ "tax_report_settings": [ { "code": "sk", "start_date": "2027-01-01T00:00:00.000Z", "auto_generate": true, "auto_send": false, "enabled": true, "locked": false, "created_at": "2026-11-09T10:42:19.726Z", "updated_at": "2026-11-09T10:42:19.726Z" } ], "meta": { "total_count": 1, "offset": 0, "limit": 25 }}- El reporte empieza el 1 de enero de 2027. Los suministros anteriores a esta fecha no tienen TDD.
- B2Brouter gestiona esta configuración.
POST,PUTyDELETEsobre/accounts/{ACCOUNT_ID}/tax_report_settings/skdevuelven HTTP 409. - Una cuenta no tiene configuración
skcuando no está en Eslovaquia, cuando no tiene IČ DPH o cuando es una unidad organizativa (oficina). Una oficina reporta a través de su cuenta matriz.
Activa Peppol
Sección titulada «Activa Peppol»Activa Peppol con un transporte Peppol estándar. Para una cuenta eslovaca:
pin_schemedebe ser"0245", ypin_valuees el DIČ (los 10 dígitos del IČ DPH). B2Brouter rechaza cualquier otro esquema con HTTP 422.- Factura y abono (Invoice y Credit Note) siempre están activados, porque todos los participantes receptores eslovacos deben aceptar los dos. La autofacturación se mantiene desactivada.
curl --request POST \ --url https://api.b2brouter.net/accounts/{ACCOUNT_ID}/transports \ --header 'X-B2B-API-Key: {YOUR_API_KEY}' \ --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \ --header 'Content-Type: application/json' \ --data '{ "transport": { "code": "peppol", "enabled": true, "reception": true, "standard_documents": true, "invoice": true, "credit_note": true, "self_billing": false, "application_response": true, "pin_scheme": "0245", "pin_value": "3000000003" } }'POST Transport - API Reference
B2Brouter publica tu empresa como participante Peppol 0245:<DIČ> en el SMP de B2Brouter. El SMP central eslovaco todavía no está activo. Cuando lo esté, B2Brouter publicará en él.
Crea un contacto
Sección titulada «Crea un contacto»Un comprador B2B eslovaco es un contacto normal. Estos campos deciden el enrutamiento y el TDD:
| Campo | Valor | Finalidad |
|---|---|---|
country | "sk" | Solo se genera un TDD para un comprador en Eslovaquia |
tin_scheme, tin_value | 9950, SK<DIČ> | Identificador fiscal del comprador (BT-48). Solo se genera un TDD para un comprador con identificador fiscal |
pin_scheme, pin_value | "0245", <DIČ> | Identificador Peppol del comprador (BT-49) |
city, postalcode | obligatorios | BT-52, BT-53 |
transport_type_code | "peppol" | Entrega por Peppol |
document_type_code | "xml.ubl.invoice.bis3" | Peppol BIS Billing 3.0 |
curl --request POST \ --url https://api.b2brouter.net/accounts/{ACCOUNT_ID}/contacts \ --header 'X-B2B-API-Key: {YOUR_API_KEY}' \ --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \ --header 'Content-Type: application/json' \ --data '{ "contact": { "name": "Odberateľ a.s.", "address": "Hlavná 10", "city": "Košice", "postalcode": "04001", "country": "sk", "currency": "EUR", "tin_scheme": 9950, "tin_value": "SK3000000014", "pin_scheme": "0245", "pin_value": "3000000014", "transport_type_code": "peppol", "document_type_code": "xml.ubl.invoice.bis3" } }'Compradores de fuera de Eslovaquia: una factura a un comprador de fuera de Eslovaquia no tiene TDD. B2Brouter la entrega por Peppol con el esquema propio del comprador, como para cualquier otro país.
Emite facturas
Sección titulada «Emite facturas»Crea la factura con la Invoice API estándar, POST /accounts/{ACCOUNT_ID}/invoices. Usa send_after_import: true para crearla y enviarla en un solo paso.
curl --request POST \ --url https://api.b2brouter.net/accounts/{ACCOUNT_ID}/invoices \ --header 'X-B2B-API-Key: {YOUR_API_KEY}' \ --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \ --header 'Content-Type: application/json' \ --data '{ "send_after_import": true, "invoice": { "type": "IssuedInvoice", "contact_id": {CONTACT_ID}, "number": "FA2027-0001", "date": "2027-01-15", "tax_point_date": "2027-01-15", "due_date": "2027-02-14", "currency": "EUR", "invoice_lines_attributes": [ { "quantity": 10.0, "description": "Consulting services", "price": 150.0, "taxes_attributes": [ { "name": "DPH", "percent": 23.0, "category": "S" } ] } ] } }'Reglas de la factura eslovaca
Sección titulada «Reglas de la factura eslovaca»- Fecha del suministro: indica la fecha del suministro (
tax_point_date, BT-7). B2Brouter la usa para decidir si la factura tiene TDD. Si no está, B2Brouter usa la fecha de entrega, después el final del periodo de facturación y después la fecha de la factura. - Tipos de IVA: 23 %, 19 % y 5 %.
- Tipos de documento con TDD:
380,381,383,388y393. - Sin TDD: tipo
384, autofacturación (389,261), facturas simplificadas, proformas y facturas con solo líneas exentas. - Correcciones: no puedes modificar una factura después de enviarla. Para corregirla, emite un abono (
381) o una factura nueva (380) conamended_number.
El TDD llega después del envío: B2Brouter genera el TDD solo cuando el envío de la factura por Peppol ha ido bien. Por eso la respuesta de
POST /invoicestienetax_report_idsvacío. Vuelve a leer la factura más tarde para obtener su ID.
Ciclo de vida de la factura
Sección titulada «Ciclo de vida de la factura»La factura sigue el ciclo de vida estándar de Peppol:
| Estado | Significado |
|---|---|
new | Creada, no enviada |
sending | B2Brouter (C2) la envía por Peppol |
sent | El punto de acceso del comprador (C3) la tiene |
registered | El punto de acceso del comprador (C3) ha confirmado la entrega |
refused | El comprador (C4) la ha rechazado |
error | B2Brouter no ha podido entregarla. Lee el error, corrige la causa y vuelve a enviarla |
Usa webhooks para seguir los cambios de estado, o lee la factura con GET /invoices/{INVOICE_ID}.
Reporte del TDD
Sección titulada «Reporte del TDD»Cuándo genera B2Brouter un TDD
Sección titulada «Cuándo genera B2Brouter un TDD»B2Brouter genera el TDD de una factura emitida cuando se cumplen todas estas condiciones:
- La cuenta está en Eslovaquia, tiene un IČ DPH (
9950) y tiene el Tax Report Settingsk. - El comprador está en Eslovaquia y tiene identificador fiscal.
- El suministro es a partir del 1 de enero de 2027.
- El tipo de factura tiene TDD (consulta las reglas de la factura eslovaca).
- El envío de la factura por Peppol ha ido bien.
El TDD reporta la factura que B2Brouter ha entregado por Peppol. No tienes que enviar ningún dato del TDD: B2Brouter lo saca de la factura.
Sigue el TDD
Sección titulada «Sigue el TDD»- Lee la factura con
GET /invoices/{INVOICE_ID}. El campotax_report_idscontiene el ID del TDD. - Lee el TDD con
GET /tax_reports/{TAX_REPORT_ID}. SutypeesSkTdd.
| Estado | Significado |
|---|---|
new | B2Brouter ha generado el TDD y todavía no lo ha enviado |
sending | B2Brouter envía el TDD al punto de acceso de la FS (C5) |
sent | El punto de acceso de la FS tiene el TDD. La FS todavía no ha respondido |
registered | La FS ha aceptado el TDD |
refused | La FS ha rechazado el TDD. Consulta errors |
error | B2Brouter no ha podido enviar el TDD. Consulta errors |
GET /tax_reports/{TAX_REPORT_ID}/downloaddevuelve el XML del TDD.- El webhook de TaxReport se activa con
registered,refusedyerror. - B2Brouter crea, envía y finaliza todos los TDD.
POST,PATCHyDELETEde un TaxReportskdevuelven HTTP 409.
La respuesta de la FS (MLS)
Sección titulada «La respuesta de la FS (MLS)»La FS responde a cada TDD con un Peppol Message Level Status (MLS): un ApplicationResponse UBL en el formato MLS de OpenPeppol (urn:peppol:edec:mls:1.0). B2Brouter lo recibe y actualiza el estado del TDD.
ResponseCode del MLS | Estado del TDD |
|---|---|
AP (aceptado) | registered |
RE (rechazado) | refused |
Para obtener el MLS, usa GET /tax_reports/{TAX_REPORT_ID}/download_response:
- Devuelve el MLS del envío actual del TDD.
- Devuelve HTTP 404 mientras la FS no ha respondido.
- Para un TDD en
error, devuelve HTTP 422 con el error del envío.
Un MLS rechazado tiene una descripción general y una línea por cada regla incumplida, con la regla y su texto, y un código de motivo de estado como BV (incumplimiento de una regla de negocio):
<cac:DocumentResponse> <cac:Response> <cbc:ResponseCode>RE</cbc:ResponseCode> <cbc:Description>Rejected due to validation errors</cbc:Description> </cac:Response> <cac:DocumentReference> <cbc:ID>…</cbc:ID> </cac:DocumentReference> <cac:LineResponse> <cac:LineReference><cbc:LineID>NA</cbc:LineID></cac:LineReference> <cac:Response> <cbc:Description>[ibr-tdd-01] – The cbc:CustomizationID (TDT-001) element MUST have the value 'urn:peppol:taxdata:sk-1'.</cbc:Description> <cac:Status><cbc:StatusReasonCode>BV</cbc:StatusReasonCode></cac:Status> </cac:Response> </cac:LineResponse></cac:DocumentResponse>El TaxReport también muestra el motivo en errors:
"errors": [ { "code": "ibr-tdd-01", "description": "BV: The cbc:CustomizationID (TDT-001) element MUST have the value 'urn:peppol:taxdata:sk-1'." }]errorssolo muestra el resultado del envío actual. Un envío nuevo lo vacía.- Sujeto a cambios: el texto de
description. Usacodepara identificar la regla. - Sujeto a cambios: ahora
errorstiene un solo elemento. Versiones posteriores pueden añadir uno por cada motivo. - Sujeto a cambios:
DocumentReference/IDidentifica el mensaje Peppol que ha llevado el TDD.
Si la FS rechaza el TDD
Sección titulada «Si la FS rechaza el TDD»La FS rechaza un TDD cuando los datos de la factura incumplen una regla. Lee errors, corrige los datos y emite una factura rectificativa: un abono (381) o una factura nueva (380) con amended_number.
Recepción de facturas
Sección titulada «Recepción de facturas»Pruebas en el Sandbox
Sección titulada «Pruebas en el Sandbox»El Sandbox ejecuta el flujo de emisión completo con una red Peppol simulada y una FS simulada. Usa una API key test_. Tu Sandbox es una copia de tu empresa de producción.
Qué cambia en el Sandbox:
- Sin el límite de 2027: cualquier fecha de suministro genera un TDD, así que puedes hacer pruebas ya.
- Transporte Peppol: la empresa del Sandbox recibe un transporte activo
0245:<DIČ>cuando B2Brouter crea el Sandbox. - Envío automático: el TDD pasa de
newasendinginmediatamente, y la FS simulada responde al cabo de un rato. - Compradores de prueba: el resultado depende del comprador.
Comprador (pin_scheme:pin_value) | Nombre | Estado de la factura | Estado del TDD |
|---|---|---|---|
0245:2099999902 | Test SK — Registered | registered | registered |
0245:2099999803 | Test SK — Refused | registered | refused |
0245:2099999704 | Test SK — Invoice refused | refused | registered |
0245:2099999605 | Test SK — TDD error | registered | error |
| Cualquier otro comprador SK | sent | registered |
- El TIN de cada comprador de prueba es
9950conSK+ los mismos 10 dígitos, por ejemploSK2099999902. - Los Sandbox nuevos de una empresa eslovaca incluyen estos cuatro contactos. Si tu Sandbox ya existía, crea tú mismo los contactos con los identificadores de la tabla.
- El comprador de prueba «Refused» siempre da la regla
ibr-tdd-01. La FS real puede rechazar por otras reglas. - El comprador de prueba «TDD error» siempre da el código de error
SK_C5_UNREACHABLE, y falla en cada envío. Sujeto a cambios: producción puede usar otros códigos. - En el Sandbox, el
DocumentReference/IDdel MLS es el UUID del TDD.
Consulta también Sandbox para las reglas generales del Sandbox.
Limitaciones
Sección titulada «Limitaciones»Estos casos todavía no están disponibles:
- Un TDD que sustituye (
R) o anula (D) uno anterior. - Un comprador sin IČ DPH.
- Un comprador que no está en Peppol.
- Las comprobaciones automáticas de los requisitos de la factura eslovaca (§ 74 de la ley del IVA).
- Las facturas de autofacturación.