Notas aguardando chegada

Toda nota fiscal criada na aba Recebimento começa aqui. Clique em Receber para registrar quem recebeu, o horário de chegada e a volumetria — a nota só passa a aparecer em Recebimento (pronta para conferência) depois disso.

Notas fiscais de entrada

Liberação de validade — recebimento de compra

Itens recebidos com validade abaixo do padrão da saída ficam PENDENTES DE LIBERAÇÃO e NÃO entram em estoque disponível. Não há recusa automática — só o perfil de Compras libera ou recusa, caso a caso, com justificativa.

Armazenar produto

Três passos: 1) bipe o código do produto · 2) informe a quantidade · 3) bipe o código da localização e conclua. A câmera aceita os dois códigos — o app identifica sozinho se é produto ou endereço.

Entrada manual / leitor pistola

A armazenar

Alimentado pelas conferências de recebimento finalizadas. Clique em usar para preencher os três passos de uma vez.

Armazenagens de hoje

Ressuprimento da face de picking

Produtos cuja face de picking ficou abaixo do mínimo. Repor mantém o separador pegando sempre na mesma posição, baixa e perto — sem subir nível nem procurar o lote. A origem sugerida é sempre o lote que vence antes (FEFO), então repor não quebra a regra de saída.

A reposição é executada na aba Transferência — o botão repor já leva origem, produto, lote, quantidade e destino preenchidos, passando por todas as validações normais (temperatura, saldo reservado, saldo negativo).

Transferir produto de endereço

Quatro passos: 1) bipe o endereço de origem · 2) bipe o produto/lote · 3) informe a quantidade · 4) bipe o endereço de destino e conclua. A câmera aceita todos os códigos — o app identifica sozinho se é endereço, produto ou caixa fechada.

Entrada manual / leitor pistola

Transferências recentes

Devoluções

Retorno de produto do cliente — avaria de transporte, recusa, recall/não conformidade, vencimento ou erro de expedição. Cada item recebido é triado na hora: volta ao estoque vendável, entra em quarentena ou é descartado.

Detalhe

Decisão de qualidade — devoluções bloqueadas

Cada item devolvido entra bloqueado. Só o perfil de Qualidade decide: liberar (volta ao estoque disponível, com endereço), manter em quarentena para análise, ou descartar. A decisão exige motivo tipificado + campo livre e fica registrada com o responsável.

Área bloqueada e descarte

Lotes bloqueados por vencimento automático, quarentena de devolução ou bloqueio manual. Item bloqueado nunca aparece na sugestão de separação. Gere a lista de recolhimento para a empresa terceirizada e registre a baixa.

Descartes registrados

Baixas de descarte já registradas — pela área bloqueada ou por decisão de qualidade sobre devoluções.

Fila de NF de Saída

Itens da NF

Auditoria de faturamento

Fila dos pedidos de venda LIBERADOS ainda não faturados, com as travas já calculadas pelo ERP (auditoria fiscal, política comercial, crédito, frete, pagamento, saldo, prazo). Em cima disso o WMS checa a validade dos lotes disponíveis (regra da Master: % de vida útil; Órgão Público exige mais de 12 meses) e o risco de devolução comparando com o histórico de venda faturada do cliente.

Alertas de risco não travam — sinalizam para você decidir. Marque cada pedido como OK para faturar, Pendência (com o motivo) ou Faturamento futuro (com a data). A decisão fica registrada e substitui a planilha "Análise de Faturamento".

Fila de separação

NF de Saída aguardando separação. O roteiro é montado na ordem do percurso do armazém (rua → módulo → nível), com o endereço de cada produto vindo do inventário e o lote escolhido por FEFO — vence antes, sai antes.

Layouts de etiqueta

Cada modelo é um tamanho + uma lista de elementos posicionados em mm. Os modelos padrão reproduzem as etiquetas de sempre — edite à vontade, o botão Restaurar padrão volta ao original.

Editar modelo

Qual modelo cada tela usa

Montar onda de separação

Separe várias NFs numa caminhada só. Cada NF ocupa uma posição fixa do carrinho — ao bipar o produto, o app diz quantas unidades vão em cada posição. O roteiro é consolidado: um mesmo produto pedido por três notas vira uma parada só.

Ou marque as notas na mão — as duas formas funcionam juntas, e a ordem da marcação define a posição no carrinho.

Dados da conferência

Leitura

Fica gravada em cada leitura seguinte até você mudar o valor — atualize ao trocar de caixa/isopor.

Lista esperada

É o gabarito do que a conferência espera encontrar — cada linha tem código, lote, validade e quantidade. Em geral já vem preenchida: ao puxar uma NF de Saída para conferir, ou ao concluir uma separação, os itens entram aqui sozinhos. Também dá para importar um CSV ou adicionar item a item numa janela (ícone do cabeçalho — só admin). O campo Lote em branco aceita qualquer lote.

Ao bipar, cada leitura é comparada com a lista: código que não está nela = NÃO PREVISTO; lote, validade ou quantidade diferentes = divergência. A conferência é cega — a quantidade esperada não aparece durante a bipagem, só ao finalizar. Com a lista vazia, toda leitura cai como NÃO PREVISTO. Limpar lista zera tudo.

Ocorrências de conferência

Na conferência de expedição, toda divergência precisa de uma ocorrência registrada antes de concluir. A ocorrência não sobrescreve a separação original — o histórico mostra o que foi separado errado.

Encerrar

Use os ícones no topo da tela para finalizar, exportar, imprimir, voltar para separação ou iniciar uma nova conferência.

