Estados

Use esta referencia para interpretar cada estado que muestran la aplicación y la API. Cada estado aparece con su nombre en la API y los webhooks y con la etiqueta que la aplicación muestra en español. Los conceptos detrás de los estados de sobres y firmantes se explican en Sobres y firmantes.

Estados del sobre

Estados

1. DRAFT Borrador
2. SENT Enviado
3. IN_PROGRESS En progreso
4. COMPLETED Completado
5. CANCELLED Cancelado
6. EXPIRED Expirado

Transiciones

• DRAFT pasa a SENT cuando enviar
• SENT pasa a IN_PROGRESS cuando primera firma
• IN_PROGRESS pasa a COMPLETED cuando última firma
• SENT pasa a COMPLETED cuando única firma
• DRAFT pasa a CANCELLED cuando cancelar
• SENT pasa a CANCELLED cuando cancelar
• IN_PROGRESS pasa a CANCELLED cuando cancelar
• SENT pasa a EXPIRED cuando barrido de vencimiento
• IN_PROGRESS pasa a EXPIRED cuando barrido de vencimiento

Un sobre pasa a EXPIRED cuando se le fijó una fecha de vencimiento al crearlo y esa fecha llega. Después del envío, la cancelación es la transición que inicia una persona; el vencimiento y la finalización ocurren automáticamente.

Estados del firmante

Estados

1. PENDING Pendiente
2. NOTIFIED Notificado
3. VIEWED Visto
4. SIGNED Firmado

Transiciones

• PENDING pasa a NOTIFIED cuando el sobre se envía y el firmante recibe su enlace
• NOTIFIED pasa a VIEWED cuando el firmante abre el enlace
• VIEWED pasa a SIGNED cuando el firmante envía su firma

En un sobre con firma secuencial, los firmantes de los turnos siguientes permanecen en PENDING hasta que el turno anterior termina; entonces reciben su enlace y pasan a NOTIFIED.

Entregas de webhooks

Cada evento al que está suscrito un webhook genera una entrega, y cada entrega puede tener varios intentos. La página Configuración, pestaña Webhooks, muestra el historial con estas etiquetas.

Estado	Etiqueta en la aplicación	Qué significa
PENDING_RENDER	Preparando	bb-sign está preparando el contenido de la entrega. El envío comienza cuando esté listo.
PENDING_SEND	Enviando	El contenido está listo y hay un intento en curso o programado. La fila muestra "Próximo intento a las" con la hora.
DELIVERED	Entregado	Su endpoint respondió con un código 2xx. La entrega quedó completa.
FAILED_PERMANENT	No se pudo construir	bb-sign no pudo generar el contenido de la entrega, por lo que no se realizó ningún envío.
SKIPPED	No enviado	El endpoint estaba desactivado cuando ocurrió el evento, así que este evento no se envió. Explica un vacío en los eventos recibidos.
DEAD_LETTERED	Abandonado	Se agotaron los reintentos sin una respuesta 2xx. La entrega queda cerrada.

Los reintentos siguen la escalera 1m, 5m, 30m, 2h, 12h, con una variación aleatoria de 20 %. Tras 3 escaleras agotadas consecutivas, bb-sign desactiva el endpoint y avisa por correo a los administradores. Ver Webhooks.

Resultado de cada intento

Resultado	Etiqueta en la aplicación	Qué significa
SUCCESS	Aceptado	Su endpoint respondió con un código 2xx.
HTTP_ERROR	Rechazado	Su endpoint respondió con un código distinto de 2xx. Busque en sus registros el X-BBSign-Event-Id de la entrega.
TRANSPORT_ERROR	Inaccesible	No hubo respuesta por un error de DNS, una conexión rechazada, un certificado TLS inválido o un tiempo de espera agotado. Compruebe que la URL sea pública y use HTTPS.

Credenciales de API

Las credenciales aparecen en Configuración, pestaña Credenciales de API.

Estado	Etiqueta en la aplicación	Qué significa
Activa	Activa	La credencial puede obtener tokens y llamar a la API.
Revocada, en expiración	Revocada — en expiración	La credencial se revocó recientemente. No obtiene tokens nuevos, y los que ya emitió siguen siendo válidos hasta caducar, como máximo 300 segundos después de emitidos. La fila muestra “Los tokens que esta credencial ya emitió dejan de funcionar a las” con la hora.
Revocada	Revocada	Ningún token de esta credencial es válido. La credencial permanece en la lista durante 90 días y luego se retira.

Rotar una credencial no cambia su estado: el secreto anterior deja de funcionar de inmediato y el nuevo se muestra una sola vez. Ver Credenciales de API.