Docusign integration error
The request contained at least one invalid parameter. 'recipients' may not be specifed when 'templateId' is set. Use 'templateRoles'.
I'm getting this as REST post response in docusign response.
Posted: 2 years ago
Accepted Solution
Posted: 2 years ago
It's fixed needed to remove templateID
Posted: 1 year ago
Just to give little more context, when you are using templates the roles are defined along with templates.
When are using a document and passing it from Pega, you can provide the recipients in the create envelope request.
In general, if you pass the document to createenvelope, you cannot use template.
here is the request which am sending :-
/***********************/
{
"templateId": "15561217-3fb2-415a-8a8a-e0321216407b",
"status": "sent",
"emailSubject": "Email Subject..",
"templateRoles": [
{
"email": "xxu@ss.com",
"roleName": "Employee",
"name": "Trip"
}
],
"emailBlurb": "Email Body..",
"notification": {
"reminders": {
"reminderDelay": "1",
"reminderEnabled": "true",
"reminderFrequency": "1"
},
"expirations": {
"expireEnabled": "true",
"expireWarn": "1",
"expireAfter": "2"
}
},
"eventNotification": {
"requireAcknowledgement": "true",
"url": "http://localhost:8080/prweb/PRRestService/DocuSignService/Services/pyCo…",
"envelopeEvents": [
{
"envelopeEventStatusCode": "completed",
"includeDocuments": "true"
}
],
"includeTimeZone": "true",
"loggingEnabled": "true",
"recipientEvents": [
{
"recipientEventStatusCode": "Delivered",
"includeDocuments": "true"
}
],
"includeCertificateOfCompletion": "true",
"includeDocuments": "true"
},
"documents": [
{
"documentId": "1",
"name": "Trip.pdf",
"fileExtension": "pdf",
"documentBase64": "JVBERi0xLjMNJeLjz9MNCjcgMCBvYmoNPDwvTGluZWFyaXplZCAxL0wgNzk0NS9PIDkvRSAzNTI0L04gMS9UIDc2NTYvSCBbIDQ1MSAxMzddPj4NZW5kb2JqDSAgICAgICAgICAgICAgICAgICAgICAgDQoxMyAwIG9iag08PC9EZWNvZGVQYXJtczw8L0NvbHVtbnMgNC9QcmVkaWN0b3IgMTI+Pi9GaWx0ZXIvRmxhdGVEZWNvZGUvSURbPDREQzkxQTE4NzVBNkQ3MDdBRUMyM"
}
],
"customFields": {
"textCustomFields": [
{
"value": "LSA-FW-MISSIONFW-WORK M-472",
"name": "WorkObjectHandle",
"show": "false",
"required": "true"
}
]
},
"recipients": {
"carbonCopies": [
{
"email": "xxu@ss.com",
"routingOrder": "1",
"name": "KLKL slss",
"recipientId": "cf5f8273-560f-4df3-a71b-041d8ab41232"
}
],
"signers": [
{
"email": "xxu@ss.com",
"deliveryMethod": "Email",
"smsAuthentication": {
"senderProvidedNumbers": [
"",
""
]
},
"routingOrder": "1",
"name": "KLKL slss",
"requireIdLookup": "false",
"tabs": {
"checkboxTabs": [
{
"documentId": "DOCUMENT_ID_TO_MAP_THIS_TAB_TO",
"shared": "ENABLE_FIELD_MARKUP(TRUE/FALSE)",
"yPosition": "VERTICAL_OFFSET_OF_THE_TAB_ON_THE_PAGE",
"name": "TOOL_TIP_OF_THE_TAB",
"tabLabel": "LABEL_USED_FOR_THE_TAB",
"recipientId": "cf5f8273-560f-4df3-a71b-041d8ab41232",
"selected": "SELECT_THE_CHECKBOX(TRUE/FALSE)",
"pageNumber": "PAGE_NUMBER_ON_DOCUMENT",
"xPosition": "HORIZONTAL_OFFSET_OF_THE_TAB_ON_THE_PAGE"
}
],
"textTabs": [
{
"documentId": "DOCUMENT_ID_TO_MAP_THIS_TAB_TO",
"width": "200",
"height": "200",
"yPosition": "VERTICAL_OFFSET_OF_THE_TAB_ON_THE_PAGE",
"value": "VALUE_OF_THE_TAB",
"name": "TOOL_TIP_OF_THE_TAB",
"tabLabel": "LABEL_USED_FOR_THE_TAB",
"recipientId": "cf5f8273-560f-4df3-a71b-041d8ab41232",
"pageNumber": "PAGE_NUMBER_ON_DOCUMENT",
"xPosition": "HORIZONTAL_OFFSET_OF_THE_TAB_ON_THE_PAGE"
}
],
"emailTabs": [
{
"documentId": "DOCUMENT_ID_TO_MAP_THIS_TAB_TO",
"width": "200",
"height": "200",
"yPosition": "VERTICAL_OFFSET_OF_THE_TAB_ON_THE_PAGE",
"name": "TOOL_TIP_OF_THE_TAB",
"tabLabel": "LABEL_USED_FOR_THE_TAB",
"recipientId": "cf5f8273-560f-4df3-a71b-041d8ab41232",
"pageNumber": "PAGE_NUMBER_ON_DOCUMENT",
"xPosition": "HORIZONTAL_OFFSET_OF_THE_TAB_ON_THE_PAGE"
}
],
"dateSignedTabs": [
{
"anchorString": "SEARCH_STRING(e.g., 'Signature')",
"anchorYOffset": "TAB_POSITION_AS_Y_OFFSET (e.g.,1)",
"anchorUnits": "OFFSET_UNITS (e.g., 'inches')",
"anchorXOffset": "TAB_POSITION_AS_X_OFFSET (e.g.,1)",
"anchorIgnoreIfNotPresent": "IGONRE_TAB_IF_ANCHOR_NOT_PRESENT(true/false)"
}
],
"noteTabs": [
{
"documentId": "DOCUMENT_ID_TO_MAP_THIS_TAB_TO",
"width": "200",
"height": "200",
"yPosition": "VERTICAL_OFFSET_OF_THE_TAB_ON_THE_PAGE",
"value": "VALUE_OF_THE_TAB",
"name": "TOOL_TIP_OF_THE_TAB",
"tabLabel": "LABEL_USED_FOR_THE_TAB",
"recipientId": "cf5f8273-560f-4df3-a71b-041d8ab41232",
"pageNumber": "1",
"xPosition": "HORIZONTAL_OFFSET_OF_THE_TAB_ON_THE_PAGE"
}
],
"signHereTabs": [
{
"anchorString": "SEARCH_STRING(e.g., 'Signature')",
"anchorYOffset": "TAB_POSITION_AS_Y_OFFSET (e.g.,1)",
"anchorUnits": "OFFSET_UNITS (e.g., 'inches')",
"anchorXOffset": "TAB_POSITION_AS_X_OFFSET (e.g.,1)",
"anchorIgnoreIfNotPresent": "IGONRE_TAB_IF_ANCHOR_NOT_PRESENT(true/false)"
}
],
"initialHereTabs": [
{
"anchorString": "SEARCH_STRING(e.g., 'Signature')",
"anchorYOffset": "TAB_POSITION_AS_Y_OFFSET (e.g.,1)",
"anchorUnits": "OFFSET_UNITS (e.g., 'inches')",
"anchorXOffset": "TAB_POSITION_AS_X_OFFSET (e.g.,1)",
"anchorIgnoreIfNotPresent": "IGONRE_TAB_IF_ANCHOR_NOT_PRESENT(true/false)"
}
]
},
"recipientId": "cf5f8273-560f-4df3-a71b-041d8ab41232",
"idCheckConfigurationName": "SMS"
}
]
}
}
/*********************/