Importation de paiements en masse

Importation au format CSV

Des paiements uniques peuvent être créés en masse pour plusieurs clients finaux existants via une importation CSV.

IMPORTANT ! Points à retenir :

Il n’est pas possible d’ajouter de nouveaux clients finaux ou de mettre à jour les informations des clients existants dans le fichier CSV d’importation des paiements. Le chargement générera une erreur.
Le nombre de caractères est limité à 100 par cellule.

Cliquez sur Paiements
Sélectionnez Importer
Cliquez sur Télécharger le modèle
Une fois téléchargé, cliquez sur le lien .csv bleu dans la fenêtre Exporter pour l'ouvrir

Un lien permettant de télécharger l'exportation vous sera également envoyé par e-mail
Saisissez le montant du paiement, la description et les dates de facturation* dans les lignes respectives des clients finaux pour lesquels vous souhaitez créer des paiements (colonnes G, I et J). Remarque : le nombre de caractères est limité à 100 par cellule.
Enregistrez le fichier csv mis à jour
Revenez à votre tableau de bord et cliquez sur Choisir un fichier pour charger votre fichier CSV enregistré
Cliquez sur Importer des paiements

Si des erreurs sont présentes dans le fichier que vous avez chargé, elles seront mises en évidence sur la page Importations. Il vous sera alors demandé de corriger ces erreurs, puis de charger à nouveau le fichier csv.
Une fois le chargement validé, la confirmation s'affichera sur la page Importations.

Ici, vous pourrez confirmer que les paiements que vous avez créés pour chaque client final sont corrects grâce à la section Lignes valides figurant en bas.
Une fois chose faite, cliquez sur Traiter les paiements.

Si vous accédez maintenant à la page de paiement de votre tableau de bord via le menu bleu se trouvant à gauche, ces paiements devraient s'afficher avec un statut de soumission en attente.

* Saisie des dates de facturation

La date de facturation doit être saisie au format AAAA-MM-JJ.

Vous devez saisir une date qui permet un temps de traitement suffisant avant le prélèvement, déterminé par le préavis et les exigences en matière de délai de soumission de paiement du programme de paiement applicable à l'endroit où se trouve votre client final.

Si vous souhaitez prélever le paiement le plus rapidement possible, vous pouvez laisser le champ payment.charge_date (colonne J) vide.

COLONNE	TITRE DE COLONNE	NÉCESSITE UNE SAISIE/ACTION
A	mandate.id	Non
B	customer.id	Non
C	customer.given_name	Non
D	customer.family_name	Non
E	customer.company_name	Non
F	customer.email	Non
G	payment.amount	Oui
H	payment.currency	Non
I	payment.description	Facultatif
J	payment.charge_date	Facultatif
K	payment.metadata.YOUR_CUSTOM_FIELD	Facultatif

Remarque : la colonne K « payment.metadata.YOUR_CUSTOM_FIELD » doit avoir un nom unique.

Gestion des accents dans l'outil de chargement en masse

Si les données de vos clients finaux contiennent des accents ou d'autres caractères spéciaux, des problèmes peuvent survenir lors de l'exécution de nos contrôles automatiques.

En effet, les tableurs comme Excel ne reconnaissent pas par défaut les caractères spéciaux inclus dans le fichier. Lorsque vous enregistrez le fichier et que vous le chargez dans le système, les caractères spéciaux sont corrompus et les données ne correspondent plus. Cela s'explique par le fait qu'Excel ne gère pas correctement ce que l'on appelle le « codage UTF-8 ».

Sous Windows, vous pouvez corriger ce problème à l'aide de l'outil « Importer un fichier texte » d'Excel pour ouvrir le fichier CSV.

