NodeJs0Common API Tasks🐈: Require your signers to provide a reason when they decline to sign

[ad_1]

Welcome to an splendid new edition of the CAT (Common API Tasks) blog series. The CAT blogs provide all you need to complete small, specific, SDK-supported tasks using one of our APIs. You can find all articles in this series on the DocuSign Developer Blog.

In today’s edition I’m going to discuss what happens when your signers decline to sign an envelope that was sent to them. By default, a signer can choose Decline to Sign from the top-right menu, and if they do so, the envelope gets voided without the signer giving any reason.

It may be beneficial to require that your signers (or your customers’ signers) have to provide a reason before they can get the envelope voided when they decline to sign it (similarly to how the sender is required to do so if they wish to void an envelope).

This can be done account-wide for all envelopes that were sent from the account by going to the Signing Settings section of the web admin tool and checking “Require a reason when a recipient declines to sign” and updating the settings for the account.

Once this is done, the signer will only be able to to decline (and thus void the envelope) after providing a reason in the following dialog:

Of course, like everything else in this blog series, we show you how to do things programmatically, using the DocuSign APIs and the DocuSign SDKs.

The following code snippets update the account’s settings (For the account that was used to authenticate to DocuSign for the purpose of making API calls) and change it to require signers to provide a reason when they decline. Note that this code can only be run if you authenticate as a user with admin privileges.

C#

Java

Node.js

PHP

Python

Ruby

That’s all, folks! I hope you found it useful. If you have any questions, comments, or suggestions for topics for future Common API Tasks posts, feel free to email me. Until next time…

Additional resources

Disclaimer

DocuSign Inc. published this content on 23 January 2023 and is solely responsible for the information contained therein. Distributed by Public, unedited and unaltered, on 24 January 2023 17:01:54 UTC.

[ad_2]

Source link

Leave a Reply

Your email address will not be published. Required fields are marked *

previous
4 ways Windows people get MacOS wrong
next
VMware : GemFire 10 Beta to Launch with Major Updates and a Brand-new Interface

[bt_bb_section layout=”boxed_1200″ lazy_load=”yes” show_video_on_mobile=”” allow_content_outside=”no”][bt_bb_row][bt_bb_column order=”0″ lazy_load=”yes” width=”1/1″ width_lg=”1/1″ width_md=”1/1″ width_sm=”1/1″ width_xs=”1/1″][bt_bb_separator top_spacing=”medium,;,,;,,;,,;,” bottom_spacing=”,;,,;,,;,,;,” text=”” border_style=”none” border_color=”none” border_width=”” opacity=”” responsive=”” publish_datetime=”” expiry_datetime=”” animation=”no_animation” el_id=”” el_class=”” el_style=””][/bt_bb_separator][/bt_bb_column][/bt_bb_row][bt_bb_row][bt_bb_column lazy_load=”yes” width=”1/5″ align=”left” vertical_align=”top” animation=”fade_in” background_image=”” inner_background_image=”” color_scheme=”” background_color=”” inner_background_color=”” opacity=”” responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=”” padding=”normal” shape=”” inner_color_scheme=”” width_lg=”1/5″ width_md=”1/1″ width_sm=”1/1″ width_xs=”1/1″][bt_bb_text responsive=”” publish_datetime=”” expiry_datetime=”” animation=”no_animation” el_id=”” el_class=”footer_f_logo” el_style=””]

