Validador de documents i formats

El Validador de B2Brouter ofereix dues maneres de validar un document electrònic: una eina en línia per a comprovacions manuals, i un endpoint d'API per a validació programàtica. Totes dues apliquen les mateixes regles de validació.

Validador en línia

El validador en línia és una eina web gratuïta que et permet comprovar documents manualment, sense escriure cap codi.

Accedeix-hi a app.b2brouter.net/ca/validation.

Com utilitzar-lo

1. Ves a app.b2brouter.net/ca/validation.
2. Puja el teu fitxer XML.
3. Fes clic a Validate.

L'eina retorna una llista d'errors i advertiments, cadascun amb la ubicació XPath de l'element problemàtic i una descripció de la regla que ha fallat.

Endpoint de l'API

L'endpoint /documents/validate et permet validar documents de manera programàtica. Fes-lo servir per integrar la validació a la teva aplicació, pipeline de CI o flux de treball automatitzat.

Consulta la referència completa de l'API a developer.b2brouter.net/reference/validate-document.

Cal autenticació. L'endpoint accepta un fitxer de document i retorna els resultats de validació de manera estructurada.

Què valida

Tant l'eina en línia com l'endpoint de l'API comproven:

• Conformitat amb l'esquema — si l'estructura XML coincideix amb l'especificació del format (per exemple, UBL 2.1 o CII D16B).
• Regles de negoci — si els camps obligatoris són presents i els valors es troben dins dels rangs permesos.
• Regles Schematron — regles de validació específiques del format definides per l'estàndard (per exemple, regles de Peppol BIS o EN 16931).
• Model de dades — comprovacions de camps a la nostra base de dades en relació amb el que requereix l'autoritat tributària.
• Informe fiscal — per a factures que generen un informe fiscal, validació dels valors de la factura necessaris per generar-lo correctament.

Cap de les dues eines comprova si el receptor existeix ni si la informació d'encaminament és correcta — això es valida en el moment de l'enviament.

Validació en crear un document mitjançant l'API

La mateixa validació s'executa automàticament quan envies un document a través de l'API (per exemple, POST /documents). Si el document no és vàlid, l'API retorna un error de validació i el document és rebutjat abans d'entrar al sistema.

Això significa que no cal cridar /documents/validate per separat abans de cada enviament, però resulta útil per depurar i fer comprovacions prèvies durant el desenvolupament.

Interpretació dels resultats

Resultat	Significat
Vàlid	El document compleix totes les regles d'esquema i de negoci del format seleccionat.
Advertiment	El document és tècnicament vàlid, però conté valors que poden causar problemes amb alguns receptors.
Error	El document no compleix el format. Serà rebutjat si s'envia.

Corregeix tots els errors abans d'utilitzar el document en una integració real. Els advertiments són informatius, però convé revisar-los.

Formats compatibles

El validador admet els principals formats acceptats per B2Brouter, incloent-hi:

• Peppol BIS Billing 3.0 (UBL)
• EN 16931 (estàndard europeu)
• Factura-e (Espanya)
• FatturaPA (Itàlia)
• UBL 2.1 Invoice / Credit Note

La llista completa de formats disponibles es mostra al selector de formats de la pàgina de validació.

Casos d'ús habituals

• Abans de passar a producció — valida documents de mostra del teu ERP o sistema de facturació per detectar problemes d'integració amb antelació.
• Depuració d'errors de l'API — si l'API retorna un error de validació de format, fes servir l'eina en línia per obtenir un desglossament detallat.
• Proves de nous formats — quan afegeixis suport per a un nou país o format, valida la sortida abans d'executar proves completes d'extrem a extrem.
• Comprovacions automatitzades prèvies — crida /documents/validate des del teu pipeline de CI o capa d'integració abans d'enviar documents a producció.