Postamail Internazionale

  • Openapi a partire da € 1,30 + iva

Il servizio di Poste Italiane per inviare la posta ordinaria all'estero

Postamail Internazionale è il servizio di posta ordinaria per spedire lettere, documenti, comunicazioni in qualsiasi Paese del Mondo ed in pochi secondi. Servizio attivo 24 ore su 24.

Esempio Postamail Internazionale

Il servizio di Postamail Internazionale consente di inviare comunicazioni a basso costo in tutti i Paesi del Mondo con consegna a partire da 8 giorni. Tutto tramite API.

Con Postamail Internazionale invii lettere e documenti a uno o più destinatari (non ci sono limiti) sia privato sia azienda, con un'unica richiesta.

Invio Postamail Internazionale

ESEMPIO RICHIESTA

POST /ordinarie/

Per inviare una Postamail Internazionale (o posta ordinaria estero) è necessario utilizzare lo stesso endpoint del servizio di Posta 4 POST /ordinarie/ e passare informazioni quali:

  • nome ed indirizzo del mittente
  • nome ed indirizzo del destinatario
  • testo
   {
  "data": {
    "mittente": {
      "ragione sociale": "openapi spa",
      "dug": "piazza",
      "indirizzo": "cavour",
      "civico": "43",
      "comune": "roma",
      "cap": "00121",
      "provincia": "rm",
      "email": "[email protected]",
      "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
   }
  }
}

 

In questo caso i dati richiesti per il destinatario sono parzialmente differenti: i campi dug (es. viale) e numero civico dovranno essere inseriti direttamente nel campo indirizzo e la provincia sarà sempre "ee".

In fase di richiesta si possono selezionare anche una serie di opzioni:

  • stampa a colori
  • programmare l'invio (timestamp_invio)
  • ricevuta d'invio
  • fronte retro

È possibile inoltre impostare la conferma automatica ("autoconfirm") e quindi inviare automaticamente la spedizione (se il valore è uguale a "true"). In questo caso si procederà immediatamente all'addebito del costo della spedizione e a pianificarne l'invio.

Se invece prima dell'invio si desiderano verificare i dati della spedizione ed i costi associati, "autoconfirm" dovrà essere impostato come "false".

ESEMPIO RISPOSTA

POST /ordinarie/

La risposta riporterà tutte le informazioni riguardanti il mittente, il destinatario e il messaggio più le informazioni dettagliate sui costi e l'id necessario per la conferma di invio.

   {
  "data": {
    "mittente": {
      "ragione sociale": "openapi spa",
      "dug": "piazza",
      "indirizzo": "cavour",
      "civico": "43",
      "comune": "roma",
      "cap": "00121",
      "provincia": "rm",
      "email": "[email protected]",
      "nazione": "IT"
    },
   "destinatari": [
    {
      "nome": "string",
      "cognome": "string",
      "indirizzo": "string",
      "comune": "string",
      "cap": "string",
      "provincia": "ee",
      "nazione": "string",
      "email": "[email protected]"
    }
  ],
 - "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": "ordinaria estero",,
      "creation_timestamp": 1627659712,
      "update_timestamp": 1627659712,
      "username": "[email protected]",,
      "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": "pagine",
            "descrizione_servizio": "Tariffa postale pagine",
            "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": "Costo Stampa",
            "percentuale_iva": 22,
            "quantita": 2,
            "importo_unitario_totale": 0,
            "importo_unitario_netto": 0,
            "importo_unitario_iva": 0
          },
          {
            "codice_servizio": "IMBUST",
            "descrizione_servizio": "Imbustamento",
            "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
}

 

Conferma d'invio

PATCH /ordinarie/

Per procedere alla conferma dell'invio della posta ordinaria estero sarà necessario effettuare una seconda richiesta con il metodo PATCH e passare l'id della richiesta precedentemente effettuata.

La risposta riporterà tutti i dati della posta ordinaria estero con lo stato "confermato".

I tempi di consegna delle spedizioni di Postamail Internazionale sono:

  • Europa: consegna nell’85% dei casi in 8 giorni lavorativi (esclusi sabato e festivi) oltre il giorno di spedizione
  • Bacino del Mediterraneo: consegna nell’85% dei casi in 12 giorni lavorativi (esclusi sabato e festivi) oltre il giorno di spedizione
  • Nord America e Oceania: consegna nell’85% dei casi in 16 giorni lavorativi (esclusi sabato e festivi) oltre il giorno di spedizione
  • Resto del mondo: consegna nell’85% dei casi in 22 giorni lavorativi (esclusi sabato e festivi) oltre a quello di spedizione

In caso di spedizioni online, ai tempi di recapito indicati si sommano i seguenti tempi di lavorazione: stampa in un giorno lavorativo (T+1), se la spedizione è accettata entro le ore 14:00 dal lunedì al venerdì, esclusi i festivi.

Le nostre tariffe

Listino prezzi a chiamata