Tudo é salvo automaticamente neste navegador/dispositivo. Nada é enviado para a internet.

Dados da conferência

Leitura

Fica gravada em cada leitura seguinte até você mudar o valor — atualize ao trocar de caixa/isopor.

Lista esperada

É o gabarito do que a conferência espera encontrar — cada linha tem código, lote, validade e quantidade. Em geral já vem preenchida: ao abrir a NF de entrada e clicar em Conferir esta nota, os itens da nota entram aqui sozinhos. Também dá para importar um CSV ou adicionar item a item numa janela (ícone do cabeçalho — só admin). O campo Lote em branco aceita qualquer lote.

Ao bipar, cada leitura é comparada com a lista: código que não está nela = NÃO PREVISTO; lote, validade ou quantidade diferentes = divergência. A conferência é cega — a quantidade esperada não aparece durante a bipagem, só ao finalizar. Com a lista vazia, toda leitura cai como NÃO PREVISTO. Limpar lista zera tudo.

Encerrar

Use os ícones no topo da tela para finalizar, exportar, imprimir ou iniciar uma nova conferência.

Tudo é salvo automaticamente neste navegador/dispositivo. Nada é enviado para a internet.

Prontos para embalar

Conferências de expedição já finalizadas, aguardando embalagem e cubagem para envio.

Embalagens

Detalhe

Prontos para despacho

NF de Saída já embalada, aguardando transporte — informe a transportadora para despachar.

Despachos

Cargas a fechar

Despachos com volumes gerados na Embalagem, aguardando a conferência física na entrega à transportadora. Bipe volume a volume contra o romaneio — a carga só fecha com todos os volumes bipados.

Cargas fechadas

Reservar peça para OS

Para o colaborador do SAM retirar peça/produto para manutenção ou validação de equipamento: bipe o código do produto e o endereço, informe a quantidade e reserve para a Ordem de Serviço. A reserva sai do disponível na hora. O número da OS é informado depois, na lista abaixo; a baixa por nota fiscal fica na aba OS Pendentes de fechamento.

Entrada manual / leitor pistola

—

Reservas de OS

OS Pendentes de fechamento

Reservas do SAM que ainda não foram fechadas. Cada OS é baixada por nota fiscal: informe o número da NF para dar baixa no estoque (movimento de saída). Enquanto a NF não é informada, a OS fica pendente e o saldo continua reservado.

Cadastro de produtos

Base única de produtos do almoxarifado. Alimenta o autocomplete de todas as telas e permite bipar o código de barras EAN do fabricante — o app converte para o código oficial na conferência, separação e armazenagem. Os indicadores abaixo mostram quantos itens estão com cadastro incompleto (sem periculosidade, sem peso, sem embalagem etc.) — clique num indicador para filtrar só esses itens; clique de novo para limpar.

Novo produto

Status AtivoInativoBloqueado

Código EAN

Código DUN (caixa/master)

Código do produto *

Código interno

Descrição *

Unidade de medida

Marca

Fabricante

Fornecedor

Dimensões (C×L×A)

Cubagem (m³)

Peso bruto (kg)

Peso líquido (kg)

Tempo de vida (dias)

Custo unitário (R$)

Temperatura de armazenagem

Mínima (°C)

Máxima (°C)

A condição de armazenamento (Ambiente / Refrigerado / Congelado) é sempre calculada a partir desta faixa — não é possível definir manualmente.

Hierarquia de embalagem

O saldo é sempre guardado na menor unidade. Fator = quantas do nível de baixo cabem em um deste. Só inteiro ≥ 1.

Menor unidade

Nome da caixa

1 caixa = ? unidades

Nome do pallet

1 pallet = ? caixas

Face de picking

Endereço fixo de onde este produto é separado, com a faixa de reposição. Quando o disponível na face cai abaixo do mínimo, o produto entra na fila de Ressuprimento para ser reposto até o máximo, puxando do pulmão pelo lote que vence antes (FEFO). Deixe em branco se o produto não tem face fixa — aí a separação continua buscando o endereço por FEFO no estoque todo.

Endereço da face

Mínimo (repor abaixo de)

Máximo (repor até)

Formato da etiqueta do fabricante

Layout de leitura da etiqueta do fabricante deste produto (o formato muda de item para item). Deixe sem campos para usar o leitor genérico — só configure quando a etiqueta vier num layout de largura fixa que o app não separa sozinho. Códigos GS1 (Data Matrix de fábrica) ou com campos separados por espaço/vírgula já são lidos direto e dispensam formato.

Copiar de outro produto

Copiar formato

Reconhecer pelo código de barras

Reconhecer formato

Monte a leitura da esquerda pra direita: cada linha consome um número de caracteres da etiqueta (ou "resto", só na última linha).

Adicionar campo

Testar — cole uma amostra de código lido

Testar

Imagem do produto

Redimensionada para ~480 px e comprimida (JPEG). Guardada na VPS (Supabase) e em cache neste dispositivo.

Remover imagem

Produto químico? —SimNão

Tamanho do produto —PequenoMédioGrande

Tipo de embalagem

Periculosidade (classificação ONU/ANVISA p/ transporte)

Salvar produto

Cancelar

Pendências de cadastro

Produtos ativos sem embalagem, faixa de temperatura ou imagem. Sem embalagem, o sistema assume unidade.

Cadastrar localização

Endereço no formato Rua | Módulo | Nível. Cada local recebe um código próprio — bipe o local antes dos produtos para registrar onde a mercadoria foi guardada ou de onde foi retirada.

Locais cadastrados

