Introducción al API de Polaris

La API de Polaris permite integrar tu sistema (ERP, sistema contable u otro software) con los servicios de firma y validación de Documentos Electrónicos ante la DGII de República Dominicana.

Es una API RESTful que trabaja sobre HTTPS y está pensada para ser simple, segura y fácil de consumir desde cualquier tecnología moderna.

🌐 Punto de entrada

Todas las operaciones del API se realizan desde el siguiente dominio:

https://api.polarisedi.com

Este dominio es único para todos los entornos. El comportamiento de cada uno se define mediante el parámetro ambiente, que debe ser incluido en cada llamada al API.

🔐 Modelo de autenticación por tokens

Polaris utiliza un esquema de autenticación dividido en dos pasos:

1. Un Authentication Token es generado desde el Portal de Certificación por un usuario administrativo. Este token es único para cada empresa.
2. Con ese token, se obtiene un Access Token válido por 60 minutos, que se utiliza en todas las llamadas al API mediante el parámetro token=....

Este enfoque permite mantener una sesión segura y separa la gestión administrativa del consumo técnico del API.

📥 Flujo básico de integración

El flujo típico de trabajo con el API sigue este orden:

1. Solicitar un Access Token usando el Authentication Token
2. Firmar documentos electrónicos y consultar resultados
3. Renovar el Access Token cada 60 minutos, si es necesario

Puedes ver este proceso en detalle en la página 👉 Flujo general de integración

🌍 Ambientes disponibles

El parámetro ambiente controla a qué entorno se dirige cada llamada. Sus valores posibles son:

Este parámetro es obligatorio en la mayoría de las llamadas al API. Algunas rutas específicas como /autenticacion/token pueden funcionar sin él.