Seguimiento del proceso
Consulta el estado del sobre y confirma el resultado desde tu servidor.
Conserva el ID del sobre después de crearlo o usar una plantilla. Tu aplicación puede consultar ese recurso para mostrar el avance, gestionar pendientes y confirmar cuándo está listo para archivar.
curl --fail-with-body \
'https://business.digito.do/api/v2/envelope/envelope_ejemplo' \
-H "Authorization: $DIGITO_API_TOKEN"Qué comprobar
status: estado general del sobre.recipients[].sendStatus: progreso de la distribución.recipients[].readStatus: apertura del documento.recipients[].signingStatus: resultado de la acción de cada persona.completedAt: fecha de finalización cuando exista.recipients[].rejectionReason: motivo del rechazo cuando corresponda.
No interpretes un correo enviado, la apertura del documento ni un campo visual insertado como confirmación de firma completada.
Consulta con intervalos
Define un intervalo según las necesidades de tu aplicación y evita una consulta por cada renderizado del frontend. El servidor puede actualizar un registro local y compartir ese resultado con las vistas autorizadas.
Espacia las consultas ante errores temporales, respeta Retry-After cuando se reciba y aplica límites y reintentos. Detén la consulta activa cuando se complete, rechace o cancele el proceso que estás siguiendo.
Si una persona cierra la vista o pierde conexión, vuelve a consultar el sobre antes de presentar una nueva acción. Un callback o redirección del navegador puede actualizar la interfaz, pero la confirmación del proceso se obtiene desde el servidor.
Resultado final
Después de comprobar COMPLETED, solicita el PDF signed de cada elemento y conserva la evidencia que necesite tu proceso. Una versión pending es provisional y no debe archivarse como documento final firmado.
El firmante se autentica de nuevo con Digito ID antes de cada acción de firma. Una sesión abierta en Business, una clave de API, un token de destinatario o un token de integración no sustituye esta autenticación.