Quando um cliente compra pelo catálogo do WhatsApp ou pelo seu anúncio em um marketplace conectado, o pedido não vira venda automaticamente. Ele entra como “pendente” numa lista unificada em Canais → WhatsApp → Pedidos recebidos e aguarda uma revisão humana antes de descontar do estoque.
Por que manual?
Input externo nunca deve mexer no seu estoque sem conferência. Três cenários que fazem diferença:
- Cliente cancela a compra no marketplace depois de fazer o pedido — sem revisão manual, você já teria baixado estoque e emitido nota.
- SKU no marketplace ≠ SKU no Jefacil — se o mapeamento estiver errado, baixa o produto errado.
- Cliente duplicou o pedido (manda 2 vezes pelo chat) — sem revisão, vira 2 vendas.
A revisão leva 10 segundos e resolve isso tudo.
Fluxo na prática
1. Pedido chega
Dependendo do canal, via caminhos diferentes:
- WhatsApp Business — cliente escolhe produtos no catálogo do chat e envia pedido. Meta Cloud API manda pro webhook do Jefacil. Cai instantaneamente.
- Mercado Livre / Shopee / Magalu / Amazon — você clica em “Buscar pedidos” no card do marketplace, ou o cron roda automático.
Todos viram linhas em Pedidos recebidos com:
- Cliente (nome e telefone, quando disponíveis)
- Quantidade de itens
- Total em R$
- Data e hora
- Badge da origem (WhatsApp, Mercado Livre, Shopee, Magalu, Amazon)
- Status: Pendente (aguardando conversão)
2. Revisar
Clique numa linha pra ver detalhes do pedido. Confira:
- Cliente é real?
- Produtos batem com o que você tem?
- Preço está coerente?
3. Converter em venda
Clique em “Converter em venda”. O Jefacil:
- Marca o
IncomingOrdercomo CONVERTED. - Abre o PDV da loja ativa com o carrinho já preenchido:
- Mapeia o SKU de cada item do pedido pro StoreProduct da loja.
- Respeita estoque disponível (se pediram 5 e só tem 3, vai 3 e você vê o aviso).
- Aplica preço efetivo (varejo / promo / atacado), não o preço do pedido externo — atenção: se o cliente comprou por um preço promocional que já passou, o PDV vai exibir o preço atual. Ajuste manualmente se for honrar o preço do pedido original.
- Você finaliza o checkout normal: escolhe forma de pagamento, emite NFC-e, etc.
Se algum SKU não bate com o estoque (produto que você tinha no Mercado Livre mas não tem cadastrado no Jefacil), aparece um toast warning com o SKU — você pode adicionar manualmente.
4. Descartar
Pedidos de teste, spam ou compras inválidas: clique em “Descartar”. Vira DISMISSED e some da lista de pendentes. Não é deletado — fica pra auditoria se precisar revisar depois.
Filtros
Dropdown no canto direito filtra por status:
- Pendentes — ainda não convertidos nem descartados (padrão).
- Convertidos — viraram venda.
- Descartados — rejeitados.
O que o pedido traz
O Jefacil guarda o payload bruto do provedor (raw_payload) pra auditoria. O que aparece na interface é o subset essencial:
| Campo | Origem WhatsApp | Origem ML | Origem Shopee |
|---|---|---|---|
| Cliente | contacts[0].profile.name | buyer.nickname | buyer_username ou recipient_address.name |
| Telefone | from | buyer.phone (quando disponível) | recipient_address.phone |
| Total | Soma dos product_items.item_price × quantity | total_amount | total_amount |
| Itens | product_items[] | order_items[] | item_list[] |
Permissões
| Papel | Ver lista | Converter | Descartar |
|---|---|---|---|
MANAGER | ✅ | ✅ | ✅ |
CASHIER | ✅ | ✅ | — |
SELLER | ✅ | ✅ | — |
STOCK | — | — | — |
OWNER e ADMIN passam sempre.
Notificação push
Quando chega um pedido novo (de qualquer canal — WhatsApp, ML, Shopee, Magalu, Amazon), o operador é avisado na hora se tiver o app mobile do Jefacil instalado e logado. A notificação leva direto pra tela de Pedidos recebidos com o pedido em destaque, sem precisar abrir o web.
Não tem app instalado? Continua funcionando — só não tem aviso ativo, você vê os pendentes pelo sino/badge da loja na próxima vez que abrir o sistema.
Limitações conhecidas
- Sem webhook de cancelamento do marketplace — se o cliente cancela no ML depois de feito, o pedido continua como PENDING no Jefacil (você descarta manualmente quando perceber).
- Sem merge de pedidos duplicados — se o cliente manda o mesmo pedido 2x, viram 2 IncomingOrders. Dedup só acontece quando o marketplace reenvia o mesmo
external_id.
Casos de uso
Loja com atendimento humano via WhatsApp — equipe vê o pedido chegando, confere o que o cliente quer, converte em venda e segue o atendimento pelo PDV normal. Zero passo adicional no workflow do atendente.
Loja com anúncios em Mercado Livre + loja física — vendedor responsável pelo online roda “Buscar pedidos” uma vez por manhã, converte os pedidos aprovados do dia, manda pra expedição. O estoque do físico nunca é afetado sem revisão.
Multi-canal sem confusão — o mesmo IncomingOrder model atende WhatsApp, ML, Shopee, Magalu e Amazon. Quando entrarem novos providers (Nuvemshop, etc.), caem no mesmo fluxo — staff nem repara na origem.