Spedisci documenti in tutto il territorio nazionale, in modo sicuro ed economico tramite API con Poste Italiane.
Il servizio di Posta 4 (Posta Ordinaria) consente di inviare comunicazioni a basso costo in Italia con consegna in 4 giorni. Tutto tramite API.
Con Posta 4 (Posta Ordinaria) è possibile inviare lettere e documenti a uno o più destinatari (non ci sono limiti) sia privato sia azienda sia casella postale, tutto con un'unica chiamata:
POST /ordinarie/
Per inviare una posta ordinaria è necessario utilizzare l'endpoint POST /ordinarie/ e passare informazioni quali:
{
"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",
"dug": "string",
"indirizzo": "string",
"civico": "string",
"comune": "string",
"cap": "string",
"provincia": "string",
"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,
"fronteretro": false,
"colori": false,
"ricevuta": false,
}
}
}
In fase di richiesta è possibile selezionare anche una serie di opzioni:
E' 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 desidera verificare i dati della spedizione ed i costi associati autoconfirm dovrà essere impostato a false.
POST /ordinarie/
La risposta riporterà tutte le informazioni riguardanti il mittente, il destinatario e il messaggio più le informazioni dettagliate sui costi e all'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": "mittente@gmail.com",
"nazione": "IT"
},
"destinatari": [
{
"nome": "string",
"cognome": "string",
"dug": "string",
"indirizzo": "string",
"civico": "string",
"comune": "string",
"cap": "string",
"provincia": "string",
"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,
"fronteretro": false,
"colori": false,
"ricevuta": false,
"timestamp_invio": 1627659712
},
"prodotto": "posta ordinaria",,
"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": "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
}
PATCH /ordinarie/
Per procedere a conferma dell'invio della posta ordinaria 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 con lo stato "confermato"
La consegna degli invii di Posta 4 avviene:
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.
Hai bisogno di aiuto?
Non hai trovato la risposta che cercavi?
Compila tutti i campi, ti ricontatteremo al più presto!
Il servizio di Posta 4 (Ordinaria), conosciuto anche come Posta 4, è un'opzione economica offerta da Poste Italiane per l'invio di lettere e documenti in Italia. Questo servizio è ideale per chi necessita di spedire comunicazioni non urgenti, come corrispondenza commerciale o documentazione amministrativa, a costi contenuti. Le aziende possono integrare facilmente Posta 4 nei propri sistemi tramite un'interfaccia API, automatizzando il processo di spedizione. Il servizio offre tracciamento delle spedizioni per una maggiore sicurezza e rappresenta una scelta sostenibile, favorendo una gestione efficiente della corrispondenza.
Puoi inviare lettere e documenti fino a un massimo di 100 pagine per spedizione.
No, non ci sono limiti. Puoi inviare a uno o più destinatari, siano essi privati, aziende o caselle postali, con un'unica chiamata.
I documenti possono essere stampati in bianco e nero o a colori. Per invii oltre le 50 pagine, la stampa fronte/retro avviene automaticamente, garantendo efficienza e risparmio di carta.
Il servizio di Posta 4 (Ordinaria) è pensato per una vasta gamma di utenti che desiderano inviare documenti cartacei in Italia in modo economico e pratico. Ecco alcuni dei destinatari ideali:
Questo servizio è particolarmente vantaggioso per chi gestisce grandi volumi di corrispondenza, grazie alla possibilità di automatizzare l'invio tramite API, consentendo un notevole risparmio di tempo e risorse. Inoltre, la sua semplicità d'uso lo rende accessibile anche a chi non ha competenze tecniche avanzate.
L'invio è accettato dal lunedì al venerdì entro le 14:00, esclusi i festivi.
La consegna della Posta 4 (Ordinaria) impiega generalmente 4 giorni lavorativi per il 90% degli invii. Tuttavia, i tempi possono variare leggermente in base alla località di destinazione e alla gestione logistica da parte dei centri di smistamento.
Il costo di Posta 4 (Ordinaria) tramite ricarica parte da €1,03 + IVA. Questa tariffa include la spesa postale, i costi di imbustamento e la stampa del documento. Il prezzo può aumentare in base al numero di pagine o alla tipologia di invio richiesto.