> 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/batch-modifications-and-reversals-reference.md). # Référence des modifications et annulations par lot Lorsque vous modifiez ou annulez des données d’action en masse, commencez par télécharger l’un des fichiers modèle fournis par impact.com et remplacez les exemples de données par les vôtres. Lorsque vous ajoutez vos propres données, veillez à suivre les consignes du tableau de référence correspondant afin de vous assurer que votre fichier soumis est correctement formaté. Une fois votre fichier de soumission prêt, vous pouvez reprendre en soumettant votre fichier de modifications / annulations par lot. {% hint style="info" %} Cet article de référence comprend les champs les plus couramment utilisés pour les modifications et annulations par lot. Pour consulter une référence complète et détaillée, avec la description des champs, reportez-vous à [Références des champs d’action et de conversion](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references). {% endhint %} **Consultez les références ci-dessous pour :** * Apprendre quels champs utiliser pour une modification ou une annulation par lot via FTP/SMTP * Télécharger des fichiers modèle avec des données d’exemple factices * Comprendre quels codes de raison appliquer et à quel moment #### Modifications au niveau de la commande Cela s’applique lorsque vous souhaitez mettre à jour des données d’action en masse au niveau de la commande plutôt qu’au niveau de l’article, par exemple modifier le montant de la commande pour plusieurs commandes.
Paramètres acceptés | Champ | Obligatoire ? | Modifiable ? | Remarque | | ----------------- | --------------------------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ActionID` | Obligatoire sous certaines conditions\* | Non modifiable | Il est recommandé de fournir cet identifiant lorsque la fenêtre de déduplication est courte. | | `Oid / OrderId` | Obligatoire sous certaines conditions\* | Non modifiable | Fournir cet identifiant est obligatoire lors de l’utilisation de *ActionTrackerId*. | | `ActionTrackerID` | Obligatoire sous certaines conditions\* | Non modifiable | Fournir cet identifiant est obligatoire lors de l’utilisation de *OrderId/Oid*. | | `Montant` | Facultatif | Modifiable | Définissez le nouveau montant total de la commande. | | `currencyCode` | Facultatif | Modifiable | Définissez la devise des revenus de l’action. Par défaut, la devise de votre compte impact.com est utilisée si elle n’est pas fournie. | | `CustomerStatus` | Facultatif | Modifiable | Définissez le statut du client au moment de la conversion, par exemple NEW / EXISTING. | | `Remarque` | Facultatif | Modifiable | Champ général à des fins de reporting au niveau de l’événement. S’il est vide dans la conversion d’origine, l’envoi d’une valeur l’ajoute. Accepté une seule fois par action — envoyez toute autre modification de champ dans la même requête. | | `LocationId` | Facultatif | Modifiable | Principalement utilisé pour les hébergements, il s’agit de l’identifiant unique de l’emplacement spécifié dans cette conversion. S’il est vide dans la conversion d’origine, l’envoi d’une valeur l’ajoute. | | `LocationName` | Facultatif | Modifiable | Principalement utilisé pour les hébergements, il s’agit du nom de l’emplacement spécifié dans cette conversion. S’il est vide dans la conversion d’origine, l’envoi d’une valeur l’ajoute. | | `GiftPurchase` | Facultatif | Modifiable | Définissez sur true pour marquer la commande comme un achat cadeau, ou sur false pour retirer ce marquage. S’il est vide dans la conversion d’origine, l’envoi d’une valeur l’ajoute. | | `Text1–Text50` | Facultatif | Modifiable | Champs de texte généraux qui acceptent des chaînes de tout type de texte que vous souhaitez envoyer (Text1 à Text50). S’ils sont vides dans la conversion d’origine, l’envoi d’une valeur les ajoute. Accepté une seule fois par action — envoyez toute autre modification de champ dans la même requête. | | `Raison` | Obligatoire | Modifiable | Fournissez un code de raison valide pour la modification. | \*Au moins un chemin d’identifiant doit être fourni, c’est-à-dire soit *ActionId* **ou** (\*OrderId/Oid \*+ *ActionTrackerId*)
Fichiers modèle * [Modèle de modifications au niveau de la commande](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_modifications_template.csv) * [Modèle d’approbations au niveau de la commande](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_approvals_template.csv)
#### Annulations au niveau de la commande Cela s’applique lorsque vous souhaitez annuler en masse des actions initiées par les partenaires au niveau de la commande plutôt qu’au niveau de l’article, par exemple annuler plusieurs commandes.
Paramètres acceptés | Champ | Obligatoire ? | Modifiable ? | Remarque | | ----------------- | ----------------------------------------- | -------------- | -------------------------------------------------------------------------------------------- | | `ActionID` | Obligatoire sous certaines conditions\* | Non modifiable | Il est recommandé de fournir cet identifiant lorsque la fenêtre de déduplication est courte. | | `Oid / OrderId` | Obligatoire sous certaines conditions\* | Non modifiable | Fournir cet identifiant est obligatoire lors de l’utilisation de *ActionTrackerId*. | | `ActionTrackerID` | Obligatoire sous certaines conditions\* | Non modifiable | Fournir cet identifiant est obligatoire lors de l’utilisation de *OrderId/Oid*. | | `Montant` | Obligatoire sous certaines conditions\*\* | Modifiable | Définissez sur **0** pour annuler la commande, sauf si le montant d’origine = 0\*\* | | `Raison` | Obligatoire | Modifiable | Fournissez un code de raison valide pour l’annulation. | \*Au moins un chemin d’identifiant doit être fourni, c’est-à-dire soit *ActionId* **ou** (*OrderId/Oid* + *ActionTrackerId*) \*\*Si le montant d’origine *Montant = 0*, laissez *Montant* inchangé afin d’éviter qu’il soit mal classé comme une modification.
Fichiers modèle * [Modèle d’annulations au niveau de la commande](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)
#### Modifications au niveau de l’article Cela s’applique lorsque vous souhaitez mettre à jour des données d’action en masse au niveau de l’article plutôt qu’au niveau de la commande, par exemple modifier le montant pour plusieurs articles d’une commande.
Paramètres acceptés | Champ | Obligatoire ? | Modifiable ? | Remarque | | ----------------- | --------------------------------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `ActionID` | Obligatoire sous certaines conditions\* | Non modifiable | Il est recommandé de fournir cet identifiant lorsque la fenêtre de déduplication est courte. | | `Oid / OrderId` | Obligatoire sous certaines conditions\* | Non modifiable | Fournir cet identifiant est obligatoire lors de l’utilisation de *ActionTrackerId*. | | `ActionTrackerID` | Obligatoire sous certaines conditions\* | Non modifiable | Fournir cet identifiant est obligatoire lors de l’utilisation de *OrderId/Oid*. | | `SKU`\*\* | Obligatoire | Non modifiable | Fournissez la valeur SKU de l’article que vous souhaitez modifier. | | `Montant`\*\* | Obligatoire sous certaines conditions | Modifiable | Définissez le nouveau montant de l’article, c’est-à-dire prix\*quantité. Si vous modifiez la quantité, ce champ doit également être modifié. | | `Quantité`\*\* | Facultatif | Modifiable | Définissez la nouvelle quantité d’articles dans la commande. | | `Catégorie`\*\* | Facultatif | Modifiable | Définissez la catégorie de l’article. | | `Raison`\*\* | Obligatoire | Modifiable | Fournissez un code de raison valide pour l’annulation. | \*Au moins un chemin d’identifiant doit être fourni, c’est-à-dire soit *ActionId* **ou** (*OrderId/Oid* + *ActionTrackerId*) \*\*Ces champs doivent être inclus pour chaque article que vous modifiez. Les champs d’identifiant ne sont inclus qu’une seule fois par commande.
Fichiers modèle * [Modèle de modifications au niveau de l’article](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_modifications_template.csv) * [Modèle d’approbations au niveau de l’article](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_approvals_template.csv)
#### Annulations au niveau de l’article Cela s’applique lorsque vous souhaitez annuler des données d’action en masse au niveau de l’article plutôt qu’au niveau de la commande, par exemple annuler plusieurs articles d’une commande.
Paramètres acceptés | Champ | Obligatoire ? | Modifiable ? | Remarque | | ----------------- | --------------------------------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `ActionID` | Obligatoire sous certaines conditions\* | Non modifiable | Il est recommandé de fournir cet identifiant lorsque la fenêtre de déduplication est courte. | | `Oid / OrderId` | Obligatoire sous certaines conditions\* | Non modifiable | Fournir cet identifiant est obligatoire lors de l’utilisation de *ActionTrackerId*. | | `ActionTrackerID` | Obligatoire sous certaines conditions\* | Non modifiable | Fournir cet identifiant est obligatoire lors de l’utilisation de *OrderId/Oid*. | | `SKU`\*\* | Obligatoire | Non modifiable | Fournissez la valeur SKU de l’article que vous souhaitez modifier. | | `Montant`\*\* | Obligatoire sous certaines conditions | Modifiable | Définissez le nouveau montant de l’article, c’est-à-dire prix\*quantité. Si vous modifiez la quantité, ce champ doit également être modifié. | | `Quantité`\*\* | Facultatif | Modifiable | Définissez la nouvelle quantité d’articles dans la commande. | | `Raison`\*\* | Obligatoire | Modifiable | Fournissez un code de raison valide pour la modification. | \*Au moins un chemin d’identifiant doit être fourni, c’est-à-dire soit *ActionId* **ou** (*OrderId/Oid* + *ActionTrackerId*) \*\*Ces champs doivent être inclus pour chaque article que vous modifiez. Les champs d’identifiant ne sont inclus qu’une seule fois par commande.
Fichiers modèle * [Modèle d’annulations au niveau de l’article](https://res.cloudinary.com/product-enablement/raw/upload/v1768298926/CSVs/Batch%20Action%20Processing/Item-level_reversals_template.csv) Le SKU O7427540 apparaît deux fois dans cet exemple, car une ligne est en cours d’annulation (Amount=0) et une autre de modification (Amount=15).
{% hint style="info" %} **Remarque :** Si vous prévoyez d’avoir des doublons *OrderIds* et choisissez d’utiliser la combinaison de *OrderId + ActionTrackerId*, impact.com applique votre mise à jour au plus récent *ActionId* par défaut. Utilisez l’ancien *ActionId* si vous souhaitez appliquer la mise à jour au plus ancien *ActionId*. {% endhint %} #### Codes de raison Chaque fois que vous modifiez ou annulez des données d’action, vous devez fournir une raison. Utilisez le code de raison approprié ci-dessous pour expliquer pourquoi l’action est mise à jour. {% hint style="warning" %} **Avertissement :** La transmission d’une valeur non acceptée entraînera le non-traitement de l’entrée et le retour d’une erreur à la place. Si vous avez besoin de codes de raison personnalisés, contactez votre CSM ou [**contactez l’assistance**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **pour discuter des codes de disposition**. {% endhint %}
CodeDescription
CONS_FRAUDConsumer fraud
CONS_ERRORConsumer error
ITEM_RETURNEDItem was returned
APPROVED

Action is approved

Note: If you’re trying to approve actions, Approve needs to be set up as a custom disposition code.

ORDER_ERROROrder error
ORDER_UPDATEOrder was updated
PUB_ACT_DISPUTEPartner activity dispute
ADV_ACT_DISPUTEBrand activity dispute
NOT_COMPLIANCE_TERMSNot in compliance with terms
ITEM_OUT_OF_STOCKItem is out of stock
TEST_ACTIONTest action
PARTNER_NOT_ACTIVEPartner account deactivated
CREDITED_DIFFERENT_MPCredited to another partner
OTHEROther reason
--- # 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/batch-modifications-and-reversals-reference.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.