> 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, 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 erronée en soumettant une modification ou une annulation. Ainsi, le partenaire sera rémunéré correctement à la fin de la période de verrouillage.

Les actions sont généralement modifiées ou annulées lorsque des clients retournent des commandes, font des erreurs au moment du paiement ou que des articles sont en rupture de stock.

Vous pouvez soumettre des modifications et des annulations en masse par API ou par FTP/e-mail, comme indiqué dans cet article. Le modèle nécessaire pour les soumissions par FTP/e-mail dépend du suivi au niveau de la commande ou de l’article, car chaque méthode requiert 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…                                                                                                                                                                                                                                                                                                       |
| ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Envoyer un fichier manuel unique, sans coder            | ​[E-mail](#step-2-submit-your-data-file) traitement par lots ou [téléversement du fichier par FTP](#step-2-submit-your-data-file)​                                                                                                                                                                                            |
| Configurer l’envoi automatisé de rapports de conversion | ​[Conversions](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) / [Actions](https://integrations.impact.com/brand-api-reference/reference/actions) API, [envoi du fichier par FTP](#step-2-submit-your-data-file), ou [récupération du fichier par FTP​](#step-2-submit-your-data-file) |

### Points à retenir :

* **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, uniquement mettre à jour ceux qui existent déjà.
* **Comprenez le fonctionnement de la déduplication** — Lorsque plusieurs actions partagent le même *Oid/OrderId*, impact.com applique les mises à jour à l’ *ActionId*. Pour remplacer ce comportement, indiquez l’ *ActionId*.
* **Utilisez&#x20;*****Amount*****&#x20;correctement pour les annulations** — Pour annuler une action, vous pouvez définir *Amount = 0*. Cependant, si l’ *Amount = 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 modèle correspondant à votre cas d’utilisation.
   * Consultez la [Référence sur les modifications et annulations par lots](https://help.impact.com/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 obtenir des modèles de fichiers avec des exemples de données.
2. Collez le contenu du modèle dans un tableur (par exemple, Microsoft Excel) ou un éditeur de texte (par exemple, le Bloc-notes).
3. Sous la ligne d’en-tête, commencez à ajouter les données modifiées de l’action.

   * Si vous utilisez un éditeur de texte, séparez chaque point de données par une virgule.
   * Si vous utilisez un tableur, saisissez chaque point de données dans une cellule distincte.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Remarque :</strong> Veillez à modifier les cellules du tableur au format « Texte brut » ou « Texte » afin d’éviter que des valeurs soient omises par inadvertance.</p></div>
4. Enregistrez le fichier sous un nom facilement identifiable, par exemple : `Batch_Mods/Reversals_2025_02_12.csv`
   * Pour consulter la liste des champs couramment utilisés pour le traitement par lots par FTP/e-mail, consultez la [Référence sur les modifications et annulations par lots](https://help.impact.com/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). Vous pouvez également consulter notre [Références des champs Action et 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 : Envoyer 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énement**](https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml).
3. Sélectionnez le **nom** du type d’événement pour lequel vous souhaitez soumettre des modifications par lots.
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échargement par lots**.
6. Choisissez l’une des méthodes suivantes, par FTP ou par e-mail, pour soumettre votre fichier :

<details>

<summary>Téléverser le fichier sur le serveur FTP du système</summary>

{% hint style="info" %}
Nous vous recommandons de fractionner les fichiers FTP/SFTP afin que chaque fichier contienne moins de 10 000 entrées.
{% endhint %}

1. Sélectionnez **Téléverser le fichier sur le serveur FTP du système.**
2. Sélectionnez **Envoyer le nom d’utilisateur et le mot de passe FTP par e-mail** et **Enregistrer**.
3. Après avoir 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 vos identifiants FTP, contactez la personne qui a créé votre compte impact.com. Vous pouvez également [contacter le support](https://app.impact.com/support/portal.ihtml).

</details>

<details>

<summary>Récupérer le fichier depuis votre propre serveur FTP</summary>

{% hint style="info" %}
Nous vous recommandons de fractionner les fichiers FTP/SFTP afin que chaque fichier contienne moins de 10 000 entrées.
{% endhint %}

1. Sélectionnez **Récupérer le fichier depuis votre propre serveur FTP**.
2. Saisissez l’ **URL du serveur**, **Port**, ainsi que le **répertoire** du fichier de modifications par lots sur votre serveur FTP. Saisissez le **nom d’utilisateur** et le **mot de passe** qu’impact.com utilisera pour se connecter à votre serveur FTP.
3. Sélectionnez **Enregistrer** et continuer.
4. Téléversez votre fichier dans le *répertoire* que vous avez indiqué ci-dessus.
   * impact.com tente de se connecter à votre serveur FTP et d’en télécharger les fichiers toutes les 24 heures. Le traitement de votre fichier peut donc prendre jusqu’à 24 heures après son téléversement.

</details>

<details>

<summary>Envoyer le fichier par e-mail au serveur SMTP du système</summary>

1. Sélectionner **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 à cette adresse unique en joignant votre fichier de modifications par lot.
   * N’indiquez que l’adresse e-mail unique correspondant au type d’événement dans le champ *À :* Si vous devez envoyer ce fichier à d’autres personnes, ajoutez-les dans le champ *CC :* .
4. Vous pouvez laisser vides le champ de l’objet et le corps du message.
   * Voici un exemple d’adresse e-mail (la vôtre sera légèrement différente) :

<div data-with-frame="true"><figure><img src="https://1651675991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpVKEIcehMut8QKRmaUZu%2Fuploads%2F4KrGuAmvXvwqwYUxauT0%2FScreenshot%202026-10-07%20at%2023.37.54.png?alt=media&amp;token=5835d762-9ad4-41c3-9715-d79be84c5af9" alt="" width="563"><figcaption></figcaption></figure></div>

</details>
{% endstep %}

{% step %}

#### Étape 3 : Vérifier l’envoi de votre fichier

Après avoir envoyé votre fichier .CSV ou .XML à impact.com, vous pouvez consulter son statut pour vérifier 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 section *Technique* et sélectionnez [**Envois de fichiers**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. Consultez le tableau pour vérifier les envois récents de fichiers reçus par impact.com, ainsi que leur statut de traitement.
   * Les fichiers envoyés apparaissent dans les 10 à 15 minutes suivant leur envoi, tandis que les mises à jour générales des rapports peuvent prendre plus de 2 heures.
   * Vous trouverez ci-dessous différents problèmes que vous pouvez rencontrer lors de la vérification des envois de fichiers, ainsi que les mesures à prendre pour les résoudre.

<details>

<summary>Référence de dépannage des envois</summary>

| Problème                                           | Mesure à prendre                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| La colonne Records indique 0                       | Vérifiez que l’extension du fichier est . CSV ou .XML.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `NO_CHANGE`                                        | Aucune modification n’a été apportée à l’action. Veuillez saisir le montant final dans la colonne *Amount* (par exemple, saisissez 0 si vous souhaitez annuler des actions).                                                                                                                                                                                                                                                                                                                                                                                                             |
| `BAD_DISPOSITION`                                  | <p>Le code de motif que vous avez fourni n’est pas valide. Veuillez utiliser l’un des codes de motif standard <a href="https://help.impact.com/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">codes de motif</a>.</p><p>Vous pouvez également configurer un <a href="https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md">code de disposition personnalisé</a>.</p> |
| `ALREADY_LOCKED`                                   | La période de verrouillage de l’action est déjà terminée. L’action ne peut plus être modifiée ni annulée.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `ActionTrackerld:ActionTrackerld value is invalid` | Cette valeur doit correspondre à l’ [Event Type ID](https://help.impact.com/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.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

</details>
{% 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=<question>&goal=<user_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.
