🛡️ Perfil: Analista & Tech Lead 🌐 Servidor: inbm2.com.br Módulo: B2Sync.Fechamento / Esteira de Bipagens
⚡ ARQUITETURA OFICIAL B2SYNC ECOSYSTEM

Funcionamento da Esteira de Pedidos

Guia técnico detalhado da esteira de expedição, automação de bipagem hands-free, transições de estado, validação cadastral e o modelo relacional completo das tabelas de banco de dados.

📦 Fases da Esteira 6 Etapas Da separação à entrega final comprovada
⚡ Operação Hands-Free < 350ms Bipagem óptica com debounce de 2 segundos
🗄️ Tabelas Relacionadas 8 Tabelas Venda, Itens, Clientes, Cidades, Histórico e Config
🔒 Validação Bloqueante 100% Cadastral Exige Fone, Endereço e Nome para despacho

01 Visão Geral da Arquitetura de Esteira

Como o B2Sync orquestra o fluxo de saída entre o ERP Firebird/MySQL e a bancada física de expedição.

A Esteira de Pedidos é o núcleo operacional de fulfillment do B2Sync. Ela sincroniza pedidos aprovados no ERP e fornece uma bancada em tela cheia com interface mobile-friendly e suporte a leitores ópticos USB/Bluetooth para expedição rápida.

