Lettre Recommandé International

Le service de Lettre Recommandé International permet d'envoyer tout type de document (lettre, facture, etc.) dans tous les pays du monde en quelques secondes et avec un système de suivi.

Il est possible d'envoyer par API des Lettre Recommandé International papier à un ou plusieurs destinataires (sans limite) que ce soit des particuliers ou des entreprises, vers des adresses standard ou des boîtes postales, le tout en un seul envoi.

Le nombre maximum de pages est actuellement de 50, ou 100 si l'option recto-verso est activée. Si un document dépassant 50 pages est téléchargé sans activer l'option recto-verso, le système génère un message d'erreur. Dans ce cas, il est obligatoire de sélectionner l'option recto-verso pour procéder correctement à l'envoi du document. La taille maximale d'un document PDF, après compression, est de 5 Mo pour tous les produits, sauf Posta 4 PRO, Posta Massiva et Raccomandata Smart (ces 3 produits acceptent jusqu'à un maximum de 15 Mo).

Lors de l'envoi via l'endpoint POST /raccomandate/, il est possible d'obtenir, avant la facturation, le coût de chaque envoi, calculé en fonction du nombre de pages, des options choisies et du pays de destination. Les pays de destination sont regroupés en 3 zones :

ENVOI DE COURRIER RECOMMANDÉ INTERNATIONAL

POST /raccomandate/

Pour envoyer un courrier recommandé international, utilisez le même endpoint que pour le service Italien POST /raccomandate/ et fournissez les informations suivantes :

   {
 "expéditeur": {
  "prénom": "string",
  "nom": "string",
  "rue": "string",
  "adresse": "string",
  "numéro": "string",
  "ville": "string",
  "code_postal": "string",
  "région": "string",
  "pays": "string",
},
   "destinataires": [
    - {
      "prénom": "string",
      "nom": "string",
      "adresse": "string",
      "ville": "string",
      "code_postal": "string",
      "région": "ee",
      "pays": "string",
    },
  ],
 - "document": [
    "Texte"
  ],
 - "options": {
    "recto_verso": false,
    "couleur": false,
    "confirmation_automatique": false,}
}

Lors de la demande, il est également possible de sélectionner un certain nombre d'options :

Dans ce cas, les données requises pour le destinataire sont partiellement différentes ; les champs "dug" (par exemple, boulevard) et le numéro de maison doivent être directement renseignés dans le champ adresse, et la province sera toujours "ee".

Il est également possible de configurer la confirmation automatique (autoconfirm) pour envoyer automatiquement l'expédition (si la valeur est "true"). Dans ce cas, le coût d'expédition sera immédiatement facturé et l'envoi sera planifié.

Si, cependant, vous souhaitez vérifier les détails de l'expédition et les coûts associés avant l'envoi, autoconfirm doit être réglé sur false. Dans la réponse à la demande POST, vous aurez accès à une série d'informations telles que l'ID (nécessaire pour la confirmation d'envoi) et les coûts d'expédition.

RÉPONSE ENVOI RECOMMANDÉ INTERNATIONAL

POST /raccomandate/

La réponse contiendra toutes les informations concernant l'expéditeur, le destinataire et le message, ainsi que des informations détaillées sur les coûts.

   {
"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": [
    "Texte"
  ],
 - "opzioni": {
    "fronteretro": false,
    "colori": false,
    "autoconfirm": false,
    "ar": true,
    "timestamp_invio": 1627649809,
},
      "prodotto": "courrier recommandé international",
      "creation_timestamp": 1627649809,
      "update_timestamp": 1627649810,
      "username": "john.doe@openapi.it",
      "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": "ReturnReceipt",
            "descrizione_servizio": "Reçu de retour",
            "percentuale_iva": 0,
            "quantita": 2,
            "importo_unitario_totale": 0.8,
            "importo_unitario_netto": 0.8,
            "importo_unitario_iva": 0
          },
          {
            "codice_servizio": "pages",
            "descrizione_servizio": "Tarif postal pages",
            "percentuale_iva": 0,
            "quantita": 2,
            "importo_unitario_totale": 3.4,
            "importo_unitario_netto": 3.4,
            "importo_unitario_iva": 0
          },
          {
            "codice_servizio": "PRINT",
            "descrizione_servizio": "Coût d'impression",
            "percentuale_iva": 0,
            "quantita": 2,
            "importo_unitario_totale": 0.1,
            "importo_unitario_netto": 0.1,
            "importo_unitario_iva": 0
          },
          {
            "codice_servizio": "ENVELOPE",
            "descrizione_servizio": "Enveloppe",
            "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"
    }
  ],

CONFIRMATION D'ENVOI

PATCH /raccomandate/

Pour confirmer l'envoi du courrier recommandé international, vous devez faire une deuxième demande en utilisant la méthode PATCH et transmettre l'ID de la demande effectuée précédemment.

La réponse comprendra toutes les données du courrier recommandé international avec le statut "confirmé".

Il est également possible de personnaliser entièrement la couverture de la communication, par exemple en ajoutant un logo, des informations sur l'entreprise ou des promotions. La personnalisation peut se faire via l'API ou via le Playground, qui permet également de visualiser un aperçu avant l'envoi.

Le service Lettre Recommandé International inclut gratuitement l'option d'archivage numérique pendant 12 mois du contenu signé et tamponné numériquement par Poste Italiane. L'archivage numérique conforme à la législation certifie le contenu, ce qui empêche la partie destinataire de le nier en cas de litige juridique.

En raison des différences d'objectifs entre les pays, la Poste italienne ne peut pas définir un objectif de qualité pour les délais de livraison vers les pays étrangers.

NOTE : Les prix lors de l'achat via l'API sont davantage détaillés entre le tarif postal, l'impression et l'enveloppe. Le code de suivi est fourni de manière synchrone dans les secondes suivant la confirmation de l'envoi.