MENU
    Récupération des raisons de refus
    • 21 Nov 2024
    • 19 Minutes à lire
    • Sombre
    • PDF

    Récupération des raisons de refus

    • Sombre
    • PDF

    Résumé de l’article

    Java SDK.NET SDKREST APIAPEX SDK

    Java SDK

    Pour télécharger l’exemple de code complet, consultez notre site Code Share .

    Si un signataire refuse de signer ses documents, il sera invité à saisir une raison pour le faire. De telles raisons peuvent être récupérées. La rubrique suivante décrit comment procéder.

    Pour récupérer les raisons de refus, vous devez d’abord créer un objet PackageID pour votre transaction. Une fois que vous avez votre objet PackageID , vous ferez appel à votre client OneSpan Sign pour récupérer ces raisons, en utilisant l’objet PackageID comme paramètre. Pour ce faire, le code suivant :

    EslClient client = new EslClient(key, url);
    
    PackageId packageId = new PackageId("VMvbq5C0BIQaxCtG_8LlppDdj08=");
    DocumentPackage documentPackage = client.getPackage(packageId);
    
    List<Message> messages = client.getPackage(packageId).getMessages();
    System.out.println(documentPackage.getStatus().toString() +" reason : " + messages.get(0).getContent());
    Java

    Résultats

    Voici un exemple de ce que vous pouvez vous attendre à voir une fois que vous avez exécuté votre code.

    Kit de développement logiciel (SDK) .NET

    Pour télécharger l’exemple de code complet, consultez notre site Code Share .

    Si un signataire refuse de signer ses documents, il sera invité à saisir une raison pour le faire. De telles raisons peuvent être récupérées. La rubrique suivante décrit comment procéder.

    Pour récupérer les raisons de refus, vous devez d’abord créer un objet PackageID pour votre transaction. Une fois que vous avez votre objet PackageID , vous ferez appel à votre client OneSpan Sign pour récupérer ces raisons, en utilisant l’objet PackageID comme paramètre. Pour ce faire, le code suivant :

    EslClient client = new EslClient(key, url);
    
    PackageId packageId = new PackageId("VMvbq5C0BIQaxCtG_8LlppDdj08=");
    
    DocumentPackage documentPackage = client.GetPackage(packageId);
    IList<Message> messages = client.GetPackage(packageId).Messages;
    
    Debug.WriteLine(documentPackage.Status.ToString() +" reason : " + messages[0].Content);
    C#

    Résultats

    Voici un exemple de ce que vous pouvez vous attendre à voir une fois que vous avez exécuté votre code.

    REST API

    Pour télécharger l’exemple de code complet, consultez notre site Code Share .

    Si un signataire refuse de signer ses documents, il sera invité à saisir une raison pour le faire. De telles raisons peuvent être récupérées. La rubrique suivante décrit comment procéder.

    Pour récupérer les messages refusés, vous devez d’abord récupérer le package JSON. Ensuite, vous pouvez récupérer les messages à partir de la clé « messages » dans l’objet JSONresponse .

    Requête HTTP

    GET /api/packages/{packageId}
    HTTP

    En-têtes HTTP

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

    Charge utile de réponse

    {
      "status": "OPTED_OUT",
      "roles": [
        {
          "id": "TE4gJQuFqNE5",
          "data": null,
          "emailMessage": {
            "content": ""
          },
          "locked": false,
          "reassign": false,
          "specialTypes": [],
          "attachmentRequirements": [],
          "type": "SENDER",
          "index": 0,
          "signers": [
            {
              "group": null,
              "language": "en",
              "signature": {
                "handdrawn": "AQAAADJI+a4cnf0t3Dlf0GqWJceCA+4AAwADAN8BAAADAAAAggPuAOgAAAACfyxAUkAlQCdAOUA6QDtAHEAtQBtACkAJQBVAFBIyfkA0QBVABkAYQCpAHEAtQC9ALkAtQDxAO0A6QEhAN0AlQCQyTjZAgEBwQIBAoFDSUOFQ8lDiUNJQ0lCiQHBAUCIXGVBSUCVQN1BJUDpQXVA9UE5QLlAuUDpQOVAkm1BhQLZAd0B7QFpAXUBPQTBAHkAdQAtAB2AmYBRgQmCAcJVwmHC5Mh42QFBAkECAQKBAsEDAQNBQ8VDyUPJQ81DTULRQg1ByUEGeIgQ6QDhAJ0AmQCZAFItwbHBtMhdBUCafUGJQcVCSUJFQoUDAQKBAsECBQHNAdEBEQDRABkAFYCdgR2BXYHhgd2CIYIVgdmBDYEJAUUBwQIFAkECwQLBA0EDAQLBAoEBwQGASG0xAc0BnQEhASkArQBxADEAKQAlABkAFMkVKUENQUVBBUGFQYVCRUKJQsVDCUNJQsUDQQKBAkEBwQFJAREAlIllVUHFQUVByUKFQslDSUNJQ9VDlUPZQ1lDWUKVQZVBEUCQyCxivr2BjYGRgdGB1YHZgZmBWYEdgRkAFQClAREBjQJNAk0CzQKNAs0CjQJNAQo9gRWBjYJNgs2DCYNRg1GCkYKRgY2Bkrg==",
                "textual": null
              },
              "id": "ZQI8k6faVoM8",
              "data": null,
              "title": null,
              "auth": {
                "scheme": "NONE",
                "challenges": []
              },
              "updated": "2018-05-02T15:55:42Z",
              "external": null,
              "knowledgeBasedAuthentication": null,
              "email": "mail44@example.com",
              "firstName": "Haris",
              "lastName": "Haidary",
              "phone": "",
              "professionalIdentityFields": [],
              "userCustomFields": [],
              "company": "eSignLive",
              "delivery": {
                "download": true,
                "email": true,
                "provider": false
              },
              "address": null,
              "created": "2018-05-02T15:55:42Z",
              "name": "",
              "specialTypes": []
            }
          ],
          "name": "Owner"
        },
        {
          "id": "bf5ed1f3-54dc-4231-8548-e01878cda700",
          "data": null,
          "emailMessage": {
            "content": ""
          },
          "locked": false,
          "reassign": false,
          "specialTypes": [],
          "attachmentRequirements": [],
          "type": "SIGNER",
          "index": 0,
          "signers": [
            {
              "group": null,
              "language": "en",
              "signature": null,
              "id": "a8e907ec-9472-4cb9-812a-efe5af88ed1b",
              "data": null,
              "title": "",
              "auth": {
                "scheme": "NONE",
                "challenges": []
              },
              "updated": "2018-05-02T15:56:02Z",
              "external": null,
              "knowledgeBasedAuthentication": null,
              "email": "mai33@example.com",
              "firstName": "john",
              "lastName": "smith",
              "phone": "",
              "professionalIdentityFields": [],
              "userCustomFields": [],
              "company": "",
              "delivery": {
                "download": false,
                "email": false,
                "provider": false
              },
              "address": null,
              "created": "2018-05-02T15:56:03Z",
              "name": "",
              "specialTypes": []
            }
          ],
          "name": "Signer1"
        },
        {
          "id": "b85551ee-6788-4468-9943-947a24b53d1e",
          "data": null,
          "emailMessage": {
            "content": ""
          },
          "locked": false,
          "reassign": false,
          "specialTypes": [],
          "attachmentRequirements": [],
          "type": "SIGNER",
          "index": 0,
          "signers": [
            {
              "group": null,
              "language": "en",
              "signature": null,
              "id": "530d4aa6-dc40-430f-a797-67ce030bd632",
              "data": null,
              "title": "",
              "auth": {
                "scheme": "NONE",
                "challenges": []
              },
              "updated": "2018-05-02T15:56:12Z",
              "external": null,
              "knowledgeBasedAuthentication": null,
              "email": "john_smith@example.com",
              "firstName": "John",
              "lastName": "Smith",
              "phone": "",
              "professionalIdentityFields": [],
              "userCustomFields": [],
              "company": "",
              "delivery": {
                "download": false,
                "email": false,
                "provider": false
              },
              "address": null,
              "created": "2018-05-02T15:56:12Z",
              "name": "",
              "specialTypes": []
            }
          ],
          "name": "Signer2"
        }
      ],
      "description": "",
      "language": "en",
      "id": "-_MOT5yMI3Cx3S7OWaFGkrXzOw8=","data": {
        "senderVisible": false,
        "currentSignerProgress": {
          "documentsToConfirmCount": "0",
          "documentsConfirmedCount": "0",
          "approvalsToConfirmCount": "0",
          "approvalsConfirmedCount": "0",
          "documentsPartiallyCompletedCount": "0",
          "approvalsToSignNowCount": "0"
        },
        "overallProgress": {
          "documentsToCompleteCount": "3",
          "documentsCompletedCount": "1",
          "documentsToConfirmCount": "3",
          "documentsConfirmedCount": "1",
          "documentsPartiallyCompletedCount": "0"
        }
      },
      "autocomplete": true,
      "completed": null,
      "sender": {
        "status": "ACTIVE",
        "language": "en",
        "signature": {
          "handdrawn": "AQAAADJI+a4cnf0t3Dlf0GqWJceCA+4AAwADAN8BAAADAAAAggPuAOgAAAACfyxAUkAlQCdAOUA6QDtAHEAtQBtACkAJQBVAFBIyfkA0QBVABkAYQCpAHEAtQC9ALkAtQDxAO0A6QEhAN0AlQCQyTjZAgEBwQIBAoFDSUOFQ8lDiUNJQ0lCiQHBAUCIXGVBSUCVQN1BJUDpQXVA9UE5QLlAuUDpQOVAkm1BhQLZAd0B7QFpAXUBPQTBAHkAdQAtAB2AmYBRgQmCAcJVwmHC5Mh42QFBAkECAQKBAsEDAQNBQ8VDyUPJQ81DTULRQg1ByUEGeIgQ6QDhAJ0AmQCZAFItwbHBtMhdBUCafUGJQcVCSUJFQoUDAQKBAsECBQHNAdEBEQDRABkAFYCdgR2BXYHhgd2CIYIVgdmBDYEJAUUBwQIFAkECwQLBA0EDAQLBAoEBwQGASG0xAc0BnQEhASkArQBxADEAKQAlABkAFMkVKUENQUVBBUGFQYVCRUKJQsVDCUNJQsUDQQKBAkEBwQFJAREAlIllVUHFQUVByUKFQslDSUNJQ9VDlUPZQ1lDWUKVQZVBEUCQyCxivr2BjYGRgdGB1YHZgZmBWYEdgRkAFQClAREBjQJNAk0CzQKNAs0CjQJNAQo9gRWBjYJNgs2DCYNRg1GCkYKRgY2Bkrg==",
          "textual": null
        },
        "id": "ZQI8k6faVoM8",
        "data": {
          "serviceCredentials": "{}",
          "showIntro": false
        },
        "account": {
          "id": "3vD0Dc9Fh7wQ",
          "data": null,
          "created": "2016-05-05T19:30:13Z",
          "logoAltTextKey": "",
          "updated": "2016-05-05T19:30:13Z",
          "company": {
            "id": "jVWmyg4cyis8",
            "data": null,
            "address": {
              "address1": null,
              "address2": null,
              "city": null,
              "country": null,
              "zipcode": null,
              "state": null
            },
            "name": "eSignLive"
          },
          "customFields": [
            {
              "required": false,
              "id": "Department",
              "data": null,
              "translations": [
                {
                  "description": "GSA Division information",
                  "language": "en",
                  "id": "",
                  "data": null,
                  "name": "Department"
                }
              ],
              "value": "",
              "name": ""
            }
          ],
          "licenses": [
            {
              "status": "ACTIVE",
              "created": "2016-05-05T19:30:13Z",
              "paidUntil": "2020-05-05T00:00:00Z",
              "plan": {
                "group": "",
                "description": "E-Sign Hundreds of Documents with Unlimited Signers",
                "id": "sandbox",
                "data": null,
                "quotas": [
                  {
                    "cycle": null,
                    "scope": "ACCOUNT",
                    "limit": 100,
                    "target": "SENDER"
                  },
                  {
                    "cycle": null,
                    "scope": "SENDER",
                    "limit": 500,
                    "target": "DOCUMENT"
                  },
                  {
                    "cycle": null,
                    "scope": "SENDER",
                    "limit": 500,
                    "target": "STORAGE"
                  }
                ],
                "cycle": "YEAR",
                "contract": "YEAR",
                "freeCycles": null,
                "features": null,
                "original": null,
                "price": {
                  "amount": 0,
                  "currency": {
                    "id": "USD",
                    "data": null,
                    "name": "US Dollar"
                  }
                },
                "name": "Sandbox"
              },
              "transactions": []
            }
          ],
          "logoUrl": "",
          "providers": null,
          "owner": "ZQI8k6faVoM8",
          "name": "Haris Haidary"
        },
        "title": null,
        "updated": "2016-05-05T19:30:13Z",
        "external": null,
        "locked": null,
        "email": "mail44@example.com",
        "firstName": "Haris",
        "lastName": "Haidary",
        "memberships": [],
        "phone": "+1 201-555-5555",
        "professionalIdentityFields": [],
        "userCustomFields": [
          {
            "id": "policy_number_id",
            "data": null,
            "translations": [],
            "value": "",
            "name": ""
          }
        ],
        "activated": null,
        "company": "eSignLive",
        "type": "MANAGER",
        "address": {
          "address1": "",
          "address2": "",
          "city": "",
          "country": "",
          "zipcode": "",
          "state": ""
        },
        "created": "2016-05-05T19:30:13Z",
        "name": "",
        "specialTypes": [],
        "hasDelegates": false
      },
      "documents": [
        {
          "status": "",
          "description": "Must be accepted and agreed to before starting the signing process.",
          "id": "default-consent",
          "data": {
            "ese_document_texttag_extract_needed": "false"
          },
          "approvals": [
            {
              "id": "d1f0b072-14b0-4bd8-8f0a-fcb53c38a4d7",
              "role": "bf5ed1f3-54dc-4231-8548-e01878cda700",
              "data": null,
              "signed": "2018-05-02T15:57:20Z",
              "accepted": "2018-05-02T15:57:20Z",
              "fields": [],
              "name": ""
            },
            {
              "id": "0d48f338-942c-4373-8b62-e6f4ed3e400b",
              "role": "b85551ee-6788-4468-9943-947a24b53d1e",
              "data": null,
              "signed": "2018-05-02T16:05:01Z",
              "accepted": "2018-05-02T16:05:01Z",
              "fields": [],
              "name": ""
            }
          ],
          "pages": [
            {
              "id": "",
              "top": 0,
              "height": 1030,
              "width": 796,
              "left": 0,
              "version": 0,
              "index": 0
            },
            {
              "id": "",
              "top": 0,
              "height": 1030,
              "width": 796,
              "left": 0,
              "version": 0,
              "index": 1
            }
          ],
          "external": null,
          "extract": false,
          "signedHash": null,
          "extractionTypes": [],
          "tagged": false,
          "signerVerificationToken": null,
          "index": 0,
          "fields": [],
          "name": "Electronic Disclosures and Signatures Consent",
          "size": 0
        },
        {
          "status": "",
          "description": "",
          "id": "01ea8c42e0443900006fd1ca13dd813764de134e379f9187",
          "data": {
            "ese_document_texttag_autofielddateformat": "yyyy-MM-dd HH:mm:ss 'GMT'",
            "ese_document_texttag_json_0": "[]",
            "ese_document_texttag_extract_needed": "true",
            "ese_document_texttag_handled_roles": "[]"
          },
          "approvals": [
            {
              "id": "ufcu7BEkPhQ7",
              "role": "bf5ed1f3-54dc-4231-8548-e01878cda700",
              "data": null,
              "signed": null,
              "accepted": null,
              "fields": [
                {
                  "binding": null,
                  "validation": null,
                  "id": "NEUF14vd6uQP",
                  "page": 0,
                  "data": null,
                  "subtype": "FULLNAME",
                  "top": 220,
                  "height": 37,
                  "extractAnchor": null,
                  "extract": false,
                  "width": 165,
                  "left": 315,
                  "type": "SIGNATURE",
                  "value": "",
                  "name": ""
                }
              ],
              "name": ""
            },
            {
              "id": "m6X4vXnEnu0S",
              "role": "b85551ee-6788-4468-9943-947a24b53d1e",
              "data": null,
              "signed": null,
              "accepted": null,
              "fields": [
                {
                  "binding": null,
                  "validation": null,
                  "id": "R8NmG0RgXGIU",
                  "page": 0,
                  "data": null,
                  "subtype": "FULLNAME",
                  "top": 267,
                  "height": 37,
                  "extractAnchor": null,
                  "extract": false,
                  "width": 165,
                  "left": 315,
                  "type": "SIGNATURE",
                  "value": "",
                  "name": ""
                }
              ],
              "name": ""
            }
          ],
          "pages": [
            {
              "id": "",
              "top": 0,
              "height": 1030,
              "width": 796,
              "left": 0,
              "version": 0,
              "index": 0
            }
          ],
          "external": null,
          "extract": true,
          "signedHash": null,
          "extractionTypes": [
            "TEXT_TAGS",
            "ACROFIELDS"
          ],
          "tagged": false,
          "signerVerificationToken": null,
          "index": 1,
          "fields": [],
          "name": "doc1",
          "size": 80054
        },
        {
          "status": "",
          "description": "",
          "id": "9fed8a66f25b2539bea003066148b56fccd67c7cd72c874a",
          "data": {
            "ese_document_texttag_autofielddateformat": "yyyy-MM-dd HH:mm:ss 'GMT'",
            "ese_document_texttag_json_0": "[]",
            "ese_document_texttag_extract_needed": "true",
            "ese_document_texttag_handled_roles": "[]"
          },
          "approvals": [
            {
              "id": "2e75dPZB1X0X",
              "role": "b85551ee-6788-4468-9943-947a24b53d1e",
              "data": null,
              "signed": null,
              "accepted": null,
              "fields": [
                {
                  "binding": null,
                  "validation": null,
                  "id": "Yy9LGdjHwLEE",
                  "page": 0,
                  "data": null,
                  "subtype": "FULLNAME",
                  "top": 691,
                  "height": 37,
                  "extractAnchor": null,
                  "extract": false,
                  "width": 165,
                  "left": 315,
                  "type": "SIGNATURE",
                  "value": "",
                  "name": ""
                }
              ],
              "name": ""
            },
            {
              "id": "kj8n0eK5KV8T",
              "role": "bf5ed1f3-54dc-4231-8548-e01878cda700",
              "data": null,
              "signed": null,
              "accepted": null,
              "fields": [
                {
                  "binding": null,
                  "validation": null,
                  "id": "7gY6IBFunFQI",
                  "page": 0,
                  "data": null,
                  "subtype": "FULLNAME",
                  "top": 737,
                  "height": 37,
                  "extractAnchor": null,
                  "extract": false,
                  "width": 165,
                  "left": 315,
                  "type": "SIGNATURE",
                  "value": "",
                  "name": ""
                }
              ],
              "name": ""
            }
          ],
          "pages": [
            {
              "id": "",
              "top": 0,
              "height": 1030,
              "width": 796,
              "left": 0,
              "version": 0,
              "index": 0
            }
          ],
          "external": null,
          "extract": true,
          "signedHash": null,
          "extractionTypes": [
            "TEXT_TAGS",
            "ACROFIELDS"
          ],
          "tagged": false,
          "signerVerificationToken": null,
          "index": 2,
          "fields": [],
          "name": "cleaning_contract",
          "size": 190472
        }
      ],
      "consent": "default-consent",
      "due": null,
      "emailMessage": "",
      "limits": null,
      "notarized": false,
      "notaryRoleId": null,
      "settings": {
        "ceremony": {
          "layout": {
            "header": {
              "breadcrumbs": true,
              "feedback": true,
              "globalActions": {
                "confirm": true,
                "download": true,
                "hideEvidenceSummary": true,
                "saveAsLayout": true
              },
              "globalNavigation": true,
              "sessionBar": true,
              "titleBar": null
            },
            "brandingBar": {
              "logo": {
                "link": "",
                "logoAltTextKey": "",
                "src": "branding"
              }
            },
            "footer": null,
            "iframe": false,
            "navigator": true
          },
          "extractTextTags": true,
          "extractAcroFields": true,
          "ada": false,
          "events": {
            "complete": {
              "redirect": "https://google.ca",
              "dialog": true
            }
          },
          "enforceCaptureSignature": false,
          "inPerson": false,
          "declineButton": true,
          "declineReasons": [],
          "disableDeclineOther": false,
          "disableDownloadForUncompletedPackage": false,
          "disableFirstInPersonAffidavit": false,
          "disableInPersonAffidavit": false,
          "disableOptOutOther": false,
          "disableSecondInPersonAffidavit": false,
          "documentToolbarOptions": null,
          "handOver": null,
          "hideCaptureText": false,
          "hideLanguageDropdown": false,
          "hidePackageOwnerInPerson": false,
          "hideWatermark": false,
          "maxAuthFailsAllowed": 3,
          "optOutButton": true,
          "optOutReasons": [],
          "style": null
        }
      },
      "signedDocumentDelivery": null,
      "trashed": false,
      "updated": "2018-05-04T19:13:21Z",
      "visibility": "ACCOUNT",
      "type": "PACKAGE",
      "created": "2018-05-02T15:55:42Z",
      "messages": [
        {
          "status": "NEW",
          "from": {
            "group": null,
            "language": "en",
            "signature": null,
            "id": "a8e907ec-9472-4cb9-812a-efe5af88ed1b",
            "data": null,
            "title": "",
            "auth": {
              "scheme": "NONE",
              "challenges": []
            },
            "updated": "2018-05-02T15:56:02Z",
            "external": null,
            "knowledgeBasedAuthentication": null,
            "email": "mai33@example.com",
            "firstName": "john",
            "lastName": "smith",
            "phone": "",
            "professionalIdentityFields": [],
            "userCustomFields": [],
            "company": "",
            "delivery": {
              "download": false,
              "email": false,
              "provider": false
            },
            "address": null,
            "created": "2018-05-02T15:56:03Z",
            "name": "",
            "specialTypes": []
          },
          "content": "I do not wish to sign electronically.",
          "created": "2018-05-04T19:13:22Z",
          "to": [],
          "documents": []
        }
      ],
      "name": "test",
      "bulkSendable": false
    }
    JSON

    Résultats

    Voici un exemple de ce que vous pouvez vous attendre à voir une fois que vous avez exécuté votre code.

    APEX SDK

    Pour télécharger l’exemple de code complet, consultez notre site Code Share .

    Si un signataire refuse de signer ses documents, il sera invité à saisir une raison pour le faire. De telles raisons peuvent être récupérées. La rubrique suivante décrit comment procéder.

    Pour récupérer les raisons de refus, vous devez d’abord créer un objet PackageID pour votre transaction. Une fois que vous avez votre objet PackageID , vous ferez appel à votre client OneSpan Sign pour récupérer ces raisons, en utilisant l’objet PackageID comme paramètre. Pour ce faire, le code suivant :

    ESignLiveSDK sdk = new ESignLiveSDK();
    ESignLiveAPIObjects.Package_x pkg = sdk.getPackage(packageId);
    if(pkg.messages == null || pkg.messages.size() == 0){
            throw new ESignLiveRESTAPIHelper.ESignLiveRestAPIHelperException('Error retrieve Optout And Declined Messages');
    }
    ESignLiveAPIObjects.Message message = pkg.messages.get(0);
    System.Debug(pkg.status.name() + ' reason: ' + message.content);
    Plain text

    Résultats

    Voici un exemple de ce que vous pouvez vous attendre à voir une fois que vous avez exécuté votre code.


    Cet article vous a-t-il été utile ?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.
    ESC

    Ozzy, facilitant la découverte de connaissances grâce à l’intelligence conversationnelle