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.

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.

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
• Modèle d’approbations au niveau de la commande

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

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
• Modèle d’approbations au niveau de l’article

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

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).

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.

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.

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 pour discuter des codes de disposition.

Code	Description
CONS_FRAUD	Consumer fraud
CONS_ERROR	Consumer error
ITEM_RETURNED	Item 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_ERROR	Order error
ORDER_UPDATE	Order was updated
PUB_ACT_DISPUTE	Partner activity dispute
ADV_ACT_DISPUTE	Brand activity dispute
NOT_COMPLIANCE_TERMS	Not in compliance with terms
ITEM_OUT_OF_STOCK	Item is out of stock
TEST_ACTION	Test action
PARTNER_NOT_ACTIVE	Partner account deactivated
CREDITED_DIFFERENT_MP	Credited to another partner
OTHER	Other reason