API de DocuSign: Listar todos los destinatarios de un sobre que aún no han firmado

Navegando la API de DocuSign para gestionar sobres

En el mundo de rápida evolución de los acuerdos digitales, las empresas dependen de plataformas de firma electrónica para agilizar los flujos de trabajo. DocuSign, como líder en este campo, ofrece una potente funcionalidad de API que permite a los desarrolladores automatizar y supervisar los procesos de documentos. Un desafío común es rastrear el estado de los destinatarios en un sobre, especialmente identificar a los que aún no han firmado. Esta capacidad es crucial para el cumplimiento, el seguimiento y la eficiencia operativa, particularmente en entornos de alto volumen, como equipos de ventas o departamentos legales.

Comprender la API de DocuSign y los destinatarios del sobre

La API de firma electrónica de DocuSign proporciona puntos finales para administrar sobres, que son esencialmente contenedores para documentos que requieren firmas. Un sobre puede tener múltiples destinatarios, cada uno con roles como firmante, aprobador o copiador. La API utiliza una arquitectura RESTful, admite cargas JSON y requiere autenticación a través de OAuth 2.0 o autorización JWT.

Para enumerar todos los destinatarios de un sobre que no han firmado, los desarrolladores suelen consultar el estado del sobre y los detalles del destinatario. El punto final clave es GET /accounts/{accountId}/envelopes/{envelopeId}/recipients en la API de sobres. Esto devuelve una lista completa de destinatarios, incluido su estado (por ejemplo, "sent", "declined", "signed" o "needs_to_sign").

Aquí hay una guía paso a paso para implementar esta funcionalidad:

1. Configuración de autenticación: obtenga un token de acceso utilizando el entorno de pruebas para desarrolladores de DocuSign. Para entornos de producción, intégrelo con el sistema IAM (Gestión de Identidad y Acceso) de su aplicación. La funcionalidad IAM de DocuSign es parte de su programa de mejora, que incluye integraciones SSO con proveedores como Okta o Azure AD, lo que garantiza un acceso seguro a la API sin exponer las credenciales.

2. Recuperar detalles del sobre: primero, obtenga el sobre utilizando GET /envelopes/{envelopeId}. Esto confirma el estado del sobre (por ejemplo, "sent" o "in_progress") y proporciona metadatos como la fecha de creación y la fecha límite.

3. Consultar destinatarios: llame al punto final de destinatarios. La respuesta incluye una matriz de objetos de destinatarios, cada uno con:

   • id: identificador único.
   • email: correo electrónico del destinatario.
   • status: estado actual (filtre "sent" o "needs_to_sign" para identificar a los destinatarios no firmados).
   • routingOrder: orden en el flujo de firma.
   • name: nombre del destinatario.

   Un fragmento JSON de ejemplo de una respuesta de API:

   {
     "recipients": {
       "signers": [
         {
           "email": "john.doe@example.com",
           "status": "sent",
           "name": "John Doe",
           "signedDateTime": null
         },
         {
           "email": "jane.smith@example.com",
           "status": "signed",
           "name": "Jane Smith",
           "signedDateTime": "2025-01-15T10:00:00Z"
         }
       ]
     }
   }
   

4. Filtrar destinatarios no firmados: en su código (por ejemplo, usando Python con la biblioteca requests o Node.js con Axios), analice la respuesta y filtre los casos donde status != "signed" y signedDateTime es nulo. Para operaciones por lotes, use el punto final GET /envelopes con parámetros de consulta como status=sent para enumerar varios sobres.

   Código de ejemplo de Python:

   import requests
   
   access_token = "your_access_token"
   account_id = "your_account_id"
   envelope_id = "your_envelope_id"
   base_url = "https://demo.docusign.net/restapi"
   
   headers = {
       "Authorization": f"Bearer {access_token}",
       "Accept": "application/json"
   }
   
   response = requests.get(
       f"{base_url}/v2.1/accounts/{account_id}/envelopes/{envelope_id}/recipients",
       headers=headers
   )
   
   if response.status_code == 200:
       data = response.json()
       unsigned_recipients = [
           r for r in data.get('recipients', {}).get('signers', [])
           if r.get('status') != 'signed' and r.get('signedDateTime') is None
       ]
       print("Unsigned recipients:", unsigned_recipients)
   

5. Manejo de errores y mejores prácticas: maneje los límites de velocidad (por ejemplo, 1000 llamadas a la API por minuto) y los errores, como 404 (sobre no encontrado). Para usuarios empresariales, aproveche los planes API avanzados de DocuSign, que incluyen webhooks de Connect API para actualizaciones de estado en tiempo real. Esto evita el sondeo y reduce las llamadas a la API.

Este enfoque garantiza que pueda notificar programáticamente a los destinatarios no firmados, escalar retrasos o integrarse con sistemas CRM como Salesforce. En entornos comerciales, dicha automatización puede reducir el seguimiento manual hasta en un 70 %, según los puntos de referencia de la industria de los recursos para desarrolladores de DocuSign.

