Soumettre des modifications et annulations par lot

Lorsqu’un partenaire génère une conversion — comme une vente — et que la période de verrouillage de 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 rémunéré 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 lot via l’API, ou par FTP/e-mail comme expliqué dans cet article. Le modèle dont vous avez besoin pour les envois FTP/e-mail dépend de savoir si vous effectuez le suivi au niveau de la commande ou de l’article, car chacun nécessite des champs différents. Si vous ne savez pas quel fichier utiliser, demandez à votre CSM ou contactez l’assistance.

Quelle méthode de soumission vous convient le mieux ?

If you want to...	Use this method...
Submit a manual, one-time file with no coding	​Email batch processing or upload file via FTP​
Set up automated conversion reporting	​Conversions / Actions API, push file via FTP, or pull file via FTP​

Points à garder à l’esprit :

• Utilisez les 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 à la plus récente ActionId. Pour passer outre cela, indiquez le ActionId.

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

1

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

1. Identifiez le fichier modèle correspondant à votre cas d’utilisation.

   • Consultez Référence des modifications et annulations en lot pour des fichiers modèle contenant des exemples de données.

2. Collez le contenu du modèle dans une application de tableur (p. ex., Microsoft Excel) ou dans un éditeur de texte (p. 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.

   Remarque : Assurez-vous de modifier les cellules du tableur au format « texte brut » ou « texte » afin que des valeurs ne soient pas omises par erreur.

4. Enregistrez le fichier avec un nom identifiable, par exemple : Batch_Mods/Reversals_2025_02_12.csv

   • Pour une liste des champs couramment utilisés dans le traitement par lot FTP/e-mail, consultez Référence des modifications et annulations en lot. Sinon, consultez notre Références des champs d’action et de conversion pour la liste complète des champs pris en charge.

2

Étape 2 : Soumettez votre fichier de données

impact.com allows a maximum of 1,000 modifications per action. If you need to make further modifications thereafter, contact support.

1. From the top navigation bar, select [User profile] → Settings.

2. In the right column, under Tracking, select Event Types.

3. Select the name of the Event Type for which you want to submit batch modifications.

4. Next to Returns Processing, select [Edit].

5. Select Automate returns processing (advanced).

6. Choose one of the following FTP- or email-related methods to submit your file:

Upload file to system FTP server

We recommend splitting FTP/SFTP files to keep the maximum number of entries per file under 10,000.

1. Select Upload file to system FTP server.

2. Select Email FTP Username and Password and Save.

3. Once you have received your FTP credentials via email, use an FTP client to connect to impact.com with the following info:

   	FTP	SFTP
   Server	batch.impact.com	sftp://batch.impact.com
   Port	21	22
   Username	(Your case-sensitive impact.com FTP Username.)	(Your case-sensitive impact.com SFTP Username.)
   Password	(Your case-sensitive impact.com FTP Password.)	(Your case-sensitive impact.com SFTP Password.)

4. Once connected, upload your file to the main directory of the server.

   • If you have not received the FTP credentials email, contact the person who created your impact.com account. Alternatively, contact support.

Pull file from your own FTP server

We recommend splitting FTP/SFTP files to keep the maximum number of entries per file under 10,000.

1. Select Pull file from your own FTP server.

2. Enter the Server URL, Port, and Directory path to the batch modifications file on your FTP server. Enter the Username and Password that impact.com will use to connect to your FTP server.

3. Select Save and continue.

4. Upload your file to the Directory you specified above.

   • impact.com attempts to connect and download files from your FTP server every 24 hours, so your file may take up to 24 hours to be processed after upload.

Email file to system SMTP server

1. Select Email file to system SMTP server.

2. A unique email address will be provided for you just below your selected method. Copy this email address.

3. Using any email client, send an email to the unique address with your batch modifications file as an attachment.

   • Only include the unique email address for the event type in the To: field. If you need to send this file to others, include them in the CC: field.

4. You can leave the subject field and message body blank.

   • See an example of the email address below (yours will be slightly different):

3

Étape 3 : Vérifiez la soumission de votre fichier

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

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

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

3. Utilisez le tableau pour consulter les envois de fichiers récents reçus par impact.com, y compris leur état de traitement actuel.

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

   • Vous trouverez ci-dessous divers problèmes que vous pouvez rencontrer lors de la vérification des soumissions de fichiers, ainsi que les actions que vous pouvez entreprendre pour les résoudre.

Submission troubleshooting reference

Issue	Action to take
Records column shows 0	Make sure the file extension is . CSV or .XML.
NO_CHANGE	There is no change made to the action. Please ensure you enter the final amount into the Amount column (e.g., enter 0 if you want to reverse actions).
BAD_DISPOSITION	The reason code you provided is not valid. Please use one of the standard reason codes. Alternatively, you can set up a custom disposition code.
ALREADY_LOCKED	The action locking period has already passed. The action can no longer undergo modifications or reversals.
ActionTrackerld:ActionTrackerld value is invalid	This should correspond to the Event Type ID entered.
ACTION_NOT_FOUND	The OID you provided is incorrect. Please provide a correct OID.
ALREADY_REVERSED	The action has already been reversed.
ALREADY_APPROVED	The action has already been approved.