flowchart LR A["🛒 Venda Criada no ERP
(Firebird / MySQL)"] -->|B2Sync Daemon| B["📥 Tabela VENDA & VENDAI
(sinc=1, status=1)"] B --> C["📦 1. Separação
(Mesa de Estoque)"] C -->|Bip QR Code / Barcode| D["🎁 2. Conferência & Embalagem
(Trava de Cadastro Ativa)"] D -->|Etiqueta ML 100x150mm| E["💳 3. Aguardando Pagamento
(Se pendente financeiro)"] E --> F["🏷️ 4. Aguardando Coleta
(Bancada de Saída Express)"] F -->|Entregador Atribuído| G["🚚 5. Em Transporte
(WhatsApp com Rastreio)"] G -->|Confirmação de Entrega| H["✅ 6. Entregue / Concluído
(Histórico Gravado)"] classDef erp fill:#1e293b,stroke:#a855f7,stroke-width:2px,color:#fff; classDef step fill:#0f172a,stroke:#38bdf8,stroke-width:2px,color:#fff; classDef done fill:#064e3b,stroke:#10b981,stroke-width:2px,color:#fff; class A,B erp; class C,D,E,F,G step; class H done;
💡
Integração Híbrida Firebird & MySQL: A tabela mestre VENDA armazena metadados flexíveis da esteira dentro da coluna dadosadicionais2 (JSON serializado contendo etapa, transportador, código de rastreio e data de atualização), garantindo compatibilidade total com o ERP sem necessidade de quebra de schema legado.

02 Fases Operacionais do Ciclo de Vida

As 6 etapas padronizadas da esteira e seus comportamentos sistêmicos.

Fase 1 • Inicial
📦

1. Separação

O pedido entra sincronizado. O operador na mesa de estoque imprime o cupom térmico (58mm/80mm) com QR Code e separa os produtos na prateleira.

Código no Banco: "1" (ou "0")
Documento Físico: Cupom Térmico 80mm
Bipagem Entrada: VENDA:<empresa>:<cod>
Fase 2 • Validação Crítica
🎁

2. Conferido & Embalado

Conferência dos itens (bipagem de EAN/GTIN) e validação de cadastro (Nome, Telefone, Endereço). Dispara a impressão da Etiqueta de Envio 100x150mm.

Código no Banco: "2"
Trava de Cadastro: OBRIGATÓRIO
Ação Automática: Abre Etiqueta 100x150
Fase 3 • Financeiro
💳

3. Aguardando Pagamento

Utilizado para pedidos com quitação pendente (ex: PIX não confirmado, boleto em compensação ou crediário). Bloqueia a liberação física.

Código no Banco: "3"
Tabela Relacionada: CAIXAHIST / PAGAMENTO
Disparo WhatsApp: Cópia de Chave PIX
Fase 4 • Expedição
🏷️

4. Aguardando Coleta

Pacote 100% selado, rotulado com rota por CEP (R-86800) e alocado na bancada de saída aguardando motorista/transportador.

Código no Banco: "4"
Triagem: Por Cidade / Prefixo CEP
Bipagem Bancada: Code 128 (PED<emp><cod>)
Fase 5 • Trânsito
🚚

5. Em Transporte

Motorista ou motoboy assume a entrega. Grava o entregador no campo transporte e envia mensagem automática via WhatsApp.

Código no Banco: "5"
Campo Gravado: transporte + dadosadic2
Notificação: WhatsApp Instantâneo
Fase 6 • Finalização
✅

6. Entregue / Concluído

Baixa final confirmada pelo entregador ou cliente. O pedido é arquivado do funil ativo e mantém o registro perpétuo na auditoria de etapas.

Código no Banco: "6"
Auditoria: api_vendas_etapas_historico
Status Final: Concluído (sinc=1)

03 Motor de Bipagem Hands-Free

Arquitetura de hardware, leitores USB/Bluetooth e regras anti-concorrência.

Padrão de Código Formato do Payload Exemplo Real Onde é Utilizado Ação no Bip
QR CODE VENDA:<empresa>:<codigo> VENDA:1:10523 Cupom Térmico (80mm/58mm) e Canhoto da Etiqueta Carrega o pedido na tela e avança para a próxima etapa configurada
CODE 128 PED<empresa><codigo> PED110523 Etiqueta de Envio Express (100x150mm) no topo Triagem rápida na bancada de saída e coleta do transportador
EAN-13 / GTIN <codigobarras> 7891234567890 Embalagem dos Produtos no Estoque Conferência cega item a item na Etapa 2 para evitar erros de separação
🛡️
Regras de Proteção de Bipagem:
  • Debounce de 2 Segundos: Bipagens repetidas do mesmo código em menos de 2000ms são descartadas para evitar avanços duplos acidentais por reflexo do laser.
  • Proteção contra Regressão de Fase: Se um pedido já estiver na Fase 4 (Aguardando Coleta) e for lido na Fase 1, o sistema bloqueia, toca um alarme sonoro e exige permissão explícita de "Transição Livre".
  • Auto-Focus Perpétuo: O input óptico mantém o foco restaurado a cada 500ms, dispensando o uso do mouse pelo operador.

04 Modelo Entidade-Relacionamento (DER)

Diagrama relacional completo conectando o ERP, a esteira e os registros de auditoria.

erDiagram EMPRESA ||--o{ VENDA : emite EMPRESA ||--o{ PESSOA : cadastra EMPRESA ||--o{ PRODUTO : possui EMPRESA ||--o{ API_ESTADOS_PEDIDO : configura_fases PESSOA ||--o{ VENDA : compra_cliente PESSOA ||--o{ VENDA : atende_vendedor CIDADE ||--o{ PESSOA : localiza VENDA ||--|{ VENDAI : contem_itens PRODUTO ||--o{ VENDAI : referencia_produto VENDA ||--o{ API_VENDAS_ETAPAS_HISTORICO : auditoria_transicoes VENDA ||--o{ CAIXAHIST : movimenta_financeiro PAGAMENTO ||--o{ CAIXAHIST : forma_recebimento VENDA { int empresa PK int codigo PK int tipopessoa FK int pessoa FK int tipovendedor int vendedor FK datetime dataemissao float totalnota float totalprodutos string situacao string dadosadicionais2 string transporte int sinc int status datetime dhsinc } VENDAI { int empresa PK int venda PK int item PK int produto FK float quantidade float precounitario float valortotal float desconto } PESSOA { int empresa PK int codigo PK int tipopessoa PK string nome string razaosocial string cnpjcpf string celular string endereco string bairro int cidade FK string cep } PRODUTO { int empresa PK int codigo PK string descricao string codigobarras float precovenda float estoqueatual string unidade } CIDADE { int codigo PK string nome string uf string ibge } API_ESTADOS_PEDIDO { int id PK int empresa_codigo FK string nome int sequencia string cor boolean ativo boolean obrigatorio } API_VENDAS_ETAPAS_HISTORICO { int id PK int empresa FK int venda FK string etapa_de string etapa_para string usuario string observacao datetime criado_em }

05 Dicionário de Tabelas do Banco de Dados

Estrutura física, campos-chave, tipos de dados e funções no ecossistema.

📄 VENDA ERP & API
Tabela mestre do pedido. Centraliza cabeçalho, valores, status de esteira e sincronização.
  • PKempresa
    INT
  • PKcodigo
    INT (Número Venda)
  • FKpessoa
    INT → PESSOA
  • FKvendedor
    INT → PESSOA
  • JSONdadosadicionais2
    TEXT (Metadados Esteira)
  • transporte
    VARCHAR(50) (Entregador)
  • situacao
    VARCHAR(1) (Fase / C=Canc)
  • totalnota
    FLOAT
  • sinc / status
    INT (Controle de Fila)
📦 VENDAI ERP & API
Itens e produtos da venda. Utilizado para separação física e conferência cega.
  • PKempresa
    INT
  • PKFKvenda
    INT → VENDA.codigo
  • PKitem
    INT (Seq 1, 2, 3...)
  • FKproduto
    INT → PRODUTO
  • quantidade
    FLOAT
  • precounitario
    FLOAT
  • valortotal
    FLOAT
👤 PESSOA ERP & API
Clientes, vendedores e motoristas. Base da conferência cadastral da Etapa 2.
  • PKempresa
    INT
  • PKcodigo
    INT
  • PKtipopessoa
    INT (1=Cliente, 2=Fornec, 3=Func)
  • nome / razaosocial
    VARCHAR(100)
  • celular / fone
    VARCHAR(20) (WhatsApp)
  • endereco / bairro
    VARCHAR(80)
  • FKcidade
    INT → CIDADE
  • cep
    VARCHAR(10) (Roteirização)
🏷️ PRODUTO ERP & API
Cadastro de mercadorias com códigos de barras para bipagem e conferência.
  • PKempresa
    INT
  • PKcodigo
    INT
  • descricao
    VARCHAR(100)
  • codigobarras
    VARCHAR(20) (EAN-13)
  • precovenda
    FLOAT
  • estoqueatual
    FLOAT
⚙️ api_estados_pedido EXCLUSIVO B2SYNC
Configuração dinâmica de etapas por empresa cliente (cores, sequência, obrigatoriedade).
  • PKid
    INT AUTO_INC
  • FKempresa_codigo
    INT → EMPRESA
  • nome
    VARCHAR(100)
  • sequencia
    INT (1..5)
  • cor
    VARCHAR(20) (Hex)
  • ativo / obrigatorio
    BOOLEAN
📜 api_vendas_etapas_historico AUDITORIA
Log imutável de cada bipagem e transição de fase com usuário e timestamp.
  • PKid
    INT AUTO_INC
  • FKempresa
    INT
  • FKvenda
    INT → VENDA
  • etapa_de / etapa_para
    VARCHAR(10)
  • usuario
    VARCHAR(60)
  • observacao
    TEXT (Entregador, PIX...)
  • criado_em
    DATETIME

06 Simulador Interativo de Transição de Etapa

Experimente a lógica de transição, validações de cadastro e gere a carga SQL / JSON em tempo real.

B2Sync Terminal Console • Validador de Esteira
// Aguardando simulação...

07 Governança, Notificações e Auditoria

Integração com AGY Hub (PWA Celular), WhatsApp do Consumidor e WebSocket AGY Bridge.

Notificação Push
📱

AGY Hub Celular

Notificação imediata no dispositivo móvel do gestor quando lotes de pedidos são concluídos ou quando ocorrem anomalias de separação.

Mensageria WhatsApp
💬

WhatsApp do Cliente

Ao avançar para a Fase 5 (Em Transporte), o sistema dispara automaticamente o link de acompanhamento e o nome do entregador para o WhatsApp cadastrado.

Telemetria Realtime
🛰️

AGY Bridge WebSocket

Atualização em tempo real do painel de monitoramento com auto-refresh configurável (10s, 30s ou manual) e suporte a múltiplos operadores simultâneos.