Sous Mac, Excel ne peut pas ouvrir les fichiers codés en UTF-8. Dans ce cas, vous devez utiliser un autre tableur (par exemple, Numbers d'Apple) ou modifier prudemment le fichier CSV à l'aide d'un éditeur de texte.

Importation au format XML

GoCardless prend en charge la création de paiements de masse via les fichiers XML PAIN.008 — le format de référence utilisé et exporté par les systèmes ERP et comptables. Cela signifie que vous pouvez commencer à traiter des paiements par prélèvement SEPA immédiatement, en utilisant les fichiers déjà générés par votre système, sans conversion manuelle.

Avant de commencer, assurez-vous que :

Votre organisation a activé le prélèvement SEPA sur votre compte GoCardless
Votre fichier est au format PAIN.008.001.08 ou PAIN.008.001.02 (les autres versions ne sont pas acceptées)
Votre fichier est inférieur à 20 Mo

Fonctionnement :

Cliquez sur Paiements
Sélectionnez Importer
Chargez votre fichier XML PAIN.008.001.08 — GoCardless détecte automatiquement le type de fichier
Vérifiez les paiements sur l'écran de confirmation, y compris les erreurs signalées au niveau de la transaction
Cliquez sur Traiter les paiements lorsque vous êtes prêt.

L'écran de vérification, la gestion des erreurs et les étapes de traitement sont identiques au flux d'importation CSV existant. Si vous maîtrisez l’import CSV, vous savez déjà utiliser l’import XML.

FAQ

La fonction d'importation XML est-elle disponible pour tous les marchands GoCardless ?
Puis-je charger un fichier XML pour créer des paiements par prélèvement SEPA dans le tableau de bord GoCardless ?
Quel format de fichier XML GoCardless prend-il en charge ?
Ai-je besoin d'un modèle pour créer mon fichier XML ?
Dois-je suivre une procédure particulière pour importer un fichier XML plutôt qu’un fichier CSV ?
Quelle est la taille maximale des fichiers que je peux charger ?
J'utilise un système ERP (tel que SAP ou Microsoft Dynamics) qui exporte des fichiers XML PAIN.008. Ces fichiers sont-ils compatibles ?
Que se passe-t-il si un mandat dans mon fichier XML n'existe pas encore dans GoCardless ?
Certaines transactions dans mon fichier ont échoué. Cela signifie-t-il que l'ensemble de mon fichier est rejeté ?
Quelles sont les erreurs qui peuvent entraîner le rejet de l'ensemble de mon fichier XML ?
J'ai chargé un fichier XML, mais je reçois un message d'erreur concernant une mauvaise version. Que dois-je faire ?
Comment puis-je savoir si mon importation a été traitée comme un fichier CSV ou XML ?

Pour commencer et éligibilité

La fonction d'importation XML est-elle disponible pour tous les marchands GoCardless ?

Les importations XML sont disponibles pour les marchands qui ont activé le prélèvement SEPA sur leur compte GoCardless. Si vous n'avez pas encore accès aux importations XML, veuillez contacter votre gestionnaire de compte ou notre équipe d'assistance et nous vous aiderons à les mettre en place.

Puis-je charger un fichier XML pour créer des paiements par prélèvement SEPA dans le tableau de bord GoCardless ?

Absolument. Si le programme SEPA de votre organisation est activé, vous pouvez charger un fichier XML PAIN.008.001.08 directement via le tableau de bord, sans conversion nécessaire. Il s’agit du même fichier que celui généré par votre ERP ou logiciel comptable pour la soumission bancaire, ce qui vous permet de commencer à traiter les paiements immédiatement.

Quel format de fichier XML GoCardless prend-il en charge ?

GoCardless prend en charge le format PAIN.008.001.08, qui correspond au standard ISO 20022 pour l’initiation des prélèvements SEPA. Si vous essayez de charger une version plus ancienne (telle que PAIN.008.001.02), un message d’erreur vous signalera que seule la version 001.08 est autorisée.

Chargement de votre fichier

Ai-je besoin d'un modèle pour créer mon fichier XML ?

Aucun modèle n'est nécessaire. Contrairement aux importations CSV, votre fichier XML doit être exporté directement depuis votre système ERP ou logiciel comptable (tel que SAP, Microsoft Dynamics ou Sage) au format PAIN.008.001.08. GoCardless interprète ce fichier tel qu’il est fourni  ; aucune information supplémentaire ni aucun reformatage préalable n’est requis.

Dois-je suivre une procédure particulière pour charger un fichier XML plutôt qu’un fichier CSV ?

Non, le parcours est identique. GoCardless identifie automatiquement les fichiers XML et CSV, sans que vous ayez à changer de paramètres ou de flux de travail. L'écran de vérification, la remontée des erreurs et les étapes de traitement sont identiques dans les deux cas.

Quelle est la taille maximale des fichiers que je peux charger ?

La taille du fichier est limitée à 20 Mo, soit la même que celle qui s'applique aux importations CSV. Pour la majorité des marchands, cela suffit largement pour traiter des dizaines de milliers de transactions par fichier.

Mandats et clients finaux

J'utilise un système ERP (tel que SAP ou Microsoft Dynamics) qui exporte des fichiers XML PAIN.008. Ces fichiers sont-ils compatibles ?

Oui, c’est précisément l’objectif de cette fonctionnalité. GoCardless extrait la référence unique de mandat, désignée par « MndtId », à partir de votre fichier XML ; il s’agit de la même référence que celle utilisée en interne par votre système ERP. Il est inutile de remplacer ces références par des identifiants propres à GoCardless.

Que se passe-t-il si un mandat dans mon fichier XML n'existe pas encore dans GoCardless ?

Dans le cadre de la procédure d'intégration à GoCardless, nous recommandons de migrer vos clients et mandats existants dans votre compte afin d’assurer un traitement optimal de vos fichiers XML dès le départ. Si une référence unique de mandat dans votre fichier ne correspond à aucun mandat existant dans GoCardless — par exemple si ce mandat n’a pas été inclus dans votre migration initiale — GoCardless migrera automatiquement le mandat en utilisant les informations présentes dans votre fichier XML. Cette migration garantit que les mandats déjà mis en place avec vos clients finaux peuvent être utilisés pour créer des paiements via GoCardless. Ce mécanisme constitue une mesure de sécurité destinée à éviter toute omission de paiement. Toutefois, il ne doit pas se substituer à une migration complète des clients lors de l’intégration. En effet, des décalages entre le moment où vous créez les paiements et celui où les mandats deviennent actifs peuvent affecter votre traitement.

Erreurs et dépannage

Certaines transactions dans mon fichier ont échoué. Cela signifie-t-il que l'ensemble de mon fichier est rejeté ?

Pas forcément. Il existe une différence entre les erreurs au niveau du fichier et les erreurs au niveau des transactions :

Les erreurs au niveau du fichier (telles qu'une version XML non prise en charge ou un fichier corrompu) entraîneront le rejet de l'intégralité du chargement. La raison sera clairement indiquée sur la page détaillant l’import.
Les erreurs au niveau d'une transaction (telles qu'un numéro de compte bancaire non valide pour un paiement spécifique) concernent uniquement la transaction en question. Le reste de vos paiements sera traité normalement, et vous pourrez télécharger un rapport d’erreurs au format CSV pour voir précisément quelles transactions nécessitent votre attention et pour quelle raison.

Quelles sont les erreurs qui peuvent entraîner le rejet de l'ensemble de mon fichier XML ?

Votre fichier sera rejeté dans les situations suivantes :

Il utilise une version de PAIN.008 non prise en charge (PAIN.008.001.08 et PAIN.008.001.02 sont acceptées)
Il ne s'agit pas d'un document XML valide ou analysable
Il n'est pas conforme aux exigences de validation structurelle de la norme PAIN.008.001.08/PAIN.008.001.02
Il contient un type de paiement autre que le prélèvement SEPA Core (le prélèvement B2B n’est pas pris en charge)
Le nombre de transactions ou le montant total figurant dans l'en-tête du fichier ne correspond pas au contenu réel
Le même fichier a déjà été importé (GoCardless détecte les doublons en utilisant l'identifiant de message unique du fichier)

Dans chaque cas, un message d’erreur détaillé s'affichera pour expliquer la cause du problème.

J'ai chargé un fichier XML, mais je reçois un message d'erreur concernant une mauvaise version. Que dois-je faire ?

GoCardless prend en charge PAIN.008.001.08 et PAIN.008.001.02. Si votre ERP ou votre logiciel bancaire génère une version plus ancienne, vous devrez mettre à jour vos paramètres d’exportation vers l’une des versions prises en charge. Vérifiez vos paramètres d'exportation ou contactez votre fournisseur ERP pour obtenir de l’aide.

Historique des importations et suivi

Comment puis-je savoir si mon importation a été traitée comme un fichier CSV ou XML ?

Dans le tableau de bord, votre historique d’importation affiche une étiquette « CSV » ou « XML » à côté de chaque fichier, vous permettant de les distinguer aisément.