DTE-JSON-Validator für El Salvador
Fügen Sie ein DTE-JSON ein oder laden Sie es hoch und sehen Sie, was das Ministerio de Hacienda voraussichtlich ablehnen würde: Schemafelder, Kontrollnummer, NIT und DUI, IVA, Tributos und Summen innerhalb der Toleranz (holgura) von ±0.01.
Tool
Läuft in Ihrem Browser. Die Datei wird nie hochgeladen.
Häufige Fehler und wie Sie sie beheben
Zehn Ablehnungsgründe aus den offiziellen JSON-Schemas des MH und dem Manual Funcional del Sistema de Transmisión v2.0.
| Regel | Was schiefgeht | So beheben Sie es |
|---|---|---|
| Schema · required | Ein Feld wird weggelassen, weil es nicht zutrifft. | Senden Sie jedes Feld des Schemas; verwenden Sie null, wenn der Wert nicht zutrifft. |
| Schema · additional | Ein Feld aus einem anderen Typ oder einer anderen Version wird gesendet (zum Beispiel v1-Felder in einer Factura v2). | Erzeugen Sie jeden Typ mit der Feldliste seiner aktuellen Schemaversion. |
| Abschnitt XI | numeroControl folgt nicht dem Muster DTE-01-M001P001-000000000000001. | Bilden Sie die Nummer aus Typ, Betriebsstätte, Verkaufsstelle und einer 15-stelligen laufenden Nummer. |
| Schema · pattern | codigoGeneracion ist kleingeschrieben oder keine UUID. | Erzeugen Sie für jeden Beleg eine UUID in Großbuchstaben. |
| Abschnitt XXI | Zu viele Nachkommastellen: Positionen erlauben 8, das Resümee 2. | Runden Sie Positionswerte auf 8 und Werte im Resümee auf 2 Nachkommastellen. |
| Abschnitt XXI | Die Summen im Resümee weichen um mehr als einen Cent von den Positionen ab. | Berechnen Sie das Resümee aus den gerundeten Positionen neu. |
| IVA | IVA falsch berechnet: Eine Factura enthält die IVA, CCF und Notas nicht. | Factura: ivaItem = gravada × 13/113. CCF/Notas: IVA = (gravada − descuento) × 13 % in tributos mit Code 20. |
| Abschnitt XIV | Ein in den Positionen verwendeter Tributo fehlt in resumen.tributos. | Führen Sie jeden Tributo-Code einmal im Resümee mit dem zusammengefassten Betrag auf. |
| Abschnitt XV | Nota de crédito oder débito ohne zugehörigen CCF, oder Positionen verweisen auf einen anderen Beleg. | Tragen Sie den Originalbeleg in documentoRelacionado ein und referenzieren Sie ihn in jeder Position. |
| NIT / DUI | DUI des Empfängers mit falscher Prüfziffer oder eine NIT, die nicht 14 Ziffern hat. | Validieren Sie die Kennungen schon beim Anlegen des Kunden in Ihrem ERP. |
So prüfen Sie beim Finanzministerium, ob ein DTE gültig ist
Dieser Validator prüft Struktur, Schemafelder und Summen eines DTE-JSON, bevor Sie es senden. Er fragt nicht beim Ministerio de Hacienda an und kann Ihnen nicht sagen, ob das MH einen Beleg erhalten hat.
Um ein empfangenes DTE zu prüfen, öffnen Sie die öffentliche Abfrageseite des MH („Consulte su DTE“ auf factura.gob.sv) und geben die beiden geforderten Werte ein: das Erstellungsdatum (fecha de generación) und den código de generación, also die UUID im Abschnitt identificacion des JSON. Ein an das MH übermitteltes DTE trägt außerdem den Empfangsstempel (selloRecibido), den das MH zurückgegeben hat.
Öffentliche DTE-Abfrage des MH · Prüfen Sie zuerst den Empfänger: DUI und NIT validieren.
Spezifikationen, gegen die dieses Tool prüft
- JSON-Schemas des 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 (Abschnitte 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/
Die Schemadateien liegen mit ihren SHA-256-Prüfsummen beim Quellcode des Tools. Das Tool prüft gegen die veröffentlichten Spezifikationen des MH; es ist weder vom Ministerio de Hacienda zertifiziert noch mit ihm verbunden.
Drei Schritte, ohne Anmeldung
JSON einfügen oder hochladen
Verwenden Sie das DTE, das Ihr System vor dem Signieren erzeugt, oder das signierte JWS. Unterstützt werden die Typen 01, 03, 05 und 06.
Bericht lesen
Schemafehler, Rechenprüfungen und Geschäftsregeln werden gruppiert, jeweils mit dem JSON-Pfad und der passenden Korrektur.
Korrigieren, bevor das MH ablehnt
Korrigieren Sie das Feld in SAP Business One oder Ihrem ERP, erzeugen Sie das JSON neu und prüfen Sie erneut. Laden Sie das PDF für Ihr Team herunter.
Fragen zu diesem Tool
Welche DTE-Typen und -Versionen werden geprüft?
Factura (01, Schemaversion 2), Comprobante de Crédito Fiscal (03, Version 4), Nota de Crédito (05, Version 4) und Nota de Débito (06, Version 4) – anhand der JSON-Schemas, die das Ministerio de Hacienda auf factura.gob.sv veröffentlicht.
Was prüft das Tool über das JSON-Schema hinaus?
Das Präfix der Kontrollnummer, die Prüfziffern von NIT und DUI, ob jeder Positionsbetrag Menge × Preis − Rabatt entspricht, die enthaltene IVA mit 13/113 bei einer Factura und 13 % bei CCF und Notas, die Zusammenfassung der Tributos im Resümee, Bezugsbelege bei Gutschriften und Belastungsanzeigen sowie jede Summe im Resümee innerhalb der Ein-Cent-Toleranz (holgura) des MH Manual Funcional.
Prüft das Tool die Signatur oder den Empfangsstempel (sello)?
Nein. Ein signiertes JWS wird dekodiert, damit sein Inhalt geprüft werden kann, aber weder die Signatur noch der sello de recepción des MH werden verifiziert. Das offizielle Ergebnis liefert nur das Übermittlungssystem des MH.
Warum lehnt das MH ein Feld ab, das mein System weglässt?
In den MH-Schemas ist jedes Feld als Pflichtfeld definiert. Trifft ein Wert nicht zu, müssen Sie das Feld trotzdem mit null senden. Zusätzliche Felder, die in der Schemaversion nicht vorkommen, werden ebenfalls abgelehnt.
Bestätigt dieser Validator, dass das MH das DTE angenommen hat?
Nein. Er prüft nur Struktur, Schemafelder und Summen des JSON, bevor Sie es senden, und kontaktiert das Ministerio de Hacienda nie. Ob ein DTE beim MH eingegangen ist, zeigt nur das MH selbst auf seiner öffentlichen Abfrageseite – anhand des Erstellungsdatums und des código de generación.
Ist das ein offizielles Tool des Ministerio de Hacienda?
Nein. Kodenova ist nicht mit dem Ministerio de Hacienda verbunden. Das Tool prüft gegen die veröffentlichten Spezifikationen des MH.
Wird mein DTE irgendwohin hochgeladen?
Nein. Das JSON wird von Ihrem eigenen Browser gelesen und geprüft, und auch das PDF entsteht dort. Nichts wird an Kodenova oder Dritte gesendet.
Für SAP-Business-One-Teams entwickelt
DTE El Salvador aus SAP Business One?
Wir binden SAP B1 an das Übermittlungssystem des MH an: JSON, Signatur, Übermittlung, Notfallverfahren (Contingencia) und Annullierung (Invalidación). Festpreis, meist innerhalb von 24 Stunden angeboten.
