El Salvador

En El Salvador, Floogos se conecta directo al Ministerio de Hacienda para emitir Documentos Tributarios Electrónicos (DTE). No hay un proveedor intermedio obligatorio: el propio motor arma el documento, lo firma digitalmente y habla directamente con los servicios web de Hacienda.

Modelo de integración

• Directo, sin PAC obligatorio: el motor Floogos arma y transmite el DTE contra los servicios de Hacienda sin depender de un proveedor autorizado intermedio.
• Formato JSON, no XML: a diferencia de la mayoría de los países de la región, el DTE salvadoreño se construye como un documento JSON, no como XML.
• Firma digital JWS: el DTE en JSON se firma con JWS (JSON Web Signature), usando el algoritmo RS512, en lugar del esquema XMLDSig usado en otros países.
• Autenticación por token: antes de transmitir, el nodo obtiene un token de autenticación contra la API de Hacienda con las credenciales del contribuyente.
• Recepción por POST: el DTE firmado se envía mediante un POST de recepción a los servicios de Hacienda.
• Sello de Recepción: cuando Hacienda procesa el documento, devuelve un Sello de Recepción que certifica su validez.
• IVA 13% como tributo: el Impuesto al Valor Agregado se calcula al 13%. En la factura al consumidor final va incluido en el precio; en el Comprobante de Crédito Fiscal se discrimina como tributo aparte.

Cuándo queda válido un documento

Un DTE no queda válido por el solo hecho de enviarlo firmado: recién se considera válido cuando Hacienda responde con estado PROCESADO y entrega el Sello de Recepción. Si Hacienda rechaza el envío, el documento no tiene validez tributaria y hay que corregir y reenviar.

Nodos disponibles

Nodo	Descripción
MhEmitirFactura	Emite factura electrónica al consumidor final: DTE en JSON, firma JWS, token y recepción
MhEmitirComprobante	Emite Comprobante de Crédito Fiscal (03), Nota de Crédito (05) o Nota de Débito (06), con IVA como tributo
MhAnular	Invalida un DTE ya emitido mediante un evento de invalidación firmado

Flujo típico

1. MhEmitirFactura o MhEmitirComprobante — se emite el documento tributario correspondiente según el receptor (consumidor final o contribuyente) y se espera el Sello de Recepción.
2. MhAnular — si el documento tiene un error, se invalida indicando el motivo; los demás datos se recuperan automáticamente a partir del Código de Generación.

Notas

• La credencial de tipo mh guarda el NIT/NRC del emisor, el usuario y clave de la API de Hacienda, el certificado de firma y el entorno (pruebas o producción).
• El codigoGeneracion devuelto en la emisión es el identificador que se necesita después para anular el documento con MhAnular.