Tutorial de Marketplaces — Vender em ML, Shopee, Amazon, iFood e mais

Bem-vindo aos Marketplaces — onde você liga o ERP aos grandes canais de venda online (Mercado Livre, Shopee, Amazon, Magalu, iFood, Rappi e outros). Conectada a conta, o sistema mantém preço e estoque sincronizados automaticamente e traz os pedidos de todos os canais para dentro do ERP — onde viram venda, baixam estoque e podem emitir nota. Um só lugar para vender em vários.

1. 1) Conectar a conta do canal (Mercado Livre, Shopee...) — uma vez por canal.
2. 2) Anunciar / vincular os produtos — o de-para entre o seu produto e o anúncio.
3. 3) Sincronizar preço e estoque — o ERP envia automaticamente para o canal.
4. 4) Receber pedidos — os pedidos de todos os canais chegam numa lista só.
5. 5) Faturar e enviar — o pedido vira venda no ERP, baixa estoque e (opcional) emite a nota.

Esta e a tela inicial dos Marketplaces. Aqui voce ve, num relance, quantas contas de canal (Mercado Livre, Shopee, iFood e outros) ja estao conectadas, quantos anuncios estao sincronizados e quantos pedidos chegaram. E o ponto de partida: dela voce abre as configuracoes, os produtos e os pedidos. Nada e criado aqui, e so a visao do conjunto.

Passo a passo

1. No menu lateral, abra Marketplace para cair direto nesta tela inicial.
2. Olhe a primeira fileira de cards: Integracoes Ativas (contas conectadas), Produtos Sincronizados (anuncios), Pedidos Hoje e Faturamento Hoje.
3. Na segunda fileira, confira Pedidos Pendentes, Erros de Sincronizacao e Total de Pedidos dos ultimos 30 dias.
4. No painel Integracoes, veja a lista das contas conectadas com a tarja de status (Ativo, Erro, Expirado ou Pendente).
5. Em Ultimos Pedidos, acompanhe os pedidos que acabaram de entrar pelos canais.
6. Use os atalhos de Acoes Rapidas: Ver Produtos, Ver Pedidos, Nova Integracao ou o botao Sincronizar Tudo.
7. Para conectar um canal novo, clique em Nova Integracao no topo direito.

Antes de vender por um marketplace, voce precisa ligar a sua conta dele ao ERP. Esta tela tem dois blocos: em cima, os canais disponiveis para adicionar (cada cartao liga um canal); embaixo, as contas que voce ja conectou, com o status de cada uma. Conectar e o primeiro passo de tudo.

Passo a passo

1. Abra Marketplace e clique em Configuracoes (ou no atalho Nova Integracao).
2. No bloco Adicionar Marketplace, encontre o canal desejado (Mercado Livre, Shopee, Amazon, Magalu, iFood, Rappi, Uber Eats, 99Food ou Aiqfome).
3. Clique no cartao do canal: o sistema cria a integracao e abre o formulario de credenciais.
4. Em Suas Integracoes (bloco de baixo), acompanhe cada conta ja conectada com o icone, o ambiente e a tarja de status.
5. Use Editar para ajustar a conta, ou Autorizar quando o status ainda nao estiver Ativo.
6. Para tirar uma conta do ar, use Desconectar e confirme na janela que aparece.

Este e o formulario onde voce informa as chaves de acesso da sua conta no canal (Client ID e Client Secret, obtidos no portal de desenvolvedor do marketplace) e escolhe se vai usar ambiente de teste ou de producao. Depois de salvar, o botao Autorizar leva voce para o login do canal e a conexao fica completa.

Passo a passo

1. No bloco Selecione o Marketplace, marque o canal (so aparece ao criar uma integracao nova).
2. Em Identificacao, de um nome amigavel para reconhecer a conta (ex.: Loja Mercado Livre Matriz).
3. Em Credenciais de API, cole o Client ID (App ID) e o Client Secret fornecidos pelo portal do canal.
4. Escolha o ambiente: Producao para vender de verdade, ou Sandbox apenas para testes.
5. Clique em Salvar; o sistema guarda a senha de forma criptografada e nunca a mostra de novo.
6. Na tela de edicao, va ate Status da Conexao e clique em Autorizar Conexao.
7. Faca login na conta do canal quando ele pedir; ao voltar, o status fica Conectado (verde) e o Seller ID e preenchido sozinho.

