Como fazer seu feed de produtos ser aceito no Akakçe, Cimri, N11 e ÇiçekSepeti

Se você vende para a Turquia, suas ferramentas de feed quase certamente foram criadas primeiro para o Google Merchant Center e a Meta. Isso vira um problema no momento em que você tenta listar no Akakçe, no Cimri, na N11 ou no ÇiçekSepeti: nenhuma das principais plataformas de feed multicanal (entre elas DataFeedWatch, Channable, Productsup, Feedonomics e Confect) oferece um modelo nativo para qualquer um desses quatro canais. Só a N11 gera pelo menos 13 motivos distintos de rejeição de produtos em seu conjunto de erros de integração, desde um GTIN que "não pertence a esta categoria" até imagens com mais de 5.000 pixels de lado. Este guia é para quem gerencia um feed para a Turquia, internamente ou em uma agência, e precisa ter os produtos aceitos nesses quatro canais sem fazer engenharia reversa de cada um do zero. Ao final, você saberá contra o que cada canal realmente valida, onde termina a documentação pública e o que verificar antes de enviar.

Por que o manual padrão de feeds não funciona aqui

O Google Shopping e o Meta Catalog publicam, cada um, uma especificação única de atributos, em inglês e versionada, que todas as ferramentas de feed processam da mesma forma. O Akakçe e o Cimri são comparadores de preços, e não marketplaces. Eles leem o próprio feed XML ou CSV da loja em vez de definir um esquema único compartilhado, então "a especificação" é, na verdade, o que o plugin de exportação da sua plataforma de loja produzir. A N11 é um marketplace completo, com um modelo de correspondência de catálogo semelhante ao da Amazon: você vincula sua oferta a um GTIN de catálogo existente, em vez de descrever livremente seu próprio produto. O ÇiçekSepeti é um marketplace vertical (flores, presentes e, cada vez mais, varejo em geral) com janelas de entrega no mesmo dia, o que faz da frequência de sincronização de estoque um ponto de falha maior do que a completude dos atributos. Tratar os quatro como um único "canal Turquia" é o motivo mais comum para um feed que passa na validação do GMC ainda ser rejeitado aqui.

N11: a correspondência de catálogo é tudo

A documentação pública para desenvolvedores da N11 expõe um endpoint de árvore de categorias, GET https://api.n11.com/cdn/categories, que retorna categorias aninhadas com um id, parentId, name e um array subCategories; uma categoria com subCategories: null é uma folha, e a N11 exige que você envie os produtos com o id da categoria no nível de folha, e não de uma categoria pai. Abaixo da árvore de categorias, a N11 faz uma correspondência de catálogo baseada primeiro no GTIN: se o código de barras do seu produto ainda não estiver registrado em uma entrada do catálogo da N11, ou estiver registrado para outro vendedor, a listagem é rejeitada em vez de ser criada do zero.

Essa lista de erros vem da própria documentação de suporte da AKINSOFT, parceira de integração da N11, que registra as strings exatas que seu conector recebe de volta da N11. Trate-a como um relato de campo de um conector ativo, e não como a especificação publicada pela própria N11, já que a N11 mantém a versão oficial em seu portal para desenvolvedores.

Akakçe e Cimri: feeds de comparação de preços, não listagens de marketplace

O Akakçe e o Cimri não fazem o checkout na maioria das listagens. Eles direcionam o clique para a sua própria loja e cobram por clique ou, no programa gerenciado "Kolay Sipariş" do Akakçe, uma comissão de cerca de 3,9% do valor do carrinho nos pedidos que eles originam. Ambos aceitam diretamente a exportação XML ou CSV da loja; nenhuma das empresas publica um dicionário de atributos versionado como o GMC faz. Na prática, os próprios plugins de exportação XML das plataformas de e-commerce turcas convergem para um conjunto mínimo de campos semelhante: nome do produto, preço, status de estoque, categoria, URL do produto, URL da imagem e, quando disponível, um GTIN ou MPN. Essa convergência é uma norma de mercado observada entre os implementadores, e não um requisito documentado de nenhuma das plataformas, então confirme isso com a exportação da sua própria plataforma de loja antes de presumir que está completo. Como não há uma especificação formal contra a qual validar, o modo de falha na prática não é uma mensagem de rejeição. É a sublistagem silenciosa: produtos sem um identificador estável não são associados à visualização de comparação de preços "mesmo produto, vários vendedores", então aparecem como uma listagem isolada, em vez de competir na tabela de comparação em que você está pagando para aparecer.

ÇiçekSepeti: o relógio importa mais do que o esquema

O ÇiçekSepeti mantém sua própria academia de vendedores e um portal separado para desenvolvedores (ciceksepeti.dev), além do fluxo padrão de envio de produtos pelo painel descrito ali. O conjunto de atributos em si não tem nada de especial em comparação com a N11 ou o GMC. O que muda é o mix de categorias: flores, plantas e presentes com entrega no mesmo dia são estoques perecíveis ou com janela de tempo, então um feed que sincroniza o estoque uma vez por dia vai vender além do disponível em relação aos horários limite de entrega, algo que raramente acontece com uma listagem de bens duráveis. Se você opera o ÇiçekSepeti junto com categorias de giro mais lento, trate-o como o canal que define seu intervalo mínimo aceitável de sincronização, e não como aquele que você sincroniza com menos frequência porque "só tem algumas centenas de SKUs".

Lado a lado

Uma linha antes e depois: corrigindo uma divergência de catálogo na N11

Digamos que seu feed orientado ao GMC exporte esta linha para uma chaleira:

title: "Electric Kettle 1.7L Black"; category: "Home & Kitchen"; gtin: (blank); image: 6200x4100px

