Merci Facteur imprime et poste vos courriers le jour même.
Une lettre
Une carte
Une photoAPI Merci Facteur /getPostagePrice : Obtenir le montant d'un ou plusieurs courriers (non nécessaire à l'envoi)
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/getPostagePrice
← Retour à la liste des endpoints de l'API Merci Facteur
← Voir ce endpoint dans la doc Swagger
GET
/getPostagePrice — Obtenir le montant d'un ou plusieurs courriers (non nécessaire à l'envoi)Vous permet d'avoir le montant de l'affranchissement et du contenu d'un courrier en fonction de son contenu, de son mode d'envoi et de sa destination. Vous n'avez pas besoin d'utiliser cette fonction pour envoyer un courrier, mais vous pouvez l'utiliser si vous avez besoin de cette information avant d'envoyer un courrier (par exemple pour des raisons de facturation). Le montant retourné est un montant HT. La partie "affranchissement" n'est pas soumise à la TVA.
Paramètres
| Nom | In | Type | Description |
|---|---|---|---|
ww-service-id | header | string | Votre service Id |
ww-access-token | header | string | Un access token valide |
modeEnvoi | query | array<string> | Mode d'envoi du courrier : normal, suivi, lrar ou lrare |
Items: Valeurs autorisées : normal, suivi, lrar, lrare | |||
paysDestinataire[] | query | array<string> | Tableau de pays de destination, avec une orthographe conforme via /getCountry (indiquez soit paysDestinataire, soit idDestinataire). |
idDestinataire[] | query | array<integer> | Tableau d'id de destinataire(s) déjà créé (indiquez soit paysDestinataire, soit idDestinataire). |
cardFormat | query | array<string> | Format de la carte (laisser vide si pas de carte) |
Items: Valeurs autorisées : postcard, naked-postcard, classic, folded, large | |||
cardPapier | query | array<string> | Papier de la carte (laisser vide si pas de carte) |
Items: Valeurs autorisées : classic, nacre, creation | |||
cardCoin | query | array<string> | Coins de la carte (laisser vide si pas de carte) |
Items: Valeurs autorisées : carre, arrondi | |||
letterPageNumber | query | integer | Nombre de page(s) de lettre (indiquer 0 si pas de lettre) |
letterPrintSides | query | string | rectoverso pour une lettre imprimée recto-verso, recto pour une lettre imprimée en recto simple. |
photoNumber | query | integer | Nombre de photo(s) (indiquer 0 si pas de lettre) |
Request body
Aucun body.
Réponses
HTTP 200 — montant HT du courrier
application/json
| Propriété | Type | Description | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
success | boolean | true si HTTP 200, sinon false | ||||||||||||||||||
error | string | le code d'erreur en cas d'erreur | ||||||||||||||||||
poids | string | Le poids du courrier en grammes | ||||||||||||||||||
affranchissement | object | object avec, pour chaque pays demandé, le montant de l'affranchissement et la zone géographique | ||||||||||||||||||
| ||||||||||||||||||||
content | object | object avec, pour chaque pays demandé, le montant de l'affranchissement et la zone géographique | ||||||||||||||||||
| ||||||||||||||||||||
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. | |||||||||
| |||||||||||
