Autenticación API Rest¶
¡Hola! Pensando en la seguridad de los datos de nuestros clientes, al actualizar la versión del sistema, el usuario deberá realizar el proceso de generación de Token para su integración vía Rest API. Antes de iniciar el desarrollo de la autenticación con Invoicy en la integración a través de la API, la mejor alternativa para entender el proceso de autenticación es generar el token en el patrón JWT - JSON Web Token manualmente.
Para realizarlo, ingrese al portal JWT y ajuste el tablero Decoded configurando los grupos de Payload y Verify Signature:
Entendiendo al grupo Payload:¶
- “Iat”: campo numérico que debe contener la fecha / hora actual en zona cero y en formato de marca de tiempo;
- “Exp”: campo numérico que debe contener la fecha / hora actual + 120 segundos en zona cero y en formato de marca de tiempo;
- “Sub”: es una cadena con el código de establecimiento RUC + de la empresa emisora. Cuando el RUC no tiene un total de 8 dígitos, es necesario llenarlo al inicio con el valor 0 hasta cerrar el valor total. Lo mismo se repite para el código de establecimiento, siendo necesario completar el total de 10 dígitos.
- “PartnerKey”: es una cadena con la clave de socio proporcionada por InvoiCy, que se puede encontrar a través de la pantalla Panel de control> Socios.
La generación de fecha / hora en la timestamp se puede realizar a través del portal Epoch Converter, como se muestra en la imagen de ejemplo a continuación:
Entendiendo al grupo Verify Signature:¶
En el campo donde se permite la edición, informe la clave de acceso de la empresa. La clave de acceso es la clave privada proporcionada por InvoiCy para cada empresa registrada, disponible a través de la pantalla de datos de la sucursal.
Al completar esta información, se generará el JWT en el panel Encoded para ser enviado a Invoicy en la opción Generate Token en la herramienta Postman, usando el proyecto de ejemplo (https://documenter.getpostman.com/view/9193875/UVXhpGED).
