Código de seguridad (QR)

El código de seguridad QR es un código privado que solo lo conoce el facturador electrónico que use servicios web y la Dirección General de Ingresos (DGI). Cumple con la función de brindar una capa de protección adicional en todas las operaciones, solicitando esta información adicional como respaldo.

El código se puede solicitar desde la página Etax en el menú de afiliación o dentro de nuestra api, utilizando el endpoint de afiliación enviando en la propiedad "affiliationType" el número 1.

El código QR está vinculado al RUC, y cada emisión deberá incluir el último QR generado. En situaciones donde se emitan documentos electrónicos con otro PAC al mismo tiempo, se requiere actualizar el QR correspondiente.

Registro de QR en Alanube

En nuestro sistema, almacenamos el código QR junto con otros datos asociados a la compañía. Si cuentas con un código QR previamente generado, podrás ingresarlo durante el proceso de creación. Estableciendo una integración completa desde la creación.

Al utilizar nuestra API el endpoint de afiliación y generar un nuevo código de seguridad, la información se actualiza automáticamente sin requerir pasos adicionales.

No obstante, si se genera un nuevo codigo por otro medio o se desea registrar un codigo disponible, se recomienda actualizar la propiedad "qr" con el endpoint actualizar compañía. De esta manera, se asegura que el QR registrado sea el correcto para la emisión de documentos.

Inhabilitación del código QR

En el caso de que la Dirección General de Ingresos (DGI) rechace la emisión de un comprobante electrónico y nos devuelva un mensaje de error relacionado con el código QR, identificado con el código 4003 y el mensaje Fingerprint en el código QR mal formado, nuestro sistema asumirá que el dato almacenado es incorrecto. Como resultado, actualizaremos la información de la compañía a un estado de inhabilitación para prevenir futuros errores.

Si el usuario intenta emitir un nuevo comprobante en este estado, recibirá el siguiente error:

{  
  "code": "AP1010",  
  "message": "Company QR not requested or wrong. Please, fix or update your company's QR before retrying",  
  "httpCode": 400  
}

Para resolver este problema, es necesario actualizar la propiedad "qr" con el endpoint actualizar compañía. De esta manera, se garantiza que el QR registrado sea el correcto para la emisión de documentos. Una vez actualizado, nuestro sistema cambiará automáticamente el estado de la compañía, permitiendo nuevamente la emisión de documentos.

Ambiente de pruebas (Sandbox)

En el ambiente de pruebas se maneja el mismo código QR para todas las emisiones, el cual está asociado con el RUC de Alanube Soluciones S.A. Esto significa que no se puede actualizar este campo en Sandbox. En caso de contar con el código se debe solicitar a soporte.