Automatizza l’invio di documenti, raccomandate, telegrammi, pubblicità con Ufficio Postale
Per l’invio dei Telegrammi via API l’endpoint di riferimento è POST /telegrammi/.
Nel body della richiesta vanno specificati i dati sul:
La risposta fornisce i dettagli del telegramma richiesto, in particolare:
NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sul telegramma inviato.
È possibile anche salvare il telegramma per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su “false”. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /telegrammi/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true
Per l’invio delle raccomandate via API l’endpoint di riferimento è POST /raccomandate/.
Nel body della richiesta vanno specificati i dati sul:
La risposta fornisce i dettagli della raccomandata richiesta, in particolare:
NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sulla raccomandata inviata e per il tracciamento.
È possibile anche salvare la raccomandata per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su false. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /raccomandate/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true
Per l’invio della raccomandata giudiziaria via API l’endpoint di riferimento è POST /atti_giudiziari/.
Nel body della richiesta vanno specificati i dati sul:
La risposta fornisce i dettagli della raccomandata giudiziaria richiesto, in particolare:
NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sulla raccomandata inviata.
È possibile anche salvare la raccomandata per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su “false”. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /atti_giudiziari/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true
Per l’invio della posta prioritaria via API l’endpoint di riferimento è POST /prioritarie/.
Nel body della richiesta vanno specificati i dati sul:
La risposta fornisce dettagli su:
NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sull’invio effettuato e per il tracciamento.
È possibile anche salvare la posta prioritaria per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su false. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /prioritarie/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true
Per l’invio della posta ordinaria via API l’endpoint di riferimento è POST /ordinarie/.
Nel body della richiesta vanno specificati i dati su:
La risposta fornisce dettagli su:
NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sull’invio effettuato.
È possibile anche salvare la posta ordinaria per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su false. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /ordinarie/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true
Per l’invio dei Telegrammi via API l’endpoint di riferimento è POST /telegrammi/
Nel body della richiesta vanno specificati i dati sul:
La risposta fornisce i dettagli del telegramma richiesto, in particolare:
NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sul telegramma inviato.
È possibile anche salvare il telegramma per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su “false”. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /telegrammi/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true
Per l’invio delle Raccomandate via API l’endpoint di riferimento è POST /raccomandate/.
Nel body della richiesta vanno specificati i dati sul:
La risposta fornisce i dettagli della raccomandata richiesta, in particolare:
NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sulla raccomandata inviata e per il tracciamento.
È possibile anche salvare la raccomandata per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su false. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /raccomandate/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true
Per l’invio della Posta Prioritaria via API l’endpoint di riferimento è POST /prioritarie/.
Nel body della richiesta vanno specificati i dati sul:
La risposta fornisce dettagli su:
NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sull’invio effettuato e per il tracciamento.
È possibile anche salvare la posta prioritaria per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su false. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /prioritarie/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true
Per l’invio della Posta Ordinaria via API l’endpoint di riferimento è POST /ordinarie/.
Nel body della richiesta vanno specificati i dati su:
La risposta fornisce dettagli su:
NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sull’invio effettuato.
È possibile anche salvare la posta ordinaria per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su false. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /ordinarie/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true
Per l’invio delle raccomandate smart via API l’endpoint di riferimento è POST /raccomandate-smart/.
Nel body della richiesta vanno specificati i dati sul:
La risposta fornisce i dettagli della raccomandata smart richiesta, in particolare:
NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sulla raccomandata smart inviata e per il tracciamento.
È possibile anche salvare la raccomandata smart per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su false. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /raccomandate_smart/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true
Per l’invio della posta massiva via API l’endpoint di riferimento è POST /posta_massiva/.
Nel body della richiesta vanno specificati i dati sul:
La risposta fornisce dettagli su:
NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sull’invio effettuato.
È possibile anche salvare la posta massiva per un successivo invio tramite il il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su false. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /posta_massiva/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true
È possibile includere più di un destinatario per i soli servizi nazionali di Ufficio Postale: telegramma, raccomandata, raccomandata giudiziaria, posta prioritaria e ordinaria, raccomandata smart, posta massiva. Per quanto riguarda gli invii verso l’estero, il destinatario può essere solo uno.
L'archiviazione digitale è il servizio gratuito ed attivo di default che consente di accedere al contenuto inviato firmato e marcato digitalmente da Poste Italiane. Il servizio certifica il contenuto invia con valore legale e rende disponibile il contenuto per 12 mesi.
Il servizio è attivo per i seguenti prodotti postali:
Sì, è possibile personalizzare completamente la copertina della comunicazione, aggiungendo ad esempio il logo, le informazioni aziendali o eventuali promozioni.
La personalizzazione può essere effettuata tramite API con l'endpoint dedicato oppure attraverso il Playground, che consente anche di visualizzare un’anteprima prima dell'invio.
La personalizzazione della Copertina è disponibile per:
Sì, l’elenco è disponibile attraverso il metodo GET.
A seconda del servizio, l’endpoint di riferimento sarà:
Non è richiesto alcun parametro di partenza.
Sì, è possibile fare una verificare dei precedenti invii attraverso gli endpoint:
In tutti i casi, come parametro di partenza è richiesto obbligatoriamente l’id, che si ottiene in fase di invio del prodotto.
Sono invece facoltativi altri parametri (se impostati):
L’opzione "mittente" consente di inserire i dati del mittente direttamente nel testo del telegramma.
Per le spedizioni in Italia, è necessario selezionare questa opzione affinché i dati siano visibili.
Per le spedizioni internazionali, invece, l’inserimento del mittente avviene automaticamente.
È importante notare che le parole utilizzate per il mittente saranno incluse nel conteggio complessivo del telegramma.
Se si carica un documento che supera le 50 pagine senza abilitare l’opzione fronte/retro, il sistema genera un messaggio di errore. In questi casi, è quindi obbligatorio selezionare l'opzione fronte/retro per procedere correttamente con l'invio del documento.
I tempi di presa in carico della richiesta da parte di Poste Italiane cambiano a seconda del servizio richiesto:
È possibile monitorare le spedizioni di alcuni prodotti diretti in Italia, ma solo per quelli che includono il servizio di tracciamento, come Raccomandata Online, Raccomandata Giudiziaria, Posta Prioritaria e Raccomandata Smart.
Per le spedizioni internazionali, il tracciamento è disponibile per la Postapriority Internazionale, permettendo di monitorare l'arrivo della spedizione al Centro di Scambio Internazionale di Poste Italiane.
Le Raccomandate inviate all'estero possono essere tracciate fino alla destinazione finale per le seguenti zone:
Zona 1 (Europa e Bacino del Mediterraneo)
Zona 2 (Africa, America e Asia)
Zona 3 (Oceania)
Per effettuare il tracciamento, l'endpoint da utilizzare è GET/tracking/{id}, dove il parametro richiesto è l'id della spedizione.
I tempi medi di consegna cambiano a seconda del servizio richiesto:
I telegrammi internazionali vengono affidati in giornata al gestore postale nazionale, mentre il recapito al destinatario avverrà secondo i tempi previsti dal sistema postale locale.
I tempi di consegna variano a seconda del Paese di destinazione.
I tempi di consegna degli invii di Postapriority Internazionale dipendono dal Paese di destinazione e sono:
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.
I tempi di consegna delle spedizioni di Postamail Internazionale sono:
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.
Il costo della richiesta singola varia a seconda del servizio e delle opzioni selezionate ed è a partire da 0,32€.
Tutti i prezzi sono disponibili nella sezione dedicata "Prezzi".
È possibile ottenere i dettagli sui prezzi anche attraverso l’endpoint GET /pricing/.
Nella sezione Utilizzo, a livello di API, è possibile monitorare le richieste gratuite ed effettuate tramite ricarica. Sono disponibili sia in modalità grafica (periodo mese e anno), sia con un riepilogo testuale.
La ricevuta digitale di invio contiene tutte le informazioni essenziali relative al telegramma trasmesso. In dettaglio, include:
Questa ricevuta rappresenta un documento ufficiale utile per la tracciabilità, la verifica dell’avvenuto invio e la conservazione a fini amministrativi o legali.
Questi servizi permettono l’invio di corrispondenza internazionale verso numerosi Paesi, in conformità con le modalità e i tempi di consegna previsti da ciascun servizio.
Zona 1 (Europa e Bacino del Mediterraneo)
Zona 2 (Altri paesi dell’Africa, Americhe, Altri paesi dell’Asia)
Zona 3 (Oceania)
Sì, la ricevuta di ritorno (A/R) è obbligatoria per la validità della notifica di un atto giudiziario. Serve come prova legale dell’avvenuta consegna. Può essere scelta in formato cartaceo o digitale (AR DIGITALE). In entrambi i casi, i dati del mittente devono corrispondere esattamente a quelli indicati per la ricezione della ricevuta.
L’AR DIGITALE è un’alternativa elettronica alla ricevuta cartacea. Viene inviata via PEC al mittente subito dopo la consegna dell’atto giudiziario, garantendo un recapito in tempo reale. Il download del documento in formato PDF, firmato digitalmente e marcato temporalmente, può essere effettuato tramite l’endpoint: GET /atti_giudiziari/{id}/destinatari/{IdDestinatario}/ardigitale
Attenzione: è necessario usare l’ID del destinatario, non quello della richiesta.
La raccomandata giudiziaria consente di inserire campi facoltativi come:
Inoltre, è possibile personalizzare la copertina con logo, dati aziendali o contenuti promozionali, utilizzando le API o il Playground con anteprima.
Il servizio include anche tracciamento, documento di accettazione e archiviazione digitale certificata (disponibile per 2 mesi), tutto conforme alla normativa vigente.
Sì, l'invio online degli atti giudiziari tramite le API di Openapi è pienamente conforme alla normativa vigente e ha la stessa validità legale dell'invio effettuato presso uno sportello fisico. La normativa italiana consente infatti la trasmissione telematica degli atti giudiziari a condizione che siano rispettati requisiti specifici:
Le API di Openapi, rispettano rigorosamente questi standard, rendendo il processo completamente tracciabile, certificato e legalmente valido in ambito giudiziario.