Referência de Modificações & Reversões em Lote

Ao modificar ou reverter dados de ação em lote, comece baixando um dos arquivos de modelo fornecidos pela impact.com e substitua os dados de exemplo pelos seus. Ao adicionar seus próprios dados, certifique-se de seguir as diretrizes na tabela de referência relevante para garantir que o envio do arquivo esteja formatado corretamente. Quando seu arquivo de envio estiver pronto, você pode continuar com enviando suas modificações / reversões em lote arquivo.

Este artigo de referência inclui os campos mais usados para modificações e reversões em lote. Para ver uma referência completa e detalhada incluindo descrições dos campos, consulte Referências de Campos de Ação e Conversão.

Consulte as referências abaixo para:

• Saber quais campos usar em uma modificação ou reversão em lote via FTP/SMTP

• Baixar arquivos de modelo com dados de exemplo como espaços reservados

• Entender quais códigos de razão aplicar e quando

Modificações em nível de pedido

Isto é para quando você deseja atualizar dados de ação em lote no nível do pedido, em vez do nível do item, por exemplo, alterar o Valor do pedido para vários pedidos.

Parâmetros aceitos

Campo	Obrigatório?	Editável?	Observação
ActionID	Obrigatório Condicionalmente*	Não editável	Recomenda-se fornecer este identificador quando a janela de desduplicação for curta.
Oid / OrderId	Obrigatório Condicionalmente*	Não editável	Fornecer este identificador é necessário ao usar ActionTrackerId.
ActionTrackerID	Obrigatório Condicionalmente*	Não editável	Fornecer este identificador é necessário ao usar OrderId/Oid.
Valor	Opcional	Editável	Defina o novo valor total do pedido.
currencyCode	Opcional	Editável	Defina a moeda de receita da ação. Padrão para a moeda da sua conta impact.com se não for fornecida.
CustomerStatus	Opcional	Editável	Defina o status do cliente no momento da conversão, por exemplo, NEW / EXISTING.
Razão	Obrigatório	Editável	Forneça um código de razão válido para a modificação.

*Pelo menos um caminho de identificador deve ser fornecido, ou seja, ou ActionId ou (*OrderId/Oid *+ ActionTrackerId)

Arquivos de modelo

• Modelo de modificações em nível de pedido

• Modelo de aprovações em nível de pedido

Reversões em nível de pedido

Isto é para quando você deseja reverter ações acionadas por parceiros em lote no nível do pedido, em vez do nível do item, por exemplo, reverter vários pedidos.

Parâmetros aceitos

Campo	Obrigatório?	Editável?	Observação
ActionID	Obrigatório Condicionalmente*	Não editável	Recomenda-se fornecer este identificador quando a janela de desduplicação for curta.
Oid / OrderId	Obrigatório Condicionalmente*	Não editável	Fornecer este identificador é necessário ao usar ActionTrackerId.
ActionTrackerID	Obrigatório Condicionalmente*	Não editável	Fornecer este identificador é necessário ao usar OrderId/Oid.
Valor	Obrigatório Condicionalmente**	Editável	Definir como 0 para reverter o pedido, a menos que o valor original = 0**
Razão	Obrigatório	Editável	Forneça um código de razão válido para a reversão.

*Pelo menos um caminho de identificador deve ser fornecido, ou seja, ou ActionId ou (OrderId/Oid + ActionTrackerId)

**Se o valor Amount = 0, deixe Valor inalterado para evitar classificar incorretamente como uma modificação.

Arquivos de modelo

• Modelo de reversões em nível de pedido

Modificações em nível de item

Isto é para quando você deseja atualizar dados de ação em lote no nível do item em vez do nível do pedido, por exemplo, alterar o Valor de vários itens em um pedido.

Parâmetros aceitos

Campo	Obrigatório?	Editável?	Observação
ActionID	Obrigatório Condicionalmente*	Não editável	Recomenda-se fornecer este identificador quando a janela de desduplicação for curta.
Oid / OrderId	Obrigatório Condicionalmente*	Não editável	Fornecer este identificador é necessário ao usar ActionTrackerId.
ActionTrackerID	Obrigatório Condicionalmente*	Não editável	Fornecer este identificador é necessário ao usar OrderId/Oid.
SKU**	Obrigatório	Não editável	Forneça o valor SKU do item que deseja modificar.
Valor**	Obrigatório Condicionalmente	Editável	Defina o novo valor do item, ou seja, preço*quantidade. Se você modificar a quantidade, este campo também requer modificação.
Quantidade**	Opcional	Editável	Defina a nova quantidade de itens no pedido.
Categoria**	Opcional	Editável	Defina a categoria do item.
Razão**	Obrigatório	Editável	Forneça um código de razão válido para a reversão.

*Pelo menos um caminho de identificador deve ser fornecido, ou seja, ou ActionId ou (OrderId/Oid + ActionTrackerId)

**Estes campos devem ser incluídos para cada item que você modificar. Os campos identificadores são incluídos apenas uma vez por pedido.

Arquivos de modelo

• Modelo de modificações em nível de item

• Modelo de aprovações em nível de item

Reversões em nível de item

Isto é para quando você deseja reverter dados de ação em lote no nível do item em vez do nível do pedido, por exemplo, reverter vários itens em um pedido.

Parâmetros aceitos

Campo	Obrigatório?	Editável?	Observação
ActionID	Obrigatório Condicionalmente*	Não editável	Recomenda-se fornecer este identificador quando a janela de desduplicação for curta.
Oid / OrderId	Obrigatório Condicionalmente*	Não editável	Fornecer este identificador é necessário ao usar ActionTrackerId.
ActionTrackerID	Obrigatório Condicionalmente*	Não editável	Fornecer este identificador é necessário ao usar OrderId/Oid.
SKU**	Obrigatório	Não editável	Forneça o valor SKU do item que deseja modificar.
Valor**	Obrigatório Condicionalmente	Editável	Defina o novo valor do item, ou seja, preço*quantidade. Se você modificar a quantidade, este campo também requer modificação.
Quantidade**	Opcional	Editável	Defina a nova quantidade de itens no pedido.
Razão**	Obrigatório	Editável	Forneça um código de razão válido para a modificação.

*Pelo menos um caminho de identificador deve ser fornecido, ou seja, ou ActionId ou (OrderId/Oid + ActionTrackerId)

**Estes campos devem ser incluídos para cada item que você modificar. Os campos identificadores são incluídos apenas uma vez por pedido.

Arquivos de modelo

• Modelo de reversões em nível de item

O SKU O7427540 aparece duas vezes neste exemplo porque uma linha está revertendo (Amount=0) e outra está modificando (Amount=15).

Observação: Observação: Se você prever ter OrderIds duplicados e optar por usar a combinação de OrderId + ActionTrackerId, a impact.com aplica sua atualização ao mais recente ActionId por padrão. Use o antigo ActionId se você quiser aplicar a atualização ao mais antigo ActionId.

Códigos de Razão

Toda vez que você modificar ou reverter dados de ação, deve fornecer uma razão. Use o código de razão relevante abaixo para explicar por que a ação está sendo atualizada.

Aviso: Passar um valor não aceito resultará na não processagem da entrada e no retorno de um erro. Se você precisar de códigos de razão personalizados, entre em contato com seu CSM ou contatar o suporte para discutir Códigos de Disposição.