API y Desarrollo

🔐 ¿Cuál es la diferencia entre el Authentication Token y el Access Token?

El Authentication Token es generado por un usuario autorizado desde el Portal de Certificación. Es único por empresa y no caduca.
El Access Token se obtiene usando el Authentication Token y tiene una duración limitada (60 minutos). Es obligatorio en todas las llamadas al API.

🔄 ¿Cada cuánto debo renovar el Access Token?

El Access Token es válido por 60 minutos. Luego de ese tiempo, debes obtener uno nuevo utilizando nuevamente el Authentication Token.

🌍 ¿Qué ambiente debo usar para desarrollo?

Polaris cuenta con un Ambiente de Desarrollo (tipo 0) que permite realizar pruebas técnicas sin necesidad de crear una empresa ni ingresar al portal.

Ideal para validar conectividad, estructura de documentos y pruebas técnicas básicas.
Los documentos no se envían a la DGII.
No se validan algunas reglas fiscales complejas.
Puedes usar un token de desarrollo proporcionado por Polaris (ej. MiTokenXYZ).

Si deseas realizar pruebas más realistas con validaciones completas de la DGII, utiliza el:

Ambiente 1 (Pruebas DGII)
- Requiere que una empresa esté registrada en Polaris (aunque no es necesario que esté certificada).

Puedes ver ambos flujos en detalle en 👉 Inicio rápido y Flujo general de integración.

📦 ¿Qué tipo de documentos se pueden firmar con Polaris?

Actualmente Polaris permite firmar los siguientes Documentos Electrónicos:

Facturas de Crédito Fiscal
Facturas de Consumo
Notas de Crédito
Notas de Débito
Otros tipos definidos por la DGII

Consulta los endpoints disponibles en la sección de 👉 Referencia del API.

📑 ¿Dónde encuentro un ejemplo de documento?

Puedes ver un modelo completo de una Factura de Crédito Fiscal en:
👉 Flujo general de integración > Paso 3

🧪 ¿Puedo hacer pruebas con Postman o curl?

Sí. Polaris acepta peticiones REST estándar por HTTP con cuerpo en formato JSON.
Puedes usar herramientas como Postman, curl, Insomnia u otras similares para hacer pruebas sin necesidad de programar.

⚠️ ¿Qué ocurre si no incluyo el parámetro `ambiente`?

La mayoría de las rutas del API requieren que especifiques el parámetro ambiente en la URL.
Las únicas excepciones son algunos endpoints como /autenticacion/token y /version.

🧠 ¿Qué es el TransaccionID?

Es un identificador único que devuelve Polaris cuando firmas un documento.
Sirve para:

Consultar el estado final del documento
Auditar o rastrear el ciclo de vida del documento
Descargar el XML firmado o la representación impresa (cuando aplica)