Guia de integração com a Trendyol 2026: API REST, conexão XML & gestão centralizada de lojas

1. Arquitetura da API da Trendyol 2026

A API Marketplace da Trendyol é uma interface RESTful, JSON-sobre-HTTPS, publicada em uma única URL base de produção — https://api.trendyol.com — com um ambiente de staging separado em https://stageapi.trendyol.com. Cada chamada de API é autenticada por meio de autenticação HTTP Basic Auth: o cabeçalho Authorization carrega um par ApiKey:ApiSecret codificado em base64, e o Supplier ID é passado como parâmetro de caminho em cada endpoint associado a um fornecedor. Não há uma troca de token de acesso separada para os vendedores próprios — o Basic Auth é verificado em cada requisição — o que mantém a integração simples, mas significa que credenciais vazadas precisam ser rotacionadas imediatamente pelo painel Partner.

URL base, autenticação, cabeçalhos

POST https://api.trendyol.com/sapigw/suppliers/{supplierId}/v2/products
Authorization: Basic BASE64(ApiKey:ApiSecret)
User-Agent: {supplierId} - SelfIntegration
Content-Type: application/json
Accept: application/json

O cabeçalho User-Agent não é cosmético: a modelagem de tráfego e a contabilidade de rate-limit da Trendyol se baseiam nele. Integradores (como a Zunapro) enviam {supplierId} - Zunapro; os vendedores próprios enviam {supplierId} - SelfIntegration. Cabeçalhos User-Agent mal preenchidos podem provocar respostas 401/403 mesmo com credenciais válidas.

Limites de taxa e cotas

A Trendyol aplica limites de taxa por endpoint e por fornecedor. Os tetos publicados para 2026 são:

• Endpoints de produto — normalmente 60 requisições/minuto por Supplier ID, com tolerância a picos de até 90/min por 30 segundos
• Endpoints de pedido — normalmente 600 requisições/minuto (pedidos é um endpoint de alto tráfego e baixa latência por design)
• Endpoints de atualização de preço & estoque — normalmente 100 requisições/minuto, com cada requisição carregando até 1.000 SKUs em um único lote
• Consultas de categorias & atributos — normalmente 30 requisições/minuto (mudam lentamente, então espera-se um cache agressivo)

Cada resposta inclui os cabeçalhos X-RateLimit-Limit, X-RateLimit-Remaining e, nos 429, Retry-After. Uma integração bem construída usa uma fila do tipo token-bucket por Supplier ID e aplica contrapressão nos 429 com recuo exponencial; a Zunapro implementa isso por padrão para que mesmo os envios em massa de vários milhares de SKUs nunca ultrapassem os limites.

OAuth 2.0 para integradores independentes

Para os integradores independentes de camada intermediária (Zunapro e plataformas SaaS similares que atuam em nome de muitos fornecedores), a Trendyol oferece um fluxo OAuth 2.0 do tipo authorization-code em vez de Basic Auth direto. O integrador registra um client_id / client_secret junto à equipe de relações com desenvolvedores da Trendyol, o fornecedor autoriza o integrador pelo painel Partner, e o integrador recebe um token de acesso válido por 1 hora mais um refresh token para reemissão. Isso evita ter de manipular a ApiKey / ApiSecret em bruto do fornecedor e é o caminho propício a auditorias para clientes corporativos que gerenciam muitas lojas Trendyol.

Webhooks

A Trendyol envia os eventos do ciclo de vida do pedido para a URL do seu webhook registrado: Created, Picking, Invoiced, Shipped, Delivered, Cancelled, Returned, UnDelivered. A carga útil do webhook é um envelope JSON que carrega o ID do pedido e o novo status; seu endpoint deve responder com HTTP 200 em menos de 3 segundos. Em caso de falha, a Trendyol tenta reenviar 5 vezes com recuo exponencial e depois estaciona o evento — por isso uma busca de reconciliação a cada 5 minutos contra /sapigw/suppliers/{id}/orders é uma rede de segurança não opcional.

2. Conexão via API REST — passo a passo

O caminho oficial ideal para se conectar à API REST da Trendyol em 2026 é curto e bem documentado — mas a ordem das operações importa, porque alguns pré-requisitos legais estão a montante da própria API.

2.1 Abrir uma conta de vendedor Trendyol

