Télégramme-International
€0.00 + TVA
Le Télégramme International est le service permettant d’envoyer des télégrammes papier dans n’importe quel pays du monde en quelques secondes. Le service est disponible 24 heures sur 24.
Le service de Télégrammes Internationaux permet d'envoyer des communications en temps réel et dans le monde entier. Tout cela via API.
Avec les Télégrammes Internationaux, vous pouvez envoyer via API des télégrammes papier à un ou plusieurs destinataires, qu'ils soient privés ou entreprises, dans n'importe quel pays du monde.
ENVOI DE TÉLÉGRAMME INTERNATIONAL
DEMANDE D'ENVOI DE TÉLÉGRAMME INTERNATIONAL
POST /telegrammi/
Pour envoyer un télégramme international, il est nécessaire d'utiliser le même point de terminaison utilisé pour l'envoi vers l'Italie POST /telegrammi/ et de fournir des informations telles que :
- nom et adresse de l'expéditeur
- nom et adresse du destinataire
- texte
{
"data": {
"mittente": {
"ragione sociale": "openapi spa",
"dug": "piazza",
"indirizzo": "cavour",
"civico": "43",
"comune": "roma",
"cap": "00121",
"provincia": "rm",
"email": "mittente@gmail.com",
"nazione": "IT"
},
"destinatari": [
{
"nome": "string",
"cognome": "string",
"indirizzo": "string",
"comune": "string",
"cap": "string",
"provincia": "ee",
"nazione": "string",
"id": "664228bbbf1239901b0815f2",
"state": "NEW"
}
],
- "documento": [
"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"
],
- "opzioni": {
"autoconfirm": false,
"mittente": false,
"ricevuta": false
}
}
}
Dans ce cas, les données requises pour le destinataire sont partiellement différentes, les champs dug (par exemple, avenue) et numéro civique doivent être directement insérés dans le champ adresse et la province sera toujours "ee"
Lors de la demande, il est également possible de sélectionner plusieurs options :
- expéditeur (insertion des données de l'expéditeur dans le message)
- programmer l'envoi (timestamp_invio)
- reçu de l'envoi
Il est également possible de configurer la confirmation automatique (autoconfirm) pour envoyer automatiquement l'expédition (si la valeur est "true"). Dans ce cas, le coût de l'expédition sera immédiatement facturé et son envoi sera planifié.
Si vous souhaitez vérifier les données de l'expédition et les coûts associés avant l'envoi, autoconfirm doit être réglé sur false.
Le coût du télégramme international est calculé en fonction de la zone, des mots et des options.
RÉPONSE À L'ENVOI DU TÉLÉGRAMME INTERNATIONAL
POST /telegrammi/
La réponse contiendra 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'identifiant nécessaire pour la confirmation de l'envoi.
{
"data": {
"mittente": {
"ragione sociale": "openapi spa",
"dug": "piazza",
"indirizzo": "cavour",
"civico": "43",
"comune": "roma",
"cap": "00121",
"provincia": "rm",
"email": "mittente@gmail.com",
"nazione": "IT"
},
"destinatari": [
{
"nome": "string",
"cognome": "string",
"indirizzo": "string",
"comune": "string",
"cap": "string",
"provincia": "ee",
"nazione": "string",
"id": "664228bbbf1239901b0815f2",
"state": "NEW"
}
],
- "documento":
"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",
"opzioni": {
"autoconfirm": false,
"mittente": false,
"ar_c": false,
"ar_e": false,
"timestamp_invio": 1627659712
},
"prodotto": "telegramma etero",,
"creation_timestamp": 1627659712,
"update_timestamp": 1627659712,
"username": "john.doe@openapi.it",,
"confirmed": true,,
"state": "CONFIRMED",
"documento_validato": {
"pdf": "https://ws.ufficiopostale.com/Up/pdf/test-document.pdf",
"jpg": "https://ws.ufficiopostale.com/Up/jpg/test-document.jpg",
"parole": 1,
"txt": "L",
"size": 1
},
"pricing": {
"dettaglio": [
{
"codice_servizio": "parole",
"descrizione_servizio": "Tarif Postal par mots",
"percentuale_iva": 22,
"quantita": 2,
"importo_unitario_totale": 4.27,
"importo_unitario_netto": 3.5,
"importo_unitario_iva": 0.77
},
{
"codice_servizio": "STAMPA",
"descrizione_servizio": "Coût d'impression",
"percentuale_iva": 22,
"quantita": 2,
"importo_unitario_totale": 0,
"importo_unitario_netto": 0,
"importo_unitario_iva": 0
},
{
"codice_servizio": "IMBUST",
"descrizione_servizio": "Enveloppage",
"percentuale_iva": 22,
"quantita": 2,
"importo_unitario_totale": 0,
"importo_unitario_netto": 0,
"importo_unitario_iva": 0
}
],
"totale": {
"importo_totale_netto": 7,
"importo_totale_iva": 1.54,
"importo_totale": 8.54
}
},
"lock": false,
"confirmed_timestamp": 1627659712,
"id": "61041dc0ac2b1f63327e92d2"
}
},
"success": true,
"message": "",
"error": null
}
Confirmation d'envoi
PATCH /telegrammi/
Pour procéder à la confirmation de l'envoi du télégramme international, il sera nécessaire de faire une seconde demande avec la méthode PATCH et de fournir l'identifiant de la demande effectuée précédemment.
La réponse contiendra toutes les données du télégramme international avec le statut "confirmé"
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.
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!
