¿Cómo comprobar el estado de un documento con DocuSign?

Question

Usaremos DocuSign API para firmar nuestros documentos.Una vez que se carga el documento para firmarlo/rechazarlo, tenemos DOS formas de obtener el estado del documento (firmado o rechazado):

1. Verificar el estado del documento llamando repetidamente a la API DocuSign desde nuestro servicio WCF (que está limitado a 1000 llamadas por hora, pero podemos limitarlo a 1 llamada por documento por hora)
2. ¿Enviar una URL pública con el sobre al que se llamará cada vez que se cambie el estado del documento?(https://www.docusign.com/p/RESTAPIGuide/Content/REST%20API%20References/Send%20an%20Envelope.htm) Este método requiere actualizar un parámetro llamado 'eventNotification' con la URL pública en nuestro entorno.

Me gustaría saber cuál es el mejor enfoque en cuanto a arquitectura.En promedio esperamos que se firmen 50 documentos al mes.

Answer 1

En general, la mejor práctica sería el enfoque n.° 2, es decir, configurar DocuSign Connect de manera que envíe automáticamente una notificación (al punto final que especifique) cada vez que ocurra uno de los eventos de sobre especificados.Este enfoque tiene muchas ventajas, entre ellas:

• El uso de Connect no cuenta para el límite de 1000 llamadas API por hora.
• Las notificaciones se enviarán/recibirán en tiempo (relativo) real.
• Usar Connect no requiere que pases por el proceso de "Certificación API"

La guía de servicio de DocuSign Connect (https://10226ec94e53f4ca538f-0035e62ac0d194a46695a3b225d72cc8.ssl.cf2.rackcdn.com/connect-guide.pdf) describe cómo configurar/implementar Connect.Necesitará realizar un poco de desarrollo personalizado para crear el "oyente" que recibirá y analizará las notificaciones XML de DocuSign, pero esto es sencillo y el código de muestra (en varios idiomas diferentes) está disponible en GitHub.

Nota:Si desea que DocuSign envíe automáticamente notificaciones para todos los sobres (para los remitentes que especifique), puede configurar Connect a nivel de cuenta a través de la consola web de DocuSign (Preferencias >> Conectar), en lugar de tener que especificar notificación de eventos como parte de cada Crear sobre Solicitud de API.Si utiliza este enfoque, cualquier cambio de configuración futuro se puede realizar simplemente a través de la consola web de DocuSign (Preferencias >> Conectar), en lugar de tener que realizar cambios en el código.es decir, si desea agregar notificaciones para otros eventos, incluya o excluya los documentos en sí, etc.