Salta al contingut
Log in

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 tuDetalls
Punt d’accés PeppolLliura les teves factures al punt d’accés del comprador (C2 → C3) i rep les teves factures (C3 → C2)
Registre a PeppolPublica la teva empresa com a participant Peppol 0245:<DIČ>
Generació de documentsEnvies JSON, i B2Brouter genera la factura o l’abonament Peppol BIS Billing 3.0
Report del TDDGenera 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 FSRep el Message Level Status (MLS) de la FS i actualitza l’estat del TDD
Arxiu legalConserva 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).

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.

EntornAPI de B2BrouterÚs
Produccióhttps://api.b2brouter.netFactures reals i TDD reals
Sandboxhttps://api.b2brouter.net amb una API key test_Proves del flux complet, amb una xarxa Peppol simulada i una FS simulada

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ó.

Una empresa eslovaca té tres identificadors. Cadascun té el seu lloc a B2Brouter:

IdentificadorFormatEsquemaOn vaQuè activa
IČ DPH (número d’IVA)SK + 10 dígitstin_scheme: 9950TIN del compte i dels contactesReport 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ígitscin_scheme: "0158"CIN (número d’empresa) del compteRes per si sol
  • Els 10 dígits de l’IČ DPH són el DIČ: SK2022222222 té 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 amb POST /accounts. Per al report del TDD eslovac, el compte necessita:

CampValor
country"sk"
tin_scheme, tin_value9950, SK<DIČ>
cin_scheme, cin_value"0158", l’IČO (opcional)
address, city, postalcodel’adreça de l’empresa
Finestra del 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à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, PUT i DELETE sobre /accounts/{ACCOUNT_ID}/tax_report_settings/sk retornen HTTP 409.
  • Un compte no té configuració sk quan 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 amb un transport Peppol estàndard. Per a un compte eslovac:

  • pin_scheme ha de ser "0245", i pin_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.
Finestra del 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 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à.

Un comprador B2B eslovac és un contacte normal. Aquests camps decideixen l’encaminament i el TDD:

CampValorFinalitat
country"sk"Només es genera un TDD per a un comprador a Eslovàquia
tin_scheme, tin_value9950, 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, postalcodeobligatorisBT-52, BT-53
transport_type_code"peppol"Lliurament per Peppol
document_type_code"xml.ubl.invoice.bis3"Peppol BIS Billing 3.0
Finestra del 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

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.

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.

Finestra del 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" }
]
}
]
}
}'
  • 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, 388 i 393.
  • 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) amb amended_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 /invoices té tax_report_ids buit. Torna a llegir la factura més tard per obtenir-ne l’ID.

La factura segueix el cicle de vida estàndard de Peppol:

EstatSignificat
newCreada, no enviada
sendingB2Brouter (C2) l’envia per Peppol
sentEl punt d’accés del comprador (C3) la té
registeredEl punt d’accés del comprador (C3) n’ha confirmat el lliurament
refusedEl comprador (C4) l’ha refusada
errorB2Brouter 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}.

B2Brouter genera el TDD d’una factura emesa quan es compleixen totes aquestes condicions:

  1. El compte és a Eslovàquia, té un IČ DPH (9950) i té el Tax Report Setting sk.
  2. El comprador és a Eslovàquia i té identificador fiscal.
  3. El subministrament és a partir de l’1 de gener de 2027.
  4. El tipus de factura té TDD (consulta les regles de la factura eslovaca).
  5. 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.

  1. Llegeix la factura amb GET /invoices/{INVOICE_ID}. El camp tax_report_ids conté l’ID del TDD.
  2. Llegeix el TDD amb GET /tax_reports/{TAX_REPORT_ID}. El seu type és SkTdd.
EstatSignificat
newB2Brouter ha generat el TDD i encara no l’ha enviat
sendingB2Brouter envia el TDD al punt d’accés de la FS (C5)
sentEl punt d’accés de la FS té el TDD. La FS encara no ha respost
registeredLa FS ha acceptat el TDD
refusedLa FS ha refusat el TDD. Consulta errors
errorB2Brouter no ha pogut enviar el TDD. Consulta errors
  • GET /tax_reports/{TAX_REPORT_ID}/download retorna l’XML del TDD.
  • El webhook de TaxReport s’activa amb registered, refused i error.
  • B2Brouter crea, envia i finalitza tots els TDD. POST, PATCH i DELETE d’un TaxReport sk retornen HTTP 409.

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’MLSEstat 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'."
}
]
  • errors només mostra el resultat de l’enviament actual. Un enviament nou el buida.
  • Subjecte a canvis: el text de description. Fes servir code per identificar la regla.
  • Subjecte a canvis: ara errors té un sol element. Versions posteriors poden afegir-ne un per cada motiu.
  • Subjecte a canvis: DocumentReference/ID identifica el missatge Peppol que ha portat 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.

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 new a sending immediatament, i la FS simulada respon al cap d’una estona.
  • Compradors de prova: el resultat depèn del comprador.
Comprador (pin_scheme:pin_value)NomEstat de la facturaEstat del TDD
0245:2099999902Test SK — Registeredregisteredregistered
0245:2099999803Test SK — Refusedregisteredrefused
0245:2099999704Test SK — Invoice refusedrefusedregistered
0245:2099999605Test SK — TDD errorregisterederror
Qualsevol altre comprador SKsentregistered
  • El TIN de cada comprador de prova és 9950 amb SK + els mateixos 10 dígits, per exemple SK2099999902.
  • 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/ID de l’MLS és l’UUID del TDD.

Consulta també Sandbox per a les regles generals del Sandbox.

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ó.

Última actualització: