Ошибка NOTARY_HOSTED_SIGNER_ID_REQUIRED при попытке отправить конверт eNotary

Question

Пусть мой конверт будет таким, как показано ниже:

{
    "allowReassign": "false",
    "documents": [
        {
            "documentBase64": "JVBE",
            "documentId": "1",
            "fileExtension": "PDF",
            "name": "DocumentToNotarize"
        }
    ],
    "emailSubject": "Notary Test",
    "enableWetSign": "false",
    "notification": {
        "expirations": {
            "expireAfter": "4",
            "expireEnabled": "True"
        }
    },
    "recipients": {
        "inPersonSigners": [
            {
                "email": "[e-mail]",
                "inPersonSigningType": "notary",
                "name": "Signer",
                "notaryHost": {
                    "deliveryMethod": "email",
                    "email": "[e-mail]",
                    "name": "Notary",
                    "recipientId": "995a0019-f0bc-47bf-94d5-426607388f7b",
                    "tabs": {
                        "notarizeTabs": [
                            {
                                "documentId": "1",
                                "pageNumber": "1",
                                "xPosition": "100",
                                "yPosition": "100"
                            }
                        ]
                    }
                },
                "recipientId": "3fa6ffaf-f87e-4f27-9129-6d12d987f59b",
                "tabs": {
                    "signHereTabs": [
                        {
                            "documentId": "1",
                            "pageNumber": "1",
                            "recipientId": "3fa6ffaf-f87e-4f27-9129-6d12d987f59b",
                            "scaleValue": "0.6",
                            "xPosition": "45",
                            "yPosition": "527"
                        }
                    ]
                }
            }
        ]
    },
    "status": "sent"
}

Что вызывает следующую ошибку:

{
    "errorCode": "NOTARY_HOSTED_SIGNER_ID_REQUIRED",
    "message": "The host signer Id is required to associate with notary in person signer."
}

К моему удивлению, я обнаружил, что если я изменю только значение recipientId подписывающей стороны на целое число, как показано ниже, это сработает!? Я что-то упускаю? GUID разрешены, правда?

 "recipientId": "3",
        "tabs": {
          "signHereTabs": [
            {
              "documentId": "2",
              "pageNumber": "1",
              "recipientId": "3",
              "scaleValue": "0.6",
              "xPosition": "45",
              "yPosition": "527"
            }
          ]
        }
      }

Answer 1

К моему удивлению, я обнаружил, что если я изменю только значение recipientId подписывающей стороны на целое число, как показано ниже, это сработает!? Я что-то упускаю? GUID разрешены, верно?

Если это работает, когда вы используете целое число, я рекомендую вам использовать целое число.

Если вы хотите сохранить гид с получателем в качестве метаданных, которые позже можно будет извлечь из конверта, используйте customFields атрибут signer объект.

Answer 2

Для большинства вызовов API нет проблем с установкой GUID для recipientId, потому что большинство типов получателей не зависят от другого получателя.

Проблема с нотариусом заключается в том, что нотариус и подписывающий получатель связаны с recipientId, а логика API предназначена для синтаксического анализа recipientId как Int, что, вероятно, вызвало проблему. Вы также столкнетесь с той же проблемой при использовании личной подписи, поскольку это очень похожий процесс, когда хост и лицо, подписывающее лично, являются одним получателем.