API de facturación electrónica
API de facturación electrónica para desarrolladores
La API de JRHub permite integrar la facturación electrónica dominicana con aplicaciones que envían y reciben información mediante HTTPS y JSON. Está dirigida a equipos de desarrollo, proveedores de software y empresas con sistemas propios.
Por JRHub · Actualizado el
Conecta la parte fiscal desde tu código.
Emisión, consulta y recepción de documentos
En la emisión, tu aplicación prepara la información de la operación. JRHub valida los datos recibidos y gestiona el proceso de firma y envío del comprobante. La integración debe tratar las respuestas de validación y permitir corregir los campos que correspondan.
En el seguimiento, tu sistema consulta el estado del documento y las respuestas de la DGII. En compras recibidas, utiliza el listado para localizar documentos y la consulta individual para recuperar sus partidas, cantidades e importes. Mostrar únicamente el listado no equivale a importar el detalle de la factura.
Integra desde el servidor de tu aplicación
Puedes utilizar PHP, JavaScript en Node.js, Python, Java, C#, Go, Ruby u otro entorno capaz de realizar solicitudes HTTPS y procesar JSON. La compatibilidad depende de implementar el contrato de la API, no de utilizar una biblioteca exclusiva de JRHub.
Mantén las credenciales en tu backend y utiliza la configuración del entorno correspondiente. El código que se entrega a un navegador o a una aplicación cliente no debe exponer claves privadas de integración. La página de inicio incluye un ejemplo ilustrativo de consulta de conexión en sandbox.
- Mapea los campos de tu sistema a los campos y tipos del contrato.
- Comprueba cantidades, importes, impuestos y datos de la empresa antes del envío.
- Interpreta las respuestas y conserva una referencia del documento procesado.
- Distingue los estados de procesamiento de los errores que requieren corrección.
Prueba el recorrido completo en sandbox
Los entornos de pruebas y producción están separados. Utiliza sandbox para revisar la conexión, la estructura de los datos y el manejo de respuestas antes de configurar una operación real. Las credenciales y direcciones deben corresponder siempre al mismo entorno.
Incluye escenarios de datos incompletos, respuestas pendientes, fallos de conexión y consulta posterior del documento. Frente a una respuesta incierta, revisa el estado antes de repetir una operación: el comportamiento de reintento debe seguir el contrato vigente y evitar duplicar procesos en tu sistema.
Define la operación después de integrar
La integración termina cuando el usuario puede entender qué ocurrió con cada comprobante. Establece quién revisa los documentos pendientes, cómo se presentan los errores y qué información necesita soporte para investigar una incidencia.
Comparte con JRHub el tipo de aplicación, las operaciones que necesitas conectar y el alcance del proyecto. Así se puede revisar una propuesta y coordinar la implementación sin sustituir tus procesos de ventas, inventario o contabilidad.
Preguntas frecuentes
¿La integración se realiza con JSON?
Tu aplicación intercambia información con la API mediante HTTPS y JSON conforme al contrato de integración. Los ejemplos públicos de la web utilizan datos de muestra y el entorno sandbox.
¿Puedo integrar varias tecnologías?
Sí. El requisito técnico es poder realizar solicitudes HTTPS y procesar las respuestas. Tu implementación debe respetar la autenticación, los campos y las validaciones del contrato.
¿JRHub importa automáticamente las líneas de compras a mi ERP?
El integrador debe consultar el detalle de cada documento y decidir cómo incorporarlo a su sistema. Una respuesta de listado por sí sola no crea productos ni movimientos de inventario.
