Tous vos envois via API et en temps réel
Automatisez l'envoi de documents, de recommandés, de télégrammes, de publicité avec la Poste
Pour envoyer des télégrammes via API, l'endpoint de référence est POST /telegrammi/.
Dans le corps de la requête, les données relatives à:
- l'expéditeur (prénom, nom, adresse complète)
- le(s) destinataire(s) (prénom, nom, adresse complète)
- le document
- l'option supplémentaire éventuelle (avis de passage)
La réponse fournit les détails du télégramme demandé, en particulier
- l'expéditeur (prénom, nom, adresse complète)
- le(s) destinataire(s) (prénom, nom, adresse complète)
- les spécifications du document
- le prix final
- l'identifiant du télégramme
ATTENTION: L'identifiant sera utile ultérieurement pour obtenir des informations sur le télégramme envoyé.
Il est également possible de sauvegarder le télégramme pour un envoi ultérieur grâce au paramètre "autoconfirmation" qui, dans ce cas, doit être réglé sur "false". Pour confirmer l'envoi ultérieurement, vous devrez utiliser l'endpoint PATCH /telegrammi/{id} en transmettant l'identifiant d'envoi et, dans le corps de la demande, la valeur "confirmed":true.
Pour envoyer des lettres recommandées via l'API, le point de terminaison de référence est POST /raccomandate/.
Dans le corps de la requête, les données relatives à:
- l'expéditeur (prénom, nom, adresse complète)
- le(s) destinataire(s) (prénom, nom, adresse complète)
- le document
- l'option supplémentaire éventuelle (recto/verso, couleurs, retour, avis de réception)
La réponse fournit les détails de l'envoi recommandé demandé, notamment
- l'expéditeur (nom, prénom, adresse complète)
- le(s) destinataire(s) (nom, prénom, adresse complète)
- les spécifications du document
- le prix final
- l'id de l'envoi recommandé
ATTENTION: L'id sera utile ultérieurement pour obtenir des informations sur le courrier recommandé envoyé et à des fins de suivi.
Il est également possible de sauvegarder la lettre recommandée pour un envoi ultérieur via le paramètre "autoconfirmation" qui, dans ce cas, doit être réglé sur faux. Pour confirmer l'envoi ultérieurement, il faudra utiliser le PATCH /raccomandate/{id} endpoint en passant l'id de l'envoi et dans le corps de la requête la valeur "confirmed":true.
Pour envoyer du courrier ordinaire via API, l'endpoint de référence est POST /ordinarie/.
Dans le corps de la demande, vous devez spécifier des données sur:
- l'expéditeur (prénom, nom, adresse complète)
- le(s) destinataire(s) (prénom, nom, adresse complète)
- le document
- l'option supplémentaire éventuelle (recto/verso, couleurs, avis de livraison)
La réponse fournit des informations sur
- l'expéditeur (nom, prénom, adresse complète)
- le(s) destinataire(s) (prénom, nom, adresse complète)
- les spécifications du document
- le prix final
- l'id du courrier
ATTENTION: L'id sera utile ultérieurement pour obtenir des informations sur l'envoi.
Il est également possible de sauvegarder le courrier ordinaire pour un envoi ultérieur via le paramètre "autoconfirmation" qui, dans ce cas, doit être réglé sur false. Pour confirmer l'envoi ultérieurement, il faudra utiliser le PATCH /ordinarie/{id} endpoint en passant l'id de l'envoi et dans le corps de la requête la valeur "confirmed":true
Pour envoyer un courrier prioritaire via API, l'endpoint de référence est POST /prioritarie/.
Dans le corps de la requête, les données relatives à l'expéditeur (prénom, nom, adresse complète) doivent être saisies:
- l'expéditeur (prénom, nom, adresse complète)
- le(s) destinataire(s) (prénom, nom, adresse complète)
- le document
- l'option supplémentaire éventuelle (recto/verso, couleurs, avis de livraison)
La réponse fournit des informations sur
- l'expéditeur (nom, prénom, adresse complète)
- le(s) destinataire(s) (prénom, nom, adresse complète)
- les spécifications du document
- le prix final
- l'id du courrier prioritaire
VEUILLEZ NOTER: L'id sera utile ultérieurement pour obtenir des informations sur l'envoi et à des fins de suivi.
Il est également possible de sauvegarder l'envoi en courrier prioritaire pour un envoi ultérieur via le paramètre "autoconfirmation" qui, dans ce cas, doit être réglé sur false. Pour confirmer l'envoi ultérieurement, il faut utiliser le PATCH /prioritarie/{id} endpoint en transmettant l'id de l'envoi et dans le corps de la requête la valeur "confirmed":true.
Pour envoyer un courrier recommandé smart via API, l'endpoint de référence est POST /raccomandate_smart/.
Dans le corps de la requête, les données relatives à:
- l'expéditeur (prénom, nom, adresse complète)
- le(s) destinataire(s) (prénom, nom, adresse complète)
- le document
- les options supplémentaires éventuelles (recto/verso, couleurs, retour, avis de livraison, URL de callback éventuelle)
La réponse fournit les détails du courrier recommandé smart demandé, en particulier
- l'expéditeur (prénom, nom, adresse complète)
- le(s) destinataire(s) (prénom, nom, adresse complète)
- les spécifications du document
- le prix final
- l'id du courrier recommandé smart
ATTENTION: L'id sera utile ultérieurement pour obtenir des informations sur le courrier recommandé smart envoyé et pour le suivi.
Vous pouvez également sauvegarder le courrier recommandé pour un envoi ultérieur via le paramètre "autoconfirmation" qui, dans ce cas, doit être réglé sur false. Pour confirmer l'envoi ultérieurement, il faudra utiliser le PATCH /raccomandate_smart/{id} endpoint en passant l'id de l'envoi et dans le corps de la requête la valeur "confirmed":true.
Pour envoyer des courriers en nombre via API, l'endpoint de référence est POST /posta_massiva/.
Dans le corps de la requête, les données relatives à l'expéditeur (prénom, nom, adresse complète) doivent être fournies:
- l'expéditeur (prénom, nom, adresse complète)
- le(s) destinataire(s) (prénom, nom, adresse complète)
- le document
- option supplémentaire éventuelle (recto/verso, couleurs, avis de livraison)
La réponse fournit des informations sur
- l'expéditeur (nom, prénom, adresse complète)
- le(s) destinataire(s) (prénom, nom, adresse complète)
- les spécifications du document
- le prix final
- l'id de l'envoi en nombre
ATTENTION: L'id sera utile ultérieurement pour obtenir des informations sur l'envoi.
Il est également possible de sauvegarder l'envoi en nombre pour un envoi ultérieur via le paramètre "autoconfirmation" qui, dans ce cas, doit être réglé sur false. Pour confirmer l'envoi ultérieurement, il faudra utiliser l'endpoint PATCH /posta_massiva/{id} en passant l'id du mailing et dans le corps de la requête la valeur "confirmed":true
Oui, il est également possible d'inclure plusieurs destinataires pour tous les Services Postaux Italiens: télégramme, courrier recommandé, prioritaire et ordinaire, courrier recommandé smart, courrier en nombre.
Oui, la liste est disponible via la méthode GET.
Selon le service, l'endpoint de référence sera:
- GET /telegrammi/ pour les télégrammes
- GET /raccomandate/ pour les courriers recommandées
- GET /prioritarie/ pour le courrier prioritaire
- GET /ordinarie/ pour le courrier ordinaire
- GET /raccomandate_smart/ pour le courrier recommandé intelligent
- GET /posta_massiva/ pour le courrier en nombre
Aucun paramètre de départ n'est requis.
Oui, il est possible de vérifier les envois précédents via les endpoints:
- GET /telegrammi/{id} pour les télégrammes
- GET /raccomandate/{id} pour les courrier recommandées
- GET /prioritarie/{id} pour le courrier prioritaire
- GET /ordinarie/{id} pour le courrier ordinaire
- GET /raccomandate_smart/{id} pour le courrier recommandé intelligent
- GET /posta_massiva/{id} pour le courrier en nombre
Dans tous les cas, l'identifiant, qui est obtenu lors de l'envoi du produit, est requis comme paramètre de départ.
Les autres paramètres (s'ils sont définis) sont facultatifs:
- receipt (pour les télégrammes, les envois recommandés, prioritaires et ordinaires): un PDF est renvoyé dans la réponse
- statut (pour tous les services)
- callback (UNIQUEMENT pour l'environnement sandbox et uniquement pour le courrier recommandé)
Vous pouvez suivre les envois individuels pour les produits avec suivi (courrier recommandé, courrier prioritaire, courrier recommandé smart) via l'endpoint GET /tracking/{id}, en commençant par le paramètre id.
Le délai de prise en charge de la demande par Poste Italiane varie en fonction du service demandé:
Courrier recommandé: en temps réel
Télégramme: en temps réel
Courrier ordinaire: en temps réel
Courrier prioritaire: en temps réel
Courrier en nombre: en secondes
Courrier recommandé smart: en secondes
Le délai de livraison moyen varie en fonction du service demandé:
Courrier recommandé: 4-6 jours ouvrables
Télégramme: à partir de 24 heures
Courrier ordinaire: à partir de 4 jours
Courrier prioritaire: à partir de 24 heures
Courrier en nombre: de 7 à 9 jours
Courrier recommandé smart: de 4 à 7 jours
Le coût d'une requête unique varie en fonction du endpoint et est aussi bas que 0,32€.
Pour le courrier recommandé: le coût commence à 4,24€.
Pour le telegram: le coût sortant est de 3,63€.
Pour le courrier ordinaire (poste 4): le coût de départ est de 1,03€.
Pour le courrier prioritaire (poste 1): le coût de départ est de 2,28€.
Pour le courrier en nombre: le coût de départ est de 0,32€.
Pour le courrier recommandé smart: le coût de départ est de 2,60€.
Tous les prix sont disponibles dans la section "Tarification".
Vous pouvez également obtenir le détail des prix via l'endpoint GET /pricing/.
Dans la section Utilisation, au niveau de l'API, vous pouvez suivre vos requêtes gratuites et vos requêtes de recharge. Elles sont disponibles à la fois en mode graphique (période, mois et année) et avec un résumé textuel.