> For the complete documentation index, see [llms.txt](https://ola.meajuda.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ola.meajuda.cc/app-meus-pedidos/balanca.md).

# Balança

### Visão geral

O Modo Balança permite dois formatos de operação:

* **Com operador**: o operador confirma/captura o peso no PDV (manual) ou o sistema captura automaticamente no PDV.
* **Autoatendimento**: o cliente realiza a pesagem; o sistema registra o item e pode **imprimir uma comanda** ou **vincular o peso a uma comanda existente via leitor**.

### Pré-requisitos

Antes de começar, garanta que você tenha:

* Uma balança compatível e conectada corretamente.
* A balança configurada nos parâmetros de comunicação.
* (Opcional) Impressora configurada para imprimir a comanda no autoatendimento.
* (Opcional) Monitor/tela para exibir instruções ao cliente.

{% hint style="warning" %}

### Importante

As **configurações da balança são por usuário**. Isso significa que:

* Cada pessoa que opera o PDV pode ter suas próprias configurações de balança.
* Se mais de uma pessoa usa o mesmo PDV, verifique se o usuário logado está com a configuração correta.

O modo balança só está disponível no app **Meus Pedidos**. **(**[**baixe aqui**](/app-meus-pedidos/gestor-de-pedidos.md)**)**
{% endhint %}

<details>

<summary>Onde encontrar as configurações</summary>

No app **Meus Pedidos (**[**baixe aqui**](/app-meus-pedidos/gestor-de-pedidos.md)**)**:

* Acesse as **Configurações** e procure a área de **Balança / Modo Balança**.

<figure><img src="/files/eqdUi7vZr66avTK5HG53" alt="" width="218"><figcaption></figcaption></figure>

</details>

<details>

<summary>Ativar o Modo Balança</summary>

Para ativar o modo balança, é necessário já ter uma balança conectada ao computador.

Ao ativar o modo balança, você verá informações como:

* Status da balança
* Último peso lido
* Ação para testar peso

<figure><img src="/files/YzvcPlFGZvAezH4uasdO" alt="" width="359"><figcaption><p>Clique em testar peso para verificar a conexão</p></figcaption></figure>

</details>

<details>

<summary>Cuidados na conexão das balanças</summary>

#### Cabos compatíveis para conectar balanças

Confira os principais cabos e adaptadores utilizados para conectar uma balança à plataforma.

A compatibilidade pode variar conforme o modelo da balança, o tipo de saída disponível no equipamento e as entradas disponíveis no computador utilizado na operação.

#### O que verificar antes de comprar ou conectar

Antes de instalar a balança, confira:

* O modelo da balança;
* O tipo de saída de comunicação disponível na balança;
* Se a balança será conectada ao computador usado na operação;
* Se o computador possui entrada serial ou apenas USB;
* Se será necessário utilizar cabos intermediários ou adaptadores;
* Se o cabo é original, homologado ou indicado pelo fabricante da balança.

#### Conexões mais comuns

As conexões podem variar conforme o equipamento, mas os formatos mais comuns são:

* **Serial DB9:** comum em balanças comerciais.
* **RJ45 para serial:** utilizado em alguns modelos de balança.
* **USB:** usado quando a balança possui conexão direta com o computador.
* **Adaptador USB para serial:** necessário quando a balança usa comunicação serial, mas o computador possui apenas entrada USB.

<figure><img src="/files/8Wl6jCG9gRa8bG5ZgtUm" alt="" width="563"><figcaption><p>Exemplos de cabos e adaptadores que podem ser utilizados na conexão de balanças comerciais.</p></figcaption></figure>

#### Como utilizar

1. Conecte o cabo na saída de comunicação da balança.
2. Conecte a outra ponta ao computador usado na operação.
3. Se necessário, utilize cabos intermediários ou adaptador USB para serial.
4. Configure a balança na plataforma.
5. Faça um teste de pesagem ou uma venda teste para confirmar se o peso está sendo enviado corretamente.

<figure><img src="/files/HtIrWVvB6aUaVVOegjyq" alt="" width="563"><figcaption><p>Exemplo de sequência de conexão. A ordem pode variar conforme o equipamento</p></figcaption></figure>

#### Atenção

A compatibilidade dos cabos pode variar conforme o modelo da balança. Em alguns casos, pode ser necessário usar mais de um cabo ou adaptador para fazer a conexão com o computador.

Sempre que possível, utilize cabos originais, homologados ou indicados pelo fornecedor da balança. Cabos de baixa qualidade ou incompatíveis podem impedir a comunicação correta entre a balança e o sistema.

<figure><img src="/files/0USuMKaiXD6KZP6jJa7t" alt="" width="563"><figcaption><p>Cabos incompatíveis ou de baixa qualidade podem causar falhas na comunicação com a balança.</p></figcaption></figure>

Em caso de dúvida sobre o cabo correto, pinagem ou compatibilidade física do equipamento, consulte o fornecedor ou a assistência técnica da balança antes de comprar ou instalar.

</details>

<details>

<summary>Parâmetros da balança</summary>

Consulte o manual da balança para confirmar as especificações e preencher corretamente os campos de comunicação. Em seguida, configure os parâmetros necessários para o PDV se comunicar com a balança (por exemplo: modelo, porta serial e demais opções exigidas no seu cenário).

<figure><img src="/files/tNjdhFXbuNhBD18lsAM1" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
As balanças compatíveis estão na lista **Modelo Balança**. Caso a sua balança não esteja na lista, entre em contato com nosso suporte.
{% endhint %}

{% hint style="info" %}
Dica: após ajustar parâmetros, volte e use Testar peso para validar.
{% endhint %}

</details>

<details>

<summary>Modo de cobrança (como o valor é calculado)</summary>

<figure><img src="/files/XNekVKDHD49YXFa7jp4w" alt="" width="142"><figcaption></figcaption></figure>

#### 1. Kg

Neste modo, a cobrança é feita exclusivamente por quilograma (kg). O preço final é calculado multiplicando o peso do produto pelo valor do kg cadastrado. O(s) produto(s) deste modo de operação você define mais abaixo dentro do **modo de operação**.

#### 2. Livre (valor fixo)

Neste modo, a cobrança é feita por unidade, independentemente do peso. O cliente paga um valor fixo por produto. Adicione ou remova o produto usado para a cobrança do tipo “livre”.

<figure><img src="/files/XWl7wnzKctb62Kb9Rkc6" alt="" width="540"><figcaption></figcaption></figure>

#### 3. Kg + Livre

**Misto:** Neste modo, o sistema oferece flexibilidade para cobrar tanto por quilograma quanto por unidade. O sistema automaticamente define o método de cobrança no momento da venda.

* Permite cobrar por kg ou por valor fixo, conforme configuração.
* Você pode definir o limite (em gramas ou em valor) para atingir o “livre”.
* Adicione ou remova o produto usado como base.

<figure><img src="/files/bwgFvYSVg2rI7J9Yta9V" alt="" width="540"><figcaption></figcaption></figure>

</details>

<details>

<summary>Modo de operação da pesagem</summary>

Defina como a pesagem acontece na prática. Há dois formatos de operação:

* **Com operador**
* **Autoatendimento**

<figure><img src="/files/4WBeTw3YRMUQnD3JyU0z" alt="" width="563"><figcaption></figcaption></figure>

#### 1. Com operador

Nesse modo, ao posicionar o prato na balança:

* O PDV pode exibir uma janela/modal de confirmação de pesagem automaticamente sempre que a balança detecta o peso (caso a balança tenha essa possibilidade), ou
* O operador pode acessar a pesagem pelo botão do **ícone da balança**, localizado na parte inferior do carrinho, ou
* O operador pode acessar a pesagem teclando a letra **P**, ou
* O operador pode abrir o produto e clicar na parte inferior da janela/modal do produto para realizar a pesagem e adicionar no carrinho o produto.

**Método de captura do peso**

* **Manual**: o operador escolhe quando capturar o peso, pressionando **C** ou clicando em **Capturar peso (C)**. Em seguida, confirma em **Confirmar peso** (ou **Enter**).
* **Automático**: o sistema captura o peso ao identificar um novo item pesado. Em seguida, o operador confirma em **Confirmar peso** (ou **Enter**).

<figure><img src="/files/eSpucqijDyqsXgLIa9Kw" alt="" width="353"><figcaption><p>Tela do PDV quando há um produto na balança</p></figcaption></figure>

**Produtos disponíveis ao pesar**

Você pode configurar:

* Quais produtos aparecem para seleção na confirmação de pesagem.
* Qual produto vem marcado por padrão (o primeiro da lista é o padrão).
* A ordem dos produtos.

<figure><img src="/files/hncdjQhw8PSjaesarH57" alt="" width="520"><figcaption></figcaption></figure>

**Fluxo (com operador)**

1. Cliente coloca o prato na balança.
2. O sistema identifica o peso (ou o operador clica para capturar a pesagem no PDV).
3. O operador **confirma** o peso.
4. O operador seleciona o produto (se aplicável).
5. O item é adicionado ao carrinho/pedido.

<figure><img src="/files/Vw50abA9ve3oj8xBmJA8" alt="" width="563"><figcaption></figcaption></figure>

#### 2. Autoatendimento

Nesse modo, o cliente realiza a pesagem.

* (Opcional) Você pode exibir uma **tela de instruções** para guiar o cliente.
* Após a pesagem, o sistema registra automaticamente o item com o **produto padrão**, e marca como **entregue** no gestor de mesas/comandas.

{% hint style="info" %}
No autoatendimento da balança, o sistema sempre seleciona automaticamente a próxima comanda disponível. Se não houver comanda disponível, ele cria uma nova comanda automaticamente, mesmo quando a opção [**Seleção automática da comanda**](/app-meus-pedidos/gestor-de-pedidos/selecao-automatica-da-comanda.md) não estiver ativada.&#x20;
{% endhint %}

**Configurações do autoatendimento**

* **Produto padrão**: produto usado para registrar a pesagem.
* **Tara do prato:** Informação que será mostrada ao cliente somente se utilizar uma tela de autopesagem.
* **Modo de operação**:
  * **Imprimir comanda (impressora da balança)**, ou
  * **Ler comanda com código de barras/QR Code** (vincula a pesagem a uma comanda existente).

<figure><img src="/files/fdoPmmwCfWOsmdfMKfvV" alt="" width="377"><figcaption></figcaption></figure>

* **(Opcional) Imagem de fundo para a tela de instruções.** Tamanho recomendado: 1920x1080 px.
* **(Opcional) Observações extras exibidas na tela de instruções.**
* **(Opcional) Selecione o tamanho da fonte:**
  * **Pequena:** tamanho padrão.
  * **Média:** fonte intermediária.
  * **Grande:** fonte ampliada.

<figure><img src="/files/94RNiuA3thgCgk9lx9FV" alt="" width="440"><figcaption></figcaption></figure>

<figure><img src="/files/U7SWRVaUpFu0dyEsJspY" alt=""><figcaption></figcaption></figure>

Além das configurações acima, a opção de **Autoatendimento** deve estar ativa nas opções da Balança, na parte superior da tela no app do computador que será utilizado:

<figure><img src="/files/Vm9dihQnQavwFv5Mz9CP" alt="" width="248"><figcaption></figcaption></figure>

**Fluxo: Autoatendimento com impressão de comanda**

1. Cliente coloca o prato na balança.
2. Sistema pesa o prato.
3. Impressora imprime a comanda.
4. Cliente retira o prato da balança.

<figure><img src="/files/IGFfYR3GxyiFzYHNBPDn" alt="" width="563"><figcaption></figcaption></figure>

**Fluxo: Autoatendimento vinculando a comanda (leitor de código de barras ou QR Code)**

1. Cliente coloca o prato na balança.
2. Sistema pesa o prato.
3. Sistema solicita que o cliente informe a comanda (aproximando **código de barras ou QR Code** no leitor).
4. Sistema vincula o peso à comanda.
5. Cliente retira o prato da balança.

<figure><img src="/files/Ukkaz5QZsZvqM4hXcYjt" alt="" width="563"><figcaption></figcaption></figure>

**Tela de instruções de pesagem (opcional)**

Você pode abrir a tela de instruções para orientar o cliente durante o autoatendimento em dois locais no PDV: **Pedidos em criação** e **Criando pedido**. Basta clicar neste botão (para ficar visível

<figure><img src="/files/bm2aqPyYdUlNY27TG8nA" alt=""><figcaption></figcaption></figure>

A tela ficará neste formato. Para sair da tela, tecle ESC:

<figure><img src="/files/P3AjL1uVj97vaQXtZZx3" alt="" width="563"><figcaption></figcaption></figure>

**Como a tela funciona (passo a passo):**

Um exemplo de sequência em 4 etapas:

1. **Olá, coloque na balança**
2. **Aguarde a pesagem** (com indicador de carregamento)
3. **Pegue a comanda** (mostra peso e valor)
4. **Retire da balança**

Quando o prato é retirado, o processo reinicia.

<figure><img src="/files/lLIZg0tcUavy2EnuucBD" alt="" width="563"><figcaption></figcaption></figure>

</details>

<details>

<summary>Impressão personalizada da balança (opcional*)</summary>

É possível configurar um modelo de impressão específico para a balança.

* Esse modelo pode ser impresso em diferentes pontos do fluxo:
  * manualmente pelas opções extras no checkout do PDV (opção “Imprimir personalizada”)
  * no gestor de mesas na comanda nas opções de impressão
  * no autoatendimento\* (sempre imprime neste formato, mesmo quando não há nenhum produto adicionado na personalização)
* Você pode mostrar uma lista de produtos para serem impressos.
* Situações ao imprimir esta comanda:
  * Quando o operador cria o pedido pelo PDV e o produto do pedido **não consta** na comanda personalizada:
    * **Sem tabela de produtos personalizada**: o sistema cria a tabela e adiciona o produto + a quantidade da compra **somente para esta impressão** (não fica assim para os próximos pedidos).
    * **Com tabela de produtos personalizada**: o sistema adiciona o produto + a quantidade da compra **somente para esta impressão** (não fica assim para os próximos pedidos).
  * Quando o operador cria o pedido pelo PDV e há **mais de 1 produto com peso**, o sistema lista os produtos no topo da impressão.

<figure><img src="/files/wVmPqcBShAv5JLab2IE8" alt="" width="290"><figcaption></figcaption></figure>

</details>

<details>

<summary>Solução de problemas (rápido)</summary>

#### A balança não pesa / não comunica

* Confira os **Parâmetros da balança**.
* Use **Testar peso** para validar a conexão.
* Verifique se o usuário logado está com a configuração correta (configurações por usuário).

#### Não imprimiu a comanda

* Confirme se o modo está em **Imprimir comanda**.
* Verifique a impressora selecionada/configurada.

#### Leitor não vincula a comanda

* Confirme se o modo está em **Ler comanda com código de barras/QR Code**.
* Valide o leitor e o padrão de leitura (código de barras/QR Code).

</details>

<details>

<summary>Perguntas frequentes</summary>

#### Posso usar o modo com operador e autoatendimento na mesma loja?

Sim. Isso depende de como você configura o modo de operação para cada usuário/estação.

#### Preciso de monitor para o autoatendimento?

Não. A tela de instruções é **opcional**; você pode operar apenas com a balança (dependendo do seu fluxo).

</details>

<details>

<summary>Orientação por voz no autoatendimento da balança</summary>

#### Ativar a orientação por voz

1. Acesse as configurações de **Autoatendimento**.
2. Na seção **Orientação por voz na tela de instrução**, selecione **Usar orientação por voz**.
3. Clique em **Configurar voz**.

<figure><img src="/files/didnGAURlLKpit7Rxysh" alt="" width="432"><figcaption></figcaption></figure>

{% hint style="info" %}
Ao selecionar Não usar, nenhum áudio será reproduzido durante a pesagem.
{% endhint %}

#### Configurar a voz e as etapas

Na janela de configuração:

1. Em **Voz**, escolha **Feminina** ou **Masculina**.
2. Ative os áudios das etapas desejadas.
3. Use o botão de reprodução para ouvir uma prévia.
4. Clique em **Salvar**.

<figure><img src="/files/aaJldlGDEo5CO18zlUp5" alt="" width="329"><figcaption></figcaption></figure>

#### Etapas disponíveis

Você pode ativar ou desativar o áudio individualmente para estas etapas:

* Aguardando peso
* Verificando estabilidade
* Pegar comanda
* Leitor - instrução (quando usar o modo de operação “Ler comanda com código de barras”)
* Leitor - comanda não encontrada (quando usar o modo de operação “Ler comanda com código de barras”)
* Aguardando
* Finalizado

O sistema reproduzirá as orientações somente nas etapas ativadas.

</details>