Consultas por lote a través de la API

En esta sección exploraremos cómo aprovechar al máximo la función de consultas por lote a través de nuestra API, una característica que resulta de gran utilidad en términos de eficiencia, debido a que te permite realizar múltiples consultas de manera simultánea, optimizando tus procesos y ahorrándote tiempo.

¿Qué es una consulta por lote? 

Las consultas por lote es una opción para realizar consultas de más de un documento o nombre por medio de una plantilla de Excel, lo cual te ayudará a ahorrar tiempo en tus procesos. 

¿Cómo establecer una conexión vía API?

La documentación está realizada con el fin de facilitar la interpretación del funcionamiento del API, conocer los diversos endpoint y pasos a seguir para ejecutar una consulta, visualizar los reportes y dejar claro cuál es la estructura y cantidad de datos que necesitamos para entregar los resultados correctamente.

Si quieres conocer la documentación API, ingresa al siguiente enlace: http://docs.tusdatos.co/redoc

¿Cómo lanzar una consulta por lote vía API? 

Sigue estos sencillos pasos para sacar el máximo provecho de esta poderosa herramienta:

Paso 1: Autorización
Asegúrate de contar con autorización para utilizar la función de consultas por lote. Para esto debes estar registrado con usuario y contraseña en nuestra plataforma, que son las credenciales para el acceso HTTP tipo Autenticación básica (Basic Authentication).

Paso 2: Prepara tus datos
Reúne la información requerida para tus consultas y organízala de manera clara. En este paso, es momento de ingresar los datos a consultar: tipo de documento typedoc, fecha de expedición expedition_date y el número del documento doc. Importante: Tener en cuenta que cada combinación de typedoc y doc debe ser única en la lista y que no puede tener más de 2000 elementos.

Paso 3: Envía tu solicitud
Utiliza el endpoint de launch designado para crear y lanzar tu lote de consultas. Puedes verificar el estado de la consulta por lote a través del endpoint de progreso. La API manejará la verificación y procesamiento. Ver documentación

Paso 4: Verificación y lanzamiento
La API verificará tus datos, una vez lanzado el lote y te proporcionará una respuesta, que puedes visualizar en el endpoint de results, acorde al código de estado de respuesta HTTP obtenido. 

¿Dónde puedo encontrar la documentación?

Te recomendamos nuestra documentación API que contiene las explicaciones de cada endpoint y la forma en que se suceden entre sí para entregar la respuesta final con la información consultada.

¡Y eso es todo! Recuerda que puedes gestionar hasta tres lotes de consulta a la vez por usuario. ¡Éxito en tus consultas por lotes!

Si tienes dudas adicionales, puedes escribirnos a la cuenta soporte@tusdatos.co o a través del chat de ayuda de nuestra página principal para atender tus inquietudes.