Sincronizar locais entre dispositivos

Usa a conexão configurada na aba NF de Saída (URL e chave anon). Teste da fundação de sync genérico (tabela wms_estado).

Não configurado.

Caixas de separação (pick-to-cart)

Etiqueta Data Matrix para colar nas caixas plásticas usadas na separação em onda. Numeração sequencial CX001, CX002… — imprima uma vez, em material sintético (transferência térmica com ribbon resina). Na aba Onda de separação, com a conferência ligada, o operador clica na posição e bipa a caixa; a caixa fica vinculada àquela posição pelo resto da onda.

Cadastro de Embalagem

Tipos de caixa cadastrados uma vez — cada caixa salva já gera o Data Matrix dela, usado no modo "Ler código" do processo de Embalagem e também reconhecido em qualquer outro aparelho, mesmo sem essa caixa cadastrada localmente.

Cadastro de Transportadora

CNPJ, nome reduzido, nome e status — usados na aba Expedição para sugerir a transportadora do despacho.

Sincronização entre dispositivos

Usa a mesma conexão Supabase já configurada no app (aba NF de Saída). Tabela fixa: transportadoras.

Não configurado.

Posição de estoque

Itens em endereço incompatível

Divergência de temperatura entre o produto e a posição onde ele está — para achar o que já estava errado antes do bloqueio entrar em vigor.

Saldo dos itens

O saldo parte do que foi lançado no inventário e é movimentado pelas conferências finalizadas: recebimento soma, expedição subtrai. A Contagem de inventário (varredura por local) gera ajuste próprio; a conferência avulsa tipo Inventário continua sem efeito no saldo.

Físico = o que está no endereço · Saldo ERP = o que o Oracle acha que tem daquele lote (comparativo, só leitura) · Reservado = preso por NF de saída em aberto, por reservas para OS do SAM e por reservas de contrato · Disponível = o que entra em um pedido novo.

Reserva de contrato

Comodato ou licitação com programação: separa uma quantidade de um lote/endereço que não entra no disponível para a saída comum. A reserva sai do disponível até ser encerrada ou até vencer a data da reserva.

Extrato de movimentação

Cada linha nasce de uma conferência finalizada. Somente leituras validadas movimentam saldo — divergências (lote errado, não previsto, vencido) ficam de fora.

Consulta por endereço

Bipe (ou digite) o código do endereço e veja o que está guardado ali agora — lote, validade, quantidade, quanto já está reservado e quanto sobra de disponível. A lista sai em ordem FEFO: o que vence antes aparece primeiro.

Conferências finalizadas

Detalhe

Auditoria — quem fez o quê, e quando

Trilha automática de governança: cada operação relevante (Recebimento/Conferência, Armazenagem, Separação, Contagem de inventário, Pedidos, Produtos, Locais) grava sozinha o usuário logado, o início e o fim. Não é possível apagar — só consultar e exportar.

Acompanhamento de NF de Saída

Linha do tempo de cada NF de saída: Separação → Conferência → Embalagem → Aguardando transporte → Despachado. "Aguardando transporte" acende assim que a embalagem conclui, e vira concluído (com o nome da transportadora) quando a NF é despachada na aba Expedição. Clique no ícone de uma etapa para abrir a tela daquele processo já naquela NF.

Acompanhamento de Recebimento

Linha do tempo de cada nota fiscal de entrada: Pré-Recebimento → Recebimento → Conferência → Armazenagem → Nota lançada. Clique no ícone de uma etapa para abrir a tela daquele processo já naquela nota.

Atividade diária

Operações registradas por dia (todos os módulos) no período selecionado.

Produtividade por operador

Separação, conferência (saída e recebimento), armazenagem, embalagem e contagem de inventário concluídas no período, por responsável. Linhas/hora é a métrica padrão de picking — compare operadores por ela, não por unidades/hora (que varia com o tamanho do item). Na armazenagem, o tempo é o tempo ativo: intervalos acima de 30 min entre bipagens contam como pausa.

Reslotting — itens fora da posição da curva

Produtos com curva ABC cadastrada guardados numa posição que não combina com o giro deles: curva A longe do início do percurso ou em nível alto, curva C ocupando as posições boas. Mover estes itens encurta a rota de separação todo dia. Use a aba Transferência para remanejar.

Taxa de erro de separação

taxa = linhas com ocorrência de conferência ÷ total de linhas separadas, no período. Para o time de qualidade cruzar com os chamados do ERP.

Evolução mensal (taxa geral)

Ranking por separador

Ciclo do pedido (tempo médio por etapa)

—

Despacho por transportadora

Assistente

Leitura da operação em linguagem natural, gerada sob demanda a partir dos indicadores e eventos do próprio WMS. O assistente não altera nada no sistema — as ações sugeridas são só atalhos que você acata ou dispensa.

O que é enviado à IA não inclui CNPJ, e-mail, telefone, preço, margem nem crédito.

—

Ações sugeridas

Perfis de acesso

Um perfil define quais abas um usuário pode abrir. Sem nenhum perfil cadastrado, todo mundo continua com acesso completo — a restrição só passa a valer depois que você cria perfis e vincula e-mails a eles abaixo.

Usuários e vínculo de perfil

Vincula o e-mail corporativo (o mesmo do login Microsoft) a um perfil. Quem não estiver nesta lista usa o perfil padrão definido abaixo.

Perfil padrão para e-mails não cadastrados

Aplica-se a qualquer e-mail logado que não esteja na lista de vínculos acima. Deixe em "(nenhum)" para não restringir ninguém que não esteja explicitamente cadastrado. O modo de teste local (sem login) nunca é restringido, mesmo com perfis configurados.

