Selecione a loja para buscar o endereço cadastrado.
Resumo do fechamento individual
Selecione cliente e período para calcular.
Dashboard
—
U
—
Configuração Replay
Escolha uma data e um período para reproduzir a operação de Pedidos. Nenhum pedido será criado ou alterado.
Recebidos0
Em andamento0
Finalizados0
Entregadores0
Replay histórico · posições dos entregadores aproximadas, não GPS
Ocultar controles
Acontecimentos deste período
Os eventos aparecerão durante o Replay.
Filtros do período e operação
Selecione os critérios para analisar os indicadores.
Pedidos
—
—
SLA médio
—
—
TMA médio
—
—
KM médio
—
—
Cobrado do cliente
—
—
Pago ao entregador
—
—
Pedidos por status
Distribuição dos pedidos no período.
—pedidos
Entregadores por status
Situação da equipe no período.
—entregadores
Pedidos por hora
Volume de pedidos agrupado por hora no período selecionado.
Pedidos por hora
Pedidos por turno
Conforme o turno configurado em cada loja.
Top 5 lojas (mais pedidos)
Volume no período selecionado
Top 5 entregadores (mais entregas)
Volume no período selecionado
Relatórios
Relatórios e indicadores operacionais.
Consulte todos os movimentos importados por período e loja.
Filtros
Pedidos, vales, bônus e demais movimentos relacionados às lojas.
Movimentos
—
registros no filtro
Pedidos
—
pedidos no filtro
Vales
—
lançamentos VALE
Bônus
—
lançamentos BÔNUS
Outros
—
ajustes e demais tipos
Valor dos pedidos
—
soma dos pedidos
Cobrado do cliente
—
todos os movimentos
Pago ao entregador
—
todos os movimentos
| Integração | Código | Tipo | Etapa | Loja | Cliente | Entregador | KM | Taxa cobrada | Taxa entregador | Taxa extra | Finalização | Ações |
|---|
Análise loja
Compara o vale calculado pela regra contratual com o vale realmente aplicado no sistema.
Regra: Vale calculado = quantidade de pedidos faltantes × taxa contratual. Vale aplicado = registros VALE já lançados no relatório. Taxa cobrada considera todos os demais movimentos financeiros da loja, inclusive ajustes negativos/positivos. O número de entregadores por turno ignora a janela de limbo configurada da loja.
Pedidos
—
no período
Vale calculado
—
deveria ser aplicado
Vale aplicado
—
já lançado no sistema
Diferença do vale
—
aplicado − calculado
Taxa cobrada
—
pedidos + ajustes financeiros
Taxa extra
—
adicionais identificados
Acima de 5 km
—
pedidos no período
Total cobrado
—
todos os movimentos cobrados
Vendas
—
valor dos pedidos
Custo por pedido
—
total cobrado ÷ pedidos
Total em cobrançasR$ 0,00
Em abertoR$ 0,00
VencidoR$ 0,00
PagoR$ 0,00
Nota fiscal e cobrança possuem controles separados
| Pix / Boleto | Pagamento | Ações | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Carregando... | ||||||||||
Carregando registros...
Novo fechamento
Selecione o período operacional do cliente. O sistema calcula o valor direto do financeiro.
A Stark Bank recebe juros em percentual ao mês. O painel converte automaticamente a taxa informada ao dia × 30.
Faturamento por período - várias lojas
Lojas selecionadas para este fechamento.
| Clique na seleção de lojas acima para começar. | |||||
Mostrando 0 de 0 lojas
Fechamento individual Para uma única loja, com ajuste manual de endereço quando necessário
Enviados hoje—E-mails enviados nesta data
Pendentes—Aguardando envio
Com NFS-e autorizada—Cobranças com NFS-e pronta
Falhas / sem e-mail—Erros no envio ou e-mail ausente
Filtros
Verificando integração SMTP...
Cobranças (e-mails)
0 cobrança(s) selecionada(s)
| Cliente / Loja | Período | Vencimento | Valor | NFS-e | Último envio | Status | Ações | ||
|---|---|---|---|---|---|---|---|---|---|
| Carregando... | |||||||||
0 registros
Modelo e prévia de e-mail
Configure a mensagem e os e-mails da equipe que receberão cópia nos próximos disparos.Modelo de e-mail
Separe os e-mails por vírgula, ponto e vírgula ou linha. A equipe receberá o mesmo e-mail e os anexos. O CC é visível para o cliente; deixe vazio para não copiar ninguém.
Tags disponíveis: cliente, valor, data do fechamento, período, vencimento, forma, link de pagamento, número/status da NFS-e e número do fechamento.
WhatsApp · Cobrança
Envie avisos aos contatos financeiros confirmados com o mesmo fechamento e link de pagamento do e-mail.
Verificando configuração...
Cobranças listadas—Na lista filtrada
Contatos confirmados—WhatsApp financeiro autorizado
Aceitos pela API—Não garante entrega ou leitura
Precisam de atenção—Sem contato ou envio inconclusivo
Filtros
O envio é manual. O aceite da Uazapi não garante entrega ou leitura. Verifique envios inconclusivos antes de tentar novamente.
Cobranças (WhatsApp)
0 cobrança(s) selecionada(s)
| Cliente / Loja | Período | Vencimento | Valor | WhatsApp financeiro | NFS-e | Último envio | Status | Ações | |
|---|---|---|---|---|---|---|---|---|---|
| Abra a aba para carregar as cobranças. | |||||||||
—
Modelo e prévia do WhatsApp
O texto é salvo aqui; URL, token e intervalo ficam em Configuração NFS-e.Modelo de mensagem
Use as tags para inserir os dados reais do fechamento. Nenhuma mensagem é enviada ao salvar.
Faturas
Acompanhe faturas em aberto, vencidas e a vencer.
Valor em aberto
—
a receber
Total vencido
—
fora do prazo
A vencer
—
dentro do prazo
Faturas abertas
—
quantidade
Faturas
Mostrando 0 a 0 de 0 registros
Histórico de importações
Regras de contrato
Tabela base e quantidade mínima de pedidos por dia para cálculo automático do vale.
Somar por turno: quando ativo, o vale é calculado separadamente em cada turno. Quando desativado, o cálculo é consolidado no total do dia.
| Ação |
|---|
Hora do servidor—
•
Próximo pagamentoAgendamento desligado
Saldo Stark
—
Aguardando aprovação
—
Aprovados
—
Processando
—
Em revisão
—
Concluídos hoje
—
Pago hoje
—
Custo Stark hoje
—
Lucro % hoje
—
Lucro líquido hoje
—
| PIX | Ações | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|
Abra a aba para carregar os saques. | ||||||||||
Mostrando 0 a 0 de 0 registros
Integração Stark Bank Carregando…
Carregando segurança da integração...
Ambiente
—
SDK
—
Credenciais
—
Processamento
—
Webhook
—
Diagnóstico técnico recolhido por padrão. Use somente para validar a integração e o webhook.
Como funciona o painel de Saques Guia operacional
Fluxo do saque
Aguardando aprovação → Aprovado → Enviado / aguardando confirmação → Concluído. O saldo do entregador fica reservado enquanto o saque estiver aberto.
Novo saque e taxa
Ao criar um saque manual, a taxa padrão é fixa + percentual. O botão Remover taxa cria somente aquele saque com taxa R$ 0,00. O valor debitado da carteira continua sendo o valor solicitado.
Auto PIX
Quando o Auto PIX está ativo, um saque que ficar Aprovado é enviado automaticamente à Stark. Com Auto PIX desligado, o operador usa Processar PIX.
Pagamento semanal
O agendamento cria e processa saques para saldos elegíveis no dia e horário configurados. É possível marcar Não cobrar taxa no pagamento agendado. Saques já aprovados antes do lote mantêm a taxa original.
Confirmação automática
O webhook é a primeira confirmação do pagamento. Como segurança adicional, o backend reconcilia automaticamente transferências abertas em ciclos periódicos. O botão Conciliar permanece apenas como contingência manual.
Taxa x custo Stark
Taxa é o valor cobrado do entregador pela Box Boy. Custo Stark é a tarifa bancária informada pela Stark e aparece separadamente nos indicadores.
Travas de segurança
O sistema valida saldo, limite diário, chave PIX, titularidade, saldo Stark e impede dois saques abertos do mesmo entregador. Transferências com ID Stark nunca são reenviadas cegamente.
Status de exceção
Em revisão indica que existe dúvida operacional e o saldo continua reservado. Falhou significa que o pagamento não foi concluído. O motivo aparece na própria linha.
Entregadores com saque sem taxa
Cadastre os entregadores autorizados a sacar pelo app sem taxa fixa ou percentual. A isenção é vinculada ao ID e vale somente para solicitações futuras.
Entregadores isentos—Cadastrados nesta lista
Taxa no aplicativoR$ 0,00Fixa e percentual zeradas
VigênciaPróximos saquesHistórico financeiro preservado
Adicionar entregador
Busque por nome, CPF ou ID. Somente cadastros ativos podem ser incluídos.
Digite pelo menos 2 caracteres para buscar.
Lista de isentos
Remover a isenção não altera saques anteriores.
| Entregador | ID | CPF | Isenção | Incluído em | Ações |
|---|---|---|---|---|---|
| Abra esta subpágina para carregar. | |||||
A isenção elimina a taxa de serviço cobrada ao entregador. Eventual tarifa da Stark Bank permanece como custo da Box Boy. O Saque rápido / PickNGo é independente.
Todo lançamento precisa ter uma loja de origem para compor o fluxo financeiro. O crédito será vinculado ao ID do entregador; não haverá transferência Pix automática.
Regras ativas—
Total de programações—
Próxima execução—
Valor semanal previsto—
Nova programação
Configure o valor, origem financeira, responsável e recorrência.
Últimas execuções
Histórico real dos valores registrados automaticamente.
Ainda não há lançamentos.
Histórico de lançamentos automáticos
Comprovante de cada execução: criação da regra, beneficiário, origem, valor e movimento financeiro.
Carregando histórico...
Auditoria de alterações
Todas as criações, inclusões de beneficiário, alterações, pausas e ativações com data/hora e administrador.
Carregando auditoria...
Uma regra alcança cada entregador uma única vez por semana, conforme o critério configurado: pedidos finalizados ou alocados. A loja de origem é obrigatória. Descontos podem gerar saldo negativo. A execução automática não envia PIX.
Regras em massa—
Automáticas ativas—
Próximo processamento—
Nova regra de lançamento em massa
Personalize o tipo, o público elegível, o valor e a automação.
Prévia da semana e entregadores elegíveis
Apenas consulta. Para lançar, salve a regra e confirme a execução.
Selecione os critérios e clique em “Prévia sem lançar”.
Para execução manual, desmarque os entregadores que deseja excluir. A automação utilizará apenas as exclusões cadastradas na regra. Alterar a regra não altera lançamentos anteriores.
Histórico dos lançamentos em massa
Competência, descrição, valores, responsável, status e movimentos individuais.
Sem histórico.
Auditoria de criação e alterações
Apuração do mínimo garantido
Calculado por entregador e dia, com no máximo 2 turnos. Turnos e limbo vêm da configuração de cada loja.
Pedidos no limbo e em lojas de apoio entram na produção do dia, mas não criam um turno adicional. A loja principal do turno é a que tiver mais pedidos; empate: maior valor produzido.
Selecionados: 0 · R$ 0,00
Entregadores/dias0
Complemento calculadoR$ 0,00
PendenteR$ 0,00
Turnos elegíveis0
Selecione o período e clique em Calcular tudo. | |||||||||||
A seleção de pagamentos é preservada entre as páginas. O seletor do cabeçalho marca todos os pendentes do período, inclusive os de outras páginas.
Configuração por loja
Defina o valor garantido por turno em cada dia da semana. Horários e limbo continuam cadastrados na própria loja.
Automação diária
Após o fechamento operacional, o sistema calcula o dia anterior e lança diretamente no financeiro do entregador.
O lançamento é do tipo ADMINISTRATIVO, vinculado ao ID do entregador e à loja principal do turno. Reexecuções reconhecem o que já foi aplicado e lançam somente diferença pendente.
Último dia automático processado: Nunca executado
Histórico e auditoria operacional
Execuções manuais/automáticas e créditos efetivamente criados no financeiro.
Execuções
Créditos
Saque rápido — resultado financeiro
Analisa volume, taxa cobrada, custo da API e lucro dos saques processados pelo bot.
Regra: antes de classificar o saque, o BI procura o CPF do solicitante em lista_saque. Tipo 4 = grátis, tipo 5 = bloqueado; se o CPF não estiver na lista, mantém o fluxo normal. Um saque concluído custa R$ 0,99 de API.
Solicitações
—
registros no filtro
Consultas de saldo
—
intenção 1
Saques com taxa
—
intenção 3
Saques grátis
—
intenção 4
Saques bloqueados
—
intenção 5
Na lista especial
—
CPF encontrado em lista_saque
Saques concluídos
—
pagamentos com sucesso
Valor antecipado
—
volume dos saques concluídos
Taxa cobrada
—
receita bruta do saque rápido
Custo API
—
R$ 0,99 × saques concluídos
Lucro líquido
—
taxa cobrada − custo API
Margem
—
lucro ÷ taxa cobrada
| Rank | Entregador | Solicitações | Saques concluídos | Com taxa | Grátis | Bloqueados | Valor antecipado | Taxa cobrada | Custo API | Lucro |
|---|
Resultado por dia
| Data | Solicitações | Consultas | Saques | Valor antecipado | Taxa cobrada | Custo API | Lucro | Margem |
|---|
Resultado por origem
| Origem | Solicitações | Saques | Taxa cobrada | Custo API | Lucro |
|---|
| Data/hora | Entregador | Intenção efetiva | Regra da lista | Origem | Valor | Taxa | Custo API | Lucro | Status | Retorno |
|---|
GPS dos entregadores indisponível
Ranking Entregadores
Ranking individual pelo SLA dos pedidos finalizados no período.
Como o ranking funciona:
SLA = pedidos concluídos em até 30 minutos ÷ pedidos com tempo válido.
Em caso de empate no SLA, quem possui mais pedidos aparece primeiro.
Entregadores
—
no ranking atual
Pedidos
—
pedidos analisados
SLA geral
—
ponderado pelos pedidos
Atrasos
—
acima de 30 min
TMA médio
—
aceite → finalização
| Rank | Entregador | Pedidos | No SLA | Atrasos | SLA |
|---|
Maior volume de pedidos
Top 15 entregadores por quantidade de pedidos.
| Rank SLA | Entregador | Lojas | Pedidos | No SLA | Atrasos | SLA | TMA médio | KM médio | Turnos |
|---|
Distribuição geográfica dos pedidos finalizados do relatório.
Filtros do período e operação
Selecione os critérios para analisar os dados no mapa.
Pedidos
—
No período
Mapeados
—
—
Pendentes
—
—
Atrasos
—
—
SLA geral
—
Pedidos com SLA válido
Carregando mapa...
Volume de pedidosConcentração de pedidos finalizados.—
Áreas mais quentes
Regiões com maior concentração de pedidos finalizados.
#ÁREAPEDIDOS
Geocodificação automática
Processa e localiza automaticamente os pedidos no mapa.
Pedidos processados——
Carregando situação...
Nova importação
A base é tratada pela API e gravada no PostgreSQL. Importações anteriores não são substituídas.
Escolha obrigatória: PickNGo não gera saldo; Box Boy gera.
Diagnóstico de desempenho
Registra tempos nesta aba, sem pedidos, clientes, tokens ou credenciais. Compare os mesmos testes antes e depois da atualização.
Carregando documentação da API...
＋
Cadastrar acesso
Crie um novo acesso para o sistema e defina a modalidade para controlar as permissões.
Liderança: visão geral das lojas liberadas e somente valores pagos aos entregadores.
Selecione um usuário.
Atividades
0 registros
Mostrando 0 a 0 de 0 registros
| Carregue os logs. | |||||||
Total de entregadores—Cadastros no sistema
Bloqueados—Acesso indisponível
Pendentes de revisão—Aguardando análise
Aprovados—Cadastros aprovados
Filtros
Entregadores0 registros
| Selecionar | # | Nome | Telefone | Cidade | Veículo | Data de cadastro | Saldo | Status | Ações | |
|---|---|---|---|---|---|---|---|---|---|---|
| Carregando... | ||||||||||
Página 1
Filtros
Empresas / Lojas
Carregando...
0 selecionada(s)
| Selecionar | Imagem | Empresa | Identificador | Razão social | CNPJ | Origem | Situação | Filtros | Último pedido | Ações |
|---|---|---|---|---|---|---|---|---|---|---|
| Carregando lojas... | ||||||||||
Carregando comissões...
CONFIGURAÇÕES · DISTRIBUIÇÃO ANDROID
Abrir página do entregador ↗
Aplicativo Box Boy Entregador
Envie o APK compilado, confira os dados e publique uma versão por vez. O link é público, mas somente o Administrador publica.
VERSÃO PUBLICADA
Carregando...Aguardando conexão com o servidor.
—LINK PARA ENTREGADORES
/baixar-appCompartilhe apenas este endereço oficial.
ARMAZENAMENTO E SEGURANÇA
Verificando...O arquivo precisa ficar em um volume persistente na VPS. Rascunhos nunca aparecem no site público.
02
Versões e publicação
Confira o instalador e clique em Publicar para liberar o download.
Carregando histórico de versões...
Atenção à assinatura: o Android não atualiza um aplicativo se a assinatura, o package ID ou o versionCode estiver incorreto. Nunca distribua APK debug. A conferência criptográfica no servidor depende da disponibilidade de apksigner.
Clientes
Base consolidada dos clientes que já possuem pedidos operacionais na Box Boy.
| Nome | Telefone | Endereço | Última loja | Valor do pedido | Pedidos | Última compra |
|---|---|---|---|---|---|---|
| Carregando... | ||||||
Gerencie bots, mensagens automáticas, lojas participantes e histórico de envios.
Selecione uma fila ou crie uma nova.
Selecione uma taxa extra ou crie uma nova.
Carregando clãs...
Selecione um clã ou crie um novo.
iFood Sob Demanda
Consulte uma cotação e solicite entregadores do iFood, sem misturar com a frota própria Box Boy.
Integração preparada e desativada até autorização do módulo Shipping.
1. Escolher pedido
As solicitações são vinculadas ao ID do pedido operacional. Somente pedidos abertos e sem entregador Box Boy.
2. Consultar cobertura e cotação
Pedidos iFood são cotados pelo Order ID oficial; pedidos externos exigem coordenadas reais.
3. Conferir preço e solicitar
Selecione uma loja, um pedido e consulte uma cotação.
Dados reais para pedido externo — exigidos pela API Shipping. Não serão preenchidos automaticamente com dados fictícios.
Solicitações e acompanhamento
HTTP 202 significa solicitação recebida, não entregador encontrado. A alocação é confirmada por eventos do iFood.
Carregando histórico…
Gerenciar turnos
Sem configuração personalizada: Almoço 03:00–17:59 • Jantar 18:00–02:59. O limbo padrão dos entregadores é 16:00–18:00 e pode ser alterado por loja.
Lojas
Selecione uma loja.
Selecione uma loja.