Documentación

Inicio rápido

Empiece a procesar facturas electrónicas en menos de 5 minutos. FACTURA-SV automatiza la extracción de datos, la firma digital y la transmisión de Documentos Tributarios Electrónicos (DTE) al Ministerio de Hacienda de El Salvador.

Formatos soportados

FACTURA-SV acepta múltiples formatos de entrada. El sistema utiliza algoritmos de extracción inteligente y OCR con IA para obtener los campos del DTE automáticamente.

Formato	Extensiones	Precisión estimada	Notas
JSON DTE	.json	100%	Formato nativo de la DGII. Extracción directa sin conversión.
XML	.xml	95%+	Compatible con sistemas ERP que exportan en XML.
PDF (texto)	.pdf	90%+	PDFs generados digitalmente con texto seleccionable.
PDF (escaneado)	.pdf	85%+	Procesado con OCR. Mejor resultado con escaneos de alta resolución.
Imágenes	.jpg, .png	80%+	Fotografías de facturas. Recomendado: buena iluminación y enfoque.

Configurar credenciales del Ministerio de Hacienda

Cada empresa registrada en FACTURA-SV requiere sus propias credenciales para interactuar con el sistema de facturación electrónica del Ministerio de Hacienda. Estas credenciales son necesarias para firmar digitalmente cada DTE y transmitirlo a la DGII.

Datos requeridos

• NIT — Número de Identificación Tributaria del contribuyente.
• NRC — Número de Registro de Contribuyente (registro IVA).
• Certificado de firma electrónica — Archivo .p12 o .pfx emitido gratuitamente por la DGII.
• Contraseña del certificado — La contraseña que protege el archivo del certificado.

Cómo configurar

1. Inicie sesión en el dashboard de FACTURA-SV.
2. Vaya a Configuración → Credenciales MH.
3. Ingrese su NIT y NRC.
4. Suba su certificado .p12 o .pfx.
5. Ingrese la contraseña del certificado.
6. Seleccione el ambiente: Pruebas (para testing) o Producción (para transmisiones reales).
7. Guarde los cambios.

Usar el dashboard

El dashboard es el centro de control de FACTURA-SV. Desde aquí puede monitorear el estado de sus DTEs, subir nuevas facturas, exportar reportes y gestionar la configuración de su cuenta.

Panel de métricas

Al ingresar, verá cuatro métricas principales en tiempo real:

• Procesadas hoy — Cantidad de facturas procesadas en el día actual.
• Pendientes — Facturas extraídas pero aún no transmitidas al MH.
• Errores — Facturas rechazadas por el MH o con errores de extracción.
• Tasa de éxito — Porcentaje de DTEs aceptados por Hacienda sobre el total transmitido.

Tabla de facturas

La tabla central muestra todas las facturas procesadas con las siguientes columnas: fecha, tipo de DTE, NIT emisor, NIT receptor, número de control, monto total y estado. Puede filtrar por:

• Rango de fechas
• NIT del emisor o receptor
• Estado (pendiente, transmitido, aceptado, rechazado)
• Tipo de DTE (Factura, CCF, Nota de Crédito, etc.)

Acciones disponibles

• Ver detalle — Muestra todos los campos extraídos del DTE y el JSON completo.
• Reprocesar — Vuelve a extraer los datos del documento original (útil si editó la fuente).
• Transmitir — Firma y envía el DTE al Ministerio de Hacienda.
• Exportar — Descarga los datos en formato CSV, XLSX o PDF.

Subir facturas

FACTURA-SV acepta facturas individuales o en lote. El procesamiento es automático: al subir un archivo, el sistema identifica el formato, extrae los datos del DTE y los presenta para su revisión.

Métodos de subida

• Drag & drop — Arrastre archivos directamente al área de subida en el dashboard.
• Click para seleccionar — Haga click en el área de subida para abrir el explorador de archivos.
• API — Envíe archivos programáticamente vía POST /api/invoices/upload. Consulte la API Reference.

Límites

• Tamaño máximo por archivo: 10 MB.
• Formatos aceptados: .json, .xml, .pdf, .jpg, .png.
• Procesamiento en lote: hasta 50 archivos simultáneos.

Detección de duplicados

El sistema detecta automáticamente facturas duplicadas comparando la combinación de NIT emisor + número de control + fecha + monto total. Si se detecta un duplicado, la factura se marca con una alerta y no se transmite automáticamente.

Transmitir DTEs al Ministerio de Hacienda

La transmisión es el paso final: el DTE se firma digitalmente con su certificado electrónico y se envía a la API REST del Ministerio de Hacienda. Si el documento cumple con todas las validaciones, la DGII otorga un Sello de Recepción que lo convierte en un documento fiscalmente válido.

Flujo de transmisión

Estados de un DTE

