Referência de Modificações e 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 substituindo os dados de exemplo pelos seus. Ao adicionar seus próprios dados, siga as diretrizes na tabela de referência relevante para garantir que o envio do seu arquivo esteja formatado corretamente. Assim que o 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 comumente 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.

Veja 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 em espaço reservado
• Entender quais códigos de motivo aplicar e quando

Modificações no nível do pedido

Isso é para quando você quiser 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
ID da ação	Obrigatório condicionalmente*	Não editável	Fornecer este identificador é recomendado quando a janela de deduplicação é curta.
Oid / ID do pedido	Obrigatório condicionalmente*	Não editável	Fornecer este identificador é obrigatório ao usar ActionTrackerId.
ActionTrackerID	Obrigatório condicionalmente*	Não editável	Fornecer este identificador é obrigatório ao usar OrderId/Oid.
Amount	Opcional	Editável	Defina o novo valor total do pedido.
código da moeda	Opcional	Editável	Defina a moeda da receita da ação. Por padrão, será a moeda da sua conta impact.com, se não for informada.
CustomerStatus	Opcional	Editável	Defina o status do cliente no momento da conversão, por exemplo, NEW / EXISTING.
Motivo	Obrigatório	Editável	Forneça um código de motivo válido para a modificação.

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

Arquivos de modelo

• Modelo de modificações no nível do pedido
• Modelo de aprovações no nível do pedido

Reversões no nível do pedido

Isso é para quando você quiser 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
ID da ação	Obrigatório condicionalmente*	Não editável	Fornecer este identificador é recomendado quando a janela de deduplicação é curta.
Oid / ID do pedido	Obrigatório condicionalmente*	Não editável	Fornecer este identificador é obrigatório ao usar ActionTrackerId.
ActionTrackerID	Obrigatório condicionalmente*	Não editável	Fornecer este identificador é obrigatório ao usar OrderId/Oid.
Amount	Obrigatório condicionalmente**	Editável	Defina como 0 para reverter o pedido, a menos que o valor original = 0**
Motivo	Obrigatório	Editável	Forneça um código de motivo válido para a reversão.

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

**Se o original Valor = 0, deixe Amount inalterado para evitar que seja classificado incorretamente como uma modificação.

Arquivos de modelo

• Modelo de reversões no nível do pedido

Modificações no nível do item

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

Parâmetros aceitos

Campo	Obrigatório?	Editável?	Observação
ID da ação	Obrigatório condicionalmente*	Não editável	Fornecer este identificador é recomendado quando a janela de deduplicação é curta.
Oid / ID do pedido	Obrigatório condicionalmente*	Não editável	Fornecer este identificador é obrigatório ao usar ActionTrackerId.
ActionTrackerID	Obrigatório condicionalmente*	Não editável	Fornecer este identificador é obrigatório ao usar OrderId/Oid.
SKU**	Obrigatório	Não editável	Forneça o valor do SKU do item que você deseja modificar.
Amount**	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 precisa ser modificado.
Quantidade**	Opcional	Editável	Defina a nova quantidade de itens no pedido.
Categoria**	Opcional	Editável	Defina a categoria do item.
Motivo**	Obrigatório	Editável	Forneça um código de motivo válido para a reversão.

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

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

Arquivos de modelo

• Modelo de modificações no nível do item
• Modelo de aprovações no nível do item

Reversões no nível do item

Isso é para quando você quiser 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
ID da ação	Obrigatório condicionalmente*	Não editável	Fornecer este identificador é recomendado quando a janela de deduplicação é curta.
Oid / ID do pedido	Obrigatório condicionalmente*	Não editável	Fornecer este identificador é obrigatório ao usar ActionTrackerId.
ActionTrackerID	Obrigatório condicionalmente*	Não editável	Fornecer este identificador é obrigatório ao usar OrderId/Oid.
SKU**	Obrigatório	Não editável	Forneça o valor do SKU do item que você deseja modificar.
Amount**	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 precisa ser modificado.
Quantidade**	Opcional	Editável	Defina a nova quantidade de itens no pedido.
Motivo**	Obrigatório	Editável	Forneça um código de motivo válido para a modificação.

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

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

Arquivos de modelo

• Modelo de reversões no nível do item

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

Observação: Se você espera ter OrderIds duplicados IDs do pedido 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 motivo

Sempre que você modificar ou reverter dados de ação, é preciso fornecer um motivo. Use o código de motivo relevante abaixo para explicar por que a ação está sendo atualizada.

Aviso: A passagem de um valor não aceito resultará no não processamento da entrada e, em vez disso, no retorno de um erro. Se você precisar de códigos de motivo personalizados, entre em contato com seu CSM ou entre em contato com o suporte para discutir Códigos de Disposição.

Código	Descrição
CONS_FRAUD	Fraude do consumidor
CONS_ERROR	Erro do consumidor
ITEM_RETURNED	O item foi devolvido
APPROVED	A ação está aprovada Observação: Se você estiver tentando aprovar ações, Aprovar precisa ser configurado como um código de disposição personalizado.
ORDER_ERROR	Erro do pedido
ORDER_UPDATE	O pedido foi atualizado
PUB_ACT_DISPUTE	Disputa de atividade do parceiro
ADV_ACT_DISPUTE	Disputa de atividade da marca
NOT_COMPLIANCE_TERMS	Não está em conformidade com os termos
ITEM_OUT_OF_STOCK	O item está fora de estoque
TEST_ACTION	Ação de teste
PARTNER_NOT_ACTIVE	Conta do parceiro desativada
CREDITED_DIFFERENT_MP	Creditado para outro parceiro
OUTRO	Outro motivo