> 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

Este artigo explica como funciona o Modo Balança (com operador ou autoatendimento) e como configurar a balança no sistema.

### 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)**
{% endhint %}

<details>

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

No app **Meus Pedidos (baixe aqui)**:

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

<div data-with-frame="true"><figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FsDP3Z7xdsjVglkQUqJwA%2Fimage.png?alt=media&#x26;token=801b0f45-e319-4275-a495-876a277137de" alt="" width="218"><figcaption></figcaption></figure></div>

</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

<div data-with-frame="true"><figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FzA4M8bhSMkXAwHH2Pm85%2Fimage.png?alt=media&#x26;token=afdd2cb6-3fa2-4daa-a64a-de63cc923a71" alt="" width="359"><figcaption><p>Clique em testar peso para verificar a conexão</p></figcaption></figure></div>

</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="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2Fl7SfqAa823SNJQdIKZSq%2Fb23fc564-456b-4aac-b5b2-740a91e20dc0.png?alt=media&#x26;token=b3acb25c-cbaa-4d67-a2c2-a34cce0060c0" 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="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FWEgrTpGmGnUlxDuTSFuO%2Fimage.png?alt=media&#x26;token=1d5ad798-930b-428e-b00a-f866a4765977" 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="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2F7xqv0Jqqug345j2aiVZf%2F2b7bef12-4b9e-486c-9f12-3d744795d674.png?alt=media&#x26;token=cc2e839f-0d07-4b55-980a-4304fd43f11c" 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).

<div data-with-frame="true"><figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2F1Jv299rcC4i3Xisiux3O%2Fimage.png?alt=media&#x26;token=ff0c56b8-4454-4798-90f9-ffe1c1051604" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
As balanças compatíveis devem utilizar um dos protocolos disponíveis na lista **“Modelo da balança”** dentro do aplicativo. Caso sua balança não utilize nenhum dos protocolos listados, entre em contato com nosso suporte para verificar a compatibilidade.
{% endhint %}

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

</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="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FiuQD5ny00lss5XoXW5KI%2Fimage.png?alt=media&#x26;token=3fd7d8fd-5e00-4cc5-a22f-d75ba905051a" 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**).

<div data-with-frame="true"><figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2F04VpI7zJaoH4mI7In71Z%2Fimage%20(1).webp?alt=media&#x26;token=787c3fb6-4caa-4e6d-bbb4-08b27e40070a" alt="" width="353"><figcaption><p>Tela do PDV quando há um produto na balança</p></figcaption></figure></div>

**Produtos disponíveis ao realizar a pesagem**

Nesta seção, você define os produtos que poderão ser selecionados durante a pesagem e como será feita a cobrança de cada um.

Clique em **Adicionar produto** e configure:

* **Produto por Kg:** produto cujo valor será calculado de acordo com o peso;
* **Produto Livre (opcional):** produto com valor fixo utilizado quando o limite configurado for atingido;
* **Limite para Livre:** informe o limite em reais ou gramas;
* **Valor do Livre:** mostra o preço cadastrado no Produto Livre selecionado.

Se houver um Produto Livre selecionado e o limite de valor ou peso for atingido, o sistema adicionará ao pedido o produto com valor fixo, em vez do produto por Kg.

Você também pode adicionar, excluir e alterar a ordem dos produtos. O primeiro produto da lista fica pré-selecionado durante a pesagem. Para alterar o produto padrão, reorganize a ordem arrastando os produtos.

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FLLDVbRCzpv30ey0Z3weU%2Fimagem%20balan%C3%A7a%201%20(1).png?alt=media&amp;token=6c57eaf5-7e0d-4a27-8fc9-60c4ca61c844" alt=""><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="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FX1xVi2Qj4k5g9DKDenxg%2F3.png?alt=media&#x26;token=bb17d699-beb5-428f-a208-06a2043d36c4" 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** não estiver ativada.
{% endhint %}

**Configurações do autoatendimento**

**Produtos da pesagem**

Nesta seção, configure como o produto será registrado e cobrado no autoatendimento:

* **Produto por Kg:** produto cujo valor será calculado de acordo com o peso;
* **Produto Livre (opcional):** produto com valor fixo utilizado quando o limite configurado for atingido;
* **Limite para Livre:** informe o limite em reais ou gramas;
* **Valor do Livre:** mostra o preço cadastrado no Produto Livre selecionado.

Se houver um Produto Livre selecionado e o limite de valor ou peso for atingido, o sistema adicionará ao pedido o produto com valor fixo, em vez do produto por Kg.

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FExPyDsYzAokIHM3a35Ds%2Fimagem%20balan%C3%A7a%202%20(1).png?alt=media&amp;token=7fe59219-b1ad-4ada-a94d-bb32e72dcd56" alt=""><figcaption></figcaption></figure>

* **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).
* **(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="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FPEND0CA1Xnl84H9HmMVh%2Fimage.png?alt=media&#x26;token=e38b1a22-f74f-4336-bfa4-4dc8f5d9dd46" alt="" width="440"><figcaption></figcaption></figure>

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FWcn6ciVMqfeiHKiqQMPl%2Fimage.png?alt=media&#x26;token=6aa5b9cc-94ba-42e0-a8c2-e846aa4647b3" 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="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2F4VeGa4xHHEhcx6HOM4aW%2Fimage.png?alt=media&#x26;token=22f82f43-8cbc-4c96-b896-4510b2427c72" 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="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FvYTXEERuhUn6Oo1x1bCR%2F5.png?alt=media&#x26;token=8ef65456-d79b-4516-9d79-da1aa0f664f5" 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="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FhV2F6Mws8NXJtXEdnoes%2F6.png?alt=media&#x26;token=88c15ac4-f3f4-4911-bc92-e9162b3ef463" 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="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FSACZDoGl1T1CnbyZ4rqO%2Fimage.png?alt=media&#x26;token=15a2730a-0828-41c6-ba6e-1e0437854d0e" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FbcC6KwnEq3CIIsP6rCFU%2Fimage.png?alt=media&#x26;token=c647fa7d-8997-430d-81b5-4b6e17c9a362" 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="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FpVsLwlOmNzHYcsohgRgT%2F8.png?alt=media&#x26;token=1fbc71af-83f8-4a3a-a203-083070c5fbe0" 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.

<div data-with-frame="true"><figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FWs7QS8L2YhgHVFW2biW8%2Fimage.png?alt=media&#x26;token=05c8f762-6d2c-4169-aeed-baf80dd47ece" alt="" width="290"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FnLF2crqOf7LR0RLGkGaT%2Fimage%20(23).png?alt=media&#x26;token=8ef65456-d79b-4516-9d79-da1aa0f664f5" alt="" width="432"><figcaption></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="https://3193212287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-ME41abfRf7bWmvqahTl%2Fuploads%2FFYA7SkthQrrH7ewcnVD9%2Fimage%20(8).png?alt=media&amp;token=bb499097-33ed-4369-a701-5fb95a4ccb0b" alt=""><figcaption></figcaption></figure></div>

#### Etapas disponíveis

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

* Aguardando peso
* Verificando estabilidade
* Pesagem não concluída
* 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

{% hint style="info" %}
Na etapa **Pesagem não concluída**, o sistema reproduz a mensagem:

**“Pesagem não concluída. Por favor, pese novamente.”**

Esse aviso é emitido quando a comanda é lida antes de o sistema concluir a pesagem. Nesse caso, realize a pesagem novamente e aguarde a etapa **Pegar comanda** antes de aproximar o código de barras ou QR Code do leitor.
{% endhint %}

{% hint style="info" %}
O sistema reproduzirá as orientações somente nas etapas ativadas.
{% endhint %}

</details>