Comprendre les statuts et les erreurs des tâches

Lorsque vous téléversez un fichier (un lot de Courrier, une mise à jour de Contacts ou similaire) Payreq Delivery le compare à la Spécification de l’interface Payreq avant de le traiter. Si le fichier ne répond pas aux spécifications, la tâche affiche un statut Erreur au lieu de se terminer. Cet article explique ce que cela signifie, les causes courantes et comment corriger et soumettre à nouveau le fichier. Voir Que sont les tâches? pour savoir ce qu’est une tâche en général.

Avant toute chose : assurez-vous que la bonne personne est réellement informée de l’échec d’une tâche. Les erreurs de tâche ne s’affichent nulle part à moins que quelqu’un ne vérifie l’onglet Tâches. Ainsi, si personne n’a activé Un travail a échoué dans ses paramètres de notification, un fichier ayant échoué peut passer inaperçu. Voir « Recevoir une notification lorsqu’une tâche échoue » plus loin dans cet article.

Statuts des tâches

Payreq utilise les quatre statuts suivants :

Qu’est-ce qui cause l’erreur d’une tâche

Un statut d’erreur signifie que la validation du fichier a échoué avant que Payreq ne le traite, ou qu’il s’est arrêté à mi-chemin. Ceci est distinct de Non livrable, qui est un indicateur de révision par document qui peut apparaître après un chargement réussi, lorsqu’un canal de livraison échoue pour un document autrement traité : voir Traiter le Courrier non livrable pour ce scénario. Cet article couvre spécifiquement les erreurs de tâche au niveau du fichier.

La solution générale, dans tous les cas, est la même :

1. Lisez le message d’erreur affiché dans les détails de la tâche.
2. Vérifiez la section appropriée de la Spécification de l’interface Payreq pour le type de fichier concerné (Contacts, Facture, Paie ou Externe).
3. Corrigez le fichier.
4. Donnez au fichier corrigé un nouvel ID de fichier unique : Payreq rejette une nouvelle soumission qui réutilise un ID de fichier précédent.
5. Soumettez à nouveau.

Voir Spécification de l’interface Payreq pour un aperçu de l’interface et comment obtenir le document de spécifications détaillé actuel.

Si vous ne savez pas comment corriger un fichier vous-même, votre mailhouse ou votre Contact technique qui génère le fichier est généralement le mieux placé pour effectuer la correction, car cela implique généralement d’ajuster le processus de génération de fichier plutôt que le fichier individuel.

Premières choses à vérifier

Avant d’examiner un message d’erreur spécifique, voici la plupart des causes :

• Nombre de colonnes. Le défaut le plus courant. Une ligne de Contacts nécessite 19 colonnes, une ligne de facture en nécessite 32 (anciennes versions de l’interface 4.x) ou 50 (5.1.0), une ligne d’élément de ligne en nécessite 14, une ligne de paie en nécessite 11 et une ligne externe en nécessite 3. Les champs facultatifs peuvent être vides, mais la colonne (et sa virgule de délimitation) doit toujours être là.
• Nombre d’enregistrements de fin. Le nombre d’enregistrements indiqué dans la ligne de fin doit correspondre au nombre de lignes de données dans le fichier (à l’exclusion de l’en-tête et de la fin lui-même).
• Unicité de l’ID de fichier. Chaque fichier que vous envoyez nécessite un ID de fichier unique. La réutilisation d’un fichier d’un fichier antérieur – même s’il a échoué – entraîne un rejet.
• Jeu de caractères. Utilisez uniquement des caractères ASCII simples, y compris dans les noms de fichiers. Les caractères accentués n’importe où dans le fichier peuvent interrompre le traitement.
• Version de l’interface. Le numéro de version dans l’en-tête du fichier doit correspondre à ce qui est attendu pour ce type de fichier : les fichiers de Contacts utilisent 4.0.0, les fichiers de factures utilisent 5.1.0 (ou l’ancien 4.5.0), les fichiers externes utilisent 4.0.0 et les fichiers de paie utilisent 4.2.0.

Exemples d’erreurs courantes

Voici des exemples réels de travaux ayant échoué récemment, montrant le type de message d’erreur que vous pourriez voir et comment chacun a été résolu :

Remarque sur la résolution de ces problèmes. Payreq arrête de valider un fichier à la première ligne qui échoue, donc le message d’erreur ne vous informe que d’un problème : il peut y en avoir d’autres plus loin dans le fichier. Vérifiez chaque ligne par rapport aux spécifications avant de soumettre à nouveau, pas seulement celle nommée dans l’erreur.

Si une tâche semble bloquée plutôt qu’erreur

Une tâche peut rester à pending-file sans passer à in-progress. Si le fichier a été soumis par API, cela peut indiquer qu’il n’a pas été trouvé à l’emplacement attendu. Vérifiez que le nom du fichier correspond exactement et attendez quelques minutes : le transfert peut être mis en file d’attente plutôt qu’être immédiat.

Soyez averti lorsqu’une tâche échoue

Par défaut, une tâche n’envoie d’alerte à personne : un statut d’erreur reste simplement dans l’onglet Tâches jusqu’à ce que quelqu’un le regarde. Pour tout ce qui est urgent (une facture, une mise à jour des Contacts avant une date limite), c’est trop lent pour s’y fier.

Assurez-vous qu’au moins un utilisateur approprié (une personne capable de réparer le fichier lui-même ou qui sait à qui le transmettre (votre mailhouse ou votre Contact technique)) a la notification Un travail a échoué activée, idéalement définie sur Immédiatement. Il s’agit d’un paramètre par utilisateur, et non à l’échelle du compte, il vaut donc la peine de vérifier qui l’a réellement activé plutôt que de supposer que quelqu’un le fait.

Voir Notifications de l’utilisateur pour savoir comment configurer cela, et Gestion des utilisateurs dans Payreq Delivery pour accéder aux paramètres de notification d’un utilisateur en premier lieu. Si votre organisation utilise un mailhouse pour générer des fichiers, il est utile de confirmer avec elle qui, de son côté, doit également être informé, afin qu’un échec n’attende pas que quelqu’un de votre côté le remarque avant même qu’il ne soit transmis.

Quand contacter Payreq Support

Si vous avez vérifié le fichier par rapport aux spécifications et que le correctif n’est toujours pas clair, ou si le même fichier continue d’échouer après correction, contactez Payreq Support plutôt que de deviner davantage. Inclure:

• Le message d’erreur complet provenant des détails de la tâche.
• La ligne d’en-tête du fichier.
• Un exemple de ligne de données défaillante (avec toutes les informations personnelles supprimées).

Soumettre un ticket avec ces informations afin que Payreq Support puisse enquêter sans avoir besoin de les demander séparément.

Articles connexes

• Que sont les tâches?
• Spécification de l’interface Payreq
• Téléverser du Courrier
• Traiter le Courrier non livrable
• Notifications de l’utilisateur