DOCAPOSTESEND Workflow Application

Overview

The DOCAPOSTESEND workflow application lets you send one or more documents to Docaposte for electronic signature.

How it works

• The DOCAPOSTESEND application creates a single envelope and sends it to one or more signers.

• You can specify one or more files per DOCAPOSTESEND action. To do this, use the FILEx parameter, where x is the file number (e.g.: FILE1). At least one file is required.

• You can specify one or more signers. To do this, use the combination of SIGNER_FIRSTNAME_LIST, SIGNER_LASTNAME_LIST, and SIGNER_EMAIL_LIST. You can also use SIGNER_FIRSTNAMEx, SIGNER_LASTNAMEx, and SIGNER_EMAILx, where x is the number of the signer.

• You can specify one type of signature per recipient. To do this, depending on the method you use to specify signers (with or without _LIST), you can use SIGNATURE_TYPE_LIST or SIGNATURE_TYPEx, where x is the signer number. Possible values: OTP (default), PAD, TOKEN, CONSENT_PROOF or IDENTITY.

• Application logs are available. These can be specified by setting the value of the DocaposteSendLogLevel parameter in the web.config file to 0 to disable logging, 1 for error logs, 2 for information logs, or 3 for debug logs; The default value is 0.

Required parameters

You can use one of the following two configurations: with a list of signers or with signer numbers.

With a list of signers

Parameter	Type	Direction	Description
SIGNER_FIRSTNAME_LIST	TEXT	IN	First names of signers, separated by the value defined in the DATA_SEPARATOR parameter
SIGNER_LASTNAME_LIST	TEXT	IN	Last names of signers, separated by the value defined in the DATA_SEPARATOR parameter
SIGNER_EMAIL_LIST	TEXT	IN	Email addresses of the signers, separated by the value defined in the DATA_SEPARATOR parameter
FILEx	FILE	IN	File(s) to send, where x is the file number; you can add one or more files

With signer numbers

Parameter	Type	Direction	Description
SIGNER_FIRSTNAMEx	TEXT	IN	First name(s) of the signer(s), where x corresponds to the signer number; you can add one or more signers
SIGNER_LASTNAMEx	TEXT	IN	Last name(s) of the signer(s), where x corresponds to the signer number; you can add one or more signers
SIGNER_EMAILx	TEXT	IN	Email address(es) of the signer(s), where x is the signer's number; you can add one or more signers
FILEx	FILE	IN	File(s) to send, where x is the file number; you can add one or more files

Optional parameters

Docaposte configuration

Parameters	Type	Direction	Description
DOCAPOSTE_USERNAME	TEXT	IN	Docaposte username By default, this value comes from the DocaposteUsername parameter in the web.config file.
DOCAPOSTE_PASSWORD	TEXT	IN	Docaposte password By default, this value comes from the DocapostePassword parameter in the web.config file.
DOCAPOSTE_HOST_SERVER	TEXT	IN	Docaposte host server By default, this value comes from the DocaposteHostServer parameter in the web.config file.
DOCAPOSTE_OFFER_CODE	TEXT	IN	Docaposte offer code By default, this value comes from the DocaposteOfferCode parameter in the web.config file.
DOCAPOSTE_ORGANIZATIONAL_UNIT_CODE	TEXT	IN	Docaposte organizational unit code By default, this value comes from the DocaposteOrganizationalUnitCode parameter in the web.config file.

General

Parameters	Type	Direction	Description
DATA_SEPARATOR	TEXT	IN	Separator used to separate the contents of SIGNERS_FIRSTNAME_LIST,SIGNERS_LASTNAME_LIST, SIGNERS_EMAIL_LIST, and SIGNER_TYPE_LIST Default : , (comma)
SIGNER_TYPE_LIST	TEXT	IN	Signature type of signers, separated by the value defined in the DATA_SEPARATOR parameter Possible values: OTP(default) PAD TOKEN CONSENT_PROOF IDENTITY
SIGNER_TYPEX	TEXT	IN	Signature type of signer(s), where x corresponds to the signer number; you can add one or more signers Possible values: OTP(default) PAD TOKEN CONSENT_PROOF IDENTITY
CUSTOM_REFERENCE	TEXT	IN	Provider reference The content of this parameter can allow the provider to identify the transaction on its end with; for example, a value specific to its business domain (e.g. customer file number). Default:WorkflowGen
TEST_MODE	TEXT	IN	Indicates whether the transaction is a TEST transaction (Y or N) Default: N
EMAIL_SUBJECT	TEXT	IN	Subject of the email that will be sent to signers Default: Please sign the document sent from WorkflowGen
EMAIL_FROM	TEXT	IN	Domain name of the email address that will be used to send the email to signers Default : do-not-reply
EMAIL_BODY	FILE	IN	Content of the email to send to signers (see the Customizing the body of the email section)

Return parameters

Parameter	Type	Direction	Description
DOCAPOSTE_TRANSACTION_ID`	TEXT	OUT	Contains the Docaposte transaction ID; you can use this ID in the DOCAPOSTCHECK workflow application
DOCAPOSTE_DOCUMENT_NAMES	TEXT	OUT	Contains the names of the documents sent to Docaposte; you can use these values in the DOCAPOSTECHECK workflow application

Customizing the body of the email

You can customize the content of the body of the email to be sent to the signer. The template must contain the <DOCAPOSTE_SIGN_URL> tag, which will be replaced by the link allowing the signer to add their signature.

Default value:

<!DOCTYPE html>
<html lang=""en"" xmlns=""http://www.w3.org/1999/xhtml"">
<head>
    <meta charset=""utf-8"" />
</head>
<body>
    <p>Hello {firstname} {lastname},</p>
    <p>
        Please sign the document sent from WorkflowGen.
        <br />
        <a href=""<DOCAPOSTE_SIGN_URL>"">Click here to sign on Docaposte</a>
    </p>
    <p>Regards,</p>
    <p>WorkflowGen</p>
</body>
</html>

Examples

With a list of signers

Parameter	Type	Direction	Value
SIGNER_FIRSTNAME_LIST	TEXT	IN	John,Bernard
SIGNER_LASTNAME_LIST	TEXT	IN	Smith,Martin
SIGNER_EMAIL_LIST	TEXT	IN	[e-mail],[e-mail]
SIGNER_TYPE_LIST	TEXT	IN	PAD,OTP
FILE1	FILE	IN	contract.pdf
DOCAPOSTE_TRANSACTION_ID	TEXT	OUT	xxxxx-xxxxx-xxxxx-xxxxx
DOCAPOSTE_DOCUMENT_NAMES	TEXT	OUT	contract.pdf

With signer numbers

Parameter	Type	Direction	Value
SIGNER_LASTNAME1	TEXT	IN	Smith
SIGNER_LASTNAME2	TEXT	IN	Martin
SIGNER_FIRSTNAME1	TEXT	IN	John
SIGNER_FIRSTNAME1	TEXT	IN	Bernard
SIGNER_EMAIL1	TEXT	IN	[e-mail]
SIGNER_EMAIL2	TEXT	IN	[e-mail]
SIGNER_TYPE1	TEXT	IN	PAD
SIGNER_TYPE2	TEXT	IN	TOKEN
FILE1	FILE	IN	contract.pdf
DOCAPOSTE_TRANSACTION_ID	TEXT	OUT	xxxxx-xxxxx-xxxxx-xxxxx
DOCAPOSTE_DOCUMENT_NAMES	TEXT	OUT	contract.pdf