This web service allows the delivery of postal products like Raccomandate, Telegrammi, Posta Prioritaria through Poste Italiane
Array of objects[ items ] | |
success | boolean |
message | string |
error | any |
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/raccomandate/"); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN"); curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers); CURLcode ret = curl_easy_perform(hnd);
{- "data": [
- {
- "mittente": {
- "nome": "Alberto",
- "cognome": "Venanzoni",
- "email": "john.doe@openapi.it"
}, - "creation_timestamp": 1608040424,
- "update_timestamp": 1608040424,
- "confirmed": false,
- "state": "NEW",
- "id": "5fd8bfeaa10b340e2e558db7"
}
], - "message": "1 Risultati",
- "success": true,
- "error": null
}
Send a Raccomandata. You should provide information about the sender and the receiver(s) in the post body. Additionally, the "autoconfirm" parameter can be set to false to save the Raccomandata for a later confirmation with a PATCH request, while you do custom logic with the response. Check the NumeroRaccomandata field in the recipient object if you need the tracking number
object | |
object | |
Array of objects <= 2 items [ items ] | |
Array of strings or string (documento) The document can either be a string or an array of strings in plain text.
The maximum size for a PDF document, after our compression, is 5 MB for every products execept Posta 4 PRO. |
object | |
object | |
Array of objects[ items ] | |
Array of strings or string (documento) The document can either be a string or an array of strings in plain text.
The maximum size for a PDF document, after our compression, is 5 MB for every products execept Posta 4 PRO. | |
object (documento_validato) The output of the document generation process. |
{- "mittente": {
- "titolo": "mr",
- "nome": "Simone",
- "cognome": "Desantis",
- "dug": "SST",
- "indirizzo": "Valnerina",
- "civico": "1",
- "comune": "montefranco",
- "cap": "05030",
- "provincia": "tr",
- "nazione": "Italia",
- "email": "john.doe@openapi.it"
}, - "destinatari": [
- {
- "nome": "Simone",
- "cognome": "Desantis",
- "co": "Altravia Servizi SRL",
- "dug": "via",
- "indirizzo": "G.RINALDI",
- "civico": "6",
- "comune": "Reggio nell'Emilia",
- "cap": "42124",
- "provincia": "RE",
- "nazione": "Italia"
}, - {
- "nome": "Simone",
- "cognome": "Desantis",
- "co": "Altravia Servizi SRL",
- "dug": "piazza",
- "indirizzo": "San Giovanni Decollato",
- "civico": "6",
- "comune": "Terni",
- "cap": "05100",
- "provincia": "TR",
- "nazione": "Italia"
}
], - "documento": [
- "Example document"
], - "opzioni": {
- "fronteretro": false,
- "colori": false,
- "ar": true,
- "autoconfirm": true
}
}
{- "data": [
- {
- "mittente": {
- "titolo": "mr",
- "nome": "Simone",
- "cognome": "Desantis",
- "dug": "SST",
- "indirizzo": "Valnerina",
- "civico": "1",
- "comune": "montefranco",
- "cap": "05030",
- "provincia": "tr",
- "nazione": "IT",
- "email": "john.doe@openapi.it"
}, - "destinatari": [
- {
- "nome": "Simone",
- "cognome": "Desantis",
- "co": "Altravia Servizi SRL",
- "dug": "via",
- "indirizzo": "G.RINALDI",
- "civico": "6",
- "comune": "reggio nell'emilia",
- "cap": "42124",
- "provincia": "RE",
- "nazione": "IT",
- "id": "6103f711dd2507415c5db6ce",
- "state": "NEW"
}, - {
- "nome": "Simone",
- "cognome": "Desantis",
- "co": "Altravia Servizi SRL",
- "dug": "piazza",
- "indirizzo": "San Giovanni Decollato",
- "civico": "6",
- "comune": "terni",
- "cap": "05100",
- "provincia": "TR",
- "nazione": "IT",
- "id": "6103f711dd2507415c5db6cf",
- "state": "NEW"
}
], - "documento": [
- "Example document"
], - "opzioni": {
- "fronteretro": false,
- "colori": false,
- "ar": {
- "titolo": "mr",
- "nome": "Simone",
- "cognome": "Desantis",
- "dug": "SST",
- "indirizzo": "Valnerina",
- "civico": "1",
- "comune": "montefranco",
- "cap": "05030",
- "provincia": "tr",
- "nazione": "IT",
- "email": "john.doe@openapi.it"
}, - "autoconfirm": true,
- "timestamp_invio": 1627649810
}, - "prodotto": "raccomandata",
- "creation_timestamp": 1627649809,
- "update_timestamp": 1627649810,
- "username": "john.doe@openapi.it",
- "confirmed": true,
- "state": "CONFIRMED",
- "documento_validato": {
- "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,
- "importo_unitario_iva": 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