Aqui ficam os anuncios que ligam um produto do seu ERP a um anuncio no canal (o chamado de-para). Cada linha mostra preco, estoque, desempenho e a saude do anuncio. Esta tela serve para acompanhar e sincronizar: os vinculos nascem da propria sincronizacao com o canal, e nao de um cadastro manual aqui.

Passo a passo

1. Abra Marketplace e clique em Ver Produtos (ou acesse Produtos Sincronizados).
2. Use os filtros do topo para escolher um Marketplace (conta) e um Status (Ativo, Pausado, Encerrado ou Erro).
3. Na tabela, identifique cada anuncio: foto, titulo, SKU/EAN e o ID dele no marketplace.
4. Confira as colunas de Preco, Estoque (com aviso de SEM ESTOQUE ou BAIXO) e Saude do anuncio.
5. Para atualizar um anuncio na hora, clique em Sincronizar agora na linha dele.
6. Use Ativar/Desativar sync para ligar ou pausar a atualizacao automatica daquele item.
7. Clique em Ver no marketplace para abrir o anuncio publico no site do canal.

Esta e a tela central do dia a dia: todos os pedidos que vieram dos seus canais aparecem aqui, com resumo de quantos estao pendentes, pagos, enviados, entregues e cancelados. Os pedidos chegam sozinhos (o ERP busca de tempos em tempos), mas voce tambem pode forcar a busca a qualquer momento. E daqui que voce abre cada pedido e o transforma em venda no ERP.

Passo a passo

1. No menu do modulo Marketplaces, clique em Pedidos para abrir a lista.
2. Olhe os cards do topo: eles resumem quantos pedidos estao em cada situacao (Pendentes, Pagos, Enviados, Entregues, Cancelados) e o faturado dos ultimos 30 dias.
3. Use os filtros de Marketplace e Status para encontrar um grupo de pedidos (ex: so os Pagos do Mercado Livre).
4. Se quiser puxar os pedidos mais recentes na hora, clique em Importar Novos: o ERP vai buscar nos canais conectados.
5. Na tabela, identifique o pedido pela coluna do canal, pelo nome do comprador e pelo valor.
6. Para um pedido ainda nao trazido para o ERP, use a acao de criar pedido no ERP (ele vira venda).
7. Clique no pedido para abrir o detalhe completo e acompanhar o ciclo de vida dele.

Toda conversa do ERP com os canais fica registrada aqui: login/autorizacao, sincronizacao de produto, estoque e preco, importacao de pedidos, webhooks e erros. E o lugar para conferir se algo deu certo ou descobrir por que um pedido nao entrou. Cada linha pode ser expandida para ver os detalhes tecnicos do que aconteceu.

Passo a passo

1. No menu do modulo, clique em Logs (ou Historico) para abrir o registro de operacoes.
2. Olhe os cards do topo: eles contam quantas operacoes deram Sucesso, Erro, Aviso e Info.
3. Use os filtros de Marketplace e de Tipo (login, produto, estoque, preco, importacao de pedido, webhook, erro) para achar o que procura.
4. Filtre por Status (Sucesso, Erro, Aviso, Info) para isolar so os problemas, por exemplo.
5. Clique numa linha para expandir e ver a mensagem completa e os detalhes do erro.
6. Se a lista estiver muito cheia, use Limpar Antigos para remover os registros com mais de 30 dias.
7. Quando achar um erro de pedido, volte a tela de Pedidos para reimportar o pedido afetado.

As palavras do dia a dia, em português simples:

• Canal / Marketplace: a plataforma onde você vende (Mercado Livre, Shopee, Amazon, Magalu, iFood, Rappi...).
• Integração / Conta: a ligação entre uma conta sua num canal e o ERP. Você pode ter várias.
• Credenciais (Client ID/Secret): as chaves de acesso da API do canal, pegas no portal de desenvolvedor dele.
• Autorizar (OAuth): o login no próprio canal que libera o ERP a agir em nome da sua conta.
• Sandbox x Produção: ambiente de teste (sandbox) ou o de verdade (produção).
• Anúncio (de-para): o vínculo entre o seu produto no ERP e o anúncio no canal (1 por produto por canal).
• Sincronizar preço/estoque: o ERP envia o preço de venda e a quantidade atuais para o canal.
• Pedido do marketplace: a compra feita por um cliente no canal, que chega no ERP para ser faturada.
• Status da conta: Ativo (no ar), Pendente (falta autorizar), Expirado (reautorizar) ou Erro.
• Logs / Histórico: o registro do que o sistema fez (sincronizações, erros) — onde investigar problemas.