Sincronização entre dispositivos

Usa a mesma conexão Supabase já configurada no app (aba NF de Saída). Tabelas fixas: wms_perfis e wms_usuarios.

Não configurado.

O SQL de políticas de segurança exige um JWT válido do Entra em toda leitura/escrita e restringe as tabelas sensíveis (wms_perfis, wms_usuarios, estoque, wms_estado). Rode-o no SQL Editor do Supabase depois de criar as tabelas.

Entrada de mercadoria

Parâmetros do recebimento de compra e da área bloqueada.

Dados da empresa

CNPJ, razão social e Inscrição Estadual da Master Diagnóstica — usados como embarcador/remetente ao enviar romaneios para a Active OnSupply.

Usada junto com o cadastro de Transportadora e a conexão Supabase (aba NF de Saída) para enviar romaneios de despacho à Active OnSupply — ver aba Expedição.

Auditoria de faturamento

Parâmetros da aba Auditoria de faturamento (grupo Faturamento). As views do ERP (erp_ped_faturamento, erp_venda_hist) são criadas pela TI a partir do SQL abaixo. Itens com validade abaixo da regra passam a exigir aprovação (perfil Comercial) antes de liberar o faturamento; essa aprovação também dispensa a aprovação de validade na separação.

Assistente de IA

O assistente gera um insight da operação só quando alguém clica — nada é chamado sozinho. O provedor, a chave e o modelo ficam só no servidor. O pacote enviado não leva CNPJ, e-mail, telefone, preço, margem nem crédito; nome de operador entra (para a leitura de produtividade). O histórico fica 60 dias.

Função: —

Backup de emergência do aparelho

Baixa um arquivo JSON com tudo que está salvo neste dispositivo (todas as chaves mdqr_*). Guarde antes de limpar o cache do navegador ou trocar de aparelho. O import substitui o estado local — use com cuidado.

Como usar

1. Início: painel com os números da operação (atualiza a cada 60 s ou no botão Atualizar) e atalhos em ícones. Cada indicador é clicável e leva direto à tela correspondente. O menu lateral (☰, canto superior esquerdo) abre em qualquer tela e mostra pendências nos módulos.
2. NF de Saída: a fila de trabalho. Uma NF nasce A separar, vai para A conferir quando o separador termina e fecha em Concluído automaticamente quando você finaliza a conferência dela. Entradas possíveis: cadastro manual, importação CSV do ERP (uma linha por item) ou Supabase, que compartilha a fila entre todos os aparelhos. O botão conferir carrega os itens da NF na lista esperada e já abre a aba de conferência.
   A fila mostra por padrão só o que está em aberto (a separar / a conferir). Quando a NF é concluída ela sai da fila automaticamente — continua acessível no filtro Concluídos ou Todos os status.
   Para o Supabase: preencha URL do projeto + chave anon + nome da tabela, use Testar conexão e Baixar SQL da tabela para criar a estrutura no banco. Sem configurar nada, o app funciona 100% local.
3. Gerar código (unidade): informe código, descrição, lote e validade → Gerar Código. Use Adicionar à fila para montar uma folha de etiquetas e imprimir todas de uma vez.
4. Gerar código de caixa fechada: no card Caixa fechada / master, dê um identificador ao volume (ex.: CX-0001) e adicione uma linha por lote com a quantidade de unidades — 10, 12, 20, quantas houver. Uma caixa pode conter vários lotes e até vários códigos. O total é somado automaticamente e um único código representa o volume inteiro. A etiqueta impressa já sai com a lista de lotes ao lado do código.
   Ao bipar esse código na conferência, o app dá baixa em todas as unidades de todos os lotes de uma vez e mostra uma linha de status por lote. Limite prático: ~15 lotes por código.
5. Recebimento: as notas entram por Nova NF, CSV (nf;fornecedor;emissao;codigo;descricao;lote;validade;quantidade, uma linha por item) ou Supabase (tabela notas_fiscais, com SQL para baixar). Abrindo a nota você tem os itens com lote, validade e situação de vencimento, e três caminhos:
   • Gerar e imprimir todas as etiquetas — código no padrão do app para todos os itens da nota.
   • Imprimir etiquetas selecionadas — marque só os itens que precisa reetiquetar.
   • Conferir esta nota — leva os itens da NF para a lista esperada e abre a conferência, validando código, lote, validade e quantidade contra a nota. Ao finalizar, a NF é marcada como Conferida com o resultado, o saldo recebe a entrada e o status sobe para o Supabase. A nota sai do Pré-Recebimento e da lista "A conferir" na hora — fica no filtro Conferidas (ou Todas) para consulta, e segue para a Armazenagem.
   A chave 1 etiqueta por unidade replica a etiqueta pela quantidade da nota (12 un. = 12 etiquetas); desmarcada, sai uma por lote. Tamanho e rolo seguem o que está configurado na aba Gerar Código.
6. Armazenagem: o passo seguinte ao recebimento. A fila A armazenar é alimentada pelas conferências de recebimento finalizadas, mostrando o que está na doca, de qual NF e quanto falta guardar. O processo tem três passos: 1) bipe o código do produto — o app já sugere a quantidade pendente e mostra onde esse lote está hoje; 2) ajuste a quantidade; 3) bipe o código do endereço e clique em Concluir armazenamento. A mesma câmera lê os dois códigos, identificando sozinha se é produto ou endereço.
   Armazenar é uma transferência de endereço: sai da doca (ou do endereço com mais saldo) e entra na posição bipada — o saldo total não muda, e o movimento aparece no extrato como ARMAZENAGEM com o percurso origem → destino. Se o lote não tiver saldo em nenhum endereço, o app pergunta antes de lançar como entrada direta. O endereço bipado permanece selecionado depois de concluir, para você guardar vários itens na mesma posição em sequência. Bipar o código de uma caixa fechada preenche produto e quantidade de uma vez.
