Téléverser du Courrier via SFTP

L’échange de fichiers SFTP permet d’automatiser les téléversements de gros volumes. Il est généralement géré par un Mailhouse ou un Print Service Provider au nom d’un expéditeur. Consultez Téléverser du Courrier pour la méthode manuelle dans la console, et la Spécification de l’interface Payreq pour situer SFTP parmi les méthodes d’intégration disponibles.

À qui s’adresse-t-il

Ce document de référence technique s’adresse à l’équipe de développement d’un Mailhouse, d’un Print Service Provider ou d’un expéditeur qui met en place un processus automatisé. Si vous téléversez vos documents dans la console, vous n’avez pas besoin de cet article.

Comment ça marche, en termes généraux

Chaque envoi de Courrier implique l’envoi à Payreq de deux types de fichiers : un fichier Contacts (qui sont vos clients ou employés, afin que les inscriptions puissent être rapprochées) et un fichier Facture ou Paie (les documents eux-mêmes, un index et les PDF). Chaque fichier suit la même structure de base : une ligne d’en-tête identifiant le fichier, les lignes de données et une ligne de fin confirmant le nombre de lignes de données.

Le processus de transmission :

1. Votre système, ou celui de votre prestataire, téléverse le fichier sur le serveur SFTP de Payreq.
2. Payreq récupère et traite le fichier.
3. Payreq place un fichier d’accusé de réception dans votre emplacement SFTP pour confirmer le résultat.
4. Vous ou votre prestataire récupérez cet accusé de réception pour vérifier que le fichier a été traité comme prévu.

L’accès SFTP (clés et détails de connexion) est configuré lors de l’intégration, ainsi qu’un test pour confirmer que tout fonctionne avant de vous y fier pour les fichiers de production.

Après l’arrivée du fichier

Une fois que Payreq récupère un fichier, il est suivi de la même manière qu’un téléversement dans la console, en tant que Tâche. Voir Que sont les tâches? et Comprendre les statuts et les erreurs des tâches si une tâche affiche un état d’erreur au lieu d’être terminée.

Certaines intégrations utilisent également Payreq API avec SFTP. Au lieu d’attendre que Payreq récupère automatiquement un nouveau fichier, votre système peut soumettre une tâche lorsque le fichier est arrivé, puis interroger son statut.

Accusés de réception et notifications par courriel

Le fichier d’accusé de réception est renvoyé par SFTP pour chaque fichier, indépendamment des paramètres de notification. Il indique le résultat du traitement dans un format que votre intégration peut lire automatiquement.

La notification par courriel Un travail a échoué est distincte. Il s’agit d’un paramètre par utilisateur dans la console, qui permet à une personne d’être informée rapidement d’un échec. Elle ne remplace pas l’accusé de réception SFTP, et son activation ou sa désactivation n’a aucun effet sur l’envoi de ce fichier. Consultez Comprendre les statuts et les erreurs des tâches.

Types et versions de fichiers

Les fichiers de Contacts, de factures, externes et de paie ont chacun leur propre format et leur propre version d’interface actuelle. Voir Spécification de l’interface Payreq pour ce résumé.

Obtenir la référence technique complète

Cet aperçu ne reproduit pas la spécification complète du fichier champ par champ (noms de champ exacts, formats et règles de validation pour chaque type d’enregistrement). Payreq fournit les spécifications actuelles et complètes directement aux mailhouses et aux Contacts techniques dans le cadre de l’intégration ou lors de la planification d’un changement d’intégration.

Communiquez avec votre gestionnaire de compte ou le soutien technique Payreq pour obtenir la référence adaptée à votre intégration et des réponses à vos questions de mise en œuvre.

Articles connexes

• Téléverser du Courrier
• Spécification de l’interface Payreq
• Payreq API
• Que sont les tâches?
• Comprendre les statuts et les erreurs des tâches