Los precios de la API de DocuSign comienzan desde $600/año para el plan Starter (40 sobres por mes) y se extienden a opciones empresariales personalizadas. Para los equipos en industrias reguladas, combinar esto con capacidades IAM, como pistas de auditoría avanzadas y acceso basado en roles, puede mejorar el cumplimiento sin desarrollo personalizado.

¿Está comparando plataformas de firma electrónica con DocuSign o Adobe Sign?

eSignGlobal ofrece una solución de firma electrónica más flexible y rentable con cumplimiento global, precios transparentes y un proceso de incorporación más rápido.

👉 Comience una prueba gratuita

Explorando el ecosistema de DocuSign y las capacidades de IAM

DocuSign se extiende más allá de las firmas básicas y ofrece herramientas integradas como CLM (Gestión del ciclo de vida del contrato) en su conjunto de Gestión Inteligente de Acuerdos (IAM). IAM CLM automatiza la creación, negociación y ejecución de contratos, extrayendo datos de sobres para rastrear obligaciones. Para los usuarios de API, admite la incorporación de ceremonias de firma y la extracción de datos de destinatarios no firmados en paneles.

En la práctica, las empresas utilizan IAM para la visibilidad de extremo a extremo: las entradas de destinatarios no firmados de sobres activan alertas de riesgo o flujos de trabajo de aprobación. Los precios de las actualizaciones de IAM son personalizados, a menudo incluidos con el plan Business Pro a $480/usuario/año, agregando capacidades de gobernanza y análisis.

Panorama competitivo: una comparación neutral

El mercado de firmas electrónicas es competitivo, con plataformas que difieren en profundidad de API, precios y cumplimiento regional. Aquí hay una tabla de comparación de Markdown de jugadores clave, que destaca las capacidades de API para la gestión de destinatarios, los precios centrales y las ventajas. Los datos provienen de fuentes públicas de 2025 para garantizar la neutralidad.

Esta tabla destaca las compensaciones: DocuSign sobresale en un ecosistema maduro, mientras que otras plataformas priorizan la asequibilidad o las ventajas de nicho.

Adobe Sign: descripción general de la integración y la API

Adobe Sign, parte de Adobe Document Cloud, enfatiza los flujos de trabajo centrados en PDF. Su API es similar a DocuSign para el seguimiento de destinatarios, utilizando GET /agreements/{agreementId}/participants para enumerar las partes no firmadas. Se adapta a las industrias creativas, con capacidades de edición de PDF integradas. Los precios comienzan en $10/mes para Individual y se escalan a tarifas personalizadas para empresas. La ventaja de Adobe radica en la integración perfecta con Acrobat y herramientas de marketing, pero las cuotas de API pueden limitar el uso de alto volumen.

HelloSign (Dropbox Sign): simplicidad para SMB

HelloSign, ahora Dropbox Sign, ofrece una API sencilla para la gestión de sobres. Recupere destinatarios no firmados a través de GET /v3/signature_request/{request_id}, filtrando por estado. Es elogiado por su facilidad de uso, con plantillas y recordatorios integrados. A $180/año para Essentials, es económico para equipos pequeños, aunque carece del IAM avanzado de DocuSign.

eSignGlobal: una alternativa optimizada para APAC

eSignGlobal se posiciona como un competidor global, que admite el cumplimiento en más de 100 países y territorios principales. Tiene una ventaja particular en Asia-Pacífico (APAC), donde las regulaciones de firma electrónica son fragmentadas, de alto estándar y estrictamente reguladas, lo que a menudo requiere un enfoque profundo de integración del ecosistema en lugar de modelos basados en marcos ESIGN/eIDAS comunes en los EE. UU. y la UE. Los requisitos de APAC para el acoplamiento profundo de hardware/API de identidad digital de gobierno a empresa (G2B) son una barrera técnica mucho más allá de la verificación de correo electrónico o los métodos de autodeclaración comunes en los mercados occidentales.

La API de la plataforma incluye consultas de estado de destinatarios similares a DocuSign, con soporte para envío masivo y webhooks en el plan Professional. Los precios son competitivos: la versión Essential cuesta solo $16.6/mes (equivalente a $199/año en algunas promociones), lo que permite hasta 100 documentos firmados, asientos de usuario ilimitados y verificación de código de acceso, todo mientras se mantiene el cumplimiento. Se integra perfectamente con iAM Smart de Hong Kong y Singpass de Singapur, lo que lo hace adecuado para operaciones transfronterizas en APAC.

¿Está buscando una alternativa más inteligente a DocuSign?

eSignGlobal ofrece una solución de firma electrónica más flexible y rentable con cumplimiento global, precios transparentes y un proceso de incorporación más rápido.

👉 Comience una prueba gratuita

Implicaciones comerciales y recomendaciones

Desde una perspectiva comercial, la API de DocuSign sigue siendo un punto de referencia para la confiabilidad en el seguimiento de sobres, particularmente para las empresas globales. Sin embargo, a medida que las empresas se expanden a diversas regiones, las alternativas están ganando terreno. Para los usuarios que buscan alternativas a DocuSign, eSignGlobal se destaca como una opción de cumplimiento regional, especialmente en APAC, que equilibra el costo y las características sin cargos por asiento. Evalúe según su capacidad, integraciones y ubicación geográfica para encontrar la mejor opción.