O ANYMARKET agora oferece suporte completo à gestão de pedidos de Amostra Grátis do TikTok Shop, desde a identificação automática até o envio do código de rastreio.
Essa integração garante conformidade fiscal, automação logística e eliminação de processos manuais.
Índice:
Identificação de pedidos de Amostra Grátis
O TikTok Shop disponibilizou um novo campo em sua API de pedidos chamado gift_retail_price, que contém o valor fiscal dos produtos em pedidos de amostra grátis (free sample, live giveaway e gift with purchase).
A partir desta atualização, o ANYMARKET passou a mapear automaticamente esses valores para permitir o faturamento correto desses pedidos nos ERPs, mantendo o total pago zerado, conforme a política do canal.
Isso permite o faturamento correto dos pedidos de amostra grátis, garantindo conformidade fiscal e eliminando a necessidade de incluir valores fictícios para emissão de notas fiscais.
Além disso, facilita a identificação desses pedidos tanto na interface do ANYMARKET quanto por meio da API, tornando o processo mais simples e transparente.
Novo comportamento no ANYMARKET
Quando um pedido TikTok for identificado como pedido de amostra (is_sample_order = true), o sistema irá:
- Preencher o valor fiscal do item no campo "unit" com o valor de
gift_retail_price; - Aplicar o mesmo valor no campo "discount", garantindo que o total do pedido permaneça R$ 0,00;
- Marcar o desconto com a nova tag de identificação de amostras grátis, conforme descrito abaixo.
Visualização na tela de pedidos
Na tela de Vendas > Pedidos, esses pedidos podem ser facilmente identificados através do novo filtro: “Tipo de desconto”.
Além disso, dentro do detalhe do pedido, será exibida a identificação do desconto no bloco de informações do item, indicando que o pedido se trata de uma amostra gratuita.
Identificação por API
Para integrações via API, a informação estará disponível no campo:
"discountMetadata": [{ "type": ["FREE_ITEM"] } ]Esse campo sinaliza que o pedido contém itens enviados como amostras gratuitas, com valor fiscal indicado no campo unit e desconto equivalente no campo discount.
Exemplo simplificado de resposta de pedido:
{"orderId": "1234567890","items": [{"sku": "ABC-001","unit": 59.90,"discount": 59.90}],"discountMetadata": [{ "type": ["FREE_ITEM"] }] }Observação importante
Essa atualização não altera o total financeiro do pedido, mantendo o valor pago igual a R$ 0,00, em alinhamento com a política do TikTok Shop para amostras grátis.
O campo antigo is_sample_order deixa de ser utilizado nas respostas da API do ANY, sendo substituído pela nova estrutura discountMetadata.
Resumo técnico
Origem (TikTok) | Destino (ANYMARKET) | Descrição |
gift_retail_price | items[].unit | Valor fiscal do item |
gift_retail_price | items[].discount | Valor do desconto aplicado |
is_sample_order=true | discountMetadata=[{"type":["FREE_ITEM"]}] | Identificação de amostra grátis |
Atualização automática de tracking
O ANYMARKET também permite enviar o código de rastreio (tracking) automaticamente para os pedidos de amostra grátis no TikTok Shop para pedidos de Amostra Grátis.
Essa automação elimina o envio manual no painel do marketplace e mantém os status sempre atualizados entre o ANYMARKET, ERP e marketplace. Isso significa redução de erros operacionais e melhora o tempo de expedição.
Como funciona?
1. Configuração da transportadora
No módulo TikTok Shop, configure a transportadora padrão para o fluxo de Amostra Grátis.
Essa transportadora será utilizada em todos os pedidos de amostra grátis, is_sample_order=true.
2. Integração do pedido
Quando o pedido for integrado no ANY, ele já assume automaticamente a transportadora configurada.
No ERP, o pedido já chega com a transportadora definida.
3. Envio e rastreio
Após gerar o código de rastreio no ERP, quando o ANYMARKET receber essa informação vai enviar o tracking e o status de envio para o TikTok Shop.
O canal passa a exibir automaticamente o número de rastreio e o status do pedido atualizado.
O que você precisa saber?
- A atualização de tracking é exclusiva para pedidos de Amostra Grátis (is_sample_order=true).
- É obrigatório ter a transportadora configurada no módulo de integração para que o fluxo ocorra.
- Se não houver transportadora configurada, o pedido não será atualizado no canal.
- O envio de tracking utiliza a API oficial
POST /fulfillment/202309/packages/{package_id}/ship, garantindo aderência total às regras do TikTok Shop.
Este artigo foi útil?
Que bom!
Obrigado pelo seu feedback
Desculpe! Não conseguimos ajudar você
Obrigado pelo seu feedback
Feedback enviado
Agradecemos seu esforço e tentaremos corrigir o artigo