Ir al contenido
Log in

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 tiDetalles
Punto de acceso PeppolEntrega tus facturas al punto de acceso del comprador (C2 → C3) y recibe tus facturas (C3 → C2)
Registro en PeppolPublica tu empresa como participante Peppol 0245:<DIČ>
Generación de documentosEnvías JSON, y B2Brouter genera la factura o el abono Peppol BIS Billing 3.0
Reporte del TDDGenera el TDD de cada factura que se debe reportar y lo envía al punto de acceso de la FS (C5)
Respuesta de la FSRecibe el Message Level Status (MLS) de la FS y actualiza el estado del TDD
Archivo legalConserva 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).

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.

EntornoAPI de B2BrouterUso
Producciónhttps://api.b2brouter.netFacturas reales y TDD reales
Sandboxhttps://api.b2brouter.net con una API key test_Pruebas del flujo completo, con una red Peppol simulada y una FS simulada

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.

Una empresa eslovaca tiene tres identificadores. Cada uno tiene su lugar en B2Brouter:

IdentificadorFormatoEsquemaDónde vaQué activa
IČ DPH (número de IVA)SK + 10 dígitostin_scheme: 9950TIN de la cuenta y de los contactosReporte 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ígitoscin_scheme: "0158"CIN (número de empresa) de la cuentaNada por sí solo
  • Los 10 dígitos del IČ DPH son el DIČ: SK2022222222 tiene 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 con POST /accounts. Para el reporte del TDD eslovaco, la cuenta necesita:

CampoValor
country"sk"
tin_scheme, tin_value9950, SK<DIČ>
cin_scheme, cin_value"0158", el IČO (opcional)
address, city, postalcodela dirección de la empresa
Ventana de terminal
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"
}
}'

POST Account - API Reference

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, PUT y DELETE sobre /accounts/{ACCOUNT_ID}/tax_report_settings/sk devuelven HTTP 409.
  • Una cuenta no tiene configuración sk cuando 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 con un transporte Peppol estándar. Para una cuenta eslovaca:

  • pin_scheme debe ser "0245", y pin_value es 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.
Ventana de terminal
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.

Un comprador B2B eslovaco es un contacto normal. Estos campos deciden el enrutamiento y el TDD:

CampoValorFinalidad
country"sk"Solo se genera un TDD para un comprador en Eslovaquia
tin_scheme, tin_value9950, 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, postalcodeobligatoriosBT-52, BT-53
transport_type_code"peppol"Entrega por Peppol
document_type_code"xml.ubl.invoice.bis3"Peppol BIS Billing 3.0
Ventana de terminal
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"
}
}'

POST Contact - API Reference

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.

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.

Ventana de terminal
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" }
]
}
]
}
}'
  • 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, 388 y 393.
  • 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) con amended_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 /invoices tiene tax_report_ids vacío. Vuelve a leer la factura más tarde para obtener su ID.

La factura sigue el ciclo de vida estándar de Peppol:

EstadoSignificado
newCreada, no enviada
sendingB2Brouter (C2) la envía por Peppol
sentEl punto de acceso del comprador (C3) la tiene
registeredEl punto de acceso del comprador (C3) ha confirmado la entrega
refusedEl comprador (C4) la ha rechazado
errorB2Brouter 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}.

B2Brouter genera el TDD de una factura emitida cuando se cumplen todas estas condiciones:

  1. La cuenta está en Eslovaquia, tiene un IČ DPH (9950) y tiene el Tax Report Setting sk.
  2. El comprador está en Eslovaquia y tiene identificador fiscal.
  3. El suministro es a partir del 1 de enero de 2027.
  4. El tipo de factura tiene TDD (consulta las reglas de la factura eslovaca).
  5. 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.

  1. Lee la factura con GET /invoices/{INVOICE_ID}. El campo tax_report_ids contiene el ID del TDD.
  2. Lee el TDD con GET /tax_reports/{TAX_REPORT_ID}. Su type es SkTdd.
EstadoSignificado
newB2Brouter ha generado el TDD y todavía no lo ha enviado
sendingB2Brouter envía el TDD al punto de acceso de la FS (C5)
sentEl punto de acceso de la FS tiene el TDD. La FS todavía no ha respondido
registeredLa FS ha aceptado el TDD
refusedLa FS ha rechazado el TDD. Consulta errors
errorB2Brouter no ha podido enviar el TDD. Consulta errors
  • GET /tax_reports/{TAX_REPORT_ID}/download devuelve el XML del TDD.
  • El webhook de TaxReport se activa con registered, refused y error.
  • B2Brouter crea, envía y finaliza todos los TDD. POST, PATCH y DELETE de un TaxReport sk devuelven HTTP 409.

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 MLSEstado 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'."
}
]
  • errors solo muestra el resultado del envío actual. Un envío nuevo lo vacía.
  • Sujeto a cambios: el texto de description. Usa code para identificar la regla.
  • Sujeto a cambios: ahora errors tiene un solo elemento. Versiones posteriores pueden añadir uno por cada motivo.
  • Sujeto a cambios: DocumentReference/ID identifica el mensaje Peppol que ha llevado 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.

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 new a sending inmediatamente, y la FS simulada responde al cabo de un rato.
  • Compradores de prueba: el resultado depende del comprador.
Comprador (pin_scheme:pin_value)NombreEstado de la facturaEstado del TDD
0245:2099999902Test SK — Registeredregisteredregistered
0245:2099999803Test SK — Refusedregisteredrefused
0245:2099999704Test SK — Invoice refusedrefusedregistered
0245:2099999605Test SK — TDD errorregisterederror
Cualquier otro comprador SKsentregistered
  • El TIN de cada comprador de prueba es 9950 con SK + los mismos 10 dígitos, por ejemplo SK2099999902.
  • 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/ID del MLS es el UUID del TDD.

Consulta también Sandbox para las reglas generales del Sandbox.

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.

Última actualización: