Primeros Pasos con la API de Facturación Electrónica
Esta guía te ayudará a comprender el proceso completo de implementación de la API de Facturación Electrónica y los pasos necesarios para hacerlo exitosamente.
Visión general del proceso
El sistema de facturación electrónica en El Salvador requiere que los contribuyentes emitan y reciban documentos fiscales en formato electrónico. La API facilita este proceso actuando como intermediario entre tu sistema y los servicios del Ministerio de Hacienda.
Requisitos previos
Antes de comenzar con la implementación, asegúrate de contar con:
- Credenciales del Ministerio de Hacienda
Usuario y contraseña para acceder a los servicios de la DGI. - Certificado digital
Necesario para firmar digitalmente tus documentos fiscales. - Información fiscal completa
NIT, NRC, actividad económica, dirección fiscal, etc. - Inventario de sucursales y puntos de venta
Lista detallada de todos los establecimientos que emitirán documentos. - Catálogo de productos y servicios
Clasificados según el tipo de ítem (bienes, servicios, ambos).
Arquitectura recomendada
Se recomienda la siguiente arquitectura para la integración con la API:
Secuencia de implementación
Sigue estos pasos en orden para una implementación exitosa:
- Registro de la empresa
Registra tu empresa y sucursales utilizando la guía rápida de autenticación.
- Implementación del modo de pruebas
Configura tu sistema en modo de pruebas (ambiente = "00") para verificar la integración sin generar documentos fiscales reales.
- Mapeo de catálogos
Implementa los catálogos oficiales en tu sistema para asegurar la correcta codificación de productos, servicios, impuestos, etc.
- Desarrollo del gestor de contingencias
Implementa la lógica para manejar situaciones de contingencia según guía de contingencia.
- Desarrollo de flujos de negocio
Implementa los flujos específicos de tu negocio: facturación, notas de crédito, comprobantes fiscales, etc.
- Pruebas integrales
Realiza pruebas completas de cada tipo de documento y escenario, incluyendo situaciones de contingencia.
- Migración a producción
Una vez verificadas todas las pruebas, cambia al ambiente de producción (ambiente = "01").
Checklist de implementación
Utiliza esta lista para verificar que tu implementación cubre todos los aspectos necesarios:
Verificación de implementación
Configuración básica
- Registro exitoso de empresa y sucursales
- Almacenamiento seguro de credenciales
- Implementación de renovación automática de tokens
- Configuración de acceso a ambientes de prueba y producción
Emisión de documentos
- Factura electrónica (FE)
- Comprobante de crédito fiscal (CCF)
- Comprobante de retención (CR) si aplica
Gestión de documentos
- Consulta de documentos emitidos
- Invalidación de documentos
- Almacenamiento local de documentos emitidos
Monitoreo y seguridad
- Monitoreo de estado del sistema
- Alertas de errores recurrentes
- Respaldo periódico de documentos
- Protección de credenciales y tokens
Migración desde sistema físico
Si estás migrando desde un sistema de facturación física, considera estos aspectos adicionales:
- Numeración de documentos: La numeración electrónica es independiente de la física. Los documentos electrónicos tienen su propia secuencia controlada por el sistema.
- Capacitación del personal: Entrena a tu equipo en los nuevos procesos de facturación electrónica.
- Actualización de clientes: Informa a tus clientes sobre el cambio y cómo afectará la recepción de facturas.
Próximos pasos
Ahora que comprendes el panorama completo, puedes comenzar con los siguientes recursos: