Auditoría y evidencia

El estado del sobre indica si el proceso terminó. El historial de auditoría registra eventos que permiten revisar lo sucedido. Relaciona ambos con el envelopeId y con el proceso de tu sistema.

Consulta eventos del sobreCopiar link al encabezado

La colección se pagina con page y perPage. Lee todas las páginas cuando necesites el historial completo; una primera página no representa todo el registro.

curl --fail-with-body --get \
  'https://business.digito.do/api/v2/envelope/envelope_ejemplo/audit-log' \
  -H "Authorization: $DIGITO_API_TOKEN" \
  --data-urlencode 'page=1' \
  --data-urlencode 'perPage=20'

El tipo local conserva data como unknown: su estructura depende del type del evento. Valida la variante antes de consumir sus propiedades.

Interpreta un eventoCopiar link al encabezado

Este objeto sintético ilustra la variante ENVELOPE_ITEM_CREATED de la colección:

{
  "id": "audit_ejemplo",
  "envelopeId": "envelope_ejemplo",
  "createdAt": "2026-10-06T14:00:00.000Z",
  "type": "ENVELOPE_ITEM_CREATED",
  "data": {
    "envelopeItemId": "item_ejemplo",
    "envelopeItemTitle": "Contrato"
  }
}

Un evento de correo o creación no prueba que haya terminado la firma. Consulta el estado del sobre antes de archivar el resultado. No confundas los tipos del historial con eventos de otra interfaz de integración.

Descarga los informes PDFCopiar link al encabezado

Después de comprobar que un documento esté completado, guarda los informes que necesita tu proceso:

curl --fail-with-body \
  'https://business.digito.do/api/v2/envelope/envelope_ejemplo/audit-log/download' \
  -H "Authorization: $DIGITO_API_TOKEN" \
  --output './auditoria.pdf'

curl --fail-with-body \
  'https://business.digito.do/api/v2/envelope/envelope_ejemplo/certificate/download' \
  -H "Authorization: $DIGITO_API_TOKEN" \
  --output './certificado-del-proceso.pdf'

certificate/download entrega un informe PDF del proceso; no entrega una clave privada ni un certificado para firmar por otra persona. La firma cualificada de la persona y el informe descargable son conceptos distintos.

Conservación y accesoCopiar link al encabezado

Guarda los PDFs finales de cada elemento con version=signed, los informes necesarios y sus referencias al sobre. Los documentos y registros pueden contener datos personales: limita el acceso al mismo ámbito que el proceso y evita registrar tokens, encabezados o el cuerpo completo de los eventos.

Descargar todos los documentos finales · Consultar auditoría · Descargar auditoría.