Prévisualiser une lettre

Prévisualisation d'une lettre, en prévision d'un potentiel envoi ultérieur.

Cette méthode utilise les mêmes paramètres d'entrée que l'envoi immédiat et pour cette raison nous n'allons pas les redétailler ici. La différence dans le cas de la prévisualisation, est que votre courrier ne sera pas produit tant que vous n'aurez pas dans un deuxième temps appelé la méthode de validation, en précisant son UID (qui vous est fourni dans la réponse à la preview). Une fois la validation effectuée, votre courrier sera pris en compte par notre chaîne de production exactement comme dans le cas de l'envoi immédiat. Si vous ne validez jamais un courrier prévisualisé, il sera simplement ignoré par nos services.

La prévisualisation comporte des avantages :

• connaître le prix du courrier avant de le soumettre définitivement à notre chaîne de production
  En effet : l'envoi direct renvoie également le prix, mais votre courrier est déjà parti en production. Ici vous pouvez prendre votre temps et valider quand vous voulez.
• prévisualiser le courrier avant son envoi
  Lorsque vous effectuez une demande de prévisualisation, la réponse de l'API contient l'url vers votre document PDF final hébergé dans le cloud par nos services.

🎯 Au-delà de la consultation du prix, en quoi cette prévisualisation du document final peut être cruciale ?

Dans la description de l'envoi immédiat nous avons vu qu'il était possible d'apposer l'adresse destinataire (voire également expéditeur) sur la première page de votre document. En fonction de la taille d'enveloppe retenue, cet emplacement peut varier. Cette phase de prévisualisation vous permet donc d'être en maîtrise sur l'aspect final de votre lettre, en particulier pour vous assurer que cette incrustation d'adresse ne vient pas en surimpression d'informations contenues dans votre document d'origine.

Par ailleurs, si vous optez pour l'usage de variables, la prévisualisation sera également le moyen pour vous de contrôler l'aspect final de votre document une fois les champs de fusion appliqués à votre modèle.

Pour effectuer une prévisualisation, rien de plus simple : il vous suffit de récupérer dans la réponse provenant de notre API l'url vers le fichier PDF de prévisualisation :

"fichier_previsualisation" : {
"format":"pdf",
"url":"https://sandbox-example-file.servicepostal.com/c456984a48ed710f6a62dcb78dd65e89\_01-01-2666.pdf"
}

Dans un premier temps, vous pouvez coller ce lien dans un navigateur pour visualiser l'aspect final de votre courrier. Par la suite, et si vous souhaitez aller un cran plus loin en termes d'intégration, rien ne vous empêche d'exploiter cette url dans votre propre outil métier, pour que vos utilisateurs puissent visualiser le fichier, puis le valider dans un deuxième temps en tout sérénité.

Plus globalement, la méthode de prévisualisation est intéressante pour les nouveaux venus sur notre API car elle permet de se familiariser avec les paramètres d'entrée, comprendre leur impact en termes de présentation et gagner en confiance avant la mise en production.