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. Tutto tramite API.

Grazie a questo servizio è possibile inviare 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 di pagine per la Raccomandata Internazionale può essere compreso tra 1 e 100. Oltre le 50 pagine deve essere necessariamente impostata la funzione fronte / retro.

I prezzi a lato riguardano solo le fasce di prezzo più utilizzate. In fase di invio con l'endpoint POST /raccomandate/ sarà possibile ottenere, prima dell'addebito, il costo di ciascuna spedizione, calcolato in base al numero alle pagine, delle opzioni scelte e al paese di destinazione. I paesi di destinazione sono raggruppati in 3 zone:

• Zona 1: EUROPA E BACINO DEL MEDITERRANEO
• Zona 2: ALTRI PAESI DELL’AFRICA, AMERICHE, ALTRI PAESI DELL’ASIA
• Zona 3: OCEANIA

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:

• nome ed indirizzo del mittente
• nome ed indirizzo del destinatario (numero civico opzionale)
• testo o allegato del documento (url, html, testo semplice)

   {
 "mittente": {
  "titolo": "mr",  
  "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",
      "civico": "string",
      "comune": "string",
      "cap": "string",
      "provincia": "ee",
      "nazione": "string",
    },
  ],
 - "documento": [
    "Testo"
  ],
 - "opzioni": {
    "fronteretro": false,
    "colori": false,
    "autoconfirm": false,}
}

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

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

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".

Inoltre è possibile 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'. Nella risposta alla richiesta in POST si potrà accedere ad una serie di informazioni come l'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"
    }
  ],

CONFERMA INVIO RACCOMANDATA INTERNAZIONALE

PATCH /raccomandate/

Per procedere alla conferma dell'invio della Raccomandata Internazionale 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 Raccomandata Internazionale con lo stato "confermato".

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.