A API do marketplace mudou: como mapear o risco antes de a integração parar
Um inventário simples de dependências transforma o aviso de descontinuação em plano com prazo, em vez de incidente que paralisa pedidos e faturamento.
TL;DR
- Toda operação que vende em marketplace depende de APIs externas que mudam: versões são descontinuadas, campos mudam de formato, limites de chamada caem.
- O risco não é a mudança. É descobrir no dia em que o pedido parou de entrar. Por isso as dependências precisam estar inventariadas antes do aviso de descontinuação.
- O inventário liga cada chamada de API a uma jornada crítica (pedido, estoque, preço, nota, rastreio), o que mostra o impacto real e a ordem de substituição.
- Com o mapa pronto, o aviso de mudança vira um plano com prazo, e não um incidente.
Quando a API de um marketplace muda, o risco se controla com um mapa feito antes do aviso: a lista de cada chamada que a operação faz àquela API, ligada à jornada que ela sustenta (receber pedido, atualizar estoque, publicar preço, enviar nota, informar rastreio) e ao impacto de ela parar. Com esse inventário, a descontinuação de uma versão vira um plano de substituição com prazo. Sem ele, vira uma corrida no dia em que os pedidos param de chegar.
Por que a mudança de API pega a operação de surpresa
Marketplaces evoluem as APIs o tempo todo. Uma versão antiga é descontinuada com alguns meses de aviso, um campo passa a ser obrigatório, um limite de chamadas é reduzido, um formato de resposta muda. O aviso costuma chegar por e-mail técnico, num portal de desenvolvedores, ou num comunicado que ninguém da operação lê.
Na prática de implantação, o padrão de surpresa é sempre parecido. A integração foi feita anos antes, por alguém que já não está no time, e ninguém sabe exatamente quais chamadas ela faz. Quando a versão é desligada, a primeira notícia é operacional: o estoque parou de atualizar, os pedidos pararam de entrar, o preço ficou congelado.
O inventário de dependências
Dependências de APIs externas precisam ser inventariadas antes de uma descontinuação. O inventário não precisa ser sofisticado, mas precisa responder a cinco perguntas para cada chamada:
- Qual chamada? O recurso e a versão usados (pedidos, estoque, preço, catálogo, nota, rastreio).
- Qual jornada ela sustenta? O que para na operação se essa chamada falhar.
- Com que frequência roda? Em tempo real, a cada hora, uma vez por dia.
- Quem é o dono? A pessoa ou o fornecedor que responde por ela.
- O que acontece se falhar? A operação para, atrasa ou continua com dado velho?
O mapa de impacto: o que para primeiro
Com o inventário, o mapa permite avaliar o impacto sobre jornadas críticas e planejar substituições. A ordem costuma ser esta:

Jornadas que param a venda. Receber pedido e atualizar estoque. Se o estoque não atualiza, o marketplace vende o que não existe, e o cancelamento custa reputação e, em muitos casos, penalidade.
Jornadas que param o faturamento. Envio de nota e confirmação de despacho. O pedido entra, mas não fecha.
Jornadas que degradam a operação. Atualização de preço, rastreio, perguntas de clientes. A venda continua, com dado desatualizado.
Jornadas de apoio. Relatórios, conciliação. Podem esperar.
Essa classificação define o que precisa ser substituído primeiro e o que pode conviver por algumas semanas com uma solução provisória.
Do aviso ao plano
Quando o aviso de descontinuação chega, o mapa transforma o comunicado em tarefas:
- Identificar as chamadas afetadas no inventário.
- Classificar pelo impacto na jornada.
- Planejar a substituição com prazo anterior ao desligamento, deixando folga para teste.
- Testar num ambiente separado, com pedidos reais simulados, antes de trocar em produção.
- Monitorar a primeira semana depois da troca, com alerta para pedido que não entrou e estoque que não atualizou.
Concentrar as integrações de vários marketplaces numa camada única facilita esse trabalho, porque a mudança de um canal é tratada num lugar só, sem mexer no ERP. É o papel do Marketplace Center da CWS Platform, e o tema de integração por prioridade está em integração de sistemas na venda B2B.
Os sinais de que o risco está alto
- Ninguém do time sabe listar as chamadas que a integração faz.
- A integração não tem alerta quando um pedido deixa de entrar.
- Os avisos técnicos do marketplace chegam a um e-mail que ninguém lê.
- Mais de um canal integrado diretamente ao ERP, cada um do seu jeito.
Próximo passo
Peça ao time ou ao fornecedor de integração a lista das chamadas de API que a operação faz a cada marketplace, com a versão usada. Se a lista não existir ou levar mais de uma semana para sair, esse é o risco a tratar primeiro. Confira também quem recebe os avisos técnicos de cada canal.
Perguntas frequentes
O que fazer quando a API de um marketplace vai ser descontinuada?
Identificar no inventário as chamadas afetadas, classificar pelo impacto na operação, planejar a substituição com prazo anterior ao desligamento e testar num ambiente separado antes de trocar em produção.
Como mapear dependências de API numa operação de e-commerce?
Listando cada chamada, a versão, a jornada que ela sustenta, a frequência, o dono e o que acontece se falhar. O inventário simples já mostra o impacto e a ordem de trabalho.
Quais integrações com marketplace são mais críticas?
As que recebem pedido e atualizam estoque, porque param a venda ou geram cancelamento. Depois vêm nota e despacho, que param o faturamento.
Como evitar que a integração com marketplace pare sem aviso?
Com inventário de chamadas, alertas para pedido que não entrou e estoque que não atualizou, e alguém responsável por ler os avisos técnicos de cada canal.
Leia também
- Buybox no marketplace B2B: por que o menor preço não pode decidir sozinho
- Como criar um marketplace B2B viável: as 4 condições que definem a operação
- Marketplace B2B
Sobre esta publicação
Este artigo descreve padrões observados na implantação de integrações pela CWS Platform. Não cita clientes, marketplaces nem números de resultado.
"Estavamos á quase 2 anos tentando implantar uma solução B2B, com a CWS, implantamos em 60 dias."
A integração está travando a sua operação?
Peça o diagnóstico da sua operação ou fale direto com um especialista, como preferir.
Prefiro receber os próximos textos sobre integração com o ERP
Um resumo semanal com os textos novos sobre integração com o ERP, só nas semanas em que sair algum. Sem spam, e você sai com um clique.