Acesse partner.trendyol.com e envie um pedido de "Abrir uma conta Trendyol". Você vai precisar de:

• VKN (Vergi Kimlik Numarası) — número fiscal turco (ou registro empresarial equivalente no exterior para a Trendyol International)
• Diário do registro do comércio (Ticaret Sicil Gazetesi) para sociedades limitadas ou por ações
• Circular de assinaturas (imza sirküleri)
• Comprovante de registro ETBİS (Elektronik Ticaret Bilgi Sistemi) — obrigatório para qualquer operador de e-commerce turco desde 2018
• Conta bancária (IBAN TR) em nome da entidade jurídica para os repasses do marketplace

A aprovação normalmente leva de 2 a 5 dias úteis. Uma vez aprovado, o vendedor recebe um Supplier ID e acesso ao painel Partner da Trendyol.

2.2 Gerar a chave de API e o segredo

No painel Partner, abra Configurações da conta → Informações de integração e clique em "Criar chave de API". A Trendyol gera uma chave de API de 40 caracteres e um segredo de API de 40 caracteres. Ambos os valores são exibidos apenas uma vez — não podem ser recuperados depois. Salve-os em um gerenciador de senhas ou, melhor, cole-os diretamente no bloco de integração da Zunapro, que os armazena como segredos mascarados e criptografados em AES-256.

2.3 Primeira requisição de verificação (smoke-test)

Confirme que as credenciais estão ativas acessando o endpoint de informações do fornecedor:

curl -X GET "https://api.trendyol.com/sapigw/suppliers/{supplierId}/addresses" \
  -H "Authorization: Basic $(echo -n 'API_KEY:API_SECRET' | base64)" \
  -H "User-Agent: {supplierId} - SelfIntegration" \
  -H "Accept: application/json"

Uma resposta bem-sucedida retorna os endereços de armazém e de devolução registrados do fornecedor em JSON. Um 401 significa que o cabeçalho Basic Auth está errado; um 403 significa que o Supplier ID não corresponde às credenciais; um 404 significa que o caminho do endpoint está malformado.

2.4 Variante OAuth (para integradores multifornecedor)

Para os integradores independentes, o fluxo OAuth 2.0 tem esta aparência:

1. O integrador redireciona o fornecedor para:
   https://partner.trendyol.com/oauth/authorize
     ?client_id={integratorClientId}
     &response_type=code
     &redirect_uri={integratorRedirectUri}

2. O fornecedor aprova o acesso; a Trendyol redireciona de volta com ?code={authCode}

3. O integrador troca o código por tokens:
   POST https://api.trendyol.com/oauth/token
     grant_type=authorization_code
     code={authCode}
     client_id={integratorClientId}
     client_secret={integratorClientSecret}

4. Resposta: { access_token, refresh_token, expires_in: 3600 }

Os tokens de acesso são válidos por 1 hora e renováveis por 30 dias. A Zunapro gerencia os quatro passos de forma transparente, de modo que o fornecedor vê apenas um único botão "Conectar à Trendyol".

2.5 Publicar seu primeiro produto

Use POST /sapigw/suppliers/{supplierId}/v2/products com um array JSON de itens. O objeto de produto mínimo exige barcode, title, productMainId, brandId, categoryId, quantity, stockCode, dimensionalWeight, description, currencyType (normalmente TRY), listPrice, salePrice, vatRate, cargoCompanyId, um array images (1 a 8 URLs) e um array attributes de IDs de atributos específicos da categoria.

3. Sincronização de produtos em escala

Upload em massa — 1.000 SKUs por lote

O endpoint POST /v2/products da Trendyol aceita até 1.000 SKUs por requisição JSON. Para vendedores com catálogos de mais de 10.000 SKUs, essa é a diferença entre um onboarding de uma hora e um de vários dias. O lote retorna um batchRequestId por chamada; a Trendyol processa cada lote de forma assíncrona e expõe o sucesso / falha por SKU assim que o processamento é concluído (normalmente em 1 a 15 minutos, dependendo da profundidade da fila de validação).

Mapeamento de categorias — o passo mais difícil