7. Transferência (grupo Inventário): remanejamento de endereço — mover um produto de um endereço para outro dentro do armazém. Não é entrada nem saída: o saldo total não muda e nada vai para o ERP. Quatro passos, todos por bipagem ou digitação: 1) origem · 2) produto/lote · 3) quantidade (já vem com o disponível da origem; botão Tudo) · 4) destino. Ao bipar a origem, o app lista o que existe ali com um botão usar por linha. Depois de concluir, origem e destino continuam para você mover vários itens seguidos; Inverter troca os dois. O botão Mover tudo deste endereço transfere todos os itens da posição de uma vez, validando um a um.
   Validações antes de gravar: origem ≠ destino; nunca deixa saldo negativo; endereço de destino novo é cadastrado na hora; temperatura incompatível bloqueia (só Administrador força, com justificativa que vai para a auditoria); saldo reservado por NF de saída só é movido por quem tem a permissão de Inventário — e a reserva é remanejada junto para o novo endereço — e trava sem exceção se a NF já estiver em separação; lote em quarentena pode ser movido para a área bloqueada, com confirmação. O movimento aparece no extrato como TRANSFERÊNCIA, e a aba tem histórico próprio com filtros, KPIs e CSV.
8. Separação: a fila mostra as NF de Saída A separar. Ao abrir um, o app monta o roteiro: uma linha por item, ordenada pelo percurso do armazém (rua → módulo → nível), com o endereço vindo do inventário e o lote escolhido por FEFO — vence antes, sai antes. Endereços alternativos aparecem como "tb:" abaixo do principal.
   Bipe o código do endereço e o app lista o que retirar ali; bipe o produto e a linha avança. Se o produto for bipado num endereço diferente do que o inventário aponta, ele conta mas avisa LOCAL DIFERENTE — sinal de endereçamento desatualizado. Sem saldo na posição, use ruptura: a conferência passa a esperar só o que realmente saiu. Concluir a separação é o que libera a NF para a conferência — antes disso ela não aparece lá.
9. Guia do próximo item: quando a quantidade lida bate com a solicitada, o app fecha a câmera e mostra um painel com o item concluído e o próximo a ler — código, lote, validade, quantas unidades faltam e o endereço. Clique em Continuar lendo para reabrir a câmera já apontada para o próximo, ou Dispensar para seguir manualmente. Ao fechar a última linha, o painel avisa que a conferência (ou a separação) está completa. Vale para a conferência e para a separação, e pode ser desligado na chave Pausar a câmera ao concluir cada item.
10. Conferência: preencha operação e documento, monte a lista esperada (manual, importando CSV ou puxando uma NF já separada) e comece a bipar.
11. Ocorrências de conferência (qualidade da separação): na conferência de Expedição, toda divergência entre o que foi separado e o que o conferente encontrou precisa de uma ocorrência registrada antes de concluir — o botão Finalizar fica bloqueado enquanto houver divergência sem ocorrência. Tipos: produto trocado, quantidade a maior/menor, lote diferente do alocado, validade fora do critério, avaria, item faltante. Cada ocorrência guarda NF, produto, lote, quantidade esperada e encontrada, tipo, o separador original, o conferente e a data/hora, mais uma observação livre. A ocorrência não apaga o registro da separação: o histórico continua mostrando o que foi separado errado, e a correção segue como um movimento normal de conferência.
    A aba Indicadores tem o painel Taxa de erro de separação = linhas com ocorrência ÷ total de linhas separadas no período, com ranking por separador, quebra por tipo e por produto, evolução mensal e export CSV para o time de qualidade cruzar com os chamados do ERP.
12. Fechamento de carga (bipagem de volumes): cada volume fechado na Embalagem ganha um identificador único (etiqueta própria, código Data Matrix) vinculado à NF e ao romaneio quando a NF é despachada na Expedição. Na aba Fechamento de carga, ao entregar para a transportadora, o operador bipa volume a volume contra o romaneio: o romaneio só fecha com todos os volumes bipados. Volume faltante impede o fechamento; volume repetido ou de outro romaneio é recusado com aviso. Fica registrado quem fechou, a transportadora e o horário. Cargas em risco de perder o corte (Correios até 15h, demais até 16h — ajustável) aparecem destacadas na fila e num aviso na tela, mas não bloqueiam o fechamento.
13. Produtos: a base única do almoxarifado — status, EAN, DUN (caixa/master), código, código interno, descrição, unidade, marca, fornecedor, dimensões, peso bruto, peso líquido, cubagem, periculosidade (texto livre + químico/tamanho/embalagem/temperatura) e tempo de vida. Entra por cadastro manual, CSV (status;ean;codigo;codigo_interno;descricao;unidade;marca;fornecedor;dimensoes;peso_bruto;peso_liquido;cubagem;periculosidade;p_quimico;p_tamanho;p_embalagem;p_temperatura;tempo_vida;armazenamento;codigo_dun) ou Supabase (tabela produtos, com SQL para baixar e envio por upsert no código).
    Tempo de vida é a validade total do produto em dias (ex.: 730) — com ela cadastrada, o app calcula sozinho o % de vida útil restante de cada lote nas NF de Saída, para o alerta de aprovação de envio.
    O ganho maior está na leitura: com o EAN cadastrado, o operador pode bipar o código de barras do fabricante na conferência, na separação e na armazenagem — o app converte para o código oficial sozinho e ainda completa a descrição. O código interno também resolve. Produtos inativos saem do autocomplete. Pesos e cubagem aceitam vírgula decimal, e digitar as dimensões (30x20x15 cm) oferece a cubagem calculada.
