Docs/uso/GUIA_BALANCA_BRASIL.md

Guia de Balança para o Brasil

Objetivo: padronizar o uso de produtos pesáveis no sistema e facilitar implantação em mercados brasileiros.


O que já está pronto

  • Cadastro de produto com PLU da balança
  • Leitura de etiqueta de balança no PDV
  • Exportação de cadastro para:
    • Filizola
    • Toledo

Quando usar

Use este fluxo para produtos como:

  • Banana
  • Maçã
  • Tomate
  • Cebola
  • Batata
  • Uva
  • Pães vendidos por peso
  • Granel em geral

Cadastro correto do produto

Para cada produto pesável:

  1. Defina a unidade como KG ou GR
  2. Informe o preço por quilo corretamente
  3. Preencha o campo PLU da balança
  4. Salve o produto

Exemplo

Banana Prata

  • Nome: Banana Prata
  • Unidade: KG
  • Preço: 8.99
  • PLU da balança: 12345

Maçã Gala

  • Nome: Maçã Gala
  • Unidade: KG
  • Preço: 12.50
  • PLU da balança: 12346

Diferença entre SKU, código de barras e PLU

  • SKU: código interno da loja
  • Código de barras: usado para produtos industrializados ou códigos próprios
  • PLU da balança: código do item pesável usado pela etiquetadora

Regra prática:

  • Produto de balança deve ter PLU preenchido
  • Produto comum pode funcionar só com SKU e/ou barcode

Exportar para a balança

No painel administrativo, na aba de produtos:

  1. Clique em Exportar Filizola ou Exportar Toledo
  2. Baixe o arquivo gerado
  3. Importe o arquivo no software da balança
  4. Atualize o cadastro da balança

Observação

O sistema exporta produtos elegíveis com:

  • unidade KG, GR ou UN
  • PLU da balança ou SKU

Para operação no Brasil, o ideal é usar sempre o PLU da balança.


Como funciona no caixa

Depois de cadastrar e exportar:

  1. O operador pesa o item na balança
  2. A balança imprime a etiqueta
  3. O caixa escaneia a etiqueta no PDV
  4. O sistema identifica o produto pelo PLU
  5. O sistema calcula automaticamente a quantidade com base:
    • no peso embutido na etiqueta, ou
    • no valor total embutido na etiqueta
  6. O item entra no carrinho automaticamente

Checklist de implantação no cliente

Antes de instalar em um mercado:

  1. Rodar a migration de banco:
    • scripts/039-add-scale-plu.sql
  2. Cadastrar ao menos 5 a 10 produtos pesáveis reais da loja
  3. Preencher o PLU da balança de cada item
  4. Exportar o arquivo da balança
  5. Importar o arquivo na balança do cliente
  6. Imprimir etiquetas reais
  7. Testar leitura no PDV com etiquetas reais

Checklist de homologação

Considere homologado quando:

  1. O produto impresso na balança entra no PDV com o nome correto
  2. A quantidade lida bate com o peso real
  3. O preço total bate com a etiqueta
  4. O item aparece corretamente no carrinho
  5. A venda fecha normalmente com PIX, cartão ou dinheiro

Demo comercial em 3 minutos

Roteiro

  1. Mostre um produto comum sendo vendido no caixa
  2. Abra um produto pesável cadastrado com PLU da balança
  3. Mostre no admin que existe exportação para Filizola e Toledo
  4. Escaneie uma etiqueta de balança
  5. Mostre o item entrando automaticamente no carrinho
  6. Finalize a venda

Frase de fechamento

"O cadastro sai do sistema para a balança, e a etiqueta volta pronta para o caixa. Isso reduz erro, acelera fila e organiza o setor de frutas, legumes e granel."


O que prometer ao cliente

Você pode prometer:

  • Cadastro de produtos pesáveis com PLU
  • Exportação para balança
  • Leitura de etiqueta no caixa
  • Menos erro no setor de frutas e legumes
  • Mais agilidade no atendimento

O que não prometer sem testar na loja

Não prometa antes de testar no equipamento real:

  • compatibilidade com qualquer modelo de balança
  • layout 100% compatível com toda versão de Filizola/Toledo
  • operação imediata sem importação/configuração da balança

Recomendação comercial

Para o Brasil, foque em vender esta sequência:

  1. PDV com PIX e cartão
  2. Produtos pesáveis com balança
  3. Cadastro organizado
  4. Redução de erro no caixa
  5. Velocidade no atendimento

Isso conversa melhor com a dor real de mercados pequenos e médios.