Télégramme
€0.00 + TVA
Le service de télégrammes en ligne permet d'envoyer par API sur l'ensemble du territoire national de manière sécurisée et certifiée, avec une validité légale garantie par Poste Italiane.
Le service Telegrammi Online permet de envoyer des communications à valeur légale en 24 heures et est disponible avec l'option Avis de livraison. Tout cela via API.
Avec Telegrammi Online, vous pouvez envoyer des télégrammes papier à un ou plusieurs destinataires via API, qu'ils soient privés, entreprises ou boîtes postales, le tout avec un seul envoi.
ENVOYER UN TÉLÉGRAMME
DEMANDE D'ENVOI DE TÉLÉGRAMME
POST /telegrammi/
Pour envoyer un télégramme, vous devez utiliser le point de terminaison POST /telegrammi/ et passer les informations telles que :
- nom et adresse de l'expéditeur
- nom et adresse du destinataire
- texte
{
"data": {
"expéditeur": {
"raison_sociale": "openapi spa",
"rue": "piazza",
"adresse": "cavour",
"numéro": "43",
"ville": "roma",
"code_postal": "00121",
"province": "rm",
"email": "mittente@gmail.com",
"pays": "IT"
},
"destinataires": [
{
"prénom": "string",
"nom": "string",
"rue": "string",
"adresse": "string",
"numéro": "string",
"ville": "string",
"code_postal": "string",
"province": "string",
"pays": "string",
"id": "664228bbbf1239901b0815f2",
"état": "NOUVEAU"
}
],
- "document": [
"XX XXXXXX XXXXXXXXXXXXXXX XXXXX XXXXXXXX XXXXXXXXX XXXXXXXXX XXXXX XXXXXXXX XXX, XX XXXXXXXX XXXXX X XXX XXXXX XX XXXXXXX XXX 18 XXXXX 2023,XXXXXXX XX XXXXX XX XXXXXXX XXXXXX"
],
- "options": {
"couleurs": false,
"confirmation_automatique": false,
"expéditeur": false,
"ar_c": false,
"ar_e": false
}
}
}
Lors de la demande, vous pouvez également sélectionner un certain nombre d'options :
- expéditeur (insertion des données de l'expéditeur dans le message)
- ar_c, c'est-à-dire l'avis de livraison papier
- ar_e, c'est-à-dire l'avis de livraison électronique
- programmer l'envoi (timestamp_invio)
- reçu d'envoi
Il est également possible de définir la confirmation automatique (autoconfirm) et d'envoyer la livraison automatiquement (si la valeur est définie sur "true"). Dans ce cas, le coût d'envoi sera immédiatement facturé et l'envoi sera planifié.
Si vous souhaitez vérifier les données de l'envoi et les coûts associés avant l'envoi, autoconfirm doit être défini sur false.
RÉPONSE À L'ENVOI DU TÉLÉGRAMME
POST /télégrammes/
La réponse inclura toutes les informations concernant l'expéditeur, le destinataire et le message, ainsi que les informations détaillées sur les coûts et l'ID nécessaire pour la confirmation de l'envoi.
{
"data": {
"expediteur": {
"raison_sociale": "openapi spa",
"dug": "piazza",
"adresse": "cavour",
"numero": "43",
"ville": "roma",
"code_postal": "00121",
"province": "rm",
"email": "expediteur@gmail.com",
"pays": "IT"
},
"destinataires": [
{
"prenom": "string",
"nom": "string",
"dug": "string",
"adresse": "string",
"numero": "string",
"ville": "string",
"code_postal": "string",
"province": "string",
"pays": "string",
"id": "664228bbbf1239901b0815f2",
"etat": "NEW"
}
],
- "document":
"XX XXXXXX XXXXXXXXXXXXXXX XXXXX XXXXXXXX XXXXXXXXX XXXXXXXXX XXXXX XXXXXXXX XXX, XX XXXXXXXX XXXXX X XXX XXXXX XX XXXXXXX XXX 18 XXXXX 2023,XXXXXXX XX XXXXX XX XXXXXXX XXXXXX",
"options": {
"autoconfirm": false,
"expediteur": false,
"ar_c": false,
"ar_e": false,
"timestamp_envoi": 1627659712
},
"produit": "télégramme",,
"creation_timestamp": 1627659712,
"update_timestamp": 1627659712,
"nom_utilisateur": "john.doe@openapi.it",,
"confirme": true,,
"etat": "CONFIRMED",
"document_valide": {
"pdf": "https://ws.ufficiopostale.com/Up/pdf/test-document.pdf",
"jpg": "https://ws.ufficiopostale.com/Up/jpg/test-document.jpg",
"mots": 1,
"txt": "L",
"taille": 1
},
"tarification": {
"details": [
{
"code_service": "mots",
"description_service": "Tarif postal mots",,
"pourcentage_tva": 22,
"quantite": 2,
"montant_unitaire_total": 4.27,
"montant_unitaire_net": 3.5,
"montant_unitaire_tva": 0.77
},
{
"code_service": "IMPRESSION",
"description_service": "Coût d'impression",,
"pourcentage_tva": 22,
"quantite": 2,
"montant_unitaire_total": 0,
"montant_unitaire_net": 0,
"montant_unitaire_tva": 0
},
{
"code_service": "ENVELOPPE",
"description_service": "Mise sous enveloppe",,
"pourcentage_tva": 22,
"quantite": 2,
"montant_unitaire_total": 0,
"montant_unitaire_net": 0,
"montant_unitaire_tva": 0
}
],
"total": {
"montant_total_net": 7,
"montant_total_tva": 1.54,
"montant_total": 8.54
}
},
"verrouille": false,
"timestamp_confirmation": 1627659712,
"id": "61041dc0ac2b1f63327e92d2"
}
},
"succes": true,
"message": "",
"erreur": null
}Confirmation d'Envoi
PATCH /télégrammes/
Pour procéder à la confirmation de l'envoi du télégramme, vous devrez effectuer une seconde demande avec la méthode PATCH et fournir l'ID de la demande précédente.
La réponse inclura toutes les données du télégramme avec le statut "confirmé".
Délais de livraison pour les télégrammes en Italie :
- Livraison le jour même de l'acceptation, si jour ouvrable, pour 90% des télégrammes acceptés avant 12h00 et adressés aux chefs-lieux de province ou aux lieux comptant plus de 50 000 habitants
- Livraison le jour ouvrable suivant l'acceptation pour 99% des envois, dans tous les autres cas
Les délais de livraison indiqués s'ajoutent aux temps de traitement suivants : impression en un jour ouvrable (T+1), si l'envoi est accepté avant 14h00 du lundi au vendredi, à l'exclusion des jours fériés.
NOTE : Les prix au moment de l'achat via l'API sont détaillés en tarif postal, impression, mise sous enveloppe. Le code de suivi est synchroniquement reçu dans les quelques secondes suivant la confirmation de l'envoi.
Avez-vous besoin d'aide ?
Vous n'avez pas trouvé la réponse que vous cherchiez?
Remplissez tous les détails, nous vous contacterons dès que possible!
