Manual de Controle de Pedidos, Status e Sincronização em Tempo Real
Última atualização: Abril de 2026
Aplicável para: Todos os lojistas dropshippers.
1. O Painel Central de Pedidos (/admin/pedidos)
O menu Pedidos (/admin/pedidos) é a central operacional onde você gerencia todas as vendas que entram em suas lojas do Mercado Livre e da Shopee em uma única tela consolidada.
Nele você encontra:
- Identificador do pedido e código da venda no marketplace;
- Nome e contato do comprador;
- Conta de origem (qual das suas lojas realizou a venda);
- Itens comprados e quantidade;
- Fornecedor responsável pela separação;
- Valor de custo do atacado vs valor de venda;
- Status atual da esteira de expedição.
2. O Botão Inteligente "Sincronizar Pedidos"
Embora a Hubiss receba notificações instantâneas de novos pedidos via Webhooks oficiais dos marketplaces, você pode forçar a sincronização de todas as suas lojas a qualquer momento utilizando o botão "Sincronizar Pedidos" localizado no topo da tela de pedidos.
Como a ferramenta opera:
- Varredura Multi-Contas: O sistema identifica todas as contas ativas e autorizadas do seu usuário no Mercado Livre e na Shopee.
- Backfill Inteligente: Executa uma busca direta nas APIs oficiais (
/orders/searchno Mercado Livre eget_order_listna Shopee) para localizar pedidos das últimas horas que ainda não tenham sido processados. - Modal de Diagnóstico Transparente em Tempo Real:
Ao concluir a varredura, uma janela de diagnóstico é exibida na tela com transparência total de infraestrutura:- Barra de Diagnóstico por Conta: Exibe o Método HTTP (
GET/POST), o Endpoint oficial completo consultado (ex.:https://api.mercadolibre.com/orders/search?sort=date_desc&limit=50...ouhttps://partner.shopeemobile.com/api/v2/order/get_order_list) e o Status HTTP retornado (ex.:HTTP 200,HTTP 403); - Métricas Claras: Quantidade de pedidos retornados pela API, já cadastrados no Hubiss e despachados para importação;
- Diagnóstico Preciso de Restrições: Caso o Mercado Livre retorne
403 PolicyAgent(política de escopo restrito de vendas na aplicação), o sistema destaca o motivo sem marcar a conta com erro de postagem ou desautorização, confirmando que as sincronizações de anúncios, estoque e preço permanecem 100% ativas; - Visualizador de Dados Brutos (JSON Oficial da API): Permite inspecionar e copiar com 1 clique o retorno bruto retornado diretamente pelo marketplace para auditoria rápida.
- Barra de Diagnóstico por Conta: Exibe o Método HTTP (
3. Entendendo o Ciclo de Vida dos Status de Pedidos
Para acompanhar a evolução de cada venda, conheça os status oficiais da Hubiss:
┌────────────────┐ Pagamento do ┌────────────────┐ Fornecedor Bipa ┌────────────────┐
│ 1. NEW │ Custo do Fornecedor │ 2. PAID │ e Posta na Coleta │ 3. SHIPPED │
│ (Aguardando │ ────────────────────> │ (Liberado para │ ────────────────────> │ (Em Transporte │
│ Pagamento) │ │ Expedição) │ │ ao Cliente) │
└────────────────┘ └────────────────┘ └───────┬────────┘
│
Transportadora Entrega │
▼
┌────────────────┐ Cancelamento ┌────────────────┐
│ 5. CANCELLED │ <──────────────────────────────────────────────────── │ 4. DELIVERED │
│ (Estorno │ (Antes ou após o envio) │ (Entregue com │
│ Automático) │ │ Sucesso!) │
└────────────────┘ └────────────────┘
NEW(Novo Pedido):
O pedido acabou de ser realizado no marketplace e foi importado para a Hubiss. Está aguardando a compensação do pagamento do custo de atacado ao fornecedor (via saldo Pix na carteira ou cobrança no cartão com auto-pay).PAID(Pago / Liberado para Envio):
O custo do produto foi liquidado junto ao fornecedor. O pedido entra imediatamente na esteira de impressão de etiquetas e separação física no galpão.SHIPPED(Enviado / Em Trânsito):
O fornecedor colou a etiqueta oficial do marketplace, a transportadora (Mercado Envios ou Shopee Envios) bipou o pacote na coleta e o código de rastreamento já está ativo.DELIVERED(Entregue):
O cliente recebeu a mercadoria. O marketplace inicia a contagem para liberação do seu saldo no Mercado Pago ou ShopeePay.CANCELLED(Cancelado):
A venda foi cancelada pelo comprador ou pelo marketplace. O custo do produto pago ao fornecedor é estornado para a sua Carteira Hubiss.
4. Como Funciona o Frete e o Lucro Líquido Real dos Pedidos
Uma das dúvidas mais comuns de quem vende no Mercado Livre e na Shopee é como o frete afeta o lucro:
- Frete Pago pelo Comprador (Frete Normal):
Quando o comprador paga pelo frete no checkout, esse valor é repassado integralmente à transportadora/logística do canal. O lojista não paga nada de frete (Custo de Frete do Lojista = R$ 0,00). O valor do frete pago pelo cliente não é descontado do seu repasse líquido. - Frete Grátis Ofertado pelo Lojista:
Caso o anúncio possua frete grátis configurado (ou exigido pelo marketplace para itens acima de R$ 79,00), a tarifa de envio acordada com o canal é descontada do repasse da venda. - Fórmula de Lucro Líquido Real no Monitoramento de Pedidos:
$$\text{Lucro Líquido} = \text{Valor dos Produtos} - \text{Custo Fornecedor} - \text{Comissão Marketplace} - \text{Frete Lojista (apenas se Frete Grátis)} - \text{Taxa Hubiss}$$
Você pode auditar a composição financeira e as taxas oficiais de cada pedido a qualquer momento abrindo os detalhes da venda no painel.
5. Dicas para Garantir Envio em Menos de 24 Horas
- Mantenha Saldo ou Cartão com Auto-Pay Ativo: Pedidos que entram no status
PAIDautomaticamente não sofrem filas e são despachados no mesmo dia útil se entrarem até o horário de corte do fornecedor. - Não Precisa Imprimir Etiquetas Manualmente: No modelo dropshipping da Hubiss, o fornecedor parceiro imprime a etiqueta e a declaração de conteúdo/nota fiscal diretamente no armazém dele!
6. Como Você é Avisado Quando Entra um Pedido Novo
Não é necessário ficar atualizando a tela nem perguntar ao suporte se a venda entrou:
- Sincronização automática: o marketplace envia o pedido para a Hubiss por Webhook oficial, e ele aparece na hora em Pedidos (
/admin/pedidos). - E-mail automático: a cada pedido recebido, a Hubiss envia um e-mail para o e-mail cadastrado na sua conta, mesmo que você esteja offline. O pedido também fica disponível para consulta no painel.
- Conferência manual: se quiser garantir que nenhum pedido ficou de fora (por exemplo, após uma instabilidade do marketplace), use o botão Sincronizar Pedidos descrito na seção 2.
Mantenha o e-mail de cadastro atualizado em Minha Conta (
/admin/edit-account-info). É para ele que o aviso de pedido novo é enviado.
7. Pedido Atrasado: o que Fazer Quando a Entrega Passa do Prazo
Quando um pedido aparece como PAID ou PRONTO_ENVIO e o prazo de entrega informado ao comprador passa, quase sempre é uma de duas causas:
- Etiqueta travada: o pedido ainda não foi etiquetado pelo canal. Normalmente falta resolver uma pendência no painel do canal (nota fiscal ou dado do anúncio), ou o fornecedor ainda não gerou a etiqueta.
- O que fazer: abra Monitoramento de Pedidos (
/admin/pedidos), localize o pedido e resolva a pendência no site do canal (Mercado Livre ou Shopee). Assim que a etiqueta é liberada, o rastreio começa a se movimentar.
- O que fazer: abra Monitoramento de Pedidos (
- Rastreio parado: o pedido já foi postado e a transportadora não atualizou o status.
- O que fazer: acompanhe o rastreio pelo código no site da transportadora. A Hubiss exibe o código, mas quem atualiza o rastreio é a transportadora; a primeira leitura pode levar até 1 dia útil depois da postagem.
Como a Hubiss não guarda o dinheiro da venda nem emite a etiqueta, o atraso é sempre resolvido no painel do canal (fornecedor ou marketplace), nunca pedindo reembolso para a Hubiss. Se o pedido continuar parado por mais de 2 dias úteis sem nenhuma leitura no rastreio, fale com o suporte do canal também, informando o código do pedido.
Pronto para colocar em prática?
Acesse seu painel agora mesmo para aplicar as configurações e acelerar suas vendas automatizadas.