Validateur de DTE JSON pour le Salvador
Collez ou importez le JSON d’un DTE et voyez ce que le Ministerio de Hacienda rejetterait probablement : champs du schéma, numéro de contrôle, NIT et DUI, IVA, tributos et totaux dans la tolérance (holgura) de ±0,01.
Outil
Fonctionne dans votre navigateur. Le fichier n’est jamais envoyé.
Erreurs fréquentes et comment les corriger
Dix causes de rejet tirées des schémas JSON officiels du MH et du Manual Funcional del Sistema de Transmisión v2.0.
| Règle | Ce qui ne va pas | Comment corriger |
|---|---|---|
| Schéma · required | Un champ est omis parce qu’il ne s’applique pas. | Envoyez chaque champ du schéma ; utilisez null lorsque la valeur ne s’applique pas. |
| Schéma · additional | Un champ d’un autre type ou d’une autre version est envoyé (par exemple des champs v1 dans une Factura v2). | Générez chaque type avec la liste de champs de sa version de schéma en vigueur. |
| Section XI | numeroControl ne suit pas le modèle DTE-01-M001P001-000000000000001. | Construisez-le à partir du type, de l’établissement, du point de vente et d’un numéro séquentiel à 15 chiffres. |
| Schéma · pattern | codigoGeneracion est en minuscules ou n’est pas un UUID. | Générez un UUID en majuscules pour chaque document. |
| Section XXI | Trop de décimales : les lignes en acceptent 8, le résumé 2. | Arrondissez les valeurs des lignes à 8 décimales et celles du résumé à 2. |
| Section XXI | Les totaux du résumé diffèrent des lignes de plus d’un centime. | Recalculez le résumé à partir des lignes arrondies. |
| IVA | IVA calculée à l’envers : une Factura inclut l’IVA, un CCF et les notes non. | Factura : ivaItem = gravada × 13/113. CCF/notes : IVA = (gravada − descuento) × 13 % dans tributos avec le code 20. |
| Section XIV | Un tributo utilisé dans les lignes manque dans resumen.tributos. | Indiquez chaque code de tributo une seule fois dans le résumé, avec le montant consolidé. |
| Section XV | Nota de crédito ou débito sans le CCF lié, ou lignes qui renvoient à un autre document. | Ajoutez le document d’origine dans documentoRelacionado et référencez-le dans chaque ligne. |
| NIT / DUI | DUI du destinataire avec un chiffre de contrôle erroné, ou NIT qui ne compte pas 14 chiffres. | Validez les identifiants dès la création du client dans votre ERP. |
Comment vérifier auprès du ministère des Finances qu’un DTE est valide
Ce validateur vérifie la structure, les champs du schéma et les totaux du JSON d’un DTE avant l’envoi. Il n’interroge pas le Ministerio de Hacienda et ne peut pas vous dire si le MH a reçu un document.
Pour vérifier un DTE que vous avez reçu, ouvrez la page de consultation publique du MH (« Consulte su DTE » sur factura.gob.sv) et saisissez les deux valeurs demandées : la date de génération (fecha de generación) et le código de generación, c’est-à-dire l’UUID de la section identificacion du JSON. Un DTE transmis au MH porte aussi le cachet de réception (selloRecibido) renvoyé par le MH.
Consultation publique des DTE du MH · Vérifiez d’abord le destinataire : valider le DUI et le NIT.
Spécifications utilisées par cet outil
- Schémas JSON du MH (anexo al Manual Técnico) : fe-f-v2.json, fe-ccf-v4.json, fe-nc-v4.json, fe-nd-v4.json
https://factura.gob.sv/informacion-tecnica-y-funcional/ - MH Manual Funcional del Sistema de Transmisión v2.0 (sections XI, XIV, XV, XVIII, XXI)
https://factura.gob.sv/informacion-tecnica-y-funcional/ - MH catálogos del sistema de facturación v1.2
https://factura.gob.sv/informacion-tecnica-y-funcional/
Les fichiers de schéma sont conservés avec le code source de l’outil, avec leurs empreintes SHA-256. L’outil vérifie selon les spécifications publiées par le MH ; il n’est ni certifié par le Ministerio de Hacienda ni lié à celui-ci.
Trois étapes, sans inscription
Collez ou importez le JSON
Utilisez le DTE généré par votre système avant la signature, ou le JWS signé. Les types 01, 03, 05 et 06 sont pris en charge.
Lisez le rapport
Erreurs de schéma, contrôles de calcul et règles métier sont regroupés, chacun avec le chemin JSON et la correction à apporter.
Corrigez avant le rejet du MH
Corrigez le champ dans SAP Business One ou votre ERP, régénérez le JSON et vérifiez à nouveau. Téléchargez le PDF pour votre équipe.
Questions sur cet outil
Quels types et quelles versions de DTE sont vérifiés ?
Factura (01, schéma version 2), Comprobante de Crédito Fiscal (03, version 4), Nota de Crédito (05, version 4) et Nota de Débito (06, version 4), à partir des schémas JSON publiés par le Ministerio de Hacienda sur factura.gob.sv.
Que vérifie l’outil au-delà du schéma JSON ?
Le préfixe du numéro de contrôle, les chiffres de contrôle du NIT et du DUI, que chaque montant de ligne égale quantité × prix − remise, l’IVA incluse de 13/113 sur une Factura et de 13 % sur un CCF et les notes, la consolidation des tributos dans le résumé, les documents liés sur les avoirs et notes de débit, et chaque total du résumé dans la tolérance d’un centime (holgura) du Manual Funcional du MH.
L’outil vérifie-t-il la signature ou le cachet de réception (sello) ?
Non. Un JWS signé est décodé pour que son contenu puisse être vérifié, mais ni la signature ni le sello de recepción du MH ne sont vérifiés. Seul le système de transmission du MH donne le résultat officiel.
Pourquoi le MH rejette-t-il un champ que mon système omet ?
Les schémas du MH définissent chaque champ comme obligatoire. Si une valeur ne s’applique pas, vous devez quand même envoyer le champ avec null. Les champs supplémentaires absents de la version du schéma sont aussi rejetés.
Ce validateur confirme-t-il que le MH a accepté le DTE ?
Non. Il vérifie seulement la structure, les champs du schéma et les totaux du JSON avant l’envoi, et ne contacte jamais le Ministerio de Hacienda. Seul le MH indique si un DTE a été reçu, sur sa page de consultation publique, à partir de la date de génération et du código de generación.
Est-ce un outil officiel du Ministerio de Hacienda ?
Non. Kodenova n’est pas liée au Ministerio de Hacienda. L’outil vérifie selon les spécifications publiées par le MH.
Mon DTE est-il envoyé quelque part ?
Non. Le JSON est lu et vérifié par votre propre navigateur, et le PDF y est aussi créé. Rien n’est envoyé à Kodenova ni à un tiers.
Conçus pour les équipes SAP Business One
Les DTE du Salvador depuis SAP Business One ?
Nous connectons SAP B1 au système de transmission du MH : JSON, signature, transmission, procédure de secours (contingencia) et annulation (invalidación). Prix fixe, devis généralement sous 24 heures.