Validador de DTE de El Salvador (JSON)
Pegue o suba el JSON de un DTE y vea lo que el Ministerio de Hacienda probablemente rechazaría: campos del esquema, número de control, NIT y DUI, IVA, tributos y totales dentro de la holgura de ±0.01.
Herramienta
Se ejecuta en su navegador. El archivo nunca se sube.
Errores comunes y cómo corregirlos
Diez causas de rechazo tomadas de los esquemas JSON oficiales del MH y del Manual Funcional del Sistema de Transmisión v2.0.
| Regla | Qué falla | Cómo corregirlo |
|---|---|---|
| Esquema · required | Se omite un campo porque no aplica. | Envíe todos los campos del esquema; use null cuando el valor no aplique. |
| Esquema · additional | Se envía un campo de otro tipo o versión (por ejemplo campos de v1 en una Factura v2). | Genere cada tipo con la lista de campos de su versión vigente. |
| Sección XI | numeroControl no sigue el formato DTE-01-M001P001-000000000000001. | Ármelo con el tipo, establecimiento, punto de venta y un correlativo de 15 dígitos. |
| Esquema · pattern | codigoGeneracion en minúsculas o que no es un UUID. | Genere un UUID en mayúsculas para cada documento. |
| Sección XXI | Demasiados decimales: los ítems permiten 8 y el resumen 2. | Redondee los ítems a 8 decimales y el resumen a 2. |
| Sección XXI | Los totales del resumen difieren de los ítems en más de un centavo. | Recalcule el resumen desde los ítems redondeados. |
| IVA | IVA calculado al revés: la Factura incluye IVA, el CCF y las notas no. | Factura: ivaItem = gravada × 13/113. CCF/notas: IVA = (gravada − descuento) × 13% en tributos código 20. |
| Sección XIV | Un tributo usado en los ítems no aparece en resumen.tributos. | Incluya cada código de tributo una vez en el resumen con el monto consolidado. |
| Sección XV | Nota de crédito o débito sin el CCF relacionado, o ítems que apuntan a otro documento. | Agregue el documento original en documentoRelacionado y refiéralo en cada ítem. |
| NIT / DUI | DUI del receptor con dígito verificador incorrecto o NIT que no tiene 14 dígitos. | Valide los documentos al crear el cliente en su ERP. |
Especificaciones contra las que revisa
- Esquemas JSON del 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/ - Manual Funcional del Sistema de Transmisión v2.0 del MH (secciones XI, XIV, XV, XVIII, XXI)
https://factura.gob.sv/informacion-tecnica-y-funcional/ - Catálogos del sistema de facturación v1.2 del MH
https://factura.gob.sv/informacion-tecnica-y-funcional/
Los archivos de esquema se guardan con el código de la herramienta junto a su SHA-256. La herramienta revisa contra las especificaciones publicadas por el MH; no está certificada ni afiliada al Ministerio de Hacienda.
Tres pasos, sin registro
Pegue o suba el JSON
Use el DTE que genera su sistema antes de firmar, o el JWS firmado. Se admiten los tipos 01, 03, 05 y 06.
Lea el informe
Errores de esquema, cálculos y reglas de negocio agrupados, cada uno con la ruta JSON y cómo corregirlo.
Corrija antes que el MH
Corrija el campo en SAP Business One o su ERP, genere de nuevo el JSON y vuelva a validar. Descargue el PDF para su equipo.
Preguntas sobre esta herramienta
¿Qué tipos y versiones de DTE revisa?
Factura (01, esquema versión 2), Comprobante de Crédito Fiscal (03, versión 4), Nota de Crédito (05, versión 4) y Nota de Débito (06, versión 4), con los esquemas JSON que el Ministerio de Hacienda publica en factura.gob.sv.
¿Qué revisa además del esquema JSON?
El prefijo del número de control, los dígitos verificadores de NIT y DUI, que cada ítem sea cantidad × precio − descuento, el IVA incluido de 13/113 en la Factura y el 13% en CCF y notas, la consolidación de tributos en el resumen, los documentos relacionados en notas de crédito y débito y todos los totales del resumen dentro de la holgura de un centavo del Manual Funcional del MH.
¿Verifica la firma o el sello de recepción?
No. Un JWS firmado se decodifica para revisar su contenido, pero no se verifican la firma ni el sello de recepción del MH. Solo el sistema de transmisión del MH da el resultado oficial.
¿Por qué el MH rechaza un campo que mi sistema omite?
Los esquemas del MH marcan todos los campos como requeridos. Cuando un valor no aplica, igual debe enviar el campo con null. Los campos que no existen en la versión del esquema también se rechazan.
¿Es una herramienta oficial del Ministerio de Hacienda?
No. Kodenova no está afiliada al Ministerio de Hacienda. La herramienta revisa contra las especificaciones publicadas por el MH.
¿Se sube mi DTE a algún lugar?
No. Su propio navegador lee y revisa el JSON y también crea el PDF. No se envía nada a Kodenova ni a nadie más.
Hechas para equipos de SAP Business One
¿DTE El Salvador desde SAP Business One?
Conectamos SAP B1 al sistema de transmisión del MH: JSON, firma, transmisión, contingencia e invalidación. Precio fijo, normalmente cotizado en 24 horas.
