> 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 de modèle fournis par impact.com et remplacer les données d’exemple 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 le format de votre fichier soumis est correct. Une fois votre fichier prêt à être soumis, vous pouvez passer à l’envoi de votre fichier de modifications / annulations par lots. {% hint style="info" %} Cet article de référence présente les champs les plus couramment utilisés pour les modifications et annulations par lots. Pour consulter une référence complète et détaillée, incluant les descriptions 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 :** * Découvrez quels champs utiliser pour une modification ou une annulation par lots via FTP/SMTP * Téléchargez des fichiers de modèle avec des données d’exemple fictives * Comprenez quels codes de motif appliquer et à quel moment #### Modifications au niveau de la commande Cela sert 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 | La fourniture de cet identifiant est requise lors de l’utilisation de *ActionTrackerId*. | | `ActionTrackerID` | Obligatoire sous certaines conditions\* | Non modifiable | La fourniture de cet identifiant est requise lors de l’utilisation de *OrderId/Oid*. | | `Amount` | Facultatif | Modifiable | Définissez le nouveau montant total de la commande. | | `currencyCode` | Facultatif | Modifiable | Définissez la devise du revenu 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 lors de la conversion d’origine, la soumission d’une valeur l’insère. Accepté une seule fois par action — soumettez toute autre modification de champ dans la même requête. | | `LocationId` | Facultatif | Modifiable | Principalement utilisé pour l’hébergement, il s’agit de l’identifiant unique du lieu spécifié dans cette conversion. S’il est vide lors de la conversion d’origine, la soumission d’une valeur l’insère. | | `LocationName` | Facultatif | Modifiable | Principalement utilisé pour l’hébergement, il s’agit du nom du lieu spécifié dans cette conversion. S’il est vide lors de la conversion d’origine, la soumission d’une valeur l’insère. | | `GiftPurchase` | Facultatif | Modifiable | Définissez sur true pour marquer la commande comme achat cadeau, ou sur false pour retirer cette marque. S’il est vide lors de la conversion d’origine, la soumission d’une valeur l’insère. | | `Text1–Text50` | Facultatif | Modifiable | Champs de texte généraux qui acceptent des chaînes de tout type de données textuelles que vous souhaitez envoyer (de Text1 à Text50). S’il est vide lors de la conversion d’origine, la soumission d’une valeur l’insère. Accepté une seule fois par action — soumettez toute autre modification de champ dans la même requête. | | `Reason` | Obligatoire | Modifiable | Fournissez un code de motif valide pour la modification. | \*Au moins un chemin d’identifiant doit être fourni, c’est-à-dire soit *ActionId* **ou** (\*OrderId/Oid \*+ *ActionTrackerId*)
Fichiers de 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 sert lorsque vous souhaitez annuler en masse des actions déclenché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 | La fourniture de cet identifiant est requise lors de l’utilisation de *ActionTrackerId*. | | `ActionTrackerID` | Obligatoire sous certaines conditions\* | Non modifiable | La fourniture de cet identifiant est requise lors de l’utilisation de *OrderId/Oid*. | | `Amount` | Obligatoire sous certaines conditions\*\* | Modifiable | Définissez sur **0** pour annuler la commande, sauf si le montant d’origine = 0\*\* | | `Reason` | Obligatoire | Modifiable | Fournissez un code de motif 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 *Amount* inchangé afin d’éviter de la classer à tort comme une modification.
Fichiers de 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 sert 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 | La fourniture de cet identifiant est requise lors de l’utilisation de *ActionTrackerId*. | | `ActionTrackerID` | Obligatoire sous certaines conditions\* | Non modifiable | La fourniture de cet identifiant est requise lors de l’utilisation de *OrderId/Oid*. | | `SKU`\*\* | Obligatoire | Non modifiable | Fournissez la valeur SKU de l’article que vous souhaitez modifier. | | `Amount`\*\* | 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é. | | `Quantity`\*\* | Facultatif | Modifiable | Définissez la nouvelle quantité d’articles dans la commande. | | `Category`\*\* | Facultatif | Modifiable | Définissez la catégorie de l’article. | | `Reason`\*\* | Obligatoire | Modifiable | Fournissez un code de motif 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 de 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 sert lorsque vous souhaitez annuler en masse des données d’action 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 | La fourniture de cet identifiant est requise lors de l’utilisation de *ActionTrackerId*. | | `ActionTrackerID` | Obligatoire sous certaines conditions\* | Non modifiable | La fourniture de cet identifiant est requise lors de l’utilisation de *OrderId/Oid*. | | `SKU`\*\* | Obligatoire | Non modifiable | Fournissez la valeur SKU de l’article que vous souhaitez modifier. | | `Amount`\*\* | 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é. | | `Quantity`\*\* | Facultatif | Modifiable | Définissez la nouvelle quantité d’articles dans la commande. | | `Reason`\*\* | Obligatoire | Modifiable | Fournissez un code de motif 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 de 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 effectue une annulation (Amount=0) et l’autre une modification (Amount=15).
{% hint style="info" %} **Remarque :** Si vous prévoyez d’avoir des *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 motif Chaque fois que vous modifiez ou annulez des données d’action, vous devez fournir un motif. Utilisez le code de motif 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 renvoi d’une erreur à la place. Si vous avez besoin de codes de motif 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_FRAUDFraude du consommateur
CONS_ERRORErreur du consommateur
ITEM_RETURNEDL’article a été retourné
APPROVED

L’action est approuvée

Remarque : Si vous essayez d’approuver des actions, Approuver doit être défini comme un code de disposition personnalisé.

ORDER_ERRORErreur de commande
ORDER_UPDATELa commande a été mise à jour
PUB_ACT_DISPUTELitige d’activité partenaire
ADV_ACT_DISPUTELitige d’activité de la marque
NOT_COMPLIANCE_TERMSNon conforme aux conditions
ITEM_OUT_OF_STOCKL’article est en rupture de stock
TEST_ACTIONAction de test
PARTNER_NOT_ACTIVECompte partenaire désactivé
CREDITED_DIFFERENT_MPCrédité à un autre partenaire
AUTREAutre raison
--- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` 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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.