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

Una vez creada una transacción, puede recuperar el estado de firma de esa transacción o de un firmante en particular.

Se recomienda encarecidamente utilizar una Escucha de devolución de llamada en lugar de sondear los estados de las transacciones. El uso de sondeos puede consumir recursos innecesarios tanto en su extremo como en el servicio de OneSpan Sign.

Las transacciones de OneSpan Sign siguen un ciclo de vida predefinido, definido por los siguientes estados de ciclo de vida:

  • Borrador: La transacción aún no se envió.
  • En progreso: La transacción se distribuyó para su firma, pero aún no se completó.
  • Completado: Todos los destinatarios firmaron la transacción.
  • Elegir no hacerlo: La transacción tiene al menos un destinatario que optó por no firmar la transacción electrónicamente. Nota: La opción de exclusión se eliminó de Experiencia para firmantes.
  • Rechazado: La transacción tiene al menos un destinatario que se negó a firmar la transacción.
  • Caducó: La transacción caducó (es decir, su fecha de caducidad es pasada).
  • Archivado: La transacción se archivó.

El siguiente diagrama describe el flujo por el que pasa normalmente una transacción. Además, se incluyen en este diagrama dos posibles acciones que se pueden realizar durante este proceso de ciclo de vida.

  • Acción Enviar a papelera de reciclaje: La acción Enviar a papelera de reciclaje se utiliza para mover una transacción seleccionada a la carpeta Papelera de reciclaje. Las transacciones en la carpeta de basura no se eliminan automáticamente, a menos que haya una política de retención específica establecida para esa cuenta. Las transacciones que se eliminan manualmente de esta carpeta son recuperables durante dos semanas después de la eliminación. Para recuperar estas transacciones debe ponerse en contacto con nuestro Equipo de asistencia.
  • Acción Eliminar: Su paquete se eliminará permanentemente y no se puede restaurar.

Para pasar de un estado a otro, consulte las secciones indicadas por los números en el diagrama que corresponden a los cambios de estado que desea realizar.

Captura

El primer paso es crear su objeto PackageId . El siguiente código hará lo siguiente:

 PackageId packageId = new PackageId("XB4m3cocNudSPEAoUDCIZgbkZD4="); 

A continuación, se utiliza el cliente OneSpan Sign para consultar el estado de la transacción y de un firmante. El siguiente código hará lo siguiente:

 com.silanis.esl.sdk.SigningStatus pkgStatus = eslClient.getSigningStatus(packageId, null, null);   com.silanis.esl.sdk.SigningStatus signerStatus1 = eslClient.getSigningStatus(packageId, new SignerId(signerId1), null); 

Resultados

Una vez que haya recuperado el estado de firma, ejecute System.out.println() con cada objeto SigningStatus .

A continuación, se muestra un ejemplo de lo que puede ver una vez que haya ejecutado su código.

captura

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

Una vez creada una transacción, puede recuperar el estado de firma de esa transacción o de un firmante en particular.

Se recomienda encarecidamente utilizar una Escucha de devolución de llamada en lugar de sondear los estados de las transacciones. El uso de sondeos puede consumir recursos innecesarios tanto en su extremo como en el servicio de OneSpan Sign.

Las transacciones de OneSpan Sign siguen un ciclo de vida predefinido, definido por los siguientes estados de ciclo de vida:

  • Borrador: La transacción aún no se envió.
  • En progreso: La transacción se distribuyó para su firma, pero aún no se completó.
  • Completado: Todos los destinatarios firmaron la transacción.
  • Elegir no hacerlo: La transacción tiene al menos un destinatario que optó por no firmar la transacción electrónicamente. Nota: La opción de exclusión se eliminó de Experiencia para firmantes.
  • Rechazado: La transacción tiene al menos un destinatario que se negó a firmar la transacción.
  • Caducó: La transacción caducó (es decir, su fecha de caducidad es pasada).
  • Archivado: La transacción se archivó.

El siguiente diagrama describe el flujo por el que pasa normalmente una transacción. Además, se incluyen en este diagrama dos posibles acciones que se pueden realizar durante este proceso de ciclo de vida.

  • Acción Enviar a papelera de reciclaje: La acción Enviar a papelera de reciclaje se utiliza para mover una transacción seleccionada a la carpeta Papelera de reciclaje. Las transacciones en la carpeta de basura no se eliminan automáticamente, a menos que haya una política de retención específica establecida para esa cuenta. Las transacciones que se eliminan manualmente de esta carpeta son recuperables durante dos semanas después de la eliminación. Para recuperar estas transacciones debe ponerse en contacto con nuestro Equipo de asistencia.
  • Acción Eliminar: Su paquete se eliminará permanentemente y no se puede restaurar.

Para pasar de un estado a otro, consulte las secciones indicadas por los números en el diagrama que corresponden a los cambios de estado que desea realizar.

Captura

El primer paso es crear su objeto PackageId . El siguiente código hará lo siguiente:

 PackageId packageId = new PackageId("XB4m3cocNudSPEAoUDCIZgbkZD4="); 

A continuación, se utiliza el cliente OneSpan Sign para consultar el estado de la transacción y de un firmante. El siguiente código hará lo siguiente:

 Silanis.ESL.SDK.SigningStatus signerStatus1 = eslClient.GetSigningStatus(packageId, signerId1, null);   Silanis.ESL.SDK.SigningStatus pkgStatus = eslClient.GetSigningStatus(packageId, null, null); 

Resultados