14. Locais (Rua | Módulo | Nível): cadastre os endereços um a um ou gere faixas inteiras de uma vez (ex.: ruas 1–4, módulos 1–10, níveis 1–4 = 160 endereços). O código sai no padrão RUA-00-00 (ex.: A-01-01) e cada local tem etiqueta própria com o endereço em letra grande + código.
    Na conferência, bipe primeiro o código do local: aparece a faixa “📍 Registrando em A-01-01” e todas as leituras seguintes ficam gravadas nesse endereço, até você bipar outro local ou clicar em limpar. A coluna Local do log e o bloco ENDEREÇAMENTO do CSV mostram o que foi guardado onde; a lista de locais mostra a ocupação registrada de cada posição.
15. Resultado por leitura:
    • OK código e lote conferem com a lista.
    • LOTE DIVERGENTE o código existe na lista, mas o lote é outro.
    • NÃO PREVISTO item que não consta na lista.
    • EXCEDENTE quantidade lida acima do esperado.
    • DUPLICADO / VALIDADE mesma etiqueta bipada de novo, ou validade vencida/próxima (90 dias).
    • FALTANTE item esperado que não foi bipado até o fim.
16. Inventário: lance código, lote, validade, quantidade e localização (obrigatória) — sem endereço o produto não entra no roteiro de separação. Endereço novo no padrão RUA-00-00 (ex.: A-01-01) é cadastrado em Locais na hora, com sua confirmação. O campo Local continua preenchido depois de lançar, para você cadastrar vários lotes da mesma posição em sequência. Na importação, a 6ª coluna do CSV é o local e linhas sem endereço são recusadas e listadas; no Supabase (botão na própria aba, usando a conexão da aba NF de Saída) o envio é upsert por codigo,lote,local. A tabela mostra a posição de estoque com KPIs de unidades, vencidos e a vencer em 90 dias, e filtros rápidos. O botão Gerar e imprimir etiquetas monta a folha de códigos dos itens marcados (ou dos filtrados, se nada estiver marcado) e abre a impressão direto — com a opção de 1 etiqueta por unidade para reetiquetar caixa por caixa. Enviar seleção p/ conferência transforma o inventário na lista esperada para você contar bipando as prateleiras.
17. Saldo: consulta por código + lote com entradas, saídas, endereços, situação de validade e último movimento. O saldo parte do que foi lançado no inventário e é movimentado pelas conferências finalizadas — recebimento soma, expedição subtrai, conferência de inventário não movimenta. Só leituras validadas movimentam: divergências (lote errado, não previsto, vencido, excedente) ficam fora. O botão extrato de cada linha filtra o kardex daquele item.
    Na expedição, se o endereço bipado não tem a linha do lote, a baixa sai do endereço cadastrado por FEFO. Vender item sem cadastro deixa saldo negativo — é proposital, aparece em vermelho no painel e na aba para você corrigir o inventário em vez de esconder o erro. No recebimento sem endereço bipado, o app pergunta a posição de destino antes de dar entrada.
18. Encerrar: Finalizar e salvar grava no histórico. Exporte o CSV para anexar ao processo.

Impressão — Zebra TLP 2844 · etiqueta 50 × 30 mm

Todas as etiquetas do app já saem no tamanho exato 50 × 30 mm, uma por etiqueta do rolo (uma carreira na horizontal). A página de impressão é configurada automaticamente para 50×30 mm sem margens quando você clica em qualquer botão de imprimir etiquetas.

Tamanhos disponíveis (o de local é escolhido na aba Locais):

• 50 × 30 mm — produto, caixa fechada e local de prateleira. Stock 50,8 × 30 mm, uma carreira.
• 50 × 30 mm em rolo de 2 carreiras — duas etiquetas de produto por avanço. Escolha o rolo no seletor da fila de etiquetas (aba Gerar Código) ou no inventário.
  • Deitadas: as duas lado a lado, página de 100 × 30 mm — no driver, stock 101,6 × 30 mm.
  • Na vertical: cada etiqueta gira 90° e ocupa 30 × 50 mm, página de 60 × 50 mm — no driver, stock 60 × 50,8 mm, orientação retrato.
  • Se o número de etiquetas for ímpar, a última página sai com a segunda posição em branco.
• 100 × 50 mm deitada — local de porta-palete. Endereço em 13 mm de altura, código de 23 mm. Stock 101,6 × 50,8 mm.
• 100 × 35 mm deitada — local de porta-palete em rolo mais estreito. Endereço em 10 mm, código de 15 mm. Stock 101,6 × 35 mm.
• Versões "na vertical" — a mesma etiqueta girada 90°, para colar na coluna do porta-palete. A página troca de lado: 100 × 50 vira 50,8 × 101,6 mm e 100 × 35 vira 35 × 101,6 mm no driver. Mantenha a orientação retrato — a rotação já vem no desenho, não marque "paisagem".
• 100 × 150 mm e 100 × 100 mm — 1 carreira — etiqueta grande (mesmo conteúdo das 50 × 30, ampliado) para produto, embalagem, local e caixa de separação. Escolha em cada tela: rolo de produto (aba Gerar Código / inventário), aba Locais (local e caixa de separação) e card "Etiqueta da embalagem". Página 100 × 150 mm / 100 × 100 mm sem margem, uma etiqueta por avanço.

Desde a v56, os layouts são editáveis pelo Administrador na aba Etiquetas (grupo Cadastros) — tamanho, elementos, campos e novos modelos. Os tamanhos acima são os modelos-padrão; "Restaurar padrão" volta qualquer um ao original.

Como o tamanho de página é único por impressão, quando a fila tiver etiquetas de tamanhos diferentes o app mostra um botão para cada tamanho — imprima uma rodada por rolo.

No driver da impressora (uma vez só):

• Painel de Controle → Dispositivos e Impressoras → botão direito na ZDesigner TLP 2844 → Preferências de impressão.
• Tamanho do papel / Stock: personalizado 50,8 mm × 30 mm (2,00" × 1,18"). Margens: 0 em todos os lados.
• Media type: térmica direta (etiqueta térmica) — ou transferência térmica se usar ribbon. Tracking: Web sensing (gap entre etiquetas).
• Velocidade 2–3 ips e escurecimento (darkness) 8–12: código muito claro não lê, muito escuro borra os módulos.
• Rode a calibração do rolo antes do primeiro lote (botão de feed pressionado até piscar, ou pelo utilitário Zebra).

Na janela de impressão do navegador: destino = ZDesigner TLP 2844 · escala 100% (nunca "ajustar à página") · margens nenhuma · desmarque cabeçalhos e rodapés e gráficos de fundo não é necessário marcar.

Densidade do código: o Data Matrix (padrão ECC200) ajusta automaticamente o tamanho da matriz ao conteúdo, sem "nível de correção" configurável como no QR, e com bem mais capacidade que um QR do mesmo tamanho físico. Etiquetas de caixa com muitos lotes ainda geram um código mais denso — o app avisa acima de ~320 caracteres (cerca de 6 lotes), com boa folga antes de comprometer a leitura.

v8 — embalagem, temperatura, imagem e Data Matrix

• Embalagem: em Produtos, cadastre a menor unidade, o fator da caixa (1 CX = N UN) e do pallet (1 PL = N CX). Fatores só aceitam inteiro ≥ 1. O saldo é sempre guardado na menor unidade — em Recebimento (Nova NF), Inventário (lançar) e Separação (passo dos botões +/−) você escolhe em qual unidade digita e o app converte. Produtos sem embalagem entram na lista de pendências de cadastro (aba Produtos) e são tratados como unidade.
• Temperatura: no produto informe a faixa (°C) — o tipo Ambiente / Refrigerado 2–8 / Congelado é derivado (o seletor Condição de armazenamento ainda sobrepõe manualmente). Em Locais, cada endereço tem um Tipo de área. No endereçamento (recebimento, armazenagem, devolução, inventário) o app bloqueia posição incompatível e mostra o tipo exigido × o do endereço. Só o perfil Administrador força, sempre com justificativa registrada na Auditoria. O relatório Itens em endereço incompatível (aba Inventário) lista o que já estava divergente.
• Imagem: upload no produto — redimensionada para ~480 px e guardada na VPS (tabela produto_imagens); cada aparelho mantém cache local (IndexedDB). Miniatura aparece nas listas de Separação, Conferência, Conferência de Recebimento e Inventário ao lado da descrição; um toque amplia. Ao bipar um produto, a foto também aparece no cartão de resultado da leitura em todos os processos (Conferência, Recebimento, Separação, Armazenagem, Inventário, Devolução) — para conferência visual na hora. Produto sem foto: o cartão aparece sem imagem, sem ocupar espaço.
• Ritmo de bipagem: o app exige 1 segundo entre a leitura de um produto e a do próximo — dá tempo de olhar a foto e a descrição antes de seguir, e evita contagem dobrada por eco do leitor ou disparo repetido da câmera. Leitura chegada cedo demais mostra "Aguarde 1 segundo" e é ignorada (basta bipar de novo). Bipar o endereço ou uma caixa fechada não entra nessa trava.
• Data Matrix GS1: a bipagem já lê o Data Matrix do fabricante com os AIs (01) GTIN, (10) lote, (17) validade, (21) série e o separador FNC1 (além do formato calibrado por produto). Para item sem código de fábrica, a etiqueta interna do app já é um Data Matrix com produto + lote + validade; marque etiqueta interna GS1 na aba de etiquetas da NF para gerar no padrão GS1 (01)(17)(10) (ou (91) com o código interno quando não há EAN) — reconhecida depois como equivalente à do fabricante. A mesma rotina de etiqueta é usada na contagem de inventário.
  Código de barras linear (Code 128, Code 39 etc.) de teste rápido / IVD com código, lote e validade separados por espaço, TAB ou vírgula — em qualquer ordem (ex.: 30100166 0001191522 05/11/2027): o token que for uma data (dd/mm/aaaa, dd-mm-aa, aaaammdd) vira a validade, os outros viram código e lote. É lido direto, sem formato calibrado. Se um item desse tipo estiver lendo o lote errado, abra o produto e apague os campos da seção "Formato da etiqueta do fabricante". Campos colados sem separador continuam exigindo o formato calibrado no produto.
