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

Ao modificar ou reverter dados de ação em massa, 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 arquivo enviado esteja formatado corretamente. Depois que seu arquivo de envio estiver pronto, você pode continuar com enviando suas modificações / reversões em lote arquivo.

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 substitutos

• Entender quais códigos de motivo aplicar e quando

Modificações em nível de pedido

Isto é para quando você quiser atualizar dados de ação em massa no nível do pedido em vez do nível do item, por exemplo, alterar o valor do pedido (Amount) para vários pedidos.

Parâmetros aceitos

Campo	Obrigatório?	Editável?	Observação
ActionID	Condicionalmente Obrigatório*	Não editável	Fornecer este identificador é recomendado quando a janela de deduplicação é curta.
Oid / OrderId	Condicionalmente Obrigatório*	Não editável	Fornecer este identificador é obrigatório ao usar ActionTrackerId.
ActionTrackerID	Condicionalmente Obrigatório*	Não editável	Fornecer este identificador é obrigatório ao usar OrderId/Oid.
Amount	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.
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, 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ê quiser reverter ações conduzidas por parceiros em massa 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	Condicionalmente Obrigatório*	Não editável	Fornecer este identificador é recomendado quando a janela de deduplicação é curta.
Oid / OrderId	Condicionalmente Obrigatório*	Não editável	Fornecer este identificador é obrigatório ao usar ActionTrackerId.
ActionTrackerID	Condicionalmente Obrigatório*	Não editável	Fornecer este identificador é obrigatório ao usar OrderId/Oid.
Amount	Condicionalmente Obrigatório**	Editável	Defina como 0 para reverter 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, ou seja, ou ActionId ou (OrderId/Oid + ActionTrackerId)

**Se o original Amount = 0, deixe Amount 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ê quiser atualizar dados de ação em massa no nível do item em vez do nível do pedido, por exemplo, alterar o Amount de vários itens em um pedido.

Parâmetros aceitos

Campo	Obrigatório?	Editável?	Observação
ActionID	Condicionalmente Obrigatório*	Não editável	Fornecer este identificador é recomendado quando a janela de deduplicação é curta.
Oid / OrderId	Condicionalmente Obrigatório*	Não editável	Fornecer este identificador é obrigatório ao usar ActionTrackerId.
ActionTrackerID	Condicionalmente Obrigatório*	Não editável	Fornecer este identificador é obrigatório ao usar OrderId/Oid.
SKU**	Obrigatório	Não editável	Forneça o valor SKU do item que você deseja modificar.
Amount**	Condicionalmente Obrigatório	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, 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ê quiser reverter dados de ação em massa 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	Condicionalmente Obrigatório*	Não editável	Fornecer este identificador é recomendado quando a janela de deduplicação é curta.
Oid / OrderId	Condicionalmente Obrigatório*	Não editável	Fornecer este identificador é obrigatório ao usar ActionTrackerId.
ActionTrackerID	Condicionalmente Obrigatório*	Não editável	Fornecer este identificador é obrigatório ao usar OrderId/Oid.
SKU**	Obrigatório	Não editável	Forneça o valor SKU do item que você deseja modificar.
Amount**	Condicionalmente Obrigatório	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, 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ê prevê ter duplicatas Oid / OrderIds e optar por usar a combinação de Oid / OrderId + ActionTrackerId, a impact.com aplica sua atualização ao mais novo ActionId por padrão. Use o antigo ActionId se você quiser aplicar a atualização ao mais antigo ActionId.

Para ver uma referência completa e detalhada de parâmetros incluindo descrições dos campos, consulte Referências de Ação e Dados de Conversão da impact.com.

Códigos de Razão

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

Aviso: Passar um valor não aceito resultará na não processamento da entrada e no retorno de um erro. Se você precisar de códigos de motivo personalizados, entre em contato com seu CSM ou contate 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	Item foi devolvido
APPROVED	Ação 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 de pedido
ORDER_UPDATE	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	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
OTHER	Outro motivo