Sandbox (ambiente de pruebas)

Todo lo que haces con una API key sk_test_ ocurre en el ambiente de pruebas (00) del Ministerio de Hacienda. No es una simulación: sudte firma y transmite al servicio de pruebas del MH (apitest.dtes.mh.gob.sv), que valida y sella igual que producción, pero los documentos no tienen valor legal.

• Gratis y sin límite de documentos; solo aplica un límite de velocidad por key.
• Los mismos endpoints, respuestas, webhooks y PDF que en producción. El PDF lleva la leyenda «sin valor legal», como exige la Normativa.
• Numeración propia: los correlativos de pruebas no afectan los de producción.

Cómo obtener tus credenciales de pruebas

Para transmitir a nombre de tu empresa, el MH exige que esté registrada en su ambiente de pruebas con su propio certificado.

1. En factura.gob.sv → Ingresar → Solicitud de Ingreso, entra con el NIT y la clave de Servicios en Línea de la DGII y presenta una nueva solicitud eligiendo la plataforma Sistema de Transmisión DTE. Marca los tipos de documento que emites hoy.
2. En Emisores DTE → Ambiente para pruebas, acredítate: genera el certificado de firma (con clave pública y clave privada) y define la contraseña de acceso a la API. Descarga el archivo .crt.
3. En Consultas → Consultar establecimientos, indica cuántos puntos de venta tiene cada establecimiento y descarga el reporte con sus códigos (M001, P001…).
4. En el panel de sudte, registra el emisor con esos establecimientos y carga, en el ambiente 00, el .crt, la clave de la llave privada, tu NIT como usuario y la contraseña de la API. sudte verifica el certificado y hace un login de prueba.

Consejo

Usa contraseñas de 16 a 25 caracteres con mayúsculas, minúsculas, números y uno de estos símbolos: ! * - _ . @. Así cumplen las reglas de todos los manuales del MH y no fallan en formularios. Más de tres intentos fallidos de login bloquean el usuario de la API: sudte no reintenta con una contraseña rechazada.

Pruebas mínimas para la autorización

Para pedir la autorización como emisor, el MH exige un número mínimo de documentos con sello en el ambiente de pruebas:

Documento o evento	Pruebas mínimas
Factura (01)	90
Comprobante de crédito fiscal (03)	75
Nota de crédito (05)	50
Nota de débito (06)	25
Evento de invalidación	5
Evento de contingencia	5

El plazo para completarlas es de dos meses desde la solicitud. El avance oficial se ve en el inicio del Sitio de Emisores DTE del MH. Te acompañamos en el proceso: escríbenos a soporte@sudte.com.

Datos de prueba

• La factura a consumidor final por menos de $25,000 no necesita identificar al receptor: puedes omitir receiver.
• Para créditos fiscales y notas, el receptor debe tener NIT, NRC, actividad económica y dirección con formato válido.
• Usa dry_run=true mientras ajustas tu integración: no consume correlativos ni transmite nada.
• Las fechas y horas se generan en hora de El Salvador; si envías issued_at, no puede diferir más de 30 minutos del envío.

Pasar a producción

Cuando el MH autorice tu emisor:

1. En el Sitio de Emisores DTE, acredítate en el ambiente productivo: obtendrás un certificado y una contraseña de API nuevos (los de pruebas no sirven en producción).
2. Cárgalos en el panel en el ambiente 01 y prueba la conexión.
3. Crea una API key sk_live_ y cámbiala en tu sistema. Nada más cambia en tu código.

Desde ese momento, los documentos tienen validez tributaria, la numeración de producción empieza en 000000000000001 y cuentan para tu plan.