Introducción
Bienvenido a la API de Factura Electrónica SV - Su solución completa para la facturación electrónica en El Salvador conforme a la normativa del Ministerio de Hacienda.
¿Qué es la Factura Electrónica?
La Factura Electrónica en El Salvador (DTE - Documento Tributario Electrónico) es el sistema oficial implementado por el Ministerio de Hacienda para la emisión, transmisión, validación y resguardo de documentos fiscales en formato digital. Este sistema reemplaza gradualmente los comprobantes fiscales en papel, ofreciendo mayor eficiencia, seguridad y control fiscal.
¿Por qué usar nuestra API?
Nuestra API de Factura Electrónica SV ofrece una solución integral para empresas y desarrolladores que necesitan implementar la facturación electrónica en El Salvador de manera eficiente, segura y conforme a la normativa vigente.
Mantenemos nuestra plataforma actualizada con las últimas regulaciones del Ministerio de Hacienda, garantizando el cumplimiento legal.
Automatice procesos de facturación, reduzca errores y disminuya costos operativos asociados con documentos físicos.
Implementamos cifrado de extremo a extremo y firmas digitales para garantizar la integridad y confidencialidad de sus documentos.
Diseñada para integrarse fácilmente con sus sistemas existentes, ERPs, CRMs o plataformas de comercio electrónico.
Conceptos clave
Para aprovechar al máximo nuestra API, es importante entender estos conceptos fundamentales:
DTE (Documento Tributario Electrónico)
Es el documento digital que reemplaza a la factura física tradicional. Incluye una representación en formato XML con firma electrónica que garantiza su autenticidad e integridad.
NIT y NRC
El NIT (Número de Identificación Tributaria) y el NRC (Número de Registro de Contribuyente) son identificadores fiscales obligatorios para la emisión de documentos electrónicos.
Certificado Digital
Es el archivo digital que permite firmar electrónicamente los documentos, garantizando su autenticidad. Nuestra API gestiona todo el proceso de firma por usted.
Contingencia
Proceso alternativo para emitir documentos cuando hay problemas de conexión con el Ministerio de Hacienda. Nuestra API proporciona mecanismos automáticos de contingencia.
Casos de uso
Nuestra API de Factura Electrónica SV es ideal para diversos escenarios:
Comercio minorista
Integre la emisión de facturas electrónicas con su sistema de punto de venta (POS) para automatizar la facturación en cada transacción.
Comercio electrónico
Emita facturas electrónicas automáticamente al completar ventas en línea, mejorando la experiencia de compra y cumpliendo con la normativa fiscal.
Facturación recurrente
Automatice la emisión de facturas para servicios por suscripción o pagos recurrentes, ahorrando tiempo y reduciendo errores administrativos.
Integración con ERPs
Conecte su ERP existente (SAP, Oracle, Microsoft Dynamics, etc.) con nuestra API para mantener sus procesos actuales mientras cumple con la normativa.
Arquitectura de la API
La API pública sigue un diseño RESTful con endpoints específicos para cada recurso (empresa, sucursales, puntos de venta, clientes, productos y DTEs). Utiliza JSON para el intercambio de datos y autenticación por API key.
URL base y autenticación
Todas las llamadas a la API pública usan la URL base https://api.facturaelectronicasv.com/api/v1/public e incluyen su API key en el encabezado Authorization: Bearer su_api_key. La empresa se resuelve a partir de la API key, que debe estar asociada a una empresa y a una organización con plan de pago activo.
Las respuestas siguen un sobre común: success: true con data en caso de éxito, o success: false con message en caso de error.
Flujo básico de emisión de un DTE
- Su aplicación llama al endpoint del tipo de documento (por ejemplo
POST /dtes/fc) indicando el punto de venta, el establecimiento y los datos del documento. Puede referenciar cliente y productos por su id para autocompletarlos. - La API valida los datos contra el esquema oficial del Ministerio de Hacienda y registra el documento con estado
PENDING, devolviendo suid. - De forma asíncrona, el documento se firma digitalmente y se transmite al Ministerio de Hacienda para su validación.
- El MH valida el documento y asigna un número de control único.
- Su aplicación consulta el detalle con
GET /dtes/{id}para conocer el estado final (por ejemploTRANSMITTED), el número de control y las URLs del JSON y el PDF; también puede descargar el PDF desdeGET /dtes/{id}/pdf.