Raccomandata Internazionale

Il servizio di Raccomandata Internazionale consente di inviare qualsiasi tipo di documento (lettera, fattura, ecc.) in qualsiasi Paese del Mondo in pochi secondi e con sistema di tracciamento.

E' possibile inviare tramite API raccomandate cartacee a uno o più destinatari (non ci sono limiti) sia privati sia aziende, verso indirizzi standard o caselle postali, tutte con un unico invio.

Il numero massimo di pagine è attualmente 50, o 100 se si utilizza l'opzione fronteretro. 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. La dimensione massima di un documento PDF, dopo la nostra compressione, è di 5 MB per tutti i prodotti ad eccezione di Posta 4 PRO, Posta Massiva e Raccomandata Smart (questi 3 prodotti accettano fino a un massimo di 15 MB).

In fase di invio con l'endpoint POST /raccomandate/ sarà possibile ottenere, prima dell'addebito, il costo di ciascuna spedizione che è calcolato in base al numero alle pagine, delle opzioni scelte e al paese di destinazione. I paesi di destinazione sono raggruppati in 3 zone:

RICHIESTA INVIO RACCOMANDATA INTERNAZIONALE

POST /raccomandate/

Per inviare una raccomandata internazionale è necessario utilizzare lo stesso endpoint del servizio Italia POST /raccomandate/ e passare informazioni quali:

   {
 "mittente": {
  "nome": "string",
  "cognome": "string",
  "dug": "string",
  "indirizzo": "string",
  "civico": "string",
  "comune": "string",
  "cap": "string",
  "provincia": "string",
  "nazione": "string",
},
   "destinatari": [
    - {
      "nome": "string",
      "cognome": "string",
      "indirizzo": "string",
      "comune": "string",
      "cap": "string",
      "provincia": "ee",
      "nazione": "string",
    },
  ],
 - "documento": [
    "Testo"
  ],
 - "opzioni": {
    "fronteretro": false,
    "colori": false,
    "autoconfirm": false,}
}

In fase di richiesta è possibile selezionare anche una serie di opzioni:

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"

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. Nella risposta alla richiesta in POST si potrà accedere ad una serie di informazioni come id (necessario per la conferma di invio) ed i costi della spedizione.

RISPOSTA INVIO RACCOMANDATA INTERNAZIONALE

POST /raccomandate/

La risposta riporterà tutte le informazioni riguardanti il mittente, il destinatario e il messaggio più le informazioni dettagliate sui costi.

   {
"mittente": {
  "nome": "string",
  "cognome": "string",
  "dug": "string",
  "indirizzo": "string",
  "civico": "string",
  "comune": "string",
  "cap": "string",
  "provincia": "string",
  "nazione": "string",
},
   "destinatari": [
    - {
      "nome": "string",
      "cognome": "string",
      "dug": "string",
      "indirizzo": "string",
      "civico": "string",
      "comune": "string",
      "cap": "string",
      "provincia": "string",
      "nazione": "string",
    },
  ],
 - "documento": [
    "Testo"
  ],
 - "opzioni": {
    "fronteretro": false,
    "colori": false,
    "autoconfirm": false,
    "ar": true,
    "timestamp_invio": 1627649809,
},
      "prodotto": "raccomandata estero",
      "creation_timestamp": 1627649809,
      "update_timestamp": 1627649810,
      "username": "[email protected]",
      "confirmed": true,
      "state": "CONFIRMED",
      "documento_validato": {
        "pdf": "https://ws.ufficiopostale.com/Up/pdf/f7294e76871965ea206d560d77ff079e.pdf",
        "jpg": "https://ws.ufficiopostale.com/Up/jpg/f7294e76871965ea206d560d77ff079e.jpg",
        "pagine": 1,
        "size": 9350
      },
      "pricing": {
        "dettaglio": [
          {
            "codice_servizio": "RicevutaRitorno",
            "descrizione_servizio": "Ricevuta di Ritorno",
            "percentuale_iva": 0,
            "quantita": 2,
            "importo_unitario_totale": 0.8,
            "importo_unitario_netto": >0.8,0
          },
          {
            "codice_servizio": "pagine",
            "descrizione_servizio": "Tariffa Postale pagine",
            "percentuale_iva": 0,
            "quantita": 2,
            "importo_unitario_totale": 3.4,
            "importo_unitario_netto": 3.4,
            "importo_unitario_iva": 0
          },
          {
            "codice_servizio": "STAMPA",
            "descrizione_servizio": "Costo Stampa",
            "percentuale_iva": >0,
            "quantita": 2,
            "importo_unitario_totale": 0.1,
            "importo_unitario_netto": 0.1,
            "importo_unitario_iva": 0
          },
          {
            "codice_servizio": "IMBUST",
            "descrizione_servizio": "Imbustamento",
            "percentuale_iva": 0,
            "quantita": 2,
            "importo_unitario_totale": 0,
            "importo_unitario_netto": 0,
            "importo_unitario_iva": 0
          }
        ],
        "totale": {
          "importo_totale_netto": 8.6,
          "importo_totale_iva": 0,
          "importo_totale": 8.6
        }
      },
      "lock": false,
      "confirmed_timestamp": 1627649810,
      "id": "6103f712dd2507415c5db6d0"
    }
  ],

CONFERMARE INVIO

PATCH /raccomandate/

Per procedere a conferma dell'invio della Raccomandata Internazionale sarà necessario effettuare una seconda richiesta con il metodo PATCHe passare l'id della richiesta precedentemente effettuata.

La risposta riporterà tutti i dati della Raccomandata Internazionale con lo stato "confermato"

E' inoltre possibile personalizzare interamente anche la copertina della comunicazione inserendo ad esempio logo ed informazioni aziendali o promozioni. La customizzazione può avvenire tramite API o tramite Playground che consente anche di visualizzare un'anteprima prima della spedizione.

Il servizio Raccomandata Internazionale include gratuitamente l'opzione archiviazione digitale per 12 mesi del contenuto firmato e marcato digitalmente da Poste Italiane. L'archiviazione digitale a norma di legge certifica il contenuto che non può essere disconosciuto dalla controparte in eventuale controversia legale.

Data la diversità degli obiettivi esistenti fra Paese e Paese, Poste Italiane non può stabilire un obiettivo di qualità per i tempi di consegna verso l’estero.

NOTA BENE: I prezzi in fase di acquisto tramite API vengono ulteriormente dettagliati tra tariffa postale, stampa, imbustamento. Il codice di tracciamento arriva in modo sincrono entro pochi secondi dalla conferma di invio.