Postapriority International

Le service Postapriority International, c'est-à-dire le courrier prioritaire international, permet d'envoyer des communications à faible coût avec la possibilité de vérifier l'état de la livraison. Tout cela via l'API.

Avec Postapriority International, il est possible d'envoyer des lettres et des documents à un ou plusieurs destinataires (sans limite), qu'il s'agisse de particuliers, d'entreprises ou de boîtes postales, tout avec un seul envoi.

ENVOI POSTAPRIORITY INTERNATIONAL

POST /prioritarie/

Pour envoyer une Postapriority International, il est nécessaire d'utiliser le même point de terminaison que pour le service Postapriority Italia POST /prioritarie/ et de fournir des informations telles que :

   {
  "data": {
    "expéditeur": {
      "nom": "Paolo",
      "prénom": "De Carolis",
      "rue": "piazza",
      "adresse": "cavour",
      "numéro": "43",
      "ville": "roma",
      "code_postal": "00121",
      "province": "rm",
      "pays": "IT",
      "email": "expéditeur@gmail.com",
    },
   "destinataires": [
    {
      "nom": "string",
      "prénom": "string",
      "adresse": "string",
      "ville": "string",
      "province": "ee",
      "pays": "string",
      "id": "664228bbbf1239901b0815f2",
      "statut": "NOUVEAU"
    }
  ],
 "document": [
     "Exemple de document"
    ],
 "options": {
    "recto_verso": false,  
    "couleurs": false,
    "confirmation_automatique": false,    
  }
}

Dans ce cas, les données demandées pour le destinataire sont partiellement différentes ; les champs rue (par exemple, viale) et numéro doivent être directement saisis dans le champ adresse et la province sera toujours "ee".

Lors de la demande, vous pouvez également sélectionner un certain nombre d'options :

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

Si vous souhaitez vérifier les données de l'expédition et les coûts associés avant l'envoi, confirmation_automatique doit être défini sur false.

RÉPONSE POST PRIORITAIRE INTERNATIONALE

POST /prioritarie/

La réponse contiendra toutes les informations concernant l'expéditeur, le destinataire et le message, ainsi que les informations détaillées sur les coûts et l'ID nécessaire pour la confirmation d'envoi.

   {
  "data": {
    "expéditeur": {
      "prénom": "Paolo",
      "nom": "De Carolis",
      "dug": "piazza",
      "adresse": "cavour",
      "numéro": "43",
      "ville": "roma",
      "code_postal": "00121",
      "province": "rm",
      "pays": "IT",
      "email": "mittente@gmail.com",
    },
   "destinataires": [
    {
      "prénom": "string",
      "nom": "string",
      "adresse": "string",
      "ville": "string",
      "code_postal": "string",
      "province": "ee",
      "pays": "string",
      "id": "664228bbbf1239901b0815f2",
      "état": "NEW"
    }
  ],
 "document": [
     "Exemple de document"
    ],
 "options": {
    "recto-verso": false,  
    "couleurs": false,
    "confirmation_automatique": false,
    "timestamp_envoi": 1627659712    
  },
},
"produit": "prioritaire international",,
   "timestamp_creation": 1627659712,
   "timestamp_mise_à_jour": 1627659712,
   "nom_utilisateur": "john.doe@openapi.it",,
   "confirmé": true,,
   "état": "CONFIRMÉ",
   "document_validé": {
     "pdf": "https://ws.ufficiopostale.com/Up/pdf/test-document.pdf",
     "jpg": "https://ws.ufficiopostale.com/Up/jpg/test-document.jpg",
     "mots": 1,
      "taille": 9350
   },
   "tarification": {
     "détails": [
       {
         "code_service": "pages",
         "description_service": "Tarif postal pages",
         "pourcentage_tva": 0,
         "quantité": 2,
         "montant_unitaire_total": 3.44,
         "montant_unitaire_net": 3.44,
         "montant_unitaire_tva": 0
       },
       {
         "code_service": "IMPRESSION",
         "description_service": "Coût d'impression",
         "pourcentage_tva": 0,
         "quantité": 2,
         "montant_unitaire_total": 0.1,
         "montant_unitaire_net": 0.1,
         "montant_unitaire_tva": 0
       },
       {
         "code_service": "ENVELOP",
         "description_service": "Mise sous pli",
         "pourcentage_tva": 0,
         "quantité": 2,
         "montant_unitaire_total": 0,
         "montant_unitaire_net": 0,
         "montant_unitaire_tva": 0
       }
     ],
     "total": {
       "montant_total_net":  8.6,
       "montant_total_tva": 0,
       "montant_total":  8.6
     },
   "verrouillage": false,
   "timestamp_confirmation": 1724754216,
   "id": "66cda9285673a1b85f092f03"
 }
],
"succès": true,
"message": "",
"erreur": null
}

CONFIRMATION D'ENVOI

PATCH /prioritarie/

Pour confirmer l'envoi du courrier Postapriority International, une deuxième demande avec la méthode PATCH est requise, et l'ID de la demande précédente doit être fourni.

La réponse comprendra toutes les données du courrier Postapriority International avec le statut "confirmé"

Le nombre de pages pour le courrier Postapriority International peut varier entre 1 et 100. Au-delà de la 50e page, le type d'impression sera automatiquement recto-verso. Les prix indiqués ne concernent que les tranches de prix les plus couramment utilisées. Lors de l'envoi avec le point de terminaison POST /prioritarie/, il sera possible d'obtenir le coût de chaque envoi avant facturation, calculé en fonction du nombre de pages et des options sélectionnées.

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

Les délais de livraison pour le courrier prioritaire international dépendent du pays de destination et sont les suivants :

Pour les envois en ligne, les délais de livraison indiqués sont prolongés par les délais de traitement suivants : impression en un jour ouvrable (T+1), si l'envoi est accepté avant 14h00 du lundi au vendredi, hors jours fériés.