Courrier Prioritaire
€0.00 + TVA
Envoyez des documents dans tout le pays de manière économique, rapide et avec confirmation de livraison via l'API de Poste Italiane.
Le service Posta 1, c’est-à-dire courrier prioritaire, permet de envoyer des communications à bas coût avec la possibilité de vérifier l'état de la livraison. Tout via API.
Avec le courrier prioritaire, il est possible d'envoyer des lettres et des documents à un ou plusieurs destinataires (sans limites), aussi bien des particuliers que des entreprises et des boîtes postales, le tout avec un seul envoi.
ENVOI POSTA 1
DEMANDE D'ENVOI POSTA 1
POST /prioritarie/
Pour envoyer un courrier prioritaire, il est nécessaire d'utiliser l'endpoint POST /prioritarie/ et de fournir des informations telles que :
- Nom et adresse de l'expéditeur
- Nom et adresse du destinataire
- Texte
{
"data": {
"mittente": {
"nome": "Paolo",
"cognome": "De Carolis",
"dug": "piazza",
"indirizzo": "cavour",
"civico": "43",
"comune": "roma",
"cap": "00121",
"provincia": "rm",
"nazione": "IT",
"email": "mittente@gmail.com",
},
"destinatari": [
{
"nome": "string",
"cognome": "string",
"dug": "string",
"indirizzo": "string",
"civico": "string",
"comune": "string",
"cap": "string",
"provincia": "string",
"nazione": "string",
"id": "664228bbbf1239901b0815f2",
"state": "NEW"
}
],
"documento": [
"Example document"
],
"opzioni": {
"fronteretro": false,
"colori": false,
"autoconfirm": false,
}
}Au moment de la demande, il est également possible de sélectionner une série d'options:
- Recto / verso
- Couleurs
- Programmer l'envoi (timestamp_invio)
- Réception de l'envoi
Il est également possible de configurer la confirmation automatique (autoconfirm) et ainsi d'envoyer automatiquement l'envoi (si la valeur est égale à "true"). Dans ce cas, les frais d'envoi seront immédiatement débités et l'envoi planifié.
Si, en revanche, vous souhaitez vérifier les données de l'envoi et les coûts associés avant l'envoi, autoconfirm devra être défini sur "false".
RÉPONSE ENVOI DE COURRIER 1
POST /prioritarie/
La réponse inclura toutes les informations concernant l'expéditeur, le destinataire et le message, ainsi que des informations détaillées sur les coûts et l'ID nécessaire pour la confirmation de l'envoi.
{
"data": {
"expediteur": {
"prenom": "Paolo",
"nom": "De Carolis",
"rue": "piazza",
"adresse": "cavour",
"numero": "43",
"ville": "roma",
"code_postal": "00121",
"province": "rm",
"pays": "IT",
"email": "expediteur@gmail.com",
},
"destinataires": [
{
"prenom": "string",
"nom": "string",
"rue": "string",
"adresse": "string",
"numero": "string",
"ville": "string",
"code_postal": "string",
"province": "string",
"pays": "string",
"id": "664228bbbf1239901b0815f2",
"etat": "NEW"
}
],
"document": [
"Exemple de document"
],
"options": {
"recto_verso": false,
"couleur": false,
"confirmation_automatique": false,
"timestamp_envoi": 1627659712
},
},
"produit": "standard",,
"creation_timestamp": 1627659712,
"update_timestamp": 1627659712,
"username": "john.doe@openapi.it",,
"confirme": true,,
"etat": "CONFIRME",
"document_valide": {
"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": {
"details": [
{
"code_service": "pages",
"description_service": "Tarif postal par page",
"taux_tva": 0,
"quantite": 2,
"montant_unitaire_total": 3.44,
"montant_unitaire_net": 3.44,
"montant_unitaire_tva": 0
},
{
"code_service": "IMPRESSION",
"description_service": "Coût d'impression",
"taux_tva": 0,
"quantite": 2,
"montant_unitaire_total": 0.1,
"montant_unitaire_net": 0.1,
"montant_unitaire_tva": 0
},
{
"code_service": "ENVELOPPE",
"description_service": "Enveloppement",
"taux_tva": 0,
"quantite": 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
},
"lock": false,
"confirmed_timestamp": 1724754216,
"id": "66cda9285673a1b85f092f03"
}
],
"success": true,
"message": "",
"error": null
}Confirmation de l'envoi
PATCH /prioritarie/
Pour confirmer l'envoi du courrier prioritaire, vous devrez faire une deuxième demande en utilisant la méthode PATCH et passer l'ID de la demande effectuée précédemment.
La réponse inclura toutes les données du courrier prioritaire avec le statut "confirmé".
Le nombre de pages pour le courrier prioritaire peut varier de 1 à 100. Au-delà de la 50e page, l'impression sera automatiquement recto-verso. Les prix indiqués concernent uniquement les tranches tarifaires les plus couramment utilisées. Lors de l'envoi via le point de terminaison POST /prioritarie/, vous pouvez obtenir le coût de chaque envoi avant facturation, en fonction du nombre de pages et des options sélectionnées.
Délais de livraison pour le courrier prioritaire :
- 1 jour ouvrable (hors samedis et jours fériés) après la date d'acceptation pour 80% des envois
- 4 jours ouvrables (hors samedis et jours fériés) après la date d'acceptation pour 98% des envois
Pour les envois en ligne, les délais de traitement ajoutés aux délais de livraison indiqués sont : impression dans un délai d'un jour ouvrable (T+1), si l'envoi est accepté avant 14h du lundi au vendredi, hors jours fériés.
Avez-vous besoin d'aide ?
Vous n'avez pas trouvé la réponse que vous cherchiez?
Remplissez tous les détails, nous vous contacterons dès que possible!
