Soumettre des modifications et revers en masse

Lorsqu'un partenaire génère une conversion — comme une vente — et que la période de verrouillage pour cette action n'est pas encore écoulée, vous pouvez corriger toute donnée d'action incorrecte en soumettant une modification ou une annulation. Cela garantit que le partenaire est payé correctement à la fin de la période de verrouillage.

Les actions sont généralement modifiées ou annulées lorsque les clients retournent des commandes, commettent des erreurs lors du paiement ou lorsque des articles sont en rupture de stock.

Vous pouvez soumettre des modifications et des annulations en masse soit via l'API, soit via un serveur FTP/SMTP comme décrit ci‑dessous. Le modèle dont vous avez besoin pour les soumissions FTP/SMTP dépend du fait que vous suiviez au niveau de la commande ou de l'article, car chacun nécessite des champs différents. Si vous n'êtes pas sûr du fichier à utiliser, demandez à votre CSM ou contacter le support.

Choses à garder à l'esprit

• Utilisez des formats de fichier pris en charge — Votre fichier de soumission doit être au format .CSV ou .XML.

• N'ajoutez pas de nouveaux points de données — Vous ne pouvez pas ajouter de nouveaux champs à une transaction, seulement mettre à jour ceux qui existent.

• Comprenez la gestion de la déduplication — Lorsque plusieurs actions partagent le même Oid/OrderId, impact.com applique les mises à jour au plus récent ActionId. Pour remplacer cela, spécifiez le ActionId.

• Utilisez correctement Amount pour les annulations — Pour annuler une action, vous pouvez définir Amount = 0. Cependant, si le Amount = 0d'origine, le laisser à 0 sera enregistré comme une modification, et l'action ne sera pas annulée.

Étape 1 : Préparez votre fichier de données

Pour une liste complète des champs que vous pouvez utiliser dans le traitement par lots FTP/SMTP, voir Référence des modifications et annulations par lot.

1. Identifiez le fichier modèle pertinent pour votre cas d'utilisation.

   • Voir Référence des modifications et annulations par lot par exemple des fichiers modèles.

2. Collez le contenu du modèle dans une application de feuille de calcul (par ex. Microsoft Excel) ou un éditeur de texte (par ex. Notepad).

3. Sous la ligne d'en-tête, commencez à ajouter les données d'action modifiées.

   • Si vous utilisez un éditeur de texte, utilisez des virgules pour séparer chaque point de données.

   • Si vous utilisez un éditeur de feuille de calcul, ajoutez chaque point de données dans une cellule distincte.

   Important : Assurez‑vous de modifier les cellules de la feuille de calcul en format « Texte brut » ou « Texte » afin que les valeurs ne soient pas accidentellement omises.

4. Enregistrez le fichier avec un nom identifiable, par exemple : Batch_Mods_Reversals_2025_02_12.csv

Étape 2 : Soumettez votre fichier de données

impact.com autorise un maximum de 1 000 modifications par action. Si vous devez effectuer d'autres modifications par la suite, contactez le support.

1. Depuis la barre de navigation supérieure, sélectionnez [Profil utilisateur] → Paramètres.

2. À droite, sous Tracking, sélectionnez Types d'événements.

3. Sélectionnez le nom du type d'événement pour lequel vous souhaitez soumettre des modifications par lot.

4. À côté de Traitement des retours, sélectionnez [Modifier].

5. Sélectionnez Automatisez le traitement des retours (avancé).

   • Choisissez l'une des méthodes liées au FTP ou SMTP suivantes pour soumettre votre fichier :

Télécharger un fichier sur le serveur FTP du système

1. Sélectionnez Téléchargez le fichier sur le serveur FTP du système.

2. Sélectionnez Enregistrer.

3. Une fois que vous avez reçu vos identifiants FTP par e‑mail, utilisez un client FTP pour vous connecter à impact.com avec les informations suivantes :

   
4. Une fois connecté, téléversez votre fichier dans le répertoire principal du serveur.

   • Si vous n'avez pas reçu l'e‑mail contenant les identifiants FTP, contactez la personne qui a créé votre compte impact.com. Alternativement, contacter le support.

Récupérer le fichier depuis votre propre serveur FTP

1. Sélectionnez Récupérer le fichier depuis votre propre serveur FTP.

2. Saisissez le URL du serveur, Port, et Répertoire chemin vers le fichier de modifications par lot sur votre serveur FTP. Saisissez le Nom d'utilisateur et Mot de passe que impact.com utilisera pour se connecter à votre serveur FTP.

3. Sélectionnez Enregistrer et continuez.

4. Téléchargez votre fichier de modifications par lot dans le répertoire que vous avez spécifié ci‑dessus.

   • impact.com tente de se connecter et de télécharger les fichiers depuis votre serveur FTP toutes les 24 heures, donc votre fichier peut prendre jusqu'à 24 heures pour être traité après le téléchargement.

Envoyer le fichier par e-mail au serveur SMTP du système

1. Sélectionnez Envoyer le fichier par e-mail au serveur SMTP du système, puis copiez votre adresse e-mail unique.

2. En utilisant n'importe quel client de messagerie, envoyez un e‑mail à l'adresse unique avec votre fichier de modifications par lot en pièce jointe.

   • Incluez uniquement l'adresse e‑mail unique pour le type d'événement dans le À : champ. Si vous devez envoyer ce fichier à d'autres personnes, incluez-les dans le CC : champ.

3. Vous pouvez laisser le champ objet et le corps du message vides.

Étape 3 : Vérifiez votre soumission de fichier

Une fois que vous avez envoyé votre fichier .CSV ou .XML à impact.com, vous pouvez vérifier son statut pour voir s'il a été traité.

1. Depuis la barre de navigation supérieure, sélectionnez [Profil utilisateur] → Paramètres.

2. Dans la colonne de gauche, faites défiler jusqu'à Technique section et sélectionnez Soumissions de fichiers.

3. Utilisez le tableau pour examiner les soumissions de fichiers récentes que impact.com a reçues, y compris l'état de traitement actuel.

   • Les fichiers soumis apparaîtront dans les 10 à 15 minutes suivant la soumission, tandis que les mises à jour de rapports généraux peuvent prendre plus de 2 heures.

   • Vous trouverez ci‑dessous divers problèmes que vous pouvez rencontrer lors de la révision des soumissions de fichiers et des actions que vous pouvez entreprendre pour les rectifier.

   Problème	Action à entreprendre
   La colonne Enregistrements indique 0	Assurez‑vous que l'extension du fichier est .CSV ou .XML.
   NO_CHANGE	Aucun changement n'a été apporté à l'action. Veuillez vous assurer d'entrer le montant final dans la colonne Amount (par ex., entrez 0 si vous souhaitez annuler des actions).
   BAD_DISPOSITION	Le code de motif que vous avez fourni n'est pas valide. Veuillez utiliser l'un des codes de motif. Alternativement, vous pouvez configurer un code de disposition personnalisé.
   ALREADY_LOCKED	La période de verrouillage de l'action est déjà passée. L'action ne peut plus subir de modifications ou d'annulations.
   ActionTrackerId:ActionTrackerId valeur invalide	Ceci devrait correspondre au ID du type d'événement saisi.
   ACTION_NOT_FOUND	Le OID que vous avez fourni est incorrect. Veuillez fournir un OID.
   ALREADY_REVERSED	L'action a déjà été annulée.
   ALREADY_APPROVED	L'action a déjà été approuvée.