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

Una vez enviada una transacción para su firma, puede recuperar todas las firmas en un documento específico, para un firmante específico. Use el siguiente código para hacerlo:

Si necesita una comparación con el procedimiento básico de creación de objetos o si es la primera vez que crea una transacción, consulte Crear y enviar una transacción.

Firs, recupera su objeto DocumentPackage. Use el siguiente código para hacerlo:

 DocumentPackage sentPackage = client.getPackage(packageId);

Entonces, utilizando el OneSpan SignApprovalService, puede recuperar todas las firmas. Utilice los objetos DocumentPackage, SignatureID y documentID como parámetros. Use el siguiente código para hacerlo:

 List<Signature> signer1SignableSignatures = client.getApprovalService().getAllSignableSignatures(sentPackage, documentId, signer1Id);

Finalmente, puede recorrer cada firma para recuperar cualquier información adicional, como el posicionamiento de la firma, la fecha aceptada y así sucesivamente.

 for (Signature signature : signer1SignableSignatures){   System.out.println("Position of signature " + i + ": (" + signature.getX() + ", " + signature.getY() + ") on page " + signature.getPage());   i++;   }

Si el paquete contiene un documento "Aceptar únicamente", el nodo de Aprobaciones no tendrá ninguna firma en él.

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 enviada una transacción para su firma, puede recuperar todas las firmas en un documento específico, para un firmante específico. Use el siguiente código para hacerlo:

Si necesita una comparación con el procedimiento básico de creación de objetos o si es la primera vez que crea una transacción, consulte Crear y enviar una transacción.

Firs, recupera su objeto DocumentPackage. Use el siguiente código para hacerlo:

 DocumentPackage sentPackage = client.GetPackage(packageId);

Entonces, utilizando el OneSpan SignApprovalService, puede recuperar todas las firmas. Utilice los objetos DocumentPackage, SignatureID y documentID como parámetros. Use el siguiente código para hacerlo:

 IList<Signature> signer1SignableSignatures = client.ApprovalService.GetAllSignableSignatures(sentPackage, documentId, signer1Id);

Finalmente, puede recorrer cada firma para recuperar cualquier información adicional, como el posicionamiento de la firma, la fecha aceptada y así sucesivamente.

 foreach (Signature signature in signer1SignableSignatures){   Debug.WriteLine("Position of signature " + i + ": (" + signature.X + ", " + signature.Y + ") on page " + signature.Page);   i++;   }

Si el paquete contiene un documento "Aceptar únicamente", el nodo de Aprobaciones no tendrá ninguna firma en él.

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 que haya enviado la transacción para su firma, puede usar el siguiente código para recuperar todas las firmas de todos los firmantes de un documento y usar PackageID y documentID como parámetros.

Si necesita una comparación con el procedimiento básico de creación de objetos o si es la primera vez que crea una transacción, consulte Crear y enviar una transacción.

Solicitud HTTP

GET /api/packages/{packageId}/documents/{documentId}

Encabezados HTTP

Accept: application/json; esl-api-version=11.21   
Authorization: Basic api_key

Carga útil de respuesta

  {   "description": "",   "id": "ddcad715b41ed28d0d8b16580c829501f35d5ed836d800c0",   "index": 0,   "name": "purchase_order",   "approvals": [   {   "id": "UMxe8ClLfEYK",   "role": "15be0c69-b672-4314-9ffd-d3da69770caa",   "signed": null,   "accepted": null,   "fields": [...],   "name": ""   },   {   ... }   ],   ... }

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

Entonces, puede recorrer cada firma para recuperar cualquier información adicional, como el posicionamiento de la firma, la fecha aceptada y así sucesivamente.

También puede recuperar todas las firmas de un firmante específico en uno o varios documentos. Para recuperar firmas de un solo documento, utilice el siguiente código:

Solicitud HTTP

GET /api/packages/{packageId}/documents/{documentId}/signers/{signerId}/approvals

Encabezados HTTP

Accept: application/json; esl-api-version=11.21   
Authorization: Basic api_key

Carga útil de respuesta

  [   {   "id": "eZDydIrS1XQV",   "optional": false,   "name": "",   "enforceCaptureSignature": false,   "accepted": "2019-08-12T16:01:00Z",   "signed": "2019-08-12T16:01:02Z",   "role": "50a3431e-04e2-49b1-81c8-a5e2bc550932",   "fields": [...],   ... },   {   ... }   ]

Para recuperar todas las firmas de la transacion, elimine el /documents/{documentId}" de la ruta URL. Use el siguiente código para hacerlo:

Solicitud HTTP

GET /api/packages/{packageId}/signers/{signerId}/approvals

Encabezados HTTP

Accept: application/json; esl-api-version=11.21   
Authorization: Basic api_key

Carga útil de respuesta

  [   {   "documentId": "efc058bf9f0c261947c62a8d199be5d5ea6495ca102c8076",   "approvals": [   ... ]   },   {   "documentId": "default-consent",   "approvals": [   {   "id": "339df19b-e8ee-4dd0-bdb8-d4f38bc368c5",   "enforceCaptureSignature": false,   "accepted": "2019-08-12T16:00:56Z",   "signed": "2019-08-12T16:00:56Z",   "role": "50a3431e-04e2-49b1-81c8-a5e2bc550932",   "optional": false,   "fields": [],   "name": "",   "data": null   }   ]   },   {   "documentId": "91a88db05a2f122ab214ef6f5933219658ade8d81b7f1035",   "approvals": []   }   ]

En la carga útil de respuesta, se enumeran todos los ID de documento con las firmas asignadas al firmante. Si el destinatario no tiene ninguna firma en un documento, la matriz de aprobaciones estará vacía.

Resultados

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

Captura

Tabla de carga útil de solicitud

Propiedad Tipo Editable Obligatorio Predeterminado Valores de ejemplo
description string Sí No n/a documento de consentimiento de muestra
id string Sí No n/a ddcad715b41ed28d0d8b16580c829501f35d5ed836d800c0
extract boolean Sí No false true / false
index integer Sí No 0 0 / 1 / 2 ...
name string Sí No n/a purchase_order
data
ese_document_texttag_extract_needed boolean Sí No false false / true
approvals
fields
subtype string Sí No n/a NOMBRE COMPLETO / INICIALES / CAPTURA / CAPTURA_MÓVIL / ETIQUETA / CAMPO DE TEXTO / ÁREA DE TEXTO / CASILLA DE VERIFICACIÓN / FECHA / RADIO / LISTA
type string Sí No n/a FIRMA / ENTRADA
extract boolean Sí No false true / false
height integer Sí No 50 50 / 100 / 150 ...
left integer Sí No 0 50 / 100 / 150 ...
page integer Sí No 0 0 / 1 / 2 ...
top integer Sí No 0 50 / 100 / 150 ...
width integer Sí No 200 50 / 100 / 150 ...
role string Sí No n/a Client1
pages
id string No No n/a n/a
top integer No No 0 n/a
height integer No No 1030 n/a
width integer No No 796 n/a
left integer No No 0 n/a
index integer No No 0 n/a
version integer No No 0 n/a

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

Una vez enviada una transacción para su firma, puede recuperar todas las firmas en un documento específico, para un firmante específico. Use el siguiente código para hacerlo:

Si necesita una comparación con el procedimiento básico de creación de objetos o si es la primera vez que crea una transacción, consulte Crear y enviar una transacción.

Firs, recupera su PackageID. Use el siguiente código para hacerlo:

Entonces, puede recuperar todas las firmas. Utilice PackageID SignatureID y documentID como parámetros. Use el siguiente código para hacerlo:

  public List<ESignLiveAPIObjects.Approval> getAllSignableSignatures(String packageId, String documentId, String signerId)

Finalmente, puede recorrer cada firma para recuperar cualquier información adicional, como el posicionamiento de la firma, la fecha aceptada y así sucesivamente.

  List<ESignLiveAPIObjects.Approval> allSignableSignatures = getAllSignableSignatures(packageId, documentId, signerId);   for(ESignLiveAPIObjects.Approval approval: allSignableSignatures){   System.debug('Approval ID: ' + approval.id);   if(approval.fields != null && approval.fields.size() > 0){   for(ESignLiveAPIObjects.Field field: approval.fields){   System.debug('----Field ID:' + field.id + ', TYPE: ' + field.type + ' ' + field.subtype);   }   }   }

Si el paquete contiene un documento "Aceptar únicamente", el nodo de Aprobaciones no tendrá ninguna firma en él.

Resultados

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

Captura