[/bt_bb_text][bt_bb_separator top_spacing=”” bottom_spacing=”small” text=”” border_style=”none” border_color=”none” border_width=”” opacity=”” responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=””][/bt_bb_separator][bt_bb_icon icon=”fontawesome_f0e0″ text=”info@xnetics.com” size=”xsmall,;,,;,,;,,;,” text_color=”” url=”#” url_title=”” target=”_self” align=”inherit,;,,;,,;,,;,” color_scheme=”” style=”borderless” shape=”circle” responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=”” position=”” animation=”no_animation” weight=””][/bt_bb_icon][bt_bb_separator top_spacing=”” bottom_spacing=”small” text=”” border_style=”none” border_color=”none” border_width=”” opacity=”” responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=””][/bt_bb_separator][bt_bb_icon icon=”fontawesome_f041″ text=”USA” size=”xsmall,;,,;,,;,,;,,;,” text_color=”” url=”#” url_title=”” target=”_self” align=”inherit,;,,;,,;,,;,,;,” color_scheme=”” style=”borderless” shape=”circle” responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=”” position=”” animation=”no_animation” weight=”” bb_version=”4.5.4″][/bt_bb_icon][bt_bb_separator top_spacing=”medium,;,,;,,;,,;,” bottom_spacing=”,;,,;,,;,,;,” text=”” border_style=”none” border_color=”none” border_width=”” opacity=”” responsive=”” publish_datetime=”” expiry_datetime=”” animation=”no_animation” el_id=”” el_class=”” el_style=””][/bt_bb_separator][bt_bb_row_inner column_gap=”0″ row_width=”default” responsive=”” publish_datetime=”” expiry_datetime=”” animation=”no_animation” el_id=”” el_class=”” el_style=””][bt_bb_column_inner width=”1/1″ width_lg=”1/1″ width_md=”1/1″ width_sm=”1/1″ width_xs=”1/1″ order=”0,;,,;,,;,,;,” lazy_load=”yes” align=”left,;,,;,,;,,;,” vertical_align=”top” background_image=”” inner_background_image=”” color_scheme=”” inner_color_scheme=”” background_color=”” inner_background_color=”” opacity=”” responsive=”” publish_datetime=”” expiry_datetime=”” animation=”no_animation” el_id=”” el_class=”” el_style=”” padding=”0,;,,;,,;,,;,” shape=””][bt_bb_icon size=”small,;,,;,,;,,;,” icon=”fontawesome_f082″ text=”” url=”https://www.facebook.com/xnetics” url_title=”Facebook” target=”_self” align=”left,;,,;,,;,,;,” color_scheme=”” style=”borderless” shape=”circle” responsive=”” publish_datetime=”” expiry_datetime=”” animation=”no_animation” el_id=”” el_class=”” el_style=”” text_color=”” weight=”” position=””][/bt_bb_icon][bt_bb_icon size=”small,;,,;,,;,,;,” icon=”fontawesome_f16d” text=”” url=”https://www.instagram.com/xnetics/” url_title=”instagram” target=”_self” align=”left,;,,;,,;,,;,” color_scheme=”” style=”borderless” shape=”circle” responsive=”” publish_datetime=”” expiry_datetime=”” animation=”no_animation” el_id=”” el_class=”” el_style=”” text_color=”” weight=”” position=””][/bt_bb_icon][bt_bb_icon size=”small,;,,;,,;,,;,” icon=”fontawesome_f08c” text=”” url=”https://www.linkedin.com/company/x-netics/” url_title=”” target=”_self” align=”inherit,;,,;,,;,,;,” color_scheme=”” style=”borderless” shape=”circle” responsive=”” publish_datetime=”” expiry_datetime=”” animation=”no_animation” el_id=”” el_class=”” el_style=”” text_color=”” weight=”” position=””][/bt_bb_icon][bt_bb_icon size=”small,;,,;,,;,,;,” icon=”fontawesome_f081″ text=”” url=”https://twitter.com/xnetics” url_title=”” target=”_self” align=”inherit,;,,;,,;,,;,” color_scheme=”” style=”borderless” shape=”circle” responsive=”” publish_datetime=”” expiry_datetime=”” animation=”no_animation” el_id=”” el_class=”” el_style=”” text_color=”” weight=”” position=””][/bt_bb_icon][bt_bb_icon size=”small,;,,;,,;,,;,” icon=”fontawesome_f0d3″ text=”” url=”https://in.pinterest.com/xneticsconsulting/” url_title=”” target=”_self” align=”inherit,;,,;,,;,,;,” color_scheme=”” style=”borderless” shape=”circle” responsive=”” publish_datetime=”” expiry_datetime=”” animation=”no_animation” el_id=”” el_class=”” el_style=”” text_color=”” weight=”” position=””][/bt_bb_icon][/bt_bb_column_inner][/bt_bb_row_inner][bt_bb_separator top_spacing=”,;,,;,,;,,;,” bottom_spacing=”medium,;,,;,,;,,;,” text=”” border_style=”none” border_color=”none” border_width=”” opacity=”” responsive=”” publish_datetime=”” expiry_datetime=”” animation=”no_animation” el_id=”” el_class=”” el_style=””][/bt_bb_separator][/bt_bb_column][bt_bb_column width=”1/5″ align=”left” vertical_align=”top” animation=”fade_in” background_image=”” inner_background_image=”” lazy_load=”no” color_scheme=”” background_color=”” inner_background_color=”” opacity=”” responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=”” padding=”normal” shape=”” inner_color_scheme=”” width_lg=”1/5″ width_md=”1/1″ width_sm=”1/1″ width_xs=”1/1″][bt_bb_headline font_subset=”latin,latin-ext” superheadline=”” headline=”Services” subheadline=”” html_tag=”h4″ size=”extrasmall” align=”inherit” dash=”none” color_scheme=”” color=”” supertitle_position=”” font=”inherit” font_size=”” url=”” target=”_self” responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=”” font_weight=”” supertitle_font_weight=”” subtitle_font_weight=”” supertitle_style=”” letter_spacing=””][/bt_bb_headline][bt_bb_separator top_spacing=”” bottom_spacing=”25″ text=”” border_style=”none” border_color=”none” border_width=”” opacity=”” responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=””][/bt_bb_separator][bt_bb_custom_menu direction=”vertical” menu=”39″ responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=”” weight=””][/bt_bb_custom_menu][/bt_bb_column][bt_bb_column width=”1/5″ align=”left” vertical_align=”top” animation=”fade_in” background_image=”” inner_background_image=”” lazy_load=”no” color_scheme=”” background_color=”” inner_background_color=”” opacity=”” responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=”” padding=”normal” shape=”” inner_color_scheme=”” width_lg=”1/5″ width_md=”1/1″ width_sm=”1/1″ width_xs=”1/1″][bt_bb_headline font_subset=”latin,latin-ext” superheadline=”” headline=”Hire Dedicated Developers” subheadline=”” html_tag=”h3″ size=”extrasmall,;,,;,,;,,;,” align=”inherit,;,,;,,;,,;,” dash=”none” color_scheme=”” color=”” supertitle_position=”” font=”inherit” font_size=”” url=”” target=”_self” responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=”” font_weight=”” supertitle_font_weight=”” subtitle_font_weight=”” supertitle_style=”” letter_spacing=”” subtitle_style=”” supertitle_letter_spacing=”” subtitle_letter_spacing=”” animation=”no_animation”][/bt_bb_headline][bt_bb_separator top_spacing=”” bottom_spacing=”25″ text=”” border_style=”none” border_color=”none” border_width=”” opacity=”” responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=””][/bt_bb_separator][bt_bb_custom_menu direction=”vertical” menu=”dev1″ responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=”” weight=”” animation=”no_animation”][/bt_bb_custom_menu][/bt_bb_column][bt_bb_column width=”1/5″ align=”left” vertical_align=”top” animation=”fade_in” background_image=”” inner_background_image=”” lazy_load=”no” color_scheme=”” background_color=”” inner_background_color=”” opacity=”” responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=”” padding=”normal” shape=”” inner_color_scheme=”” width_lg=”1/5″ width_md=”1/1″ width_sm=”1/1″ width_xs=”1/1″][bt_bb_separator top_spacing=”normal,;,,;,,;,,;,” bottom_spacing=”25,;,,;,,;,,;,” text=”” border_style=”none” border_color=”none” border_width=”” opacity=”” responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=”” animation=”no_animation”][/bt_bb_separator][bt_bb_custom_menu direction=”vertical” menu=”dev2″ responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=”” weight=”” animation=”no_animation”][/bt_bb_custom_menu][/bt_bb_column][bt_bb_column width=”1/5″ align=”left” vertical_align=”top” animation=”fade_in” background_image=”” inner_background_image=”” lazy_load=”no” color_scheme=”” background_color=”” inner_background_color=”” opacity=”” responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=”” padding=”normal” shape=”” inner_color_scheme=”” width_lg=”1/5″ width_md=”1/1″ width_sm=”1/1″ width_xs=”1/1″][bt_bb_separator top_spacing=”normal,;,,;,,;,,;,” bottom_spacing=”25,;,,;,,;,,;,” text=”” border_style=”none” border_color=”none” border_width=”” opacity=”” responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=”” animation=”no_animation”][/bt_bb_separator][bt_bb_custom_menu direction=”vertical” menu=”dev3″ responsive=”” publish_datetime=”” expiry_datetime=”” el_id=”” el_class=”” el_style=”” weight=”” animation=”no_animation”][/bt_bb_custom_menu][/bt_bb_column][/bt_bb_row][/bt_bb_section]