Empezando con Polaris
- mchacon
- Erika Padován
- Jean Carlo De Castro
Introducción
En esta sección encontrarás toda la información que necesitarás para la integración de tu sistema (ERP) a la API de Polaris.
En Polaris queremos que tu proceso de emisión de comprobantes electrónicos hacia la entidad fiscal sea de forma rápida y sencilla, por lo que desarrollamos un API REST que te permitirá emitir dichos documentos, mediante la integración de tu sistema de gestión (ERP) actual a Polaris.
¡Vamos a ello!
Pasos a seguir
Esta es una guía rápida que te permitirá firmar electrónicamente tu primer comprobante fiscal.
Paso 1: Regístrate como emisor electrónico ante la Dirección General de Impuestos Internos.
Paso 2: Crea y configura tu cuenta de Polaris.
Paso 3: Firma tu primer comprobante fiscal electrónico.
Paso 1: Regístrate como emisor electrónico ante la Dirección General de Impuestos Internos
Antes de poder facturar electrónicamente con Polaris es necesario seguir algunos pasos administrativos para darte de alta como emisor electrónico ante la Dirección General de Impuestos Internos.
Habilitarte como emisor electrónico con DGII
Completar el formulario de Solicitud para ser Emisor Electrónico de DGII (FI-GDF-016)
Remitir el anterior formulario, firmado y sellado por el representante de la empresa ante DGII, a la siguiente dirección de correo electrónico: facturacionelectronica@dgii.dov.do
DGII enviará en respuesta unas credenciales que te permitirán ingresar al Portal de Certificación de Facturación Electrónica en la Oficina Virtual
Ingresar al Portal de Certificación de Facturación Electrónica (https://ecf.dgii.gov.do/certecf/portalcertificacion/) para asegurar que las credenciales funcionan correctamente
Solicitar un Certificado Digital para procesos tributarios a nombre del representante de la empresa ante DGII con cualquier de las entidades calificadas:
En ambos pasos la persona representante de la empresa ante DGII deben ser la misma.
Paso 2: Crea y configura tu cuenta de Polaris
Una vez que ya estás dado de alta como emisor electrónico, debes es crear, configurar y probar tu cuenta en Polaris.
Crear tu cuenta
Contacta a nuestro equipo comercial para abrir tu cuenta de Polaris.
Configurar tu cuenta
Ingresar al portal de Polaris con las credenciales obtenidas anteriormente
Carga tu certificado de firma digital.
Una vez dentro de Polaris, en la opción Certificado realizar lo siguiente:
Click en el botón “Cargar Nuevo Certificado“ eligiendo el certificado digital obtenido al momento de haberse dado de alta como emisor electrónico.
Introducir la clave de tu certificado en el campo de texto “Clave del Certificado”
Click en el botón “Actualizar Clave”
Genera tu token Polaris:
Click en el botón “Generar Token“
Copiar el token de autenticación generado en algún lugar seguro porque será éste el usado para consumir los servicios de Polaris
Debes guardar este token de autenticación en algún lugar seguro pues es tu token para autenticarte en los API de Polaris. Si pierdes el token, deberás generar un nuevo token a través del portal.
Probar tu cuenta
Para probar que tu cuenta de Polaris está bien creada y configurada lo único que necesitas es ir a una dirección URL en cualquier navegador de internet:
Ir a la siguiente dirección URL: https://api.polarisedi.com/Autenticacion/Token?authToken=<token generado>
No olvidarse reemplazar <token generado> por el token de autenticación generado anteriormente
Validar que la respuesta muestre algo como:
Paso 3: Firma tu primer comprobante fiscal electrónico
Firmar electrónicamente con Polaris es muy fácil puesto que todo se realiza vía un API REST. Por tanto, éste puede ser consumido por diferentes herramientas e integrado a cualquier sistema sin importar la tecnología de desarrollo existente por debajo.
Existen tres formas básicas de consumir los servicios web del API de Polaris:
Desde el código fuente de cualquier software que sea capaz de consumir servicios web de tipo REST.
Usando la interfaz Swagger que posee Polaris.
Utilizando una herramienta específica para consumo de servicios web (Por ejemplo: Postman).
Firmado electrónico paso a paso
Caso de estudio
Con Polaris, todos los comprobantes fiscales se firman electrónicamente de la misma manera; entonces, para simplificar la presente guía nos vamos a centrar en la firma electrónica de una Factura de Crédito Fiscal.
Paso a paso
La mejor forma de entender cómo firmar un comprobante electrónico es realizando, paso a paso, un proceso de firmado:
Firmado usando una Librería C# de Polaris
Firmado usando Scalar