A árvore de categorias da Trendyol é profunda e rigorosa. Em 2026, há cerca de 12.000 categorias-folha, cada uma com seu próprio conjunto de atributos obrigatórios e opcionais. Um jeans listado em "Masculino → Calças → Casual" exige os atributos gender, size, color, material e fit-type; um smartphone em "Eletrônicos → Móvel → Telefones" exige brand, model, memory, guaranteeType e warrantyPeriod. Publicar um produto em uma categoria-folha errada, ou na categoria certa mas omitindo um atributo obrigatório, produz uma rejeição silenciosa no resultado do lote.

A abordagem recomendada é:

1. Buscar a árvore de categorias ao vivo em GET /sapigw/product-categories (cachear por 24 h)
2. Para cada categoria-folha, buscar os atributos obrigatórios + opcionais em GET /sapigw/product-categories/{categoryId}/attributes
3. Combinar os SKUs do seu catálogo mestre com as categorias-folha da Trendyol — a Zunapro usa um mapeador ML treinado em milhões de anúncios históricos da Trendyol para sugerir categorias a partir do título + da marca + da sua taxonomia, com uma taxa de correspondência na primeira tentativa acima de 92%
4. Validar cada SKU contra os atributos obrigatórios antes de chamar o endpoint POST, para evitar desperdiçar rate-limit em requisições fadadas ao fracasso

Lista branca de marcas e brandId

Cada produto deve referenciar um brandId que exista no registro de marcas da Trendyol. Marcas novas não podem ser criadas na hora — elas passam por um processo manual de aprovação de marca pelo painel Partner (normalmente de 1 a 3 dias úteis). Use GET /sapigw/brands?name={brandName} para procurar um brandId existente antes de criar produtos.

Regras de upload de imagens

• 1 a 8 imagens por produto
• URLs HTTPS públicas (a Trendyol rastreia e re-hospeda as imagens em seu CDN)
• Mínimo de 1200×1800 px, fundo branco para as categorias de moda
• JPG ou PNG, máx. ~10 MB por imagem
• A primeira imagem se torna a miniatura dos resultados de busca — invista nela

Consulta de status do lote

GET https://api.trendyol.com/sapigw/suppliers/{supplierId}/products/batch-requests/{batchRequestId}

Response:
{
  "batchRequestId": "abc-def-...",
  "status": "COMPLETED",
  "itemCount": 1000,
  "items": [
    { "requestItem": {...}, "status": "SUCCESS" },
    { "requestItem": {...}, "status": "INVALID", "failureReasons": ["INVALID_BARCODE"] }
  ]
}

4. Gestão de pedidos — webhooks e o fluxo de status

O ciclo de vida do pedido 2026

Um pedido da Trendyol percorre um fluxo de status fixo:

Created → Picking → Invoiced → Shipped → Delivered

Fluxos derivados:
  Cancelled (a qualquer momento antes de Shipped)
  Returned (após Delivered, dentro da janela de 14 dias)
  UnDelivered (exceção da transportadora)

Cada transição dispara tanto um evento de webhook (push) quanto se reflete na próxima busca GET /orders (poll). O vendedor é responsável pelas transições Picking → Invoiced → Shipped; os parceiros logísticos da Trendyol controlam Shipped → Delivered.

Recebimento de webhooks e idempotência

Cada webhook carrega um shipmentPackageId único. Processe-o de forma idempotente — a Trendyol de fato tenta reenviar os eventos em uma resposta diferente de 200, e o processamento duplicado do seu lado (dupla emissão de nota, dupla separação) é um risco real. O padrão pragmático é:

POST /webhook/trendyol
{
  "supplierId": 123456,
  "shipmentPackageId": 987654321,
  "status": "Picking",
  "timestamp": 1717930000000
}

Handler:
1. Adquirir um bloqueio sobre shipmentPackageId
2. Verificar o status armazenado; se já for >= "Picking", retornar 200 (no-op)
3. Persistir o novo status, agendar as ações posteriores (nota fiscal eletrônica, tarefa de separação)
4. Retornar HTTP 200 em menos de 3 segundos

Fluxo de cancelamento e reembolso

Os cancelamentos iniciados pelo comprador chegam como webhooks Cancelled; os cancelamentos iniciados pelo vendedor são enviados via POST /sapigw/suppliers/{id}/orders/{orderId}/cancel com um código de motivo de cancelamento (OUT_OF_STOCK, OTHER, etc.). Os reembolsos de itens entregues + devolvidos são tratados automaticamente pela Trendyol; a única obrigação do vendedor é confirmar o recebimento da mercadoria devolvida dentro de 48 horas após o escaneamento da transportadora.

Etiqueta de envio do Trendyol Express

Assim que um pacote passa para o status Picking, solicite a etiqueta de envio via GET /sapigw/suppliers/{id}/orders/{orderId}/labels — a Trendyol retorna um PDF (e, opcionalmente, ZPL para impressoras térmicas) contendo o código de barras do Trendyol Express, o endereço do comprador e o número de rastreamento da encomenda. O código de barras é o único artefato de roteamento da transportadora — imprima, cole, escaneie no seu WMS, deixe em um ponto de coleta do Trendyol Express (ou agende uma coleta por entregador para vendedores de alto volume).

5. Atualizações de estoque & preço em tempo real

O padrão de envio estoque-preço

A Trendyol expõe um endpoint dedicado às atualizações de estoque e preço: POST /sapigw/suppliers/{id}/products/price-and-inventory. Cada chamada aceita até 1.000 itens, com barcode, quantity, salePrice e, opcionalmente, listPrice por item. As atualizações são aplicadas em segundos para o estoque, e em 2 a 5 minutos para o preço (a Trendyol faz cache do preço para a consistência do feed de compras).

POST /sapigw/suppliers/{id}/products/price-and-inventory
{
  "items": [
    { "barcode": "8690123456789", "quantity": 42, "salePrice": 549.90, "listPrice": 699.90 },
    { "barcode": "8690987654321", "quantity": 0, "salePrice": 199.00 }
  ]
}

A arquitetura de sincronização Mestre → Local → Destinos

Para os vendedores que operam vários canais de venda (Trendyol + Hepsiburada + Çiçeksepeti + loja própria), a única arquitetura sensata é um inventário mestre na Zunapro que envia para cada marketplace de destino. A pilha de produção da Zunapro 2026 executa um cron a cada 15 minutos mais um envio orientado a eventos: qualquer mudança de estoque no mestre dispara um envio imediato price-and-inventory para a Trendyol, enquanto o cron garante a consistência eventual para qualquer envio que tenha escapado. Os SKUs são combinados por barcode (primário) ou stockCode (alternativo) — nunca pelo ID de produto interno da Trendyol, que pode mudar ao reatribuir categorias.

Regras de IVA e de exibição de preços

Os preços da Trendyol são com IVA incluído. O regime de IVA (KDV) 2026 da Turquia é de 20% padrão, 10% reduzido (alimentos, livros, medicamentos, bens básicos) e 1% especial (gêneros alimentícios essenciais, certos produtos agrícolas). O vendedor especifica o vatRate por produto e é responsável por escolher a alíquota correta; os erros são sinalizados a posteriori como rejeição de nota fiscal eletrônica pela GİB, o que é caro de corrigir.

Trendyol Fast Sale e sincronização de campanhas

As campanhas de destaque da Trendyol — Trendyol Fast Sale (Hızlı Satış), Trendyol Week, Çarşamba Pazarı (Mercado de quarta-feira) — são campanhas de elegibilidade obrigatória que aumentam a visibilidade dos anúncios mas acarretam uma comissão de campanha adicional de 1 a 3%. Os vendedores inscrevem SKUs nas campanhas via POST /sapigw/suppliers/{id}/products/campaigns com substituições de preço com desconto; a Zunapro valida automaticamente os preços mínimos de campanha contra as suas regras de margem mestras para evitar compromissos abaixo do custo.

6. Alternativa XML / CSV — quando (e quando não) usá-la

O modelo de pull XML

A Trendyol suporta um modelo de feed XML como alternativa ao fluxo POST REST. O vendedor hospeda um arquivo XML em uma URL HTTPS pública que descreve o catálogo; a Trendyol o busca em uma cadência configurável (normalmente a cada 1 a 4 horas). O esquema XML é publicado no painel Partner e espelha a forma do objeto de produto do endpoint REST — barcode, title, brandId, categoryId, attributes, images, preço, estoque.

O mesmo padrão é suportado via CSV (uma linha por SKU) para os vendedores cujo ERP exporta CSV de forma mais natural que XML.

Comparação: API REST vs XML / CSV

Quando XML / CSV é realmente a escolha certa

