Este documento describe la arquitectura de una integración general entre cliente y Dcycle. Como la solución en la nube requiere tiempo para procesar toda la información, el proceso es completamente asíncrono, basado en el uso de webhooks. Este es el flujo de Autenticación:
El cliente recibe un par único de API_KEYS para identificarse. Antes de cargar cualquier documento, se requerirá que el usuario se autentique en la plataforma. Si la autenticación ha sido exitosa, Dcycle proporcionará una URL temporal donde el cliente puede cargar el documento para ser procesado.
Una vez que el cliente ha recibido la URL temporal, podrá cargar el documento para ser procesado, como se describe en la siguiente sección:
El cliente carga el documento en la URL temporal proporcionada, y la plataforma ejecutará un proceso de validación del contenido:
Cómo Dcycle requiere de algunos minutos para procesar el documento, el proceso es completamente asíncrono. (El tiempo varía según la cantidad de datos procesados). La siguiente imagen describe el proceso:
La plataforma procesa el documento, calculando todas las emisiones correspondientes al documento cargado por el cliente. Una vez que se haya completado el procesamiento, notificará al usuario el estado vía webhook, proporcionando el estado y el id del documento procesado.
Después de que el archivo haya sido cargado y procesado completamente, el cliente tiene un ID que identifica el documento cargado previamente, y podrá realizar consultas para recibir el contenido procesado del archivo. El siguiente diagrama describe el flujo de trabajo:
En este punto, el cliente puede aplicar filtros y ordenamientos para recibir datos específicos del documento procesado, como:
Se proporcionará un documento al recibir las API_KEYS que describa cómo construir las consultas.