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
[email protected],[email protected]
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
[email protected]
SIGNER_EMAIL2
TEXT
IN
[email protected]
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

ADOBESIGNCHECK Workflow Application

DOCAPOSTECHECK Workflow Application

Last modified 27d ago

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

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

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.

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)

Parameter	Type	Direction	Value
`SIGNER_FIRSTNAME_LIST`	TEXT	IN	`John,Bernard`
`SIGNER_LASTNAME_LIST`	TEXT	IN	`Smith,Martin`
`SIGNER_EMAIL_LIST`	TEXT	IN	`[email protected],[email protected]`
`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`