Merci Facteur imprime et poste vos courriers le jour même.
Une lettre
Une carte
Une photoAPI Merci Facteur /sourcePublipostage : Envoi de la source de données du publipostage
Base URL API Merci Facteur https://www.merci-facteur.com/api/1.2/prod/service
Endpoint API Merci Facteur https://www.merci-facteur.com/api/1.2/prod/service/sourcePublipostage
← Retour à la liste des endpoints de l'API Merci Facteur
← Voir ce endpoint dans la doc Swagger
La source de donnée contient les informations de vos destinataires. Elle peut être au format CSV/TXT (; entre les champs, et saut de ligne entre les lignes, la première ligne doit contenir les champs de fusion), ou au format json (de la forme [{"prenom":"Jean-Marc", "ville":"Paris", "champ_de_fusion":"valeur"},{"prenom":"Julie", "ville":"Lyon", "champ_de_fusion":"valeur"}]). Votre fichier source doit au minimum contenir les champs de fusion suivants : "nom" ou "societe", "cp", "ville", "pays". Dans le cas d'un fichier CSV ou TXT, la première ligne doit être : civilite;nom;prenom;societe;adresse1;adresse2;adresse3;cp;ville;pays
Paramètres
| Nom | In | Type | Description |
|---|---|---|---|
ww-service-id | header | string | Votre service Id |
ww-access-token | header | string | Un access token valide |
Request body
Request body requis
application/x-www-form-urlencoded
| Propriété | Type | Description | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
idUser | integer | Id de l'utilisateur qui effectue l'envoi. | |||||||||
templateValidation | object | un json avec la valeur templateValidation telle qu'elle vous a été retourné lors de l'envoi du template sur /templatePublipostage. | |||||||||
source | object | URL du fichier csv/txt, sa version encodée en base64, ou le json des données. | |||||||||
| |||||||||||
Réponses
HTTP 200 — Objet contenant l'ID de l'envoi en vue de sa validation, ainsi que les données sources à contrôler. Vous pouvez ensuite, soit contrôler manuellement le publipostage avant de la valider (via votre interface Merci facteur Pro), soit le contrôler automatiquement et le valider avec \sendPublipostage
application/json
| Propriété | Type | Description |
|---|---|---|
success | boolean | true si HTTP 200, sinon false |
error | string | le code d'erreur en cas d'erreur |
idEnvoi | integer | Identifiant de l'envoi pour procéder à sa validation |
sourceValidation | object | Les champs de fusion avec un éventuel retraitement, tels qu'ils seront utilisés lors de la fusion pour créer les lettres finales. |
HTTP 400 — Erreur (code d'erreur dans l'entête)
application/json
| Propriété | Type | Description | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
success | boolean | true si HTTP 200, sinon false | |||||||||
error | object | Objet contenant les infos de l'erreur. | |||||||||
| |||||||||||
HTTP 401 — Erreur authentification (code d'erreur dans l'entête : token invalide ou expiré, service-id incorrecte, IP non autorisée)
application/json
| Propriété | Type | Description | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
success | boolean | true si HTTP 200, sinon false | |||||||||
error | object | Objet contenant les infos de l'erreur. | |||||||||
| |||||||||||
