Introducción a la API de Facturación Electrónica
Bienvenido a la documentación oficial de la API de Facturación Electrónica para El Salvador. Esta guía está diseñada para ayudarte a integrar rápidamente estos servicios en tu aplicación o sistema existente.
¿Qué es la API de Facturación Electrónica?
La API proporciona una solución completa para la emisión, gestión y seguimiento de documentos tributarios electrónicos (DTE) que cumplen con la normativa del Ministerio de Hacienda de El Salvador. Está diseñada para adaptarse a cualquier tipo de negocio, desde pequeñas empresas hasta grandes corporaciones.
Características Principales
- Emisión de Documentos Fiscales: Genera facturas, comprobantes de crédito fiscal, notas de crédito y otros documentos válidos fiscalmente.
- Validación Automática: Verifica que todos los documentos cumplan con los requisitos legales antes de su emisión.
- Almacenamiento Seguro: Todos los documentos se almacenan de forma segura según las normativas fiscales.
- Consultas en Tiempo Real: Accede al estado y detalles de tus documentos fiscales en cualquier momento.
- Sistema de Contingencia: Continuidad operativa incluso cuando hay problemas de conexión con los servicios de Hacienda.
- Monitoreo del Sistema: Endpoints específicos para verificar el estado y métricas del sistema.
Tipos de Documentos Soportados
Factura Electrónica
Documento fiscal para consumidores finales.
Comprobante de Crédito Fiscal (CCF)
Para transacciones entre contribuyentes con crédito fiscal.
Nota de Crédito
Para devoluciones y modificaciones a la baja de documentos previos.
Comprobante de Retención (CR)
Documento para retenciones de impuestos a proveedores.
Antes de comenzar
Para utilizar la API, necesitarás:
- Registrarte en el sistema con tus datos fiscales
- Obtener credenciales de API (API key y secret)
- Usar estas credenciales para obtener un token JWT
- Incluir este token en todas tus peticiones a la API
Estructura de la API
La API está organizada en diferentes grupos de endpoints:
- Autenticación: Registro y obtención de token JWT
- Facturas Electrónicas: Creación y gestión de facturas
- Comprobantes de Crédito Fiscal: Emisión de CCF
- Nota de crédito: Modificación de documentos previos
- Comprobante de retención: Emisión de CR
- Consulta de DTE: Búsqueda y obtención de documentos
- Invalidación: Anulación de documentos emitidos
- Monitoreo: Verificación del estado del sistema
Siguientes pasos
Para empezar a utilizar la API, te recomiendo seguir estos pasos:
- Autenticación - Regístrate y obtén tu token JWT
- Emitir una factura - Crea tu primera factura electrónica
- Consultar documentos - Aprende a buscar y verificar documentos emitidos
Documentación completa
La API está disponible en la sección de Endpoints, donde encontrarás información completa sobre cada endpoint, parámetros, ejemplos de solicitudes y respuestas.