Integrações na prática

Integrar ERP com marketplace: quem dita o ritmo é o canal

Marketplace não é loja própria: o cadastro segue a regra do canal, o saldo é disputado entre canais e o pedido chega com frete e prazo que não são seus.

Leonardo Peron5 min de leitura

Quem já integrou a loja própria ao ERP costuma tratar o marketplace como o mesmo projeto com outro endereço. É o erro que define o resto: na loja própria você decide a regra; no marketplace, a regra é dele. O canal define o que é um anúncio válido, quando o pedido precisa sair e quando o dinheiro chega. A integração não negocia nada disso — ela se adapta.

O anúncio não é o produto do ERP

No ERP existe um item com código, descrição, preço e saldo. No canal existe um anúncio, que pertence a uma categoria, exige atributos que essa categoria impõe e tem identificador próprio, criado por eles.

São entidades diferentes, e a integração precisa manter a correspondência entre as duas — por canal, porque o mesmo item vira anúncios distintos em lugares distintos. Sem essa tabela, a atualização de preço não sabe onde escrever, e a consequência é confusa: a rotina roda, não dá erro, e o preço não muda em lugar nenhum. É um de-para como qualquer outro, e vale começá-lo cedo com o mapeador.

O segundo problema do cadastro é que o canal recusa em graus. Atributo faltando raramente derruba o anúncio: ele publica com menos exposição. Não há erro para capturar nem alerta para disparar, e a descoberta acontece pela venda que não veio.

O saldo é um só, disputado por todos

Na loja própria, o estoque tem um consumidor. Em operação multicanal, o mesmo saldo físico está anunciado em vários lugares que não sabem um do outro e vendem ao mesmo tempo. Há três desenhos, e é preciso escolher.

Rateio fixo por canal. Cada canal recebe uma fatia do saldo e nunca vende além dela. É simples de explicar e de operar, e o custo é conhecido: quando um canal esgota a fatia, ele para de vender enquanto outro ainda tem peça na prateleira.

Saldo cheio em todos. Cada canal enxerga o total. Vende mais, e vende o que não tem — e aqui está a diferença mais importante em relação à loja própria: cancelar por falta custa reputação no canal, e reputação decide posição na vitrine. O prejuízo não é a venda perdida, é a próxima venda que não aparece.

Reserva no momento do pedido. O saldo sai do disponível quando o pedido entra, antes da confirmação de pagamento. É o desenho mais correto e o que exige mais decisão: quem reserva, por quanto tempo a reserva vale, e quem devolve o saldo se o pedido morre no meio.

A escolha é de negócio, não técnica, e é irmã do problema descrito em o estoque que não bate com o portal. O erro que mais aparece não é escolher errado: é não escolher, deixar a rotina agendada correndo e descobrir a decisão numa campanha.

O pedido vem com regras que não são suas

O pedido do marketplace carrega informação que o seu ERP não tem campo para guardar: modalidade logística, identificador do envio, etiqueta emitida pelo canal, prazo de despacho contado pelo relógio deles. Integração escrita para loja própria descarta esses campos porque não sabe o que fazer com eles — e a expedição perde o prazo por não saber que existia um.

Quando o canal também armazena e envia, o problema muda de natureza: o saldo no centro do canal e o saldo na sua prateleira são estoques diferentes, com prazos diferentes. Somar os dois num número só produz promessa que a operação não cumpre. As páginas de Mercado Livre e Amazon detalham o que cada um desses canais expõe.

O ritmo é ditado por eles

Notificações chegam repetidas, e chegam fora de ordem. Repetição resolve-se com chave estável, que é o assunto de o mesmo evento duas vezes. Ordem é outro problema: um evento antigo que chega depois de um novo sobrescreve o estado correto se o consumo confiar na ordem de chegada. A defesa é comparar o estado ou a versão que veio com o que já está gravado, e descartar o que for anterior.

Some-se a cota de chamadas, que num catálogo grande limita a frequência de atualização — o tema de limite de requisições — e sincronizar tudo o tempo todo deixa de ser uma opção. É preciso decidir o que atualiza rápido e o que pode esperar.

O dinheiro chega depois, e diferente

O que entra na conta é líquido: comissão, tarifa de logística e ajustes já descontados por um cálculo que é do canal. Devolução chega semanas depois da venda. Nada disso se parece com receber por uma venda na loja própria, e o desenho financeiro precisa saber disso antes — é a fronteira com integrar ERP e contabilidade.

O teste que confirma

Antes de abrir volume no canal, com um item real e saldo pequeno:

  1. Publique um anúncio a partir do ERP e confira, na tela do canal, se todos os atributos da categoria foram preenchidos — não confie na ausência de erro.
  2. Zere o saldo no ERP e cronometre quanto tempo o anúncio leva para refletir. Esse número é o tamanho da sua janela de venda a descoberto.
  3. Faça um pedido de verdade e confira se a modalidade de envio e o prazo chegaram ao ERP em campo próprio, não perdidos numa observação.
  4. Reenvie a mesma notificação de pedido e, depois, envie uma notificação antiga após uma nova. O saldo e o status precisam sobreviver às duas.
  5. Cancele esse pedido e confirme que o saldo voltou, e que voltou uma vez só.

Quem passa nos cinco tem o fluxo de fato. Quem não consegue executar o teste porque não existe ambiente para isso já descobriu o primeiro item do escopo — e a decisão anterior a ele está em o que é integração de ERP.

Isso é o que fazemos em integração de sistemas

ERP, e-commerce, CRM, banco e planilha falando entre si por API, webhook ou arquivo. Sem duplicar pedido e sem uma pessoa no meio copiando dado.

Resposta em até 1 dia útil