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.
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.
{"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.
Comentários
0 comentário
Artigo fechado para comentários.