• Que códigos de barras o app lê: no leitor USB o próprio aparelho decodifica e "digita" o texto — o app aceita qualquer texto; se um leitor novo não lê um tipo (EAN, ITF-14/DUN, Code 128, QR…), habilite a simbologia no manual do leitor (folha de códigos de configuração). Na câmera (celular/tablet) o app pede ao navegador todas as simbologias que ele souber decodificar — EAN-13/8, UPC-A/E, ITF-14/DUN, Code 128/39/93, Codabar, QR, Data Matrix, PDF417, Aztec. Funciona melhor no Chrome/Android; em navegadores sem leitor nativo (Firefox, Safari de computador) a câmera lê só QR — nesses use o leitor USB.
• Curva ABC e posição no armazém: a curva cadastrada no produto (A/B/C) passou a decidir onde ele é guardado, não só a frequência de contagem no inventário rotativo. Curva A vai para posição perto do início do percurso e em nível baixo; curva C vai para o fundo e para o alto, liberando as posições boas para quem gira. Consolidar o produto onde ele já tem saldo continua tendo prioridade — a curva é o critério de desempate. O card Reslotting (aba Indicadores) lista quem está fora da posição da curva, com o endereço sugerido e um CSV para o remanejamento.
• Formato da etiqueta do fabricante (por produto): no cadastro do produto, a seção Formato da etiqueta do fabricante calibra a leitura quando a etiqueta vem num layout de largura fixa (campos colados, sem separador). O campo Reconhecer pelo código de barras aceita uma etiqueta real (leitor USB ou colada): o app identifica onde ficam código, lote e validade (usa o código/EAN do próprio produto como âncora) e preenche o formato para você revisar e testar. Copiar de outro produto: bipe/digite o código de um produto já cadastrado e o app traz o formato dele — útil para famílias que repetem o layout de etiqueta. Deixe sem campos para usar o leitor genérico. Códigos GS1 ou com campos separados por espaço/vírgula não precisam de formato — o app avisa.

Entrada de mercadoria — compra x devolução

• Recebimento de compra: conferência normal contra o pedido/NF (código, quantidade, lote, validade). Item que chega com validade abaixo do padrão da saída (mesmo % de vida útil da expedição, configurável em Configurações → Entrada de mercadoria) fica PENDENTE DE LIBERAÇÃO e não entra em estoque disponível. Não há recusa automática. Na finalização o app oferece o e-mail ao comprador. Na aba Recebimento → Liberação de validade, só o perfil de Compras libera (com endereço sugerido — temperatura compatível e lote lado a lado) ou recusa, sempre com justificativa. Fica registrado quem recebeu, quem liberou e a data/hora de cada etapa.
• Devolução de cliente: fluxo próprio (aba Devolução), aberto por número de nota de devolução ou pelo chamado do ERP. Todo item entra BLOQUEADO em quarentena — saldo visível, mas indisponível para separação (nenhum perfil de operação separa lote bloqueado). Na aba Devolução → Decisão de qualidade, só o perfil de Qualidade decide item a item: liberar (volta ao disponível, com escolha do endereço), manter em quarentena ou descartar — sempre com motivo tipificado (produto errado enviado, item faltante, pedido de venda incorreto, avaria, temperatura, validade, outro) + campo livre. Histórico completo por item devolvido. Sem prazo limite de devolução.
• Produto vencido / área bloqueada: ao virar a validade, o lote é bloqueado automaticamente (uma vez por dia, na abertura do app) e, se um endereço da área bloqueada estiver configurado, o saldo é movido para lá. Item bloqueado nunca aparece na sugestão de separação. Em Devolução → Área bloqueada e descarte: marque os lotes, gere a lista de recolhimento (CSV para a terceirizada) e registre a baixa com o responsável — o saldo é zerado e o movimento fica no extrato.

Formato do código

Unidade: MD|codigo|lote|validade|descricao
Caixa fechada: MDX|id|embalagem|total|cod*lote*validade*qtd*desc~cod*lote*validade*qtd*desc (lotes separados por ~).
Local: MDL|A-01-01|A|01|01|setor (a etiqueta de local no app leva só o código A-01-01)
Etiqueta interna GS1: Data Matrix (01)(17)(10) quando há EAN; senão (91)codigo(17)(10) (etiquetas antigas em (240) continuam sendo lidas).
Na leitura ele também entende: JSON ({"codigo":"...","lote":"..."}), pares chave=valor separados por | ou ;, GS1 (Data Matrix ou parênteses) com AIs (01)(10)(17)(21)(91)(240)(241) e FNC1, e, como último recurso, CODIGO|LOTE ou só o código.

Celular, tablet e computador

O app se adapta ao tamanho da tela: no celular as tabelas viram cartões (um item por bloco, sem rolagem lateral), os botões ganham área de toque de 44 px para uso com luva, os campos usam fonte 16 px para o iPhone não dar zoom ao focar e o resultado da leitura fica fixo no rodapé enquanto você bipa. No tablet os formulários se reorganizam em 2–3 colunas e no computador em 4. Vale adicionar à tela inicial (Chrome: menu → Adicionar à tela inicial; Safari: Compartilhar → Adicionar à Tela de Início) para abrir em tela cheia como um aplicativo.

Requisitos da câmera

Para a câmera funcionar, a página precisa ser aberta em https:// ou em localhost (exigência dos navegadores). Em celular Android/Chrome a leitura usa o detector nativo, sem depender de internet. No iPhone use o Safari.

Publicar online

É um arquivo único: suba em qualquer hospedagem estática (GitHub Pages, Netlify, IIS/Apache interno) e acesse pelo celular. Também funciona salvo na rede e aberto direto do arquivo, mas nesse caso a câmera pode ser bloqueada — use a entrada manual/leitor pistola.