E-commerce

Para quem é este documento: quem vende em marketplaces — administradores e vendedores do CRM. O que você encontra aqui: o que cada tela do módulo faz, como o pedido do marketplace vira venda no CRM e como o sistema calcula lucro e previsão de recebimento.

O que é o módulo E-commerce

O E-commerce não é uma loja virtual própria — é a ponte entre o ERP e os marketplaces onde a sua empresa já vende. Ele importa pedidos, converte pedido em venda do CRM (reservando estoque e criando a conta a receber), envia a chave da NF-e de volta ao canal, e ainda calcula quanto sobra de cada venda depois de taxas e custos.

Se o que você procura é o site da própria empresa com vitrine e catálogo, isso é outro assunto — veja Site institucional × e-commerce.

O módulo é um add-on do CRM: usa os mesmos perfis de acesso, o mesmo catálogo de produtos e o mesmo estoque.

Canais suportados

Mercado Livre, Amazon, Magazine Luiza, Shopee, Americanas, Via (Casas Bahia), AliExpress, TikTok Shop e Magis5, que é um hub — agrega vários canais num contrato só e entra na tela como se fosse mais um marketplace.

Mapa do menu

O fluxo, do pedido ao dinheiro

Conta conectada  →  Pedido importado  →  Convertido em venda do CRM
                                          ├─ reserva de estoque
                                          ├─ conta a receber
                                          └─ NF-e enviada ao canal
                                                     ↓
                              Previsão de recebimento (Recebimentos)

Em paralelo, Taxas e ERP / Custos alimentam o cálculo de lucro que aparece em Produtos em vendas e em Recebimentos.

Visão Geral

Painel de saúde das integrações. Três indicadores no topo:

• Contas com problema — contas desconectadas, expiradas ou em erro.
• Jobs rejeitados (DLQ) — sincronizações que falharam depois de todas as tentativas.
• Pedidos pendentes — importados e ainda não convertidos.

Abaixo, dois quadros de contagem: fila de sincronização (jobs por status: recebido, processando, concluído, rejeitado) e pedidos por status.

Depois vem a lista de contas conectadas — marketplace, apelido, status, última sincronização e último erro — e a fila de erros, com os últimos incidentes: marketplace, tipo de job, número de tentativas, erro e quando aconteceu. O botão Reprocessar rejeitados devolve os jobs da DLQ para a fila em um clique.

Esta é a tela para abrir quando "os pedidos pararam de entrar". Na maioria das vezes a resposta está em contas com problema (token vencido) ou na fila de erros.

A tela de cada canal

Cada marketplace tem sua própria tela, com duas partes.

Contas conectadas

Apelido, status, identificador do vendedor (seller), se a credencial está configurada e a data da última sincronização.

Ao cadastrar uma conta você informa o apelido e as credenciais do canal — as URLs de OAuth (autorização e token), escopo, tipo de concessão, endpoint base e região, mais os campos específicos do canal em formato JSON (por exemplo {"client_id":"…","client_secret":"…"} e {"marketplace_id":"…","shop_id":"…"}). A conexão é concluída pelo fluxo OAuth do próprio marketplace.

A conta ainda tem quatro chaves de automação:

Excluir conta é ação de administrador.

Pedidos capturados

Identificador do pedido no canal, status, comprador, valor total e data. Cada pedido pode ser:

• Convertido em venda do CRM — reserva o estoque, cria a conta a receber e passa a exibir o link para a venda gerada.
• Ignorado — sai da fila de pendentes sem virar venda.

Produtos em vendas

Mostra, para o período escolhido, quanto cada produto vendeu e quanto sobrou.

Os cinco indicadores do topo:

A tabela detalha por anúncio: produto, canal, unidades vendidas, receita, preço unitário, custo unitário, taxa unitária, lucro unitário, lucro no período, classificação de desempenho e data da última venda. Há busca por nome, SKU ou anúncio.

Classificação de desempenho

Produto sem custo fica de fora dos totais. A tela avisa quantos são e aponta o caminho: sincronize o ERP em E-commerce › ERP / Custos ou informe o custo à mão. Sem custo, o lucro daquele item não entra em nenhum indicador — nem como zero, nem como prejuízo.

Recebimentos

