# DOCAPOSTESEND ## 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
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
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
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
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
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 `` 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
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
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`

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.workflowgen.com/admin/workflow-applications/docaposte/docapostesend-workflow-application.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.