Na N11, isso falha duas vezes: a categoria é um nó pai, e não uma folha, e a ausência do GTIN significa que não há entrada de catálogo à qual se vincular. Você vai receber "Reselect Product Category and Properties" e depois uma resposta de GTIN não encontrado. A linha corrigida usa o id real da categoria folha da N11, obtido no endpoint de categorias, um GTIN real puxado do seu cadastro mestre de produtos (ou proposto do zero pelo painel, se não existir) e uma imagem redimensionada abaixo do limite de 5.000px:

title: "Electric Kettle 1.7L Black"; category_id: 1003924 (leaf: "Su Isıtıcı"); gtin: 8690123456789; image: 2000x1333px

Não há nada de exótico nessa correção. É a mesma disciplina que o GMC impõe com sua própria taxonomia de categorias e seus tamanhos mínimos de imagem. A diferença é que a N11 não vai avisar que a categoria está errada até que a correspondência de GTIN já tenha falhado, então verificar primeiro a profundidade da categoria economiza uma ida e volta.

Checklist antes do envio

• Toda linha destinada à N11 está associada a um id de categoria folha obtido da árvore /cdn/categories atual, e não de uma lista salva na época da integração
• Toda linha destinada à N11 traz um GTIN que já está associado ao catálogo da N11 ou que foi proposto pelo painel
• Os títulos estão dentro da faixa de 2 a 65 caracteres da N11 e as imagens têm menos de 5.000px no lado maior
• As linhas do Akakçe e do Cimri incluem um identificador estável (GTIN ou MPN), mesmo que nenhuma das plataformas rejeite sua ausência diretamente: é a diferença entre competir na visualização de comparação e ficar invisível nela
• A frequência de sincronização de estoque do ÇiçekSepeti é definida pelo seu horário limite de entrega mais apertado, e não pela velocidade média dos seus SKUs
• Os preços de campanha ou promoção estão refletidos no mesmo campo que o canal realmente lê — um preço "de" divergente é uma das causas mais comuns de uma listagem parecer mais barata no seu site do que no canal

O que este guia não cobre e onde ele deixa de valer

Se você vende em uma única plataforma turca e em nenhum outro lugar, um plugin nativo da sua loja (İdeaSoft, Ticimax, T-Soft e similares já vêm com geradores XML para Akakçe/Cimri) vai colocar você no ar com menos configuração do que qualquer ferramenta de feed multicanal, incluindo Feedance, DataFeedWatch e Channable. Você não precisa de regras, enriquecimento nem governança entre canais para um único destino. Este guia também não cobre Trendyol nem Hepsiburada, que têm seus próprios processos de entrada documentados separadamente; e não cobre as condições comerciais completas do Akakçe ou do Cimri, que mudam independentemente da mecânica de seus feeds e que vale confirmar diretamente com cada plataforma antes de comprometer tempo de engenharia. Como o Akakçe e o Cimri não têm nenhuma especificação pública de atributos, trate a lista de campos acima como o denominador comum observado entre os conectores das plataformas de e-commerce turcas, e não como uma garantia. Confirme com o material de integração da sua própria conta antes do primeiro envio.

Perguntas frequentes

O Akakçe e o Cimri exigem GTIN?
Nenhum dos dois publica um requisito rígido, mas produtos sem GTIN têm menos chance de ser agrupados corretamente com as listagens de vendedores concorrentes do mesmo item, que é justamente todo o valor de aparecer em um site de comparação de preços.

Por que minha listagem na N11 foi rejeitada depois de passar no GMC?
Quase sempre é um problema de categoria ou de correspondência de catálogo por GTIN. As listagens com correspondência de categoria da N11 funcionam de forma diferente do campo de categoria em texto livre do GMC; veja a tabela de erros acima.

A N11 tem uma API pública que eu possa usar diretamente?
Sim, em developer.n11.com, incluindo um endpoint de árvore de categorias e o envio de produtos via RestAPI; a documentação mais antiga em magazadestek.n11.com agora redireciona para lá.

Com que frequência preciso sincronizar o estoque com o ÇiçekSepeti?
Com frequência suficiente para cumprir seu horário limite de entrega no mesmo dia mais apertado. Não há um mínimo publicado; a restrição vem da categoria do produto, e não dos limites técnicos da plataforma.

O ÇiçekSepeti é só para flores?
Não, ele se expandiu para presentes e categorias de varejo em geral, mas seu modelo de janelas de entrega continua valendo para todas as categorias listadas nele.

Um único arquivo de feed pode atender N11, Akakçe e Cimri ao mesmo tempo?
Só se ele for construído com as regras de mapeamento de cada canal aplicadas por cima. A N11 precisa de ids de categoria e de correspondência de GTIN que o Akakçe e o Cimri não exigem, então uma única exportação simples tende a atender mal especificamente a N11.

Qual tamanho de imagem a N11 realmente aceita?
Até 5.000 pixels de lado, segundo a documentação de parceiros de integração da N11; não há um mínimo publicado, mas imagens muito pequenas tendem a falhar nas verificações de qualidade de imagem específicas de cada categoria mais adiante.

Esses quatro canais suportam segmentação no estilo custom_label, como o Google Shopping?
Não, a lógica de segmentação e de lances é um conceito do Performance Max/Google. Esses canais funcionam com lógica simples de categoria e comparação de preços, e não com rótulos do lado da campanha.

A Feedance se conecta ao Akakçe, ao Cimri e a mais de 200 outros canais de anúncios e marketplaces a partir de um único feed gerenciado; se quiser uma segunda opinião sobre onde o seu feed falharia antes de enviá-lo, passe-o pela ferramenta gratuita de auditoria de feed de produtos.