Una vez que haya recuperado el estado de firma, ejecute Debug.WriteLine() con cada objeto SigningStatus.

A continuación, se muestra un ejemplo de lo que puede ver una vez que haya ejecutado su código.

captura

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

Una vez creada una transacción, puede recuperar el estado de firma de esa transacción o de un firmante en particular.

Se recomienda encarecidamente utilizar una Escucha de devolución de llamada en lugar de sondear los estados de las transacciones. El uso de sondeos puede consumir recursos innecesarios tanto en su extremo como en el servicio de OneSpan Sign.

Las transacciones de OneSpan Sign siguen un ciclo de vida predefinido, definido por los siguientes estados de ciclo de vida:

  • Borrador: La transacción aún no se envió.
  • En progreso: La transacción se distribuyó para su firma, pero aún no se completó.
  • Completado: Todos los destinatarios firmaron la transacción.
  • Elegir no hacerlo: La transacción tiene al menos un destinatario que optó por no firmar la transacción electrónicamente. Nota: La opción de exclusión se eliminó de Experiencia para firmantes.
  • Rechazado: La transacción tiene al menos un destinatario que se negó a firmar la transacción.
  • Caducó: La transacción caducó (es decir, su fecha de caducidad es pasada).
  • Archivado: La transacción se archivó.

El siguiente diagrama describe el flujo por el que pasa normalmente una transacción. Además, se incluyen en este diagrama dos posibles acciones que se pueden realizar durante este proceso de ciclo de vida.

  • Acción Enviar a papelera de reciclaje: La acción Enviar a papelera de reciclaje se utiliza para mover una transacción seleccionada a la carpeta Papelera de reciclaje. Las transacciones en la carpeta de basura no se eliminan automáticamente, a menos que haya una política de retención específica establecida para esa cuenta. Las transacciones que se eliminan manualmente de esta carpeta son recuperables durante dos semanas después de la eliminación. Para recuperar estas transacciones debe ponerse en contacto con nuestro Equipo de asistencia.
  • Acción Eliminar: Su paquete se eliminará permanentemente y no se puede restaurar.

Para pasar de un estado a otro, consulte las secciones indicadas por los números en el diagrama que corresponden a los cambios de estado que desea realizar.

Captura

El siguiente código hará lo siguiente:

Solicitud HTTP

GET /api/packages/{packageId}/signingStatus?signer={signerId}&document={documentId}

Encabezados HTTP

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

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

Carga útil de respuesta

 {   "status": "DRAFT"   } 

Donde packageId se le devuelve durante la creación de la transacción. Opcionalmente, puede agregar los parámetros documentId y signerId para recuperar el estado de firma de un firmante o un documento.

Resultados

A continuación, se muestra un ejemplo de lo que puede ver una vez que haya ejecutado su código.

captura

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

Una vez creada una transacción, puede recuperar el estado de firma de esa transacción o de un firmante en particular.

Se recomienda encarecidamente utilizar una Escucha de devolución de llamada en lugar de sondear los estados de las transacciones. El uso de sondeos puede consumir recursos innecesarios tanto en su extremo como en el servicio de OneSpan Sign.

Las transacciones de OneSpan Sign siguen un ciclo de vida predefinido, definido por los siguientes estados de ciclo de vida:

  • Borrador: La transacción aún no se envió.
  • En progreso: La transacción se distribuyó para su firma, pero aún no se completó.
  • Completado: Todos los destinatarios firmaron la transacción.
  • Elegir no hacerlo: La transacción tiene al menos un destinatario que optó por no firmar la transacción electrónicamente. Nota: La opción de exclusión se eliminó de Experiencia para firmantes.
  • Rechazado: La transacción tiene al menos un destinatario que se negó a firmar la transacción.
  • Caducó: La transacción caducó (es decir, su fecha de caducidad es pasada).
  • Archivado: La transacción se archivó.

El siguiente diagrama describe el flujo por el que pasa normalmente una transacción. Además, se incluyen en este diagrama dos posibles acciones que se pueden realizar durante este proceso de ciclo de vida.

  • Acción Enviar a papelera de reciclaje: La acción Enviar a papelera de reciclaje se utiliza para mover una transacción seleccionada a la carpeta Papelera de reciclaje. Las transacciones en la carpeta de basura no se eliminan automáticamente, a menos que haya una política de retención específica establecida para esa cuenta. Las transacciones que se eliminan manualmente de esta carpeta son recuperables durante dos semanas después de la eliminación. Para recuperar estas transacciones debe ponerse en contacto con nuestro Equipo de asistencia.
  • Acción Eliminar: Su paquete se eliminará permanentemente y no se puede restaurar.

Para pasar de un estado a otro, consulte las secciones indicadas por los números en el diagrama que corresponden a los cambios de estado que desea realizar.

Captura

La siguiente función le permite consultar un estado:

 public String getSigningStatus(String packageId, String signerId, String documentId) 

También puede consultar el estado de un paquete o de un firmante o de un firmante con ID de documento específico. El siguiente código permite hacerlo:

 String pkgStatus = getSigningStatus('_AQlDyjbxVLphMfM0oPG5YuioTU=',null,null);   String signer1Status = getSigningStatus('_AQlDyjbxVLphMfM0oPG5YuioTU=','[email protected]',null);   String signer1Document1Status = getSigningStatus('_AQlDyjbxVLphMfM0oPG5YuioTU=','[email protected]','document1'); 

Resultados

A continuación, se muestra un ejemplo de lo que puede ver una vez que haya ejecutado su código.

Captura