Planeje uma transferência controlada do seu catálogo da Trendyol para uma loja própria, abrangendo mapeamento de campos, variantes, preços, estoque, mídia e validação.
Levar produtos da Trendyol para um canal de e-commerce próprio não é simplesmente copiar títulos e preços de um arquivo para outro. Uma migração confiável concilia identidade do produto, atributos de categoria, relações entre variantes, estoque, impostos, direitos de uso de mídia e operações pós-pedido em um único modelo de dados. O objetivo não é encerrar as vendas no marketplace, mas abrir um canal adicional no qual a marca controla seu catálogo.
A documentação oficial para desenvolvedores da Trendyol apresenta a V2 como a área de integração atual. Endpoints e requisitos de campos podem mudar, portanto a implementação deve sempre seguir a documentação V2 vigente e as permissões atribuídas à conta do lojista. Captura de dados de telas, cópia automatizada da interface destinada ao consumidor ou extração não autorizada de dados não são métodos de integração sustentáveis.
Primeiro, determine o que pode ser transferido
Separe os dados em três categorias:
- Dados mestres da marca: SKU próprio da marca, código de barras, nome do produto, descrição, custo, alíquota de imposto e mídia cujos direitos de uso a marca detém.
- Dados do canal: identificadores do produto ou do lojista na Trendyol, mapeamento de categorias, preço no canal e códigos de status específicos do marketplace.
- Dados que podem pertencer à plataforma ou a terceiros: avaliações de clientes, classificações, selos, layout da página e materiais produzidos pela plataforma.
Estruture a nova loja com base na primeira categoria. Mantenha a segunda apenas para mapeamento e conciliação. Verifique explicitamente os direitos antes de transferir qualquer conteúdo da terceira categoria. Em particular, não presuma que classificações e avaliações de clientes sejam conteúdo de catálogo que a marca possa reproduzir livremente.
Crie um dicionário de mapeamento entre origem e destino
Antes da migração, prepare um dicionário de dados aprovado por todos os responsáveis:
| Conceito de origem | Campo de destino | Regra de transformação | Comportamento em caso de erro |
|---|---|---|---|
| merchantSku | canonicalSku | Remover espaços em branco; preservar maiúsculas e minúsculas | Colocar em quarentena se estiver ausente |
| barcode | barcode | Preservar como texto; manter zeros à esquerda | Interromper em caso de duplicidade |
| productMainId | productGroupKey | Agrupar variantes sob um único produto | Reportar variantes sem produto pai |
| categoryId | targetCategoryId | Usar uma tabela de mapeamento aprovada | Manter como rascunho se não houver correspondência |
| attributes | attributes | Padronizar código, valor e unidade | Não publicar se faltarem dados obrigatórios |
| salePrice | channelPrice | Aplicar regras de impostos e margem | Solicitar aprovação abaixo do limite |
| quantity | sourceInventory | Deduzir o estoque de segurança; estabelecer zero como mínimo | Gerar alerta de anomalia |
| imageUrls | mediaAssets | Verificar acesso HTTPS, formato e direitos | Não publicar se a mídia falhar |
Até mesmo o título de um produto exige critério. Um título de marketplace carregado de palavras-chave pode não combinar com a voz editorial da loja própria. Mantenha um nome neutro no catálogo canônico e gere títulos específicos para cada canal. Aplique o mesmo princípio às descrições, ao conteúdo de SEO e às promessas de entrega.
O modelo de variantes é o ponto crítico
Opções de cor, tamanho e volume podem aparecer como linhas de produtos separadas na origem, enquanto a loja de destino as apresenta como opções em uma única página de detalhes do produto. Preserve o SKU individual, o código de barras, o estoque, o preço e a relação com a mídia de cada variante.
Reduzir uma variante “Preto / 38” para “38”, por exemplo, aumenta o risco de expedir o item errado. Uma chave de variante pode ser uma combinação determinística dos códigos de cor e tamanho, mas deve permanecer estável. Teste o produto pai e a matriz de variantes considerando estas condições:
- Duas variantes do mesmo grupo têm a mesma combinação de opções?
- O mesmo código de barras está associado a vários SKUs ativos?
- Todas as variantes têm estoque disponível para venda e preço?
- Uma imagem pertence ao produto pai ou a uma cor específica?
- Uma variante inativa na origem foi reativada acidentalmente no destino?
Uma arquitetura de integração mais segura
Um fluxo direto de “ler da Trendyol e gravar na loja ativa” é frágil. Adicione uma camada de preparação monitorável:
Conexão autorizada à origem → zona de dados brutos → transformação/mapeamento → validação → catálogo canônico → publicação na loja
Uma resposta bruta com registro de data e hora ajuda na investigação de incidentes, mas dados pessoais ou sigilosos desnecessários não devem ser retidos, e o acesso deve ser restrito. As transformações precisam ser repetíveis: processar a mesma versão da origem duas vezes não pode criar produtos duplicados. Uma combinação de identidade do lojista na origem, SKU e versão dos dados pode servir como chave de idempotência.
O conector deve respeitar os limites oficiais, repetir tentativas após falhas transitórias com intervalos cada vez maiores e evitar repetir indefinidamente erros 4xx permanentes. As credenciais não devem ficar no código nem em uma URL de feed; armazene-as em um sistema de gerenciamento de segredos e conceda apenas os privilégios mínimos necessários. A conta do lojista usada na integração deve estar explicitamente autorizada para isso.
Separe a migração inicial da sincronização contínua
A primeira transferência do catálogo é um projeto; as atualizações de estoque e preço são operações contínuas.
- Carga inicial: importe os dados do produto, as variantes, os atributos e a mídia como rascunhos.
- Sincronização de estoque: atualize a quantidade disponível para venda em intervalos curtos e aplique uma margem de segurança por canal.
- Sincronização de preços: defina uma fonte de preços aprovada pelo departamento financeiro; mudanças automatizadas não podem comprometer a margem mínima.
- Sincronização de conteúdo: encaminhe as alterações para revisão, em vez de sobrescrever automaticamente o conteúdo completo da loja própria.
- Desativação: não apague um item quando ele desaparecer ou for encerrado na origem; desative-o, preservando os vínculos com pedidos em aberto e relatórios.
Quando os dois canais vendem o mesmo estoque físico, a “última quantidade conhecida” não é suficiente. É necessário reservar o estoque entre a adição ao carrinho e o pagamento, liberá-lo após um cancelamento e definir uma política para vendas acima do estoque. Para produtos críticos, alocar estoque separado por canal ou usar uma margem de segurança é a proteção mais simples.
Três etapas de validação
Etapa 1 — esquema: campos obrigatórios, tipo, tamanho, valores permitidos, unicidade e relações entre referências.
Etapa 2 — comercial: IVA, preço de tabela/preço promocional, margem de contribuição mínima, estoque, elegibilidade para venda e direitos de uso de mídia.
Etapa 3 — experiência: exibição em dispositivos móveis, seleção de variantes, adição ao carrinho, pesquisa/filtros, informações de entrega e finalização da compra.
No mínimo, o relatório automatizado de conciliação deve mostrar a quantidade de produtos na origem em comparação com as linhas importadas; a quantidade de SKUs e códigos de barras únicos; os totais de produtos pai e variantes; produtos publicados, em rascunho e em quarentena; imagens inacessíveis; e anomalias de preço ou estoque. Inclua também uma amostragem manual por categoria.
Exemplo prático de migração
Considere uma marca de casa e decoração com 600 linhas de produtos na Trendyol. A análise identifica 420 produtos pai e 180 variantes. A primeira etapa se limita a 80 produtos pai com vendas nos últimos 90 dias e estoque confiável. O mapeamento de categorias define 12 categorias de destino, 46 atributos obrigatórios e sete conversões de unidade. Os produtos entram na loja como rascunhos; 11 códigos de barras ausentes, oito SKUs duplicados e 17 imagens inacessíveis vão para a quarentena. Nada é publicado até que essas falhas sejam resolvidas. A aprovação libera primeiro 10 produtos e, em seguida, os 80; 20 pedidos de teste verificam estoque, envio e devoluções de ponta a ponta.
RACI: quem é responsável por cada decisão da migração?
| Frente de trabalho | Responsável pela execução | Responsável final | Consultado | Informado |
|---|---|---|---|---|
| Conexão oficial e segurança | Integração/tecnologia | Liderança de tecnologia | Responsável pela conta da Trendyol | E-commerce |
| Mapeamento de campos e categorias | Operações de catálogo | Liderança de e-commerce | Produto, SEO | Suporte |
| Preços e impostos | Finanças | Liderança de finanças | E-commerce | Gestão |
| Direitos de mídia e textos | Marca/conteúdo | Liderança de marca | Jurídico | Equipe de catálogo |
| Estoque e pedidos | Operações | Liderança de operações | Tecnologia, finanças | Suporte |
| Decisão de lançamento | Gerente de projeto | Liderança de e-commerce | Responsáveis por todas as frentes de trabalho | Empresa |
Lista de verificação para o lançamento
- A documentação oficial V2 atual e as permissões da conta foram confirmadas?
- A identidade na origem e o SKU da marca estão separados e podem ser rastreados?
- Os mapeamentos de categorias e atributos têm versão registrada e foram aprovados?
- A matriz de variantes, a unicidade dos códigos de barras e a relação com a mídia foram validadas?
- As regras de preço, impostos, margem mínima e segurança de estoque foram testadas?
- A integração pode ser executada novamente sem gerar produtos duplicados?
- Há um responsável definido pela fila de erros, pelos alertas, pelas novas tentativas e pelas correções manuais?
- Pelo menos um cenário de cancelamento, devolução e falta de estoque foi testado com um pedido realista?
Quando a migração do catálogo estiver estável, não se limite a listar produtos na nova loja. Conecte coleções selecionadas às vitrines de criadores para gerar demanda para o novo canal. Consulte o guia de feed de produtos para vitrines de criadores para a próxima etapa.
Inicie o cadastro como vendedor de e-commerce ou crie uma conta de marca para levar seu catálogo a um canal próprio e à rede de vendas de influenciadores por meio de um processo controlado.