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, l'endpoint 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 une lettre recommandée judiciaire via API, l’endpoint de référence est POST /atti_giudiziari/.
Dans le corps de la requête, vous devez spécifier les détails suivants :
- Expéditeur : (nom, prénom, adresse complète)
- Destinataire(s) : (nom, prénom, adresse complète)
- Document
- Option additionnelle facultative : (Avis de réception)
La réponse fournit les détails concernant la lettre recommandée judiciaire demandée, notamment :
- Expéditeur : (nom, prénom, adresse complète)
- Destinataire(s) : (nom, prénom, adresse complète)
- Spécifications du document
- Prix final
- Identifiant de la lettre recommandée
NOTE : L’identifiant sera utile par la suite pour obtenir des informations sur la lettre recommandée envoyée.
Il est également possible de sauvegarder la lettre recommandée pour un envoi ultérieur en configurant le paramètre "autoconfirm" sur "false". Pour confirmer l’envoi à une date ultérieure, vous devrez utiliser l’endpoint PATCH /atti_giudiziari/{id}, en fournissant l’identifiant de l’envoi et en incluant dans le corps de la requête : "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 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 des télégrammes via API, l'endpoint de référence est POST /telegrammi/.
Dans le corps de la requête, vous devez spécifier les informations suivantes:
- Expéditeur (nom, prénom, adresse complète)
- Destinataire(s) (nom, prénom, adresse complète)
- Texte (incluant les informations de l'expéditeur)
- Option supplémentaire (Accusé de réception, Programmation de l'envoi)
La réponse fournira les détails du télégramme demandé, notamment :
- Expéditeur (nom, prénom, adresse complète)
- Destinataire(s) (nom, prénom, adresse complète)
- Texte envoyé
- Prix final
- ID télégramme
REMARQUE: L'ID sera nécessaire pour obtenir des informations sur le télégramme envoyé.
Il est également possible d'enregistrer le télégramme pour un envoi ultérieur en utilisant le paramètre "autoconfirm" qui doit être défini sur "false". Pour confirmer l'envoi ultérieurement, il est nécessaire d'utiliser l'endpoint PATCH /telegrammi/{id}, en passant l'ID de l'envoi et en indiquant dans le corps de la requête la valeur "confirmed".
Pour envoyer des lettres recommandées via API, l'endpoint de référence est POST /raccomandate/.
Dans le corps de la requête, vous devez spécifier les informations suivantes:
- Expéditeur (nom, prénom, adresse complète)
- Destinataire(s) (nom, prénom, adresse complète)
- Texte ou pièce jointe du document (URL, HTML, texte simple)
- Option supplémentaire (Accusé de réception, Recto/verso, Couleurs, Programmation de l'envoi)
La réponse fournira les détails de la lettre recommandée demandée, notamment:
- Expéditeur (nom, prénom, adresse complète)
- Destinataire(s) (nom, prénom, adresse complète)
- Spécifications du document
- Prix final
- ID recommandée
REMARQUE: L'ID sera nécessaire pour obtenir des informations sur la recommandée envoyée et pour le suivi.
Il est également possible d'enregistrer la lettre recommandée pour un envoi ultérieur en utilisant le paramètre "autoconfirm", qui doit être défini sur "false". Pour confirmer l'envoi ultérieurement, il est nécessaire d'utiliser l'endpoint PATCH /raccomandate/{id}, en passant l'ID de l'envoi et en indiquant dans le corps de la requête la valeur "confirmed".
Pour envoyer du courrier prioritaire via API, l'endpoint de référence est POST /prioritarie/.
Dans le corps de la requête, vous devez spécifier les informations suivantes:
- Expéditeur (nom, prénom, adresse complète)
- Destinataire(s) (nom, prénom, adresse complète)
- Texte ou pièce jointe du document (URL, HTML, texte simple)
- Option supplémentaire (Accusé de réception, Recto/verso, Couleurs et Programmation de l'envoi)
La réponse fournit des détails sur:
- Expéditeur (nom, prénom, adresse complète)
- Destinataire(s) (nom, prénom, adresse complète)
- Spécifications sur le document
- Prix final
- ID courrier prioritaire
REMARQUE: L'ID sera nécessaire ultérieurement pour obtenir des informations sur l'envoi effectué et pour le suivi.
Il est également possible d'enregistrer le courrier prioritaire pour un envoi ultérieur en utilisant le paramètre "autoconfirm", qui doit être défini sur "false". Pour confirmer l'envoi ultérieurement, il sera nécessaire d'utiliser l'endpoint PATCH /prioritarie/{id}, en passant l'ID de l'envoi et dans le corps de la requête, la valeur "confirmed".
Pour envoyer du courrier ordinaire via API, l'endpoint de référence est POST /ordinarie/.
Dans le corps de la requête, vous devez spécifier les informations suivantes:
- Expéditeur (nom, prénom, adresse complète)
- Destinataire(s) (nom, prénom, adresse complète)
- Texte ou pièce jointe du document (URL, HTML, texte simple)
- Option supplémentaire (Accusé de réception, Recto/verso, Couleurs et Programmation de l'envoi)
La réponse fournit des détails sur:
- Expéditeur (nom, prénom, adresse complète)
- Destinataire(s) (nom, prénom, adresse complète)
- Spécifications sur le document
- Prix final
- ID courrier ordinaire
REMARQUE: L'ID sera nécessaire ultérieurement pour obtenir des informations sur l'envoi effectué.
Il est également possible d'enregistrer le courrier ordinaire pour un envoi ultérieur en utilisant le paramètre "autoconfirm", qui doit être défini sur "false". Pour confirmer l'envoi ultérieurement, il sera nécessaire d'utiliser l'endpoint PATCH /ordinarie/{id}, en passant l'ID de l'envoi et dans le corps de la requête, la valeur "confirmed".
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
Il est possible d'inclure plus d'un destinataire pour les services italienne de la Poste uniquement: télégramme, courrier recommandé, courrier recommandé judiciaire, courrier prioritaire et ordinaire, courrier recommandé smart, courrier en nombre. Pour le courrier à destination de l'étranger, il ne peut y avoir qu'un seul destinataire.
Oui, il est possible de personnaliser entièrement la page de couverture de la communication, en ajoutant par exemple le logo, les informations de l'entreprise ou des promotions.
La personnalisation peut être réalisée via API avec le point de terminaison dédié ou via le Playground, qui permet également d'afficher un aperçu avant l'envoi.
La personnalisation de la page de couverture est disponible pour:
- Lettre recommandée en ligne
- Lettre recommandée internationale
- Courrier recommandé judiciaire
- Lettre Ordinaire Italie (Posta 4)
Lettre Prioritaire Italie (Posta 1) - Postapriority
- Postamail
L'archivage numérique est un service gratuit et activé par défaut qui permet d'accéder au contenu envoyé, signé et horodaté numériquement par Poste Italiane. Ce service certifie le contenu envoyé avec une valeur légale et le rend disponible pendant 12 mois.
Le service est disponible pour les produits postaux suivants :
- Lettre recommandée en ligne
- Lettre recommandée internationale
- Courrier recommandé judiciaire
- Lettre Ordinaire Italie (Posta 4)
Lettre Prioritaire Italie (Posta 1) - Postapriority
- Postamail
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 (vers l'Italie et à l'étranger)
- GET /raccomandate/ pour les courriers recommandées (vers l'Italie et à l'étranger)
- GET /prioritarie/ pour le courrier prioritaire (vers l'Italie et à l'étranger)
- GET /ordinarie/ pour le courrier ordinaire (vers l'Italie et à l'étranger)
- GET /raccomandate_smart/ pour le courrier recommandé smart
- GET /atti_giudiziari/ pour le courrier recommandé judiciaire
- 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 (vers l'Italie et à l'étranger)
- GET /raccomandate/{id} pour les courrier recommandées (vers l'Italie et à l'étranger)
- GET /prioritarie/{id} pour le courrier prioritaire (vers l'Italie et à l'étranger)
- GET /ordinarie/{id} pour le courrier ordinaire (vers l'Italie et à l'étranger)
- GET /raccomandate_smart/{id} pour le courrier recommandé smart
- GET /atti_giudiziari/{id} pour le courrier recommandé judiciaire
- 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é)
Si vous téléchargez un document de plus de 50 pages sans activer l'option recto-verso, le système génère un message d'erreur. Dans ce cas, il est donc obligatoire de sélectionner l'option recto-verso pour pouvoir procéder correctement à l'envoi du document.
L'option "mittente" (="expéditeur") vous permet de saisir les données de l'expéditeur directement dans le texte du télégramme.
Pour les envois vers l'Italia, cette option doit être sélectionnée pour que les données soient visibles.
En revanche, pour les envois internationaux, la saisie de l'expéditeur se fait automatiquement.
Il est important de noter que les mots utilisés pour l'expéditeur seront inclus dans le nombre total de télégrammes.
Le délai de prise en charge de la requête 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
- Courrier recommandé judiciaire: en secondes
Il est possible de suivre les envois de certains produits vers l'Italie, mais uniquement pour ceux qui incluent le service de suivi, c'est-à-dire les envois recommandés, les envois prioritaires et les envois recommandés smart.
L'endpoint de référence est GET /tracking/{id} et le paramètre de départ est l'identifiant.
Il n'y a pas de suivi pour les produits envoyés en dehors de l'Italie.
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
- Courrier recommandé judiciaire: de 5 jours
Les télégrammes internationaux sont remis le jour même au gestionnaire postal national, tandis que la livraison au destinataire se fera selon les délais prévus par le système postal local.
Les délais de livraison varient en fonction du pays de destination.
Les délais de livraison des envois de Postapriority internationale dépendent du pays de destination et sont les suivants:
- Europe: 3 jours ouvrables (hors samedis et jours fériés) après la date d'expédition, dans 85 % des envois
- Bassin méditerranéen: 4 à 5 jours ouvrables (hors samedis et jours fériés) après la date d'expédition, dans 85 % des envois
- Pays d'Amérique du Nord: 5 à 6 jours ouvrables (hors samedis et jours fériés) après la date d'expédition, dans 85 % des envois
- Pays du reste des Amériques, Asie et Océanie: 7 à 8 jours ouvrables (hors samedis et jours fériés) après la date d'expédition, dans 85 % des envois
- Autres pays d'Afrique: 8 à 9 jours ouvrables (hors samedis et jours fériés) après la date d'expédition, dans 85 % des envois
En cas d'expéditions en ligne, aux délais de livraison indiqués s'ajoutent les délais de traitement suivants: impression en un jour ouvrable (T+1), si l'expédition est acceptée avant 14h00 du lundi au vendredi, hors jours fériés.
Les délais de livraison des envois de Postamail internationale sont les suivants:
- Europe: livraison dans 85 % des cas en 8 jours ouvrables (hors samedis et jours fériés) après la date d'expédition
- Bassin méditerranéen: livraison dans 85 % des cas en 12 jours ouvrables (hors samedis et jours fériés) après la date d'expédition
- Amérique du Nord et Océanie: livraison dans 85 % des cas en 16 jours ouvrables (hors samedis et jours fériés) après la date d'expédition
- Reste du monde: livraison dans 85 % des cas en 22 jours ouvrables (hors samedis et jours fériés) après la date d'expédition
En cas d'expéditions en ligne, aux délais de livraison indiqués s'ajoutent les délais de traitement suivants: impression en un jour ouvrable (T+1), si l'expédition est acceptée avant 14h00 du lundi au vendredi, hors jours fériés.
Le coût d'une requête unique varie en fonction du endpoint et est aussi bas que 0,32€.
Le coût de la demande unique varie en fonction du service et des options sélectionnées et commence à partir de 0,32 €.
- Pour une recommandée: le coût est à partir de 4,24 €.
- Pour un télégramme: le coût est à partir de 3,63 €.
- Pour la Poste ordinaire (Poste 4): le coût est à partir de 1,03 €.
- Pour la Poste prioritaire (Poste 1): le coût est à partir de 2,28 €.
- Pour le courrier massif: le coût est à partir de 0,32 €.
- Pour la recommandée Smart: le coût est à partir de 2,60 €.
- Pour le télégramme international: le coût est à partir de 1,90 €.
- Pour la recommandée judiciaire: le coût est à partir de 13,10 €.
- Pour la recommandée internationale: le coût est à partir de 7,50 €.
- Pour la Postamail internationale: le coût est à partir de 1,30 €.
- Pour la Postapriority internationale: le coût est à partir de 3,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.