• ERP legado sem capacidade de cliente HTTP que já exporta XML / CSV todas as noites
• Catálogos de baixa rotatividade (menos de 500 SKUs, mudanças de preço semanais, inclusões de catálogo mensais)
• Migração inicial a partir de outro marketplace, onde uma exportação CSV única acelera a primeira sincronização

Para todo o resto — webhooks de pedido, estoque em tempo real, inscrições em campanhas, sincronização multicanal — o REST é o único caminho viável em 2026. A Zunapro suporta ambos os modos, mas usa REST por padrão e o XML / CSV estritamente como fonte de ingestão ETL a partir dos ERPs legados.

7. Trendyol Express & FBA Trendyol

Trendyol Express — a camada logística

O Trendyol Express é o braço logístico integralmente detido pela Trendyol — lançado em 2018 e que hoje opera a rede de encomendas nativa de e-commerce mais densa da Turquia. Até 2026, ele cobre mais de 50.000 armários de autoatendimento e pontos de coleta ao lado de sua própria frota de entregadores, alcançando 81 províncias com entrega no mesmo dia em Istambul, Ancara, Esmirna, Bursa e Antália, e entrega no dia seguinte para o restante da Turquia continental. Os compradores veem selos "Hızlı Teslimat" (entrega rápida) nos anúncios elegíveis, e o ranking de busca da Trendyol os pondera fortemente.

FBA Trendyol — o armazém logístico da Trendyol

O FBA Trendyol (às vezes chamado de "Trendyol Lojistik Deposu" ou "Trendyol Mağaza Plus") é o equivalente ao Amazon-FBA: os vendedores enviam seu inventário para os centros de fulfillment da Trendyol em Çorlu (a instalação principal, 250.000 m² perto de Istambul), Sancaktepe e Ancara, e a Trendyol cuida do armazenamento, separação, embalagem, entrega de última milha via Trendyol Express e devoluções. Os anúncios FBA carregam um selo distinto "Trendyol'dan Gönderim" e recebem uma ponderação de visibilidade prioritária na busca.

Tarifas e elegibilidade do FBA Trendyol

• Onboarding — candidate-se pelo painel Partner; a equipe comercial da Trendyol analisa o volume mensal, as dimensões dos SKUs e a adequação da categoria
• Tarifa de armazenamento — cobrada mensalmente por metro cúbico de espaço de armazém ocupado; varia conforme a estação (o armazenamento custa mais no Q4)
• Tarifa de separação e embalagem (pick-and-pack) — tarifa fixa por pedido, variável conforme a faixa de peso da encomenda (menos de 500 g, 500 g–2 kg, 2–5 kg, 5–10 kg, 10 kg+)
• Tratamento de devoluções — incluído na tarifa de pick-and-pack para as devoluções padrão; as condições sinalizadas são cobradas à parte

Quando o FBA Trendyol faz sentido

O ponto de equilíbrio do FBA Trendyol em relação ao autoenvio fica em torno de 800 a 1.200 unidades por mês por SKU de armazém para consumíveis, eletrônicos ou moda em grades de tamanhos de rotatividade rápida. Abaixo disso, o autoenvio via depósito no Trendyol Express mais o seu próprio contrato com a Aras / Yurtiçi / DHL costuma ser mais barato. Acima disso, o ganho de conversão do selo "Trendyol'dan Gönderim" mais a promessa de entrega no mesmo dia quase sempre supera o custo de fulfillment por unidade.

8. Integração de nota fiscal eletrônica GİB (e-Fatura / e-Arşiv)

O mandato da GİB

A Gelir İdaresi Başkanlığı (GİB — Administração Tributária) da Turquia tornou a e-Fatura obrigatória para qualquer empresa com faturamento anual acima do limite publicado pela GİB (revisado anualmente; ~3 mi de TRY em 2026) e a e-Arşiv Fatura obrigatória para todas as notas B2C acima de ~30.000 TRY (revisado anualmente). Para os vendedores ativos da Trendyol em 2026, a cobertura de e-Fatura / e-Arşiv é de fato universal — praticamente todo pedido do marketplace precisa produzir uma nota fiscal eletrônica carimbada pela GİB dentro da janela de status do pedido, sob pena de multas.

Os cinco integradores certificados pela GİB

Os vendedores podem usar diretamente o portal da GİB (impraticável nos volumes de um marketplace) ou contratar um Özel Entegratör (integrador especial) certificado pela GİB. Os cinco players dominantes em 2026 são:

• Logo Yazılım — o maior fornecedor de ERP turco; e-Logo para a emissão de notas
• Mikro Yazılım — fornecedor de ERP e nota fiscal eletrônica de médio porte, forte no segmento de PMEs
• Uyumsoft — integrador independente com uma API REST robusta e a maior base de vendedores de marketplace
• Foriba — fornecedor de nível corporativo (adquirido pela Sovos em 2019), forte em setores regulados
• Veriban — alternativa de rápido crescimento, com preços competitivos e uma API amigável para desenvolvedores

O fluxo de nota fiscal eletrônica do marketplace

1. Webhook da Trendyol: status do pedido -> "Picking"
2. A Zunapro busca o detalhe do pedido (nome do comprador, VKN/TCKN, endereço, itens)
3. A Zunapro faz POST do rascunho da nota ao integrador (Logo/Mikro/Uyumsoft/Foriba/Veriban)
4. O integrador assina com o certificado de assinatura eletrônica, submete à GİB
5. A GİB retorna o ETTN (Número Único de Documento Eletrônico)
6. A Zunapro armazena o ETTN, anexa o PDF ao pedido da Trendyol
7. A Zunapro passa o pedido da Trendyol de Picking -> Invoiced via API

Escolha prática em 2026

Para os vendedores novos, Uyumsoft e Veriban são os mais fáceis de integrar (cadastro web, API REST, sem dependência on-premise). Os vendedores que já usam um ERP da Logo ou da Mikro devem permanecer no produto de nota fiscal eletrônica do mesmo fornecedor para a conciliação contábil. A Foriba é a escolha para grandes empresas com fluxos fiscais complexos. A Zunapro vem com as cinco integrações por trás de uma única tela de configuração — escolha o integrador, cole as credenciais de API, e cada pedido da Trendyol gera sua nota automaticamente.

9. Erros comuns e como projetar seu sistema para evitá-los

Incompatibilidade de categoria

Sintoma: o resultado do lote mostra INVALID_CATEGORY ou CATEGORY_NOT_LEAF. Causa: publicar em uma categoria não-folha, ou em uma categoria-folha cujo conjunto de atributos o SKU não atende. Correção: sempre publique apenas em categorias-folha (a API rejeita as não-folha), e pré-valide os atributos contra o conjunto required: true da categoria antes do POST.

Atributos obrigatórios ausentes

Sintoma: MANDATORY_ATTRIBUTE_MISSING em SKUs válidos de resto. Causa: a Trendyol marca ~30% dos atributos como obrigatórios conforme a categoria (gênero para moda, garantia para eletrônicos, etc.). Correção: faça cache do mapa de requisitos de atributos por categoria e bloqueie os POSTs conforme a completude; a Zunapro preenche automaticamente a partir da sua taxonomia mestra onde possível.

Atrasos na sincronização de estoque

Sintoma: um SKU esgotado continua aparecendo em estoque na Trendyol por vários minutos, provocando vendas em excesso. Causa: os envios price-and-inventory são de consistência eventual, com uma latência mediana de ~5–8 segundos, e durante os picos de tráfego (Black Friday, Trendyol Week) a fila pode se estender para 30–60 segundos. Correção: implemente um buffer de segurança local (reserve as últimas 1–2 unidades como buffer de esgotado por SKU de alta velocidade) e envie as mudanças de estoque de forma síncrona no evento de confirmação do pedido, não apenas no cron.

Webhooks perdidos

Sintoma: o webhook de pedido nunca chega ou chega com horas de atraso. Causa: normalmente uma mudança de firewall do lado do vendedor, uma renovação de certificado TLS que quebrou a URL do webhook, ou uma breve queda que ultrapassou o orçamento de 5 tentativas da Trendyol. Correção: sempre execute uma busca de reconciliação paralela a cada 5 minutos contra /sapigw/suppliers/{id}/orders?status=Created&startDate=...; a Zunapro faz isso por padrão e mescla de forma idempotente qualquer pedido buscado que o webhook também tenha entregado.

Vários anúncios, mesmo código de barras (Mükerrer Listing)

