Crear un consulta (check)

Si estás integrando los checks de antecedentes a través de la API de ZapSign, este es el flujo que recomendamos seguir para una correcta implementación y mejor experiencia:

1. Crear un check de persona o empresa

El primer paso es realizar una solicitud a nuestro endpoint de creación de check. Una vez enviado, el check entra en proceso de verificación.

• ⏱ Tiempo estimado de procesamiento: entre 2 minutos y 2 horas, dependiendo de las bases de datos consultadas y del país.

2. Usar el webhook de resultados (en construcción)

Recomendamos configurar un webhook para recibir automáticamente una notificación cuando el check haya finalizado.

• Cuando el check se completa, ZapSign enviará una notificación HTTP POST al webhook configurado por tu sistema, informando que los resultados están listos para ser consultados.

• Esto evita la necesidad de hacer consultas repetitivas (polling) al servidor.

3. Consultar los resultados

Una vez recibido el webhook o pasado el tiempo estimado de procesamiento, puedes obtener los resultados a través de nuestros endpoints:

• Consulta de detalles

Este endpoint devuelve el JSON completo con toda la información encontrada, incluyendo: El score global, Los detalles por dataset, Las severidades asociadas a cada hallazgo

• Consulta del PDF

Si necesitas una versión legible y lista para compartir, puedes descargar el PDF del check.

💡 Consejo: Utilizar el webhook junto con los endpoints de consulta garantiza un flujo eficiente y automatizado, evitando esperas innecesarias o llamadas redundantes a la API.