Estado	Descripción
Pendiente	Factura procesada y datos extraídos, lista para revisión y transmisión.
Transmitido	Enviado al MH, esperando respuesta de validación.
Aceptado	La DGII otorgó el Sello de Recepción. El DTE es fiscalmente válido.
Rechazado	La DGII rechazó el documento. Revise el código de error, corrija y reintente.

Gestión multi-empresa

FACTURA-SV permite gestionar múltiples empresas desde una sola cuenta. Si administra la facturación de varias empresas — como oficinas contables o contadores independientes con varios clientes — puede configurar todas desde un único dashboard.

Cómo agregar una empresa

1. Vaya a Configuración → Empresas.
2. Haga click en "Agregar empresa".
3. Ingrese los datos de la nueva empresa: nombre comercial, NIT, NRC.
4. Suba el certificado de firma electrónica .p12/.pfx de esa empresa.
5. Seleccione el ambiente (pruebas o producción) para esa empresa.
6. Guarde.

Cambiar entre empresas

En la esquina superior del dashboard verá un selector de empresa. Haga click para cambiar entre las empresas configuradas. Cada empresa tiene su propia tabla de facturas, métricas y configuración de credenciales.

Créditos y múltiples empresas

Sus créditos se comparten entre todas las empresas configuradas en su cuenta. Cada DTE emitido — sin importar desde cuál empresa — consume un crédito. Compre paquetes de créditos prepagados que nunca vencen desde el dashboard.

Paquete	Créditos	Precio	Costo por DTE
Inicial	100	$14.87	$0.15
Popular ★	500	$56.65	$0.11
Profesional	1,000	$98.00	$0.10
Contador	5,000	$313.00	$0.06
Alto volumen	10,000	$474.00	$0.05

Exportar reportes

FACTURA-SV le permite exportar sus datos en formato CSV, XLSX (Excel) o PDF para análisis externo, conciliación contable o archivos de respaldo.

Cómo exportar

1. En la tabla de facturas, aplique los filtros deseados (fecha, NIT, estado, tipo).
2. Haga click en el botón "Exportar" y seleccione el formato deseado (CSV, XLSX o PDF).
3. El archivo se descargará automáticamente a su computadora.

Formato del archivo

Los archivos CSV se generan con BOM UTF-8 para garantizar compatibilidad con Microsoft Excel en español. Los archivos XLSX se generan nativamente. Los campos exportados incluyen:

• Fecha de emisión
• Tipo de DTE (código y nombre)
• Número de control
• Código de generación (UUID)
• NIT y nombre del emisor
• NIT y nombre del receptor
• Monto gravado, exento e IVA
• Monto total
• Estado de transmisión
• Sello de recepción (si fue aceptado)
• Fecha de procesamiento

Errores comunes

Al transmitir DTEs al Ministerio de Hacienda, pueden ocurrir rechazos por diversas causas. A continuación los errores más frecuentes y cómo resolverlos.

Código	Error	Causa	Solución
CERT_EXPIRED	Certificado vencido	El certificado de firma electrónica ha expirado.	Renueve su certificado en factura.gob.sv y actualícelo en Configuración.
NIT_INVALID	NIT no registrado	El NIT del emisor no está registrado como emisor DTE activo.	Verifique su registro en el portal del MH y confirme que fue autorizado como emisor.
SCHEMA_ERROR	Error de esquema	El JSON del DTE no cumple con el esquema oficial de la DGII.	Revise los campos obligatorios. Consulte Tipos de DTE para ver los campos requeridos por tipo.
DUP_CONTROL	Número de control duplicado	Ya existe un DTE con ese número de control para el mismo emisor.	Verifique el correlativo del número de control. Use la estructura DTE-01-M001P001-000000000000001.
CAT_OBSOLETE	Catálogo obsoleto	Se usó un código de catálogo que ya no es aceptado (ej: municipios antiguos).	Actualice los catálogos. Consulte Catálogos MH para la versión vigente.
SIGN_INVALID	Firma inválida	La firma electrónica del DTE no es válida o no coincide con el certificado registrado.	Reconfigure su certificado .p12/.pfx y contraseña en Configuración → Credenciales MH.
MH_TIMEOUT	Timeout del MH	El servidor del Ministerio de Hacienda no respondió a tiempo.	Reintente en unos minutos. Si el problema persiste, verifique el estado del servicio.
AMOUNT_MISMATCH	Montos inconsistentes	La suma de los ítems no coincide con los totales declarados en el resumen.	Revise los cálculos de subtotales, IVA y total. Asegúrese de que los montos gravados + exentos + impuestos = total.

Capacidades Avanzadas (177+ endpoints)

Además de la emisión y transmisión de DTEs, FACTURA-SV incluye funcionalidades avanzadas accesibles desde el dashboard y la API REST.