Responde a "vendi, mas quando o dinheiro cai?". Cada marketplace tem seu próprio ciclo financeiro, e esta tela projeta as datas.

Quatro indicadores: a receber em 7 dias, a receber em 30 dias, total no período e lucro estimado. Abaixo, o gráfico de fluxo de caixa previsto por dia e a quebra por canal no período.

A lista Previsões por pedido traz, para cada pedido: canal, data prevista, valor bruto, taxas, valor líquido, lucro estimado e status (Previsto, Confirmado ou Cancelado).

Ciclos financeiros

Cadastra-se, por canal, a regra que gera a previsão. Excluir um ciclo é ação de administrador:

Taxas

Onde se cadastra quanto cada canal cobra. É esta tabela que alimenta a coluna "taxa" em Produtos em vendas e em Recebimentos.

A regra mais específica vence: canal + categoria supera só canal, que supera a regra global (sem canal e sem categoria). Empatou? Vence a de maior prioridade.

Cada regra tem:

• Canal e categoria (qualquer um dos dois pode ficar vazio, o que significa "todos"), mais o código de categoria do próprio marketplace quando ele for mais específico que a sua categoria interna.
• Tipo: percentual, valor fixo, ou percentual + fixo.
• Percentual e/ou valor fixo, com piso e teto opcionais.
• Faixa de preço de aplicação (de/até), para canais que cobram diferente por faixa.
• Aplica sobre frete: se a comissão incide também sobre o valor do frete.
• Vigência (início e fim) e prioridade.
• Uma descrição livre, do tipo "ML Clássico — Beleza", que é o que aparece como regra aplicada no detalhe do produto.

ERP / Custos

Integração com o Bling ERP v3, por OAuth 2.0. O custo sincronizado aqui é a base do cálculo de rentabilidade.

A tela tem duas partes:

Integrações — apelido, status (conectado, desconectado, expirado, erro), se as credenciais estão configuradas, data da última sincronização, intervalo de sincronização automática e último erro. Ao editar, deixar os campos de credencial vazios mantém as credenciais atuais.

Custos por SKU — lista com SKU, produto, custo efetivo, custo médio, preço no ERP, fonte e data de atualização. A busca aceita SKU ou descrição.

Uma sincronização informa quantos registros foram lidos, criados, atualizados, mapeados e não mapeados. Não mapeado significa que o SKU existe no ERP mas não tem produto correspondente no catálogo — é o que vira "sem custo cadastrado" na tela de rentabilidade.

Inbox unificado

Perguntas e conversas de todos os marketplaces em uma tela só, opcionalmente incluindo o WhatsApp (caixa Incluir WhatsApp nos filtros). Três abas.

Conversas

Quatro indicadores: pendentes, urgentes, SLA estourado e tempo médio de resposta (últimos 30 dias).

A lista mostra comprador, assunto, canal, prévia da última mensagem, não lidas e quanto do SLA já foi consumido. Há busca por comprador, assunto ou texto, e filtro por canal e por status.

No painel de leitura ficam o histórico da conversa, o SLA do canal, o tempo de resposta e o campo de resposta. Conversas vindas de marketplace têm um seletor de status: Pendente, Respondido, Urgente ou Fechado.

O botão Buscar mensagens varre as contas conectadas e traz o que há de novo, informando quantas mensagens foram capturadas em quantas contas.

A tela carrega as conversas mais recentes de cada fonte, até um limite. Quando esse limite é atingido, aparece um aviso pedindo para estreitar os filtros — não é erro, é recorte.

Respostas rápidas

Modelos de resposta reutilizáveis, com título, corpo, atalho (ex.: /prazo) e canal opcional (um modelo pode valer para um canal só ou para todos). A tela mostra quantas vezes cada modelo já foi usado. Na conversa, os modelos aparecem como botões acima do campo de resposta.

SLA por canal

Define, por canal, o tempo-alvo de resposta e a partir de quantos minutos a conversa passa a ser tratada como urgente. É o que alimenta os indicadores de SLA e o destaque das conversas atrasadas.

Como os perfis se dividem

As telas Taxas e ERP / Custos só aparecem no menu do administrador do CRM — são configuração do módulo, não operação do dia a dia.