Catálogo de conectores: o que o selo verde não está prometendo
A diferença entre conector previsto no código e integração homologada, e como montar um plano de entrada em canais que sobrevive ao contato com a realidade.
Numa reunião de planejamento, projetei o catálogo de conectores no telão e vi o diretor comercial anotar sete nomes num papel. Ele contou logotipos. Eu deixei acontecer. Trinta dias depois, um canal estava vendendo, dois esperavam aprovação de credenciamento e quatro nem tinham processo aberto. A culpa foi minha, por não explicar a tela antes de mostrar a tela.
O catálogo reúne 72 canais em seis domínios, com busca e filtros por nome, domínio e estado da integração. Cada cartão traz identidade visual, capacidades, instruções de credenciamento e link para o portal do seller. Por trás dessa vitrine existem 18 classes concretas de conectores no código-fonte. A conta não fecha por acidente, e já explico por quê.
Depois de ler os números do jeito certo, o passo seguinte é o cadastro de contas e credenciais.
O catálogo de conectores tem três estados, e cada um prova pouco
Os metadados classificam 31 canais como disponível, 20 como credenciamento e 21 como indisponível. Esses rótulos descrevem a situação do código e do processo de acesso. Eles não dizem nada sobre a sua maturidade comercial naquele canal.
| Estado | O que significa | O que ainda falta |
|---|---|---|
| Disponível | Existe família ou conector previsto no código | Credencial ativa, contrato e homologação ponta a ponta |
| Credenciamento | A entrada depende de aprovação prévia do canal | Processo comercial e liberação técnica |
| Indisponível | Sem conector previsto | Segue apenas informativo no catálogo |
Por que 72 canais cabem em 18 conectores
O fonte tem 18 classes concretas: Mercado Livre, Shopee, Amazon SP-API, Magalu e IntegraCommerce, Via, Skyhub, Mirakl, GFG e SellerCenter, Shein, TikTok Shop, AliExpress, MadeiraMadeira, Elo7, Feed XML, iFood, Rappi, Carrefour e OLX RPA.
A diferença entre 72 e 18 se explica pelas famílias técnicas. Mirakl, Magalu, Via, Skyhub, GFG e Feed XML compartilham contratos por plataforma, então um conector atende vários canais que rodam sobre a mesma base. Quando descobri isso, minha pergunta em reunião mudou. Parei de perguntar se o canal existe e passei a perguntar sobre qual plataforma ele roda.
Nem todo domínio recebe o mesmo tratamento
Essa assimetria é proposital, e ignorá-la é a origem mais comum de frustração em projeto de integração.
- Produtos: o núcleo do hub, com maior cobertura de publicação, preço, estoque e pedidos
- Comparadores e Feed: atendidos por feed XML público de produtos, com escopo próprio
- Delivery: iFood e Rappi normalizam e consultam pedidos, com limites que descrevo adiante
- Classificados: inclui o protótipo experimental de OLX por automação de painel
- Viagens: segue apenas informativo no catálogo
- Atacado: exige credenciamento e não tem case de conector no factory atual
As condicionais que você precisa mapear antes
Mesmo em canal com conector presente, algumas coisas dependem de condição externa. A importação de anúncios da Amazon depende do fluxo assíncrono de relatórios. A publicação direta em AliExpress, Shein e TikTok depende do schema de categoria e da homologação. Via, Shein, MadeiraMadeira, Elo7 e Rappi têm paths ou escopos finais a confirmar com a documentação entregue no credenciamento.
No delivery, o cardápio de Rappi depende de homologação com o painel do parceiro. Os conectores de iFood e Rappi normalizam e consultam pedidos periodicamente, mas o importador comum grava em pedidos e itens de pedido, e não na estrutura dedicada de delivery. Upload e publicação de cardápio ainda devolvem orientação ou falha controlada.
O caso do protótipo de classificados
O conector de OLX por automação de painel é um protótipo estrutural não operacional. Existem o conector em PHP, o contrato HTTP, a autenticação por token, o navegador automatizado, a persistência de sessão por conta, a detecção de CAPTCHA e os moldes de serviço. As chamadas externas, porém, não funcionam: a publicação devolve identificador sintético marcado como pendente de homologação, atualizar, pausar, republicar e enviar são vazios, listagens voltam vazias e a consulta de pedido devolve objeto vazio.
Some a isso que CAPTCHA e segundo fator exigem login manual, que não existe desvio e que automatizar painel pode contrariar os termos de uso do canal, com risco de suspensão da conta. Aprendi do jeito difícil a nunca colocar item de pesquisa em cronograma de entrega. Esse é item de pesquisa.
Transformando a tela em plano de entrada
- Filtre por domínio e estadoComece pelos canais do domínio Produtos marcados como disponível. É onde a cobertura funcional é maior.
- Descubra a família técnicaSe o canal roda sobre uma plataforma já atendida, o esforço de homologação cai bastante.
- Liste o que é condicionalMarque o que depende de schema de categoria, relatório assíncrono ou confirmação de escopo no credenciamento.
- Rode um piloto pequenoPublique poucos SKUs reais, acompanhe a fila de sincronização por duas semanas e só então amplie.
Se o seu sortimento tem grade, resolva isso antes de abrir canal. O texto sobre variações e grade de produtos nos canais mostra onde a paridade existe e onde ela ainda não existe.