Sintoma: um único SKU aparece como vários anúncios da Trendyol, e o estoque é decrementado de forma diferente em cada um. Causa: fusões históricas, entradas duplicadas de código de barras, ou dispersão de um mesmo produto entre várias lojas. Correção: a política de deduplicação ao estoque MIN da Zunapro (introduzida na nossa atualização de produção de 06/06/2026) agrupa todos os anúncios duplicados sob um mesmo código de barras e rastreia o valor de estoque mínimo entre eles, evitando o clássico desastre de "vendido duas vezes em dois anúncios, uma só entrega prometida".

10. Comissão da Trendyol e tarifas de vendedor 2026

A tabela de comissões de 2026 da Trendyol é escalonada por categoria, com três faixas amplas e sem taxa fixa por item. A participação em campanhas (Trendyol Fast Sale, Trendyol Week, Çarşamba Pazarı) acrescenta 1 a 3% adicional sobre a taxa da categoria.

Tarifas de vendedor / de assinatura

A Trendyol não cobra uma assinatura mensal. Não existe um nível "Vendedor profissional" ao estilo da Amazon. Os vendedores pagam:

• Comissão de categoria em cada venda (8–22%)
• Comissão de campanha ao participar do Trendyol Fast Sale / Week (+1–3%)
• Trendyol Express tarifa por envio (paga pelo comprador, mas que flui pelo resultado do vendedor)
• FBA Trendyol armazenamento + pick-and-pack (apenas se inscrito)
• Trendyol Ads CPC (opcional, controlado pelo vendedor)

Ciclo de repasse

Os vendedores padrão são pagos em um ciclo T+14 (14 dias após a entrega do pedido), reduzido para T+7 para os vendedores com uma pontuação de vendedor de primeiro nível. Os pedidos em disputa, as devoluções dentro da janela de 14 dias e os estornos são retidos do repasse. Os repasses caem no IBAN TR registrado.

Marco jurídico turco 2026 — o que os vendedores de marketplace precisam saber

KDV (IVA) e faixas de alíquota de KDV

O IVA turco — KDV (Katma Değer Vergisi) — tem três alíquotas em 2026: 20% padrão, 10% reduzido (alimentos, livros, medicamentos, hotelaria), 1% especial (gêneros alimentícios básicos, agricultura). Os vendedores de marketplace domiciliados na Turquia se registram no KDV pela sua repartição fiscal local; os vendedores transfronteiriços acima do limiar de serviços digitais usam o regime de KDV para não residentes. O campo vatRate de cada POST de produto da Trendyol deve corresponder à alíquota legalmente correta — os erros se propagam para as notas fiscais eletrônicas e podem exigir declarações retificadoras.

e-Fatura / e-Arşiv (obrigatório GİB)

Já abordado em detalhe na seção 8. Em resumo para 2026: cada pedido de marketplace produz uma nota fiscal eletrônica carimbada pela GİB (e-Fatura para B2B / destinatários de e-Fatura registrados, e-Arşiv para B2C). O vendedor é responsável pela emissão dentro da janela de status do pedido. A emissão manual é impraticável nos volumes de um marketplace — escolha um dos cinco integradores da GİB e automatize.

KVKK — o RGPD turco

A KVKK (Kişisel Verilerin Korunması Kanunu — Lei nº 6698) é o regime turco de proteção de dados, estruturalmente similar ao RGPD e aplicado pela KVKK Kurumu. Os marketplaces gerenciam o consentimento e o tratamento do lado do comprador, mas os vendedores permanecem corresponsáveis pelo tratamento em qualquer contato direto de atendimento, marketing ou comunicação pós-compra. As penalidades por descumprimento vão de 60 mil TRY a mais de 3 mi de TRY conforme a classe de infração.

ETBİS — registro de e-commerce obrigatório

ETBİS (Elektronik Ticaret Bilgi Sistemi) é o registro obrigatório do Ministério do Comércio para qualquer operador de e-commerce na Turquia, em vigor desde 2018. Os vendedores devem se registrar antes de listar na Trendyol e declarar os volumes de transações anuais. Os dados do ETBİS alimentam a aplicação da proteção ao consumidor, a triagem antifraude e a análise concorrencial.

Proteção ao consumidor — arrependimento de 14 dias, garantia de 2 anos

• Direito de arrependimento de 14 dias — os consumidores turcos podem devolver qualquer produto comprado à distância dentro de 14 dias, sem motivo (Tüketicinin Korunması Hakkında Kanun, Lei nº 6502)
• Garantia legal de 2 anos — obrigatória nas vendas B2C, independente de qualquer garantia do fabricante
• Informação do produto obrigatória em idioma turco — título, descrição, garantia, política de devolução, tudo em turco

Logística & envio na Turquia — Trendyol Express primeiro

Trendyol Express — a camada dominante

O Trendyol Express é a transportadora padrão em cerca de 70%+ dos pedidos da Trendyol em 2026. O comprador vê frete gratuito ou de baixo custo com entrega no mesmo dia ou no dia seguinte nas grandes metrópoles, além de mais de 50.000 armários de autoatendimento (Trendyol Hızlı Teslimat Noktaları) onde os compradores retiram encomendas 24 horas por dia. Os vendedores deixam os pacotes em um ponto de coleta do Trendyol Express ou agendam uma coleta por entregador; o romaneio de roteamento carrega o código de barras do Trendyol Express obtido pela API de etiqueta do pedido.

As outras transportadoras integradas

• Yurtiçi Kargo — transportadora turca consolidada, rede B2C e B2B sólida, integrada para os pedidos da Trendyol
• Aras Kargo — concorrente com forte cobertura na Anatólia, frequentemente usada para pedidos da Trendyol autoenviados
• DHL Kargo — terceira grande transportadora turca, alternativa comum para vendedores de alto volume
• PTT Kargo — operadora postal estatal, o maior alcance rural, SLAs mais lentos
• Sürat Kargo — player regional, competitivo nas regiões de Mármara e do Egeu

Pilha de envio prática 2026

A pilha pragmática 2026 para um vendedor da Trendyol: Trendyol Express como padrão (é o que os compradores esperam), Yurtiçi ou Aras como alternativa do lado do vendedor para os pedidos autoenviados que perdem a janela de coleta do Trendyol Express, PTT Kargo para os CEPs exclusivamente rurais onde nenhuma outra transportadora é econômica, e FBA Trendyol para os SKUs de rotatividade rápida assim que o volume justifica o compromisso de armazenamento.

Como começar a vender na Trendyol — onboarding em 5 passos

1. Conta de vendedor Trendyol

Candidate-se em partner.trendyol.com. Forneça o VKN, o Diário do registro do comércio, a circular de assinaturas, o comprovante de registro ETBİS e o IBAN TR. Aprovação em 2 a 5 dias úteis.

2. ETBİS + registro fiscal

Registre a entidade jurídica no ETBİS pelo portal do Ministério do Comércio (etbis.gtb.gov.tr) e confirme o registro de KDV junto à repartição fiscal local. Os vendedores estrangeiros que operam via Trendyol International nomeiam um representante turco ou usam o programa de importador oficial da Trendyol.

3. Gerar a chave de API + o segredo

No painel Partner → Configurações da conta → Informações de integração, clique em "Criar chave de API". Copie imediatamente a chave de API (40 caracteres) e o segredo de API (40 caracteres) — eles são exibidos apenas uma vez. Cole-os no bloco da Trendyol da Zunapro, onde são armazenados criptografados em AES-256 e mascarados.

4. Conectar pelo painel da Zunapro

1. Faça login na Zunapro e abra o módulo da Turquia
2. Cole o Supplier ID + API Key + API Secret no bloco de integração da Trendyol
3. Execute a verificação de saúde automática (credenciais, endpoint de endereços, informações do fornecedor)
4. Confirme os mapeamentos de categorias sugeridos pelo ML para os seus 100 principais SKUs
5. Escolha o seu integrador de nota fiscal eletrônica (Logo, Mikro, Uyumsoft, Foriba ou Veriban) e cole essas credenciais
6. Ative "Trendyol Express" + "FBA Trendyol" (se inscrito)

5. Fazer um pedido de teste

Coloque de 3 a 5 pedidos de staging contra stageapi.trendyol.com para exercitar de ponta a ponta os fluxos de pick-pack, impressão de etiqueta, transição de status e reembolso. Uma vez no verde, alterne a integração para produção com um único botão. A primeira sincronização de produção de um catálogo de 5.000 SKUs termina em cerca de 30 a 60 minutos, considerando os limites de taxa da Trendyol.

Os três caminhos de integração com a Trendyol — comparados

Antes de se comprometer com uma arquitetura de integração, é útil comparar lado a lado os três caminhos legítimos.

FAQ de integração com a Trendyol 2026