> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md). # Soumettre des modifications et annulations par lot Lorsqu’un partenaire génère une conversion — par exemple 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 les articles sont en rupture de stock. Vous pouvez soumettre des modifications et des annulations en masse soit via l’API, soit via FTP/e-mail, comme décrit dans cet article. Le modèle dont vous avez besoin pour les soumissions FTP/e-mail dépend du fait que vous suiviez les données 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 le support](https://app.impact.com/support/portal.ihtml). ### Quelle méthode de soumission vous convient le mieux ? | Si vous souhaitez... | Utilisez cette méthode... | | -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Soumettez un fichier manuel, ponctuel, sans codage | [Courriel](#step-2-submit-your-data-file) traitement par lot ou [téléverser le fichier via FTP](#step-2-submit-your-data-file) | | Configurer le reporting automatisé des conversions | [Conversions](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) / [Actions](https://integrations.impact.com/brand-api-reference/reference/actions) API, [envoyer le fichier via FTP](#step-2-submit-your-data-file), ou [récupérer le fichier via FTP​](#step-2-submit-your-data-file) | ### 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 les champs existants. * **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 contourner cela, spécifiez le *ActionId*. * **Utilisez *****Montant***** correctement pour les annulations** — Pour annuler une action, vous pouvez définir *Montant = 0*. Cependant, si le montant original *Montant = 0*, le laisser à 0 sera enregistré comme une modification, et l’action ne sera pas annulée. {% stepper %} {% step %} #### Étape 1 : Préparez votre fichier de données 1. Identifiez le fichier modèle correspondant à votre cas d’utilisation. * Voir [Référence pour les modifications et annulations en lot](/brand/fr/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md) pour les fichiers modèles avec des exemples de données. 2. Collez le contenu du modèle dans une application de feuille de calcul (par exemple Microsoft Excel) ou un éditeur de texte (par exemple 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 tableur, 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 certaines valeurs ne soient pas omises par inadvertance.

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 via FTP/e-mail, consultez [Référence pour les modifications et annulations en lot](/brand/fr/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md). Sinon, consultez notre [Références des champs d’action et de conversion](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references) pour obtenir la liste complète des champs pris en charge. {% endstep %} {% step %} #### É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](https://app.impact.com/support/portal.ihtml). 1. Dans la barre de navigation supérieure, sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Profil utilisateur] → Paramètres**. 2. Dans la colonne de droite, sous *Suivi*, sélectionnez [**Types d’événements**](https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml). 3. Sélectionnez les **nom** du type d’événement pour lequel vous souhaitez soumettre des modifications en lot. 4. À côté de *Traitement des retours*, sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fkka3dqJOx8ZhiX82RDLt%2FEdit_light.svg?alt=media\&token=f454405c-ebd8-49af-90db-22efc27476bf) **\[Modifier]**. 5. Sélectionnez **Automatiser le traitement des retours (avancé)**, puis sélectionnez **Téléversement par lot**. 6. Choisissez l’une des méthodes suivantes liées à FTP ou à l’e-mail pour soumettre votre fichier :
Téléverser le fichier sur le serveur FTP du système {% hint style="info" %} Nous recommandons de fractionner les fichiers FTP/SFTP afin de conserver un nombre maximal d’entrées par fichier inférieur à 10 000. {% endhint %} 1. Sélectionnez **Téléversez le fichier sur le serveur FTP du système.** 2. Sélectionnez **Envoyer par e-mail le nom d’utilisateur et le mot de passe FTP** et **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 : | | FTP | SFTP | | --------------------- | ------------------------------------------------------------- | -------------------------------------------------------------- | | **Serveur** | batch.impact.com | sftp\://batch.impact.com | | **Port** | 21 | 22 | | **Nom d’utilisateur** | (Votre nom d’utilisateur FTP impact.com sensible à la casse.) | (Votre nom d’utilisateur SFTP impact.com sensible à la casse.) | | **Mot de passe** | (Votre mot de passe FTP impact.com sensible à la casse.) | (Votre mot de passe SFTP impact.com sensible à la casse.) | 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. Sinon, [contactez le support](https://app.impact.com/support/portal.ihtml).
Récupérer le fichier depuis votre propre serveur FTP {% hint style="info" %} Nous recommandons de fractionner les fichiers FTP/SFTP afin de conserver un nombre maximal d’entrées par fichier inférieur à 10 000. {% endhint %} 1. Sélectionnez **Récupérer le fichier depuis votre propre serveur FTP**. 2. Entrez le **URL du serveur**, **Port**, et **Répertoire** chemin vers le fichier de modifications en lot sur votre serveur FTP. Entrez 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éversez votre fichier dans le *Répertoire* que vous avez spécifié ci-dessus. * impact.com tente de se connecter et de télécharger des fichiers depuis votre serveur FTP toutes les 24 heures, de sorte que le traitement de votre fichier peut prendre jusqu’à 24 heures après le téléversement.
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.** 2. Une adresse e-mail unique vous sera fournie juste en dessous de la méthode sélectionnée. Copiez cette adresse e-mail. 3. À l’aide de n’importe quel client de messagerie, envoyez un e-mail à l’adresse unique avec votre fichier de modifications en lot en pièce jointe. * N’incluez dans le champ *À :* que l’adresse e-mail unique pour le type d’événement. Si vous devez envoyer ce fichier à d’autres personnes, ajoutez-les dans le champ *CC :* champ. 4. Vous pouvez laisser le champ objet et le corps du message vides. * Voir ci-dessous un exemple d’adresse e-mail (la vôtre sera légèrement différente) :
{% endstep %} {% step %} #### Étape 3 : Examinez votre soumission de fichier Une fois que vous avez envoyé votre fichier .CSV ou .XML à impact.com, vous pouvez revenir consulter son statut pour voir s’il a été traité. 1. Dans la barre de navigation supérieure, sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b527686787b925f477dff4feb9be3a63f51250a7%2Fdcf31aa89710c2f91d880b79ce8d8c18489cd8cad334e5cd91dd7ee0372a44fd.svg?alt=media) **\[Profil utilisateur] → Paramètres**. 2. Dans la colonne de gauche, faites défiler jusqu’à la *Technique* section et sélectionnez [**Soumissions de fichiers**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml). 3. Utilisez le tableau pour consulter les soumissions de fichiers récentes reçues par impact.com, y compris l’état de traitement actuel. * Les fichiers soumis apparaîtront dans les 10 à 15 minutes suivant leur soumission, tandis que les mises à jour générales du reporting peuvent prendre plus de 2 heures. * Vous trouverez ci-dessous divers problèmes que vous pouvez rencontrer lors de l’examen des soumissions de fichiers, ainsi que les actions que vous pouvez entreprendre pour les résoudre.
Référence de dépannage des soumissions | Problème | Action à entreprendre | | ------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | La colonne des enregistrements affiche 0 | Assurez-vous que l’extension du fichier est . CSV ou .XML. | | `NO_CHANGE` | Aucune modification n’a été apportée à l’action. Veuillez vous assurer de saisir le montant final dans la *Montant* colonne (par exemple, saisissez 0 si vous souhaitez annuler les actions). | | `BAD_DISPOSITION` |

Le code de raison que vous avez fourni n’est pas valide. Veuillez utiliser l’un des codes de raison.

Vous pouvez également configurer un code de disposition personnalisé.

| | `ALREADY_LOCKED` | La période de verrouillage de l’action est déjà écoulée. L’action ne peut plus faire l’objet de modifications ou d’annulations. | | `La valeur ActionTrackerld:ActionTrackerld n’est pas valide` | Cela doit correspondre à l’ [ID du type d'événement](/brand/fr/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md) 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. |
{% endstep %} {% endstepper %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.