Crear un flujo de trabajo de firmantes

Para descargar la muestra de código completa, consulte nuestro sitio Code Share. Si no puede usar el FastTrack, contacte con nuestro Equipo de asistencia para activarlo para su cuenta.

Al crear una transacción, puede requerir que varios firmantes firmen varios documentos. En consecuencia, quizá desee controlar el flujo de la Signer Experience. Con OneSpan Sign, puede establecer el orden en el que participan varios firmantes o el orden en el que un firmante firma varios documentos. El flujo de trabajo de firmantes determina el orden en el que varios firmantes pueden participar en la Signer Experience. Por ejemplo, un firmante con un orden de firma 1 significa que firmará primero.

En este ejemplo, los firmantes son cuatro y deben firmar siguiendo un orden concreto. Por ejemplo, el segundo firmante recibirá una notificación para firmar el documento solo cuando el primer firmante haya terminado de firmar. Use el siguiente código para hacerlo:

Crear un flujo de trabajo de firmantes

En este ejemplo, los firmantes son cuatro y deben firmar siguiendo un orden concreto. Por ejemplo, el segundo firmante recibirá una notificación para firmar el documento solo cuando el primer firmante haya terminado de firmar. Use el siguiente código para hacerlo:

  .WithSigner(SignerBuilder.NewSignerWithEmail("[email protected]") .WithFirstName("FirstNameSigner1") .WithLastName("LastNameSigner1") .SigningOrder(1)) .WithSigner(SignerBuilder.NewSignerWithEmail("[email protected]") .WithFirstName("FirstNameSigner2") .WithLastName("LastNameSigner2") .SigningOrder(2)) .WithSigner(SignerBuilder.NewSignerWithEmail("[email protected]") .WithFirstName("FirstNameSigner3") .WithLastName("LastNameSigner3") .SigningOrder(3)) .WithSigner(SignerBuilder.NewSignerWithEmail("[email protected]") .WithFirstName("FirstNameSigner4") .WithLastName("LastNameSigner4") .SigningOrder(4))  

Editar el flujo de trabajo del firmante

Después de crear su transacción, es posible que desee editar la orden de firma. En este ejemplo, se cambia el orden de firma de los dos primeros firmantes.

  afterReorder = eslClient.GetPackage(packageId); afterReorder.GetSigner(email2).SigningOrder = 1; afterReorder.GetSigner(email1).SigningOrder = 2; eslClient.PackageService.OrderSigners(afterReorder);  

Si ya envió su transacción, deberá cambiar su estado a BORRADOR para poder actualizar el flujo de trabajo de los firmantes.

Resultados

Después de ejecutar su código, si inicia sesión en OneSpan Sign y navega hasta su transacción, verá su orden de firmantes.

Para descargar la muestra de código completa, consulte nuestro sitio Code Share.

Al crear una transacción, puede requerir que varios firmantes firmen varios documentos. En consecuencia, quizá desee controlar el flujo de la Signer Experience. Con OneSpan Sign, puede establecer el orden en el que participan varios firmantes o el orden en el que un firmante firma varios documentos. El flujo de trabajo de firmantes determina el orden en el que varios firmantes pueden participar en la Signer Experience. Por ejemplo, un firmante con un orden de firma 1 significa que firmará primero.

Crear un flujo de trabajo de firmantes

En este ejemplo, los firmantes son cuatro y deben firmar siguiendo un orden concreto. Por ejemplo, el segundo firmante recibirá una notificación para firmar el documento solo cuando el primer firmante haya terminado de firmar. Use el siguiente código para hacerlo:

Solicitud HTTP

 POST /api/packages 

Encabezados HTTP

Accept: application/jsonContent-Type: 
application/json
Authorization: Basic api_key 

Carga útil de solicitud

  { "roles": [ { "id": "role1", "index": 1, "type": "SIGNER", "signers": [ { "email": "[email protected]", "firstName": "FirstNameSigner1", "lastName": "LastNameSigner1" } ], "name": "signer1" }, { "id": "role2", "index": 2, "type": "SIGNER", "signers": [ { "email": "[email protected]", "firstName": "FirstNameSigner2", "lastName": "LastNameSigner2" } ], "name": "signer2" }, { "id": "role3", "index": 3, "type": "SIGNER", "signers": [ { "email": "[email protected]", "firstName": "FirstNameSigner3", "lastName": "LastNameSigner3" } ], "name": "signer3" }, { "id": "role4", "index": 4, "type": "SIGNER", "signers": [ { "email": "[email protected]", "firstName": "FirstNameSigner4", "lastName": "LastNameSigner4" } ], "name": "signer4" } ] }  

Para obtener una descripción completa de cada campo, consulte la tabla Carga útil de solicitud siguiente.

Carga útil de respuesta

  { "id": "9sKhW-h-qS9m6Ho3zRv3n2a-rkI=" }  

Editar el flujo de trabajo de roles

Para actualizar el flujo de trabajo de roles, deberá realizar una solicitud PUT a:

Solicitud HTTP

 PUT /api/packages/{packageId}/roles 

Encabezados HTTP

Accept: application/json
Content-Type: application/json
Authorization: Basic api_key 

Carga útil de solicitud

  [{ "id":"OGCBUbLGa7gR", "index":0 }, { "id":"CnvwToUWLPgW", "index":1 }]  

Editar el flujo de trabajo del firmante

Después de crear su transacción, es posible que desee editar la orden de firma. En este ejemplo, se cambia el orden de firma de los dos primeros firmantes.

Si ya envió su transacción, deberá cambiar su estado a BORRADOR para poder actualizar el flujo de trabajo de los firmantes.

Resultados

Después de ejecutar su código, si inicia sesión en OneSpan Sign y navega hasta su transacción, verá su orden de firmantes.

Tabla de carga útil de solicitud

Para descargar la muestra de código completa, consulte nuestro sitio Code Share.

Al crear una transacción, puede requerir que varios firmantes firmen varios documentos. En consecuencia, quizá desee controlar el flujo de la Signer Experience. Con OneSpan Sign, puede establecer el orden en el que participan varios firmantes o el orden en el que un firmante firma varios documentos. El flujo de trabajo de firmantes determina el orden en el que varios firmantes pueden participar en la Signer Experience. Por ejemplo, un firmante con un orden de firma 1 significa que firmará primero.

Crear un flujo de trabajo de firmantes

En este ejemplo, los firmantes son cuatro y deben firmar siguiendo un orden concreto. Por ejemplo, el segundo firmante recibirá una notificación para firmar el documento solo cuando el primer firmante haya terminado de firmar. Use el siguiente código para hacerlo:

  //Method1: add signing order when creating role ESignLiveAPIObjects.Role role1 = new ESignLiveAPIObjects.Role(); role1.id = 'signer1'; role1.index = 1; role1.signers = sdk.createRolesSigner('FirstNameSigner1', 'LastNameSigner1', '[email protected]', 'Applicant', 'xxx Company'); sdk.helper.createRole(packageId, role1); ESignLiveAPIObjects.Role role2 = new ESignLiveAPIObjects.Role(); role2.id = 'signer2'; role2.index = 2; role2.signers = sdk.createRolesSigner('FirstNameSigner2', 'LastNameSigner2', '[email protected]', 'Director', 'ABC Bank'); sdk.helper.createRole(packageId, role2); ESignLiveAPIObjects.Role role3 = new ESignLiveAPIObjects.Role(); role3.id = 'signer3'; role3.index = 3; role3.signers = sdk.createRolesSigner('FirstNameSigner3', 'LastNameSigner3', '[email protected]', 'Applicant', 'xxx Company'); sdk.helper.createRole(packageId, role3); ESignLiveAPIObjects.Role role4 = new ESignLiveAPIObjects.Role(); role4.id = 'signer4'; role4.index = 4; role4.signers = sdk.createRolesSigner('FirstNameSigner4', 'LastNameSigner4', '[email protected]', 'Director', 'ABC Bank'); sdk.helper.createRole(packageId, role4);  

Editar el flujo de trabajo del firmante

Después de crear su transacción, es posible que desee editar la orden de firma. En este ejemplo, se cambia el orden de firma de los dos primeros firmantes.

  sdk.setSigningOrder('packageId', 'signer1',2); sdk.setSigningOrder('packageId', 'signer2',1);  

Si ya envió su transacción, deberá cambiar su estado a BORRADOR para poder actualizar el flujo de trabajo de los firmantes.

Resultados

Después de ejecutar su código, si inicia sesión en OneSpan Sign y navega hasta su transacción, verá su orden de firmantes.