# 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

By default, this value comes from the DocapostePassword parameter in the web.config file.

Docaposte host server

By default, this value comes from the DocaposteHostServer parameter in the web.config file.

Docaposte offer code

By default, this value comes from the DocaposteOfferCode parameter in the web.config file.

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)

Signature type of signers, separated by the value defined in the DATA\_SEPARATOR parameter

Possible values:

OTP(default)
PAD
TOKEN
CONSENT\_PROOF
IDENTITY

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

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

Indicates whether the transaction is a TEST transaction (Y or N)

Default: N

Subject of the email that will be sent to signers

Default: Please sign the document sent from WorkflowGen

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](#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](https://docs.workflowgen.com/admin/8.0/docapostecheck-workflow-application) workflow application | | `DOCAPOSTE_DOCUMENT_NAMES` | TEXT | OUT | Contains the names of the documents sent to Docaposte; you can use these values in the [DOCAPOSTECHECK](https://docs.workflowgen.com/admin/8.0/docapostecheck-workflow-application) 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 `` tag, which will be replaced by the link allowing the signer to add their signature. **Default value:** ```markup

Hello {firstname} {lastname},

Please sign the document sent from WorkflowGen.
"">Click here to sign on Docaposte

Regards,

WorkflowGen

``` ## 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 | `john.smith@email.com,bernard.martin@email.com` | | `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 | `john.smith@email.com` | | `SIGNER_EMAIL2` | TEXT | IN | `bernard.martin@email.com` | | `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` |