Factura electrònica i report del TDD a Eslovàquia
Guia per integrar l'API de B2Brouter i complir amb l'obligació eslovaca de factura electrònica i de report des del teu propi sistema.
A partir de l’1 de gener de 2027, cada subjecte passiu d’IVA registrat a Eslovàquia ha d’emetre factures electròniques estructurades per als seus subministraments B2B nacionals i enviar-les per la xarxa Peppol. El punt d’accés també ha de reportar les dades de cada factura a l’Administració Financera (Finančná správa, FS) com a Tax Data Document (TDD). B2Brouter ho fa per tu: envies les dades de la factura per la REST API, i B2Brouter genera la factura Peppol BIS 3, la lliura al comprador, i genera i envia el TDD.
| Què fa B2Brouter per tu | Detalls |
|---|---|
| Punt d’accés Peppol | Lliura les teves factures al punt d’accés del comprador (C2 → C3) i rep les teves factures (C3 → C2) |
| Registre a Peppol | Publica la teva empresa com a participant Peppol 0245:<DIČ> |
| Generació de documents | Envies JSON, i B2Brouter genera la factura o l’abonament Peppol BIS Billing 3.0 |
| Report del TDD | Genera el TDD de cada factura que s’ha de reportar i l’envia al punt d’accés de la FS (C5) |
| Resposta de la FS | Rep el Message Level Status (MLS) de la FS i actualitza l’estat del TDD |
| Arxiu legal | Conserva les factures, els TDD i les respostes MLS durant els 10 anys que exigeix la llei |
El camí fins a la primera factura: crea el compte amb l’IČ DPH → comprova el Tax Report Setting sk → activa Peppol → crea un contacte → emet la factura → segueix el TDD.
Context normatiu: la Llei 385/2025 Coll. modifica la llei eslovaca de l’IVA (222/2004 Coll.). A partir de l’1 de gener de 2027, un subjecte passiu d’IVA emet factures electròniques (EN 16931) per als subministraments nacionals a empreses i persones jurídiques establertes a Eslovàquia, i les envia per un servei de lliurament certificat (un punt d’accés Peppol). El proveïdor i el client reporten les dades de la factura a l’Administració Financera en un termini de cinc dies, a través del servei de lliurament. Tots els subjectes passius i persones jurídiques nacionals han de poder rebre factures electròniques. A partir de l’1 de juliol de 2030, s’apliquen les regles definitives: report per transacció dels subministraments nacionals i transfronterers, i fi de la declaració de control (control statement).
Per a qui és aquesta guia?
Section titled “Per a qui és aquesta guia?”eDocExchange: empreses que connecten el seu ERP o programari de comptabilitat a B2Brouter. Crees el compte una vegada (interfície web o API) i després emets les factures i en segueixes el cicle de vida per l’API.
eDocSync: proveïdors de programari que ofereixen el compliment eslovac als seus propis clients. Crees els comptes dels teus clients per l’API, emets les seves factures i en segueixes el cicle de vida. Els teus clients no necessiten accés a B2Brouter.
Les funcions eslovaques són les mateixes en tots dos models.
Abans de començar
Section titled “Abans de començar”Entorns
Section titled “Entorns”| Entorn | API de B2Brouter | Ús |
|---|---|---|
| Producció | https://api.b2brouter.net | Factures reals i TDD reals |
| Sandbox | https://api.b2brouter.net amb una API key test_ | Proves del flux complet, amb una xarxa Peppol simulada i una FS simulada |
Credencials de l’API
Section titled “Credencials de l’API”L’autenticació fa servir una API key estàtica a la capçalera HTTP X-B2B-API-Key. Genera-la a la interfície de B2Brouter, a Desenvolupadors → API Keys. Indica també X-B2B-API-Version a cada petició.
És la primera vegada que fas servir l’API? Comença per la introducció a l’API: entorns, API key i primera petició.
Identificadors eslovacs
Section titled “Identificadors eslovacs”Una empresa eslovaca té tres identificadors. Cadascun té el seu lloc a B2Brouter:
| Identificador | Format | Esquema | On va | Què activa |
|---|---|---|---|---|
| IČ DPH (número d’IVA) | SK + 10 dígits | tin_scheme: 9950 | TIN del compte i dels contactes | Report del TDD (automàtic) |
| DIČ (número fiscal) | 10 dígits | "0245" | Identificador Peppol (pin_scheme, pin_value) | Participant Peppol 0245:<DIČ> |
| IČO (número d’empresa) | 8 dígits | cin_scheme: "0158" | CIN (número d’empresa) del compte | Res per si sol |
- Els 10 dígits de l’IČ DPH són el DIČ:
SK2022222222té el DIČ2022222222. - L’IČO és sempre un número d’empresa (
cin_scheme), mai un TIN. - El Peppol eslovac identifica cada participant amb el DIČ (
0245). L’IČ DPH (9950) no és un identificador Peppol vàlid a Eslovàquia.
Crea el compte de l’empresa
Section titled “Crea el compte de l’empresa”Crea el compte amb POST /accounts. Per al report del TDD eslovac, el compte necessita:
| Camp | Valor |
|---|---|
country | "sk" |
tin_scheme, tin_value | 9950, SK<DIČ> |
cin_scheme, cin_value | "0158", l’IČO (opcional) |
address, city, postalcode | l’adreça de l’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
Section titled “El Tax Report Setting sk”B2Brouter crea el Tax Report Setting sk automàticament quan un compte a Eslovàquia té un IČ DPH (9950): quan crees el compte, o quan hi afegeixes l’IČ DPH més tard. No l’has de crear tu.
Per consultar-lo, fes servir 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 report comença l’1 de gener de 2027. Els subministraments anteriors a aquesta data no tenen TDD.
- B2Brouter gestiona aquesta configuració.
POST,PUTiDELETEsobre/accounts/{ACCOUNT_ID}/tax_report_settings/skretornen HTTP 409. - Un compte no té configuració
skquan no és a Eslovàquia, quan no té IČ DPH o quan és una unitat organitzativa (oficina). Una oficina reporta a través del seu compte matriu.
Activa Peppol
Section titled “Activa Peppol”Activa Peppol amb un transport Peppol estàndard. Per a un compte eslovac:
pin_schemeha de ser"0245", ipin_valueés el DIČ (els 10 dígits de l’IČ DPH). B2Brouter refusa qualsevol altre esquema amb HTTP 422.- Factura i abonament (Invoice i Credit Note) sempre estan activats, perquè tots els participants receptors eslovacs han d’acceptar tots dos. L’autofacturació es manté 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 la teva empresa com a participant Peppol 0245:<DIČ> a l’SMP de B2Brouter. L’SMP central eslovac encara no està actiu. Quan ho estigui, B2Brouter hi publicarà.
Crea un contacte
Section titled “Crea un contacte”Un comprador B2B eslovac és un contacte normal. Aquests camps decideixen l’encaminament i el TDD:
| Camp | Valor | Finalitat |
|---|---|---|
country | "sk" | Només es genera un TDD per a un comprador a Eslovàquia |
tin_scheme, tin_value | 9950, SK<DIČ> | Identificador fiscal del comprador (BT-48). Només es genera un TDD per a un comprador amb identificador fiscal |
pin_scheme, pin_value | "0245", <DIČ> | Identificador Peppol del comprador (BT-49) |
city, postalcode | obligatoris | BT-52, BT-53 |
transport_type_code | "peppol" | Lliurament per 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" } }'Compradors de fora d’Eslovàquia: una factura a un comprador de fora d’Eslovàquia no té TDD. B2Brouter la lliura per Peppol amb l’esquema propi del comprador, com per a qualsevol altre país.
Emet factures
Section titled “Emet factures”Crea la factura amb l’Invoice API estàndard, POST /accounts/{ACCOUNT_ID}/invoices. Fes servir send_after_import: true per crear-la i enviar-la en un sol pas.
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" } ] } ] } }'Regles de la factura eslovaca
Section titled “Regles de la factura eslovaca”- Data del subministrament: indica la data del subministrament (
tax_point_date, BT-7). B2Brouter la fa servir per decidir si la factura té TDD. Si no hi és, B2Brouter fa servir la data de lliurament, després el final del període de facturació i després la data de la factura. - Tipus d’IVA: 23 %, 19 % i 5 %.
- Tipus de document amb TDD:
380,381,383,388i393. - Sense TDD: tipus
384, autofacturació (389,261), factures simplificades, proformes i factures amb només línies exemptes. - Correccions: no pots modificar una factura després d’enviar-la. Per corregir-la, emet un abonament (
381) o una factura nova (380) ambamended_number.
El TDD arriba després de l’enviament: B2Brouter genera el TDD només quan l’enviament de la factura per Peppol ha anat bé. Per això la resposta de
POST /invoicestétax_report_idsbuit. Torna a llegir la factura més tard per obtenir-ne l’ID.
Cicle de vida de la factura
Section titled “Cicle de vida de la factura”La factura segueix el cicle de vida estàndard de Peppol:
| Estat | Significat |
|---|---|
new | Creada, no enviada |
sending | B2Brouter (C2) l’envia per Peppol |
sent | El punt d’accés del comprador (C3) la té |
registered | El punt d’accés del comprador (C3) n’ha confirmat el lliurament |
refused | El comprador (C4) l’ha refusada |
error | B2Brouter no l’ha pogut lliurar. Llegeix l’error, corregeix-ne la causa i torna-la a enviar |
Fes servir webhooks per seguir els canvis d’estat, o llegeix la factura amb GET /invoices/{INVOICE_ID}.
Report del TDD
Section titled “Report del TDD”Quan genera B2Brouter un TDD
Section titled “Quan genera B2Brouter un TDD”B2Brouter genera el TDD d’una factura emesa quan es compleixen totes aquestes condicions:
- El compte és a Eslovàquia, té un IČ DPH (
9950) i té el Tax Report Settingsk. - El comprador és a Eslovàquia i té identificador fiscal.
- El subministrament és a partir de l’1 de gener de 2027.
- El tipus de factura té TDD (consulta les regles de la factura eslovaca).
- L’enviament de la factura per Peppol ha anat bé.
El TDD reporta la factura que B2Brouter ha lliurat per Peppol. No has d’enviar cap dada del TDD: B2Brouter la treu de la factura.
Segueix el TDD
Section titled “Segueix el TDD”- Llegeix la factura amb
GET /invoices/{INVOICE_ID}. El camptax_report_idsconté l’ID del TDD. - Llegeix el TDD amb
GET /tax_reports/{TAX_REPORT_ID}. El seutypeésSkTdd.
| Estat | Significat |
|---|---|
new | B2Brouter ha generat el TDD i encara no l’ha enviat |
sending | B2Brouter envia el TDD al punt d’accés de la FS (C5) |
sent | El punt d’accés de la FS té el TDD. La FS encara no ha respost |
registered | La FS ha acceptat el TDD |
refused | La FS ha refusat el TDD. Consulta errors |
error | B2Brouter no ha pogut enviar el TDD. Consulta errors |
GET /tax_reports/{TAX_REPORT_ID}/downloadretorna l’XML del TDD.- El webhook de TaxReport s’activa amb
registered,refusedierror. - B2Brouter crea, envia i finalitza tots els TDD.
POST,PATCHiDELETEd’un TaxReportskretornen HTTP 409.
La resposta de la FS (MLS)
Section titled “La resposta de la FS (MLS)”La FS respon cada TDD amb un Peppol Message Level Status (MLS): un ApplicationResponse UBL en el format MLS d’OpenPeppol (urn:peppol:edec:mls:1.0). B2Brouter el rep i actualitza l’estat del TDD.
ResponseCode de l’MLS | Estat del TDD |
|---|---|
AP (acceptat) | registered |
RE (refusat) | refused |
Per obtenir l’MLS, fes servir GET /tax_reports/{TAX_REPORT_ID}/download_response:
- Retorna l’MLS de l’enviament actual del TDD.
- Retorna HTTP 404 mentre la FS no ha respost.
- Per a un TDD en
error, retorna HTTP 422 amb l’error de l’enviament.
Un MLS refusat té una descripció general i una línia per cada regla incomplerta, amb la regla i el seu text, i un codi de motiu d’estat com ara BV (incompliment d’una regla de negoci):
<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 també mostra el motiu a errors:
"errors": [ { "code": "ibr-tdd-01", "description": "BV: The cbc:CustomizationID (TDT-001) element MUST have the value 'urn:peppol:taxdata:sk-1'." }]errorsnomés mostra el resultat de l’enviament actual. Un enviament nou el buida.- Subjecte a canvis: el text de
description. Fes servircodeper identificar la regla. - Subjecte a canvis: ara
errorsté un sol element. Versions posteriors poden afegir-ne un per cada motiu. - Subjecte a canvis:
DocumentReference/IDidentifica el missatge Peppol que ha portat el TDD.
Si la FS refusa el TDD
Section titled “Si la FS refusa el TDD”La FS refusa un TDD quan les dades de la factura incompleixen una regla. Llegeix errors, corregeix les dades i emet una factura rectificativa: un abonament (381) o una factura nova (380) amb amended_number.
Recepció de factures
Section titled “Recepció de factures”Proves al Sandbox
Section titled “Proves al Sandbox”El Sandbox executa el flux d’emissió complet amb una xarxa Peppol simulada i una FS simulada. Fes servir una API key test_. El teu Sandbox és una còpia de la teva empresa de producció.
Què canvia al Sandbox:
- Sense el límit del 2027: qualsevol data de subministrament genera un TDD, de manera que pots fer proves ara.
- Transport Peppol: l’empresa del Sandbox rep un transport actiu
0245:<DIČ>quan B2Brouter crea el Sandbox. - Enviament automàtic: el TDD passa de
newasendingimmediatament, i la FS simulada respon al cap d’una estona. - Compradors de prova: el resultat depèn del comprador.
Comprador (pin_scheme:pin_value) | Nom | Estat de la factura | Estat 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 |
| Qualsevol altre comprador SK | sent | registered |
- El TIN de cada comprador de prova és
9950ambSK+ els mateixos 10 dígits, per exempleSK2099999902. - Els Sandbox nous d’una empresa eslovaca inclouen aquests quatre contactes. Si el teu Sandbox ja existia, crea tu mateix els contactes amb els identificadors de la taula.
- El comprador de prova «Refused» sempre dona la regla
ibr-tdd-01. La FS real pot refusar per altres regles. - El comprador de prova «TDD error» sempre dona el codi d’error
SK_C5_UNREACHABLE, i falla a cada enviament. Subjecte a canvis: producció pot fer servir altres codis. - Al Sandbox, el
DocumentReference/IDde l’MLS és l’UUID del TDD.
Consulta també Sandbox per a les regles generals del Sandbox.
Limitacions
Section titled “Limitacions”Aquests casos encara no estan disponibles:
- Un TDD que substitueix (
R) o anul·la (D) un d’anterior. - Un comprador sense IČ DPH.
- Un comprador que no és a Peppol.
- Les comprovacions automàtiques dels requisits de la factura eslovaca (§ 74 de la llei de l’IVA).
- Les factures d’autofacturació.