> 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.**

<figure><img src="/files/94RNiuA3thgCgk9lx9FV" alt="" width="440"><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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ola.meajuda.cc/app-meus-pedidos/balanca.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.