€0.00 + TVA
Postamail International est le service de courrier ordinaire pour envoyer des lettres, des documents et des communications dans n'importe quel pays du monde en quelques secondes. Le service est disponible 24 heures sur 24, 7 jours sur 7.
Le service Postamail International permet d'envoyer des communications à bas coût dans tous les pays du monde avec une livraison en 8 jours. Tout cela via API.
Avec Postamail International, il est possible d'envoyer des lettres et des documents à un ou plusieurs destinataires (sans limite) aussi bien privés qu'entreprises, le tout avec un seul appel :
POST /ordinarie/
Pour envoyer du courrier international, il faut utiliser le même point de terminaison que pour le service Poste 4 POST /ordinarie/ et fournir des informations telles que :
{
"data": {
"expéditeur": {
"raison_sociale": "openapi spa",
"rue": "piazza",
"adresse": "cavour",
"numéro": "43",
"ville": "roma",
"code_postal": "00121",
"région": "rm",
"email": "expéditeur@gmail.com",
"pays": "IT"
},
"destinataires": [
{
"prénom": "string",
"nom": "string",
"adresse": "string",
"ville": "string",
"code_postal": "string",
"région": "ee",
"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": {
"recto/verso": false,
"couleur": false,
"confirmation_automatique": false,
"reçu": false
}
}
}
Dans ce cas, les données requises pour le destinataire sont partiellement différentes : les champs rue (par exemple, viale) et numéro doivent être directement entrés dans le champ adresse, et la région sera toujours "ee".
Lors de la demande, il est également possible de sélectionner plusieurs options :
Il est également possible de définir la confirmation automatique (autoconfirm) pour envoyer automatiquement l'envoi (si la valeur est définie sur "true"). Dans ce cas, le coût d'expédition sera immédiatement facturé et l'envoi sera planifié.
En revanche, si vous souhaitez vérifier les données d'expédition et les coûts associés avant l'envoi, autoconfirm doit être défini sur false.
POST /ordinaire/
La réponse comprendra toutes les informations concernant l'expéditeur, le destinataire et le message, ainsi que des informations détaillées sur les coûts et l'ID 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": {
"fronte/retro": false,
"colori": false,
"autoconfirm": false,
"ricevuta": false
},
"prodotto": "ordinaire international",,
"creation_timestamp": 1627659712,
"update_timestamp": 1627659712,
"username": "john.doe@openapi.it",,
"confirmed": true,,
"state": "CONFIRMÉ",
"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": "pages",
"descrizione_servizio": "Tarif postal pages",
"percentuale_iva": 22,
"quantita": 2,
"importo_unitario_totale": 4.27,
"importo_unitario_netto": 3.5,
"importo_unitario_iva": 0.77
},
{
"codice_servizio": "PRINT",
"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": "ENVELOPING",
"descrizione_servizio": "Enveloppe",
"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
},
"confirmed_timestamp": 1724754216,
"id": "66cda9285673a1b85f092f03"
}
],
"success": true,
"message": "",
"error": null
}
PATCH /ordinaire/
Pour confirmer l'envoi du courrier ordinaire international, une seconde demande doit être effectuée en utilisant la méthode PATCH et en passant l'ID de la demande effectuée précédemment.
La réponse comprendra toutes les données du courrier ordinaire international avec le statut "confirmé"
Les délais de livraison pour les envois de courrier international sont les suivants :
Pour les envois en ligne, les délais de traitement suivants s'ajoutent : impression en un jour ouvré (T+1), si l'envoi est accepté avant 14h du lundi au vendredi, hors jours fériés.
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!