DTE

Tipos de Documento

Conoce los tipos de documentos tributarios electrónicos disponibles en la API

Factura Electrónica
Código 01POST /factura/emitir
Documento principal para ventas con derecho a crédito fiscal. Utilizado principalmente para ventas a consumidores finales o empresas.

Características:

IVA incluido (13%)Crédito fiscalPagos múltiplesCampos opcionales flexibles
Crédito Fiscal Electrónico
Código 03POST /credito-fiscal/emitir
Para operaciones entre contribuyentes (B2B) con derecho a crédito fiscal. Requiere que el receptor tenga NRC.

Características:

IVA desglosado (13%)Requiere NRC del receptorCrédito fiscal completoCondiciones de pago
Nota de Remisión
Código 04POST /nota-remision/emitir
Para documentar el traslado de mercaderías entre ubicaciones sin transferencia de propiedad.

Características:

Sin valor fiscalTraslado de mercaderíaApéndice para datos de transporteConductor y vehículo opcionales

Comparativa de Documentos

CódigoNombreIVAUso PrincipalRequiere NRC
01Factura Electrónica13%Ventas B2C y B2B generalesNo
03Crédito Fiscal13%Ventas B2B con crédito fiscalSí
04Nota de RemisiónVariable*Traslado de mercaderíasNo

* El IVA en Nota de Remisión se calcula automáticamente según el tipo de item (1 o 2 = 13%, 3 = exento, 4 = no gravado)

Campos Auto-generados

La API genera automáticamente los siguientes campos para simplificar la emisión de DTEs:

Identificación

  • • codigoGeneracion - UUID único del DTE
  • • numeroControl - Número correlativo formateado
  • • fecEmi - Fecha de emisión (YYYY-MM-DD)
  • • horEmi - Hora de emisión (HH:MM:SS)
  • • ambiente - PRUEBAS o PRODUCCION (según API key)
  • • version - Versión del formato DTE

Emisor

  • • nit - NIT del emisor
  • • nrc - NRC del emisor
  • • nombre - Razón social del emisor
  • • codActividad - Código de actividad económica
  • • direccion - Dirección completa del emisor
  • • telefono - Teléfono del emisor
  • • correo - Email del emisor

Cálculos

  • • ventaGravada - Total de ventas gravadas con IVA
  • • ventaExenta - Total de ventas exentas
  • • ventaNoSuj - Total de ventas no sujetas
  • • ivaRete1 - Retención de IVA 1% (si aplica)
  • • totalPagar - Total a pagar
  • • tributos - Array de tributos aplicables

Firma Digital

  • • El DTE se firma automáticamente con el certificado asociado a tu API key
  • • Se genera un JWS (JSON Web Signature) con algoritmo RS512
  • • El dteFirmado se incluye en la respuesta

Consideraciones Importantes

IVA en El Salvador

El Impuesto al Valor Agregado (IVA) en El Salvador es del 13% para la mayoría de productos y servicios. La API calcula automáticamente el IVA según el tipo de item especificado.

Crédito Fiscal - Requisito de NRC

Para emitir un Crédito Fiscal (código 03), el receptor DEBE tener un Número de Registro de Contribuyente (NRC) válido. Este requisito es obligatorio según la normativa del Ministerio de Hacienda.

Nota de Remisión - Apéndice

Las Notas de Remisión permiten incluir un campo apendice con información adicional como conductor, placa del vehículo, origen y destino del traslado. Este campo es opcional pero muy útil para control logístico.

Ambiente de Pruebas vs Producción

Cada API key está asociada a un ambiente específico (PRUEBAS o PRODUCCION). Los DTEs emitidos en PRUEBAS se envían a https://apitest.dtes.mh.gob.sv y no tienen validez fiscal. Los de PRODUCCION se envían a https://api.dtes.mh.gob.sv y tienen plena validez legal.

Otros Tipos de DTE Disponibles

Además de los 3 tipos principales mostrados arriba, la API también soporta los siguientes tipos de DTE (próximamente en la documentación):

05

Nota de Crédito

Para anular o corregir DTEs

06

Nota de Débito

Para cargos adicionales

07

Comprobante de Retención

Para retenciones de IVA

08

Comprobante de Liquidación

Para liquidaciones

11

Factura de Exportación

Para exportaciones

14

Factura Sujeto Excluido

Para contribuyentes exentos

15

Comprobante de Donación

Para donaciones