Como consultar a origem do desconto por pedido e por item no ANYMARKET?

É comum que um mesmo pedido em marketplace tenha mais de um desconto aplicado. Em uma única venda, por exemplo, pode haver um desconto oferecido pelo seller e outro concedido pelo próprio marketplace. Além disso, esses descontos podem ser aplicados ao pedido completo ou apenas a produtos específicos.

Sem a indicação clara da origem de cada desconto, o seller pode interpretar como custo próprio um valor que, na verdade, foi subsidiado pelo marketplace. Isso pode impactar a análise de rentabilidade da venda e dificultar a conferência dos valores repassados pelo canal.

Para oferecer mais transparência nesse processo, o ANYMARKET identifica a origem de cada desconto aplicado ao pedido, informando se ele foi concedido pelo seller ou pelo marketplace. Essa informação é apresentada tanto no nível do pedido quanto no nível dos itens vendidos.

Neste artigo, você verá como consultar esses dados na tela do pedido, na planilha de exportação de vendas e também pela API, para operações integradas via ERP.

Neste artigo:

• Como funciona/Como configurar
• Pré-requisitos
• Passo a passo
• Consultando a origem do desconto pela API (integrações com ERP)
• Boas práticas
• Dúvidas comuns

Como funciona/Como configurar

O ANYMARKET já armazena o valor total de desconto aplicado a um pedido e a cada item vendido. Esses campos permanecem disponíveis sem alterações, garantindo a compatibilidade com integrações e processos já existentes.

Além do valor consolidado, o ANYMARKET também armazena a origem dos descontos aplicados quando o canal do pedido envia essa informação, separando o que foi concedido pelo seller do que foi concedido pelo marketplace. Esse detalhamento é disponibilizado em dois níveis:

• Por pedido: quanto do desconto total do pedido veio do seller e quanto veio do marketplace.
• Por item/produto: quanto do desconto aplicado a cada produto do pedido veio do seller e quanto veio do marketplace.

O ANYMARKET identifica, por pedido e por item, todos os tipos de desconto aplicados:

• Cupom de desconto
• Amostra grátis (100% de desconto)
• Moeda virtual do marketplace
• Desconto concedido por pagamento via PIX
• Desconto de programa de fidelidade do canal
• Desconto por compra de kit ou combo de produtos

Essa informação depende de o marketplace de origem enviar os descontos de forma discriminada. Quando o marketplace não envia essa separação, o ANYMARKET continua registrando e exibindo apenas o valor total de desconto. Nesses casos, não há alteração no comportamento atual da plataforma nem das integrações.

Pré-requisitos

Para consultar a origem de um desconto, considere os seguintes pontos:

• Canal do pedido: atualmente, a discriminação da origem dos descontos está disponível apenas para pedidos do TikTok Shop, canal que já envia essa informação de forma separada ao ANYMARKET. Pedidos de outros canais continuam exibindo apenas o valor total do desconto.
• Desconto aplicado: o pedido ou item precisa possuir algum valor de desconto para que a origem seja exibida. Pedidos sem desconto não apresentam essa informação.

Importante: novos canais poderão passar a enviar a discriminação da origem dos descontos futuramente. Consulte esta Central de Ajuda para acompanhar a cobertura mais atual da funcionalidade.

Passo a passo

1. Acesse o ANYMARKET e abra a tela de Vendas > Pedidos e clique para editar o pedido que você quer consultar (no ícone de caneta).
2. Para ver a origem do desconto de um produto específico, localize o campo de desconto do item, na lista de produtos do pedido.
3. Para ver a origem do desconto do pedido como um todo, localize o campo de desconto do pedido, no resumo financeiro da venda.
4. Passe o cursor sobre o ícone ao lado do campo de desconto para abrir o detalhamento.
5. Consulte os valores exibidos: "Desconto Seller: R$ X,XX" indica o valor concedido pelo próprio seller; "Desconto Marketplace: R$ X,XX" indica o valor concedido pelo canal. O detalhamento mostra apenas as linhas que têm valor informado, nunca uma linha zerada ou vazia.
6. Repita a consulta para os demais itens do pedido, se necessário, para ver a discriminação produto a produto.

O detalhamento da origem dos descontos é exibido apenas quando essa informação é enviada pelo marketplace. Caso contrário, apenas o valor total do desconto será apresentado na tela.

Consultando várias vendas de uma vez, pela planilha de exportação

Para conciliar vários pedidos ao mesmo tempo, sem abrir um por um, exporte a planilha de vendas do ANYMARKET. Na aba Dados, quatro colunas trazem a origem do desconto de cada pedido/item exportado:

• Desconto Produto Seller
• Desconto Produto Marketplace
• Desconto Pedido Seller
• Desconto Pedido Marketplace

Células sem valor informado ficam em branco. A aba Documentação da própria planilha traz a descrição dessas quatro colunas, no mesmo padrão das demais colunas já existentes.

Consultando a origem do desconto pela API (integrações com ERP)

Sellers com integração via API/ERP encontram a mesma discriminação no objeto discountMetadata, retornado pelos endpoints GET, POST e PUT de /v2/orders. Quatro novos campos numéricos foram adicionados a esse objeto:

Os campos já existentes items[].discount (nível do item) e discount (nível do pedido) continuam sendo retornados sem nenhuma alteração, já que a discriminação é um complemento, não uma substituição. Um campo sem valor informado é omitido da resposta: ele nunca aparece como 0 ou como null.

Exemplo de payload com discountMetadata discriminado:

"metadata": {
  "discountMetadata": [
    {
      "type": "COUPON",
      "discountProdutoSeller": 10.00,
      "discountProdutoMarketplace": 5.90,
      "discountPedidoMarketplace": 20.00
    }
  ]
}

Neste exemplo, discountPedidoSeller não aparece porque o canal não informou nenhum valor de desconto de pedido concedido pelo seller. Nesse caso, apenas os três campos com valor são retornados.

A documentação completa dos campos, com tipos e exemplos adicionais de payload, está disponível no site developers do ANYMARKET.

Boas práticas

• Ao analisar a rentabilidade de uma venda, verifique a origem dos descontos aplicados. Isso ajuda a identificar quais valores foram concedidos pelo seller e quais foram subsidiados pelo marketplace.
• O detalhamento da origem dos descontos é exibido apenas quando essa informação é enviada pelo canal de venda. Atualmente, essa funcionalidade está disponível para pedidos do TikTok Shop.
• Ao planejar campanhas de preço ou margem, considere o histórico dos descontos aplicados aos pedidos para entender qual parcela foi assumida pelo marketplace e qual impactou diretamente sua operação.
• Para analisar grandes volumes de vendas, utilize a planilha de exportação de pedidos. Ela permite consultar as informações de forma mais rápida do que a análise individual de cada pedido.
• Se sua operação utiliza integração via ERP, os dados de origem dos descontos também podem ser consultados pela API, sem substituir os campos consolidados de desconto já existentes.

Dúvidas comuns

Por que o valor do meu repasse não bate com o valor que eu esperava receber?
Consulte a origem do desconto do pedido na tela de Vendas > Pedidos ou na planilha de exportação de vendas. Na maioria dos casos, a diferença no repasse é explicada por um desconto concedido pelo marketplace.

Por que alguns pedidos não mostram o detalhamento da origem do desconto?
A discriminação da origem dos descontos depende das informações enviadas pelo canal de venda. Como alguns canais ainda não fornecem esse detalhamento, o ANYMARKET pode exibir apenas o valor total do desconto.

Quais canais já enviam a discriminação de origem do desconto?
Atualmente, apenas o TikTok Shop envia ao ANYMARKET a discriminação da origem dos descontos, permitindo identificar separadamente os valores concedidos pelo seller e pelo marketplace. Novos canais poderão passar a disponibilizar esse detalhamento futuramente. Consulte esta Central de Ajuda para acompanhar as atualizações da funcionalidade.

A origem do desconto aparece por pedido ou por produto?
A origem do desconto aparece nos dois níveis: o ANYMARKET indica a origem do desconto do pedido como um todo e, separadamente, a origem do desconto aplicado a cada produto do pedido.

Consigo consultar a origem do desconto de vários pedidos de uma vez, sem abrir um por um?
Sim. Para consultar a origem do desconto de vários pedidos, exporte a planilha de vendas do ANYMARKET e consulte as colunas Desconto Produto Seller, Desconto Produto Marketplace, Desconto Pedido Seller e Desconto Pedido Marketplace, na aba Dados.

Meu ERP é integrado via API. Onde encontro essa informação?
No objeto discountMetadata, retornado pelos endpoints GET, POST e PUT de /v2/orders, nos campos discountProdutoSeller, discountProdutoMarketplace, discountPedidoSeller e discountPedidoMarketplace. Os campos consolidados discount (pedido) e items[].discount continuam sendo retornados normalmente.

Um pedido sem desconto aplicado exibe alguma informação de origem?
Não. A informação de origem do desconto só existe em pedidos que efetivamente tiveram algum desconto aplicado pelo seller ou pelo marketplace.