> For the complete documentation index, see [llms.txt](https://ajuda.pdvlegal.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.pdvlegal.com.br/integracoes/recepcao-de-clientes-controle-de-portaria.md).

# Recepção de Clientes (Controle de Portaria)

Aplicativo para Android e Windows voltado ao controle de entrada, abertura de comandas e gestão de lotação com integração ao PDV Legal.

> O **Recepção** é um aplicativo voltado para o controle de entrada de clientes em bares, boates e casas de show. Ele opera integrado ao PDV Legal, usando cartões e pulseiras NFC ou código de barras para identificar clientes, abrir comandas automaticamente e acompanhar o fluxo de pessoas no salão em tempo real.

{% hint style="danger" %}
**Pré-requisito:** o aplicativo **Recepção** exige um **Centralizador** ativo e acessível na rede local. Ele pode ser:

* **Centralizador Windows**
* **Raspberry Pi** ou servidor físico
* **Centralizador Android**
* [**Servidor Legal (Servidor em Nuvem)**](https://ajuda.pdvlegal.com.br/integracoes/servidor-legal-servidor-em-nuvem)

Sem o Centralizador, o aplicativo não sincroniza dados nem abre comandas.
{% endhint %}

{% hint style="info" %}
O Recepção está disponível para **Android** e para **Windows**.

* No Android, instale pela **Google Play Store** para receber atualizações automáticas.
* No Windows, baixe a versão pelo [Centralizador de links](https://www.tiautomacaocomercial.com.br/apps/).

A configuração e a operação seguem o mesmo fluxo nas duas plataformas. Recursos que dependem do hardware do aparelho, como câmera para foto e leitura NFC por aproximação, exigem que o equipamento tenha esses componentes.
{% endhint %}

***

### 1. Liberação no OEM

> Antes da instalação, libere o módulo da solução na filial correta.

{% stepper %}
{% step %}
Acesse o sistema **OEM**.
{% endstep %}

{% step %}
Pesquise o cliente pelo **Código, CNPJ ou Nome**.
{% endstep %}

{% step %}
Clique no ícone **Filiais** e localize a filial desejada.
{% endstep %}

{% step %}
Clique no ícone **Editar**.

Use o lápis para abrir a configuração da filial.
{% endstep %}

{% step %}
Role a tela para baixo, marque o módulo do **Recepção de clientes** e clique em **Gravar**.
{% endstep %}
{% endstepper %}

***

### 2. Pré-requisitos no PDV Legal

> Antes da configuração, prepare os **grupos de produtos** usados como gatilho de entrada no PDV Legal. O Recepção trabalha com dois tipos de grupo: **Entradas** e **Consumação**.

{% hint style="info" %}
**Por que isso é necessário?**

O PDV Legal não abre uma comanda sem ao menos um produto lançado. Os grupos de **Entradas** e **Consumação** fazem esse papel. Assim que o cliente é recepcionado, um produto é lançado automaticamente na comanda.
{% endhint %}

{% hint style="info" %}
**Qual é a diferença entre os dois grupos?**

* **Entrada:** o cliente paga o ingresso e o valor se encerra ali. O que ele consumir depois é cobrado à parte.
* **Consumação:** o valor pago na entrada vira crédito de consumo dentro da casa. Se o cliente consumir menos do que o valor pago, a diferença fica com o estabelecimento. Se consumir mais, paga a diferença no fechamento.

O estabelecimento também pode combinar os dois, convertendo apenas parte do ingresso em consumação.
{% endhint %}

{% stepper %}
{% step %}
**Criar o grupo de Entradas**

Acesse **Gestão Legal > Produtos > Grupos de Produtos**.

* Crie um grupo chamado, por exemplo, **Entradas**.
* Cadastre os produtos de cobrança de entrada, como **Entrada Masculina**, **Entrada Feminina** e **Entrada VIP**.
* Esse grupo **não** deve ser marcado como consumação.
  {% endstep %}

{% step %}
**Criar o grupo de Consumação**

* Crie um grupo chamado **Consumação**.
* Cadastre produtos como **Consumação R$ 50**, **Consumação Camarote** e **Consumação VIP**.
* Esse grupo deve ser marcado como **consumação**.

{% hint style="info" %}
O nome do grupo é livre. O que define o comportamento é a marcação de consumação no grupo, e não o nome escolhido. Ainda assim, use nomes claros para facilitar o suporte e o treinamento da equipe.
{% endhint %}

{% hint style="success" %}
**Sem cobrança de entrada?**

Crie um produto de consumação com valor de **R$ 0,01**, como **Abertura de Comanda**. Ele serve apenas como gatilho para abrir a comanda.
{% endhint %}
{% endstep %}

{% step %}
**Combinar Entradas e Consumação**

Você pode usar apenas um grupo ou os dois ao mesmo tempo.

Exemplo: o cliente paga **R$ 50** de entrada e **R$ 100** de consumação. O recepcionista seleciona os dois produtos e o sistema lança **R$ 150** na comanda.

{% hint style="warning" %}
Apenas **um produto de cada grupo** pode ser selecionado por recepção. Se o grupo tiver um único item, ele já vem pré-selecionado.
{% endhint %}
{% endstep %}
{% endstepper %}

***

### 3. Perfis de acesso no PDV Legal

> O login no Recepção usa as mesmas credenciais do PDV Legal. O que cada operador pode fazer no app depende das permissões do **Perfil de Usuário PDV**.

Acesse **Gestão Legal > Administrativo > Perfis de Usuário PDV**.

Selecione ou crie o perfil desejado e configure:

| Permissão        | O que libera no app                                       |
| ---------------- | --------------------------------------------------------- |
| **Cadastros**    | Recepionar clientes e registrar novos cadastros           |
| **Consultas**    | Ver informações financeiras, histórico e média de consumo |
| **Configuração** | Acessar e alterar as configurações do aplicativo          |

{% hint style="warning" %}
Um operador sem a permissão de **Configuração** não consegue acessar os ajustes do app, mesmo conhecendo a senha de emergência.
{% endhint %}

***

### 4. Instalação e primeiro acesso

{% stepper %}
{% step %}
Acesse o [Centralizador de links](https://www.tiautomacaocomercial.com.br/apps/) no dispositivo **Android** ou **Windows** e instale o aplicativo **Recepção**.

No Android, você também pode instalar pela **Google Play Store**.
{% endstep %}

{% step %}
Abra o aplicativo. No primeiro acesso, ele exibirá a **tela de configuração inicial**.
{% endstep %}

{% step %}
Escolha a forma de conexão do aplicativo.

Se usar **servidor local**, informe o **IP do Centralizador** utilizado pelo PDV Legal.

Se usar **Servidor Legal**, ative essa opção, informe o **CNPJ** da mesma licença e filial e confirme o servidor encontrado.
{% endstep %}

{% step %}
Clique em **Testar Conexão**.

{% hint style="success" %}
Se o Centralizador já tiver sido configurado antes por outro dispositivo com o mesmo CNPJ ou CPF, o app preencherá a licença automaticamente e baixará as configurações salvas.
{% endhint %}
{% endstep %}

{% step %}
Se o campo de licença não for preenchido automaticamente, informe o **CPF ou CNPJ** do cliente.
{% endstep %}

{% step %}
Clique em **Buscar Licença** e depois em **Buscar Dados**.

O aplicativo sincroniza grupos de produtos, usuários e configurações do PDV Legal.
{% endstep %}
{% endstepper %}

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FbvOnrgnsYKPEo6MOnYSH%2Frecepcao_instalacao.gif?alt=media&#x26;token=e368198c-26e8-428f-af0c-346b1ef36d5c" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Entre os aplicativos móveis, o **Recepção** costuma ser um dos cenários mais aderentes ao **Servidor Legal**, principalmente quando a operação precisa conectar pontos diferentes com mais flexibilidade.
{% endhint %}

***

### 5. Configuração do aplicativo

> Após o primeiro acesso, o aplicativo exibe a tela completa de configuração. Ajuste cada seção conforme o perfil do estabelecimento.

#### 5.1 Aparência

{% stepper %}
{% step %}
Em **Tema**, selecione **Claro** ou **Escuro** conforme o ambiente do estabelecimento.
{% endstep %}

{% step %}
Em **Orientação da Tela**, defina se o dispositivo ficará em retrato ou paisagem.
{% endstep %}

{% step %}
Ative **Forçar Sincronização de Produtos** para atualizar o cardápio sempre que o app for aberto.
{% endstep %}
{% endstepper %}

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2Fg4DigcXOFt179c8p09fE%2Frecepcao_aplicativo.gif?alt=media&#x26;token=60c9519e-5506-4c12-94eb-31fbeef329ef" alt=""><figcaption></figcaption></figure>

***

#### 5.2 Grupos de produtos

{% stepper %}
{% step %}
Em **Entradas**, selecione o grupo de produtos cadastrado no PDV Legal para cobrança de ingresso.

Deixe em branco se o estabelecimento não cobrar entrada.
{% endstep %}

{% step %}
Em **Consumação**, selecione o grupo que representa a consumação mínima.

{% hint style="warning" %}
**Ao menos um dos grupos deve ser selecionado.** Sem isso, o aplicativo não consegue abrir comandas no PDV Legal.
{% endhint %}
{% endstep %}
{% endstepper %}

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FvrtqI7IDxu9FGcLt9Faf%2Frecepcao_produtos.gif?alt=media&#x26;token=481d5dc7-4db9-4cb9-a61a-af1afc414b00" alt=""><figcaption></figcaption></figure>

***

#### 5.3 Controle de lotação

{% stepper %}
{% step %}
Em **Capacidade Máxima**, informe o número máximo de pessoas permitidas no estabelecimento.

Deixe em **0** para não controlar lotação.
{% endstep %}

{% step %}
Em **Percentual de Alerta**, informe quando o aplicativo deve avisar o recepcionista. Exemplo: **90** para alertar com 90% da capacidade ocupada.

{% hint style="info" %}
Durante a recepção, o operador pode informar quantas pessoas estão entrando juntas. O sistema soma o grupo à lotação atual e exibe um alerta se o limite for ultrapassado.
{% endhint %}
{% endstep %}
{% endstepper %}

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FXiaUqRb66xAn8twsJgFB%2Frecepcao_lotacao.gif?alt=media&#x26;token=edc20eee-a6d1-4b6d-b236-8eeff15b4456" alt=""><figcaption></figcaption></figure>

***

#### 5.4 Campos de cadastro

> Configure quais dados serão solicitados ao recepcionar um novo cliente. Cada campo pode ser **opcional**, **obrigatório** ou **oculto**.

{% hint style="info" %}
Quanto mais campos obrigatórios, mais lenta fica a fila da portaria. Em operações de fluxo intenso, deixe obrigatório apenas o essencial, como nome e telefone, e mantenha os demais como opcionais.
{% endhint %}

{% stepper %}
{% step %}
**Foto**

* Se habilitada, a câmera do dispositivo será acionada para registrar a foto do cliente.
* A imagem fica armazenada no Centralizador por **60 dias**.
* Se marcada como opcional, o recepcionista pode pular essa etapa.
  {% endstep %}

{% step %}
**Telefone**

* Recomendado para facilitar a busca de clientes recorrentes e o contato por WhatsApp.
  {% endstep %}

{% step %}
**CPF**

* Útil para estabelecimentos que precisam de identificação fiscal ou emissão de nota.
* O app identifica automaticamente se o número digitado na busca é um **CPF** ou um **telefone** e preenche o campo correspondente.
* Se um dos dois campos estiver **oculto** na configuração, a informação é direcionada para o campo disponível, sem impedir a gravação do cadastro.
  {% endstep %}

{% step %}
**Código de Referência**

* Campo usado para vincular um **cartão ou pulseira NFC** ao cadastro do cliente.
* Também conecta o cliente à **Conta Assinada** no PDV Legal.

{% hint style="info" %}
Se o cliente retornar com o mesmo cartão NFC, o sistema reconhece o cadastro e preenche os dados automaticamente.
{% endhint %}
{% endstep %}

{% step %}
**E-mail** e **Endereço**

* Campos opcionais para enriquecer o cadastro do cliente.
  {% endstep %}
  {% endstepper %}

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FeTBL3tXnhc07VucY5zC2%2Frecepcao_cadastro.gif?alt=media&#x26;token=e75249a6-1426-4e33-8419-2b21606ca02f" alt=""><figcaption></figcaption></figure>

Para mais detalhes sobre leitura e uso de cartões, consulte [Cartões e Pulseiras NFC no PDV Legal](https://ajuda.pdvlegal.com.br/integracoes/cartoes-e-pulseiras-nfc-no-pdv-legal).

***

#### 5.5 Configurações financeiras

{% stepper %}
{% step %}
**Mostrar Alerta de Saldo Devedor**

Ative para exibir um aviso quando o cliente tiver débitos em aberto na **Conta Assinada**.
{% endstep %}

{% step %}
**Mostrar Botão de Informação Financeira**

Ative para exibir um ícone ao lado do cadastro do cliente durante a recepção, com acesso ao histórico das **últimas 10 visitas** e à **média de consumo**.
{% endstep %}
{% endstepper %}

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FgH2M9sP7zwswAJMoJQ6j%2Frecepcao_financeira.gif?alt=media&#x26;token=b3382cce-8236-4c69-8bad-64ba97014bc1" alt=""><figcaption></figcaption></figure>

Se você usa crédito pré-carregado, veja também [Módulo Conta Assinada: O que preciso saber?](https://ajuda.pdvlegal.com.br/pdv/modulos-de-operacao/modulo-conta-assinada).

***

#### 5.6 Configurações de leitura

{% stepper %}
{% step %}
Selecione o tipo de leitura que o estabelecimento utilizará: **NFC** e ou **Código de Barras**.

{% hint style="info" %}
Deixe habilitado apenas o que a operação usa de fato. Isso simplifica a tela de recepção e evita confusão do operador na portaria.
{% endhint %}
{% endstep %}

{% step %}
Se usar NFC, avalie ativar o **Modo NFC Exclusivo**.

{% hint style="warning" %}
Com o **Modo NFC Exclusivo** ativado, a recepção só pode ser concluída com a leitura física do cartão ou pulseira. Não é possível digitar o número da comanda manualmente.
{% endhint %}
{% endstep %}
{% endstepper %}

***

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F5JpcWv0EtbFnPkaQTs4x%2Frecepcao_leitura.gif?alt=media&#x26;token=27561b29-a2b7-442b-9f20-14c5eac05fc0" alt=""><figcaption></figcaption></figure>

#### 5.7 Consulta de saída

Ative **Habilitar Consulta de Saída** para liberar a tela de verificação de saída no menu do aplicativo.

> Essa tela permite verificar se a comanda foi quitada antes de liberar a passagem do cliente. A busca pode ser feita por cartão NFC, nome, telefone ou código de referência, conforme os campos habilitados.

{% hint style="info" %}
Ative também **Saída Somente pelo Número da Comanda** se quiser restringir a consulta de saída apenas à leitura do cartão NFC.
{% endhint %}

***

### 6. Operação do aplicativo

#### 6.1 Tela de login

{% stepper %}
{% step %}
Na tela inicial, informe o **usuário** e a **senha** cadastrados no Gestão Legal (Retaguarda Cloud).
{% endstep %}

{% step %}
Observe o **indicador de conexão** no canto superior:

* 🟢 **Verde** — Centralizador encontrado e comunicação ativa.
* 🔴 **Vermelho / Engrenagem** — Centralizador não encontrado.

{% hint style="warning" %}
Se o ícone de engrenagem aparecer, clique nele e informe a senha de emergência **1234** para acessar as configurações e corrigir o IP do Centralizador. Essa senha só funciona quando o aplicativo está sem conexão.
{% endhint %}
{% endstep %}

{% step %}
Clique no ícone de **sincronização** para forçar a atualização de usuários, produtos e configurações antes de iniciar a operação.

{% hint style="info" %}
Use essa sincronização sempre que cadastrar um novo usuário ou produto no PDV Legal e precisar que ele apareça imediatamente no aplicativo.
{% endhint %}
{% endstep %}
{% endstepper %}

***

#### 6.2 Recepcionando um cliente

{% stepper %}
{% step %}
Na tela principal, localize o cliente. Você pode:

* digitar o **nome** ou o **número**
* aproximar o **cartão ou pulseira NFC**, pelo ícone laranja
* ler um **QR Code** ou código de barras, pelo ícone correspondente

Se o cliente for encontrado, clique no cadastro para carregá-lo. Se não for, o app pergunta se você deseja cadastrar um novo cliente. Clique em **Sim**.

{% hint style="info" %}
Os ícones de leitura aparecem conforme o que estiver habilitado em **Configurações de leitura**.
{% endhint %}

{% hint style="info" %}
Ao buscar por número, o app reconhece o que foi digitado e leva o dado para o campo certo do cadastro:

* **CPF válido com 11 dígitos** — preenche o campo **CPF/CNPJ**
* **Telefone com 10 ou 11 dígitos** — preenche o campo **Telefone**, já formatado
* **CNPJ com 14 dígitos** — preenche o campo **CPF/CNPJ**

Exemplo: ao buscar `22981175914`, o app abre o formulário com `(22) 98117-5914` no campo de celular e deixa o CPF livre para digitação.
{% endhint %}
{% endstep %}

{% step %}
Preencha os dados solicitados conforme a configuração dos campos.
{% endstep %}

{% step %}
Se o estabelecimento usa **cartão ou pulseira NFC**, clique no ícone amarelo de NFC e aproxime o cartão do dispositivo para vinculá-lo ao cadastro.

{% hint style="info" %}
Se o cliente já possui cadastro e voltou com o mesmo cartão, basta aproximá-lo na tela de busca para preencher os dados automaticamente.

O app lê o número de série do cartão da mesma forma que o PDV Legal, sem necessidade de digitar a numeração.
{% endhint %}
{% endstep %}

{% step %}
Clique em **Salvar Cliente e Avançar**.
{% endstep %}

{% step %}
Selecione o produto de **Entrada** e ou **Consumação** correspondente à visita.

* Se houver um único produto no grupo, ele já vem pré-selecionado.
* Para grupos com entrada e consumação, selecione um de cada.
* Informe a **quantidade de pessoas** se o cliente estiver acompanhado.
  {% endstep %}

{% step %}
Se a casa trabalha com **promotores**, selecione o promotor responsável por aquele cliente.

Esse vínculo é o que alimenta o relatório de comissões.

{% hint style="info" %}
A pergunta sobre o promotor só aparece quando a opção **Ativar Informar Promoter** está habilitada nas configurações.
{% endhint %}
{% endstep %}

{% step %}
Confirme a leitura do cartão NFC ou, se o modo exclusivo não estiver ativo, confirme o número da comanda. Depois, clique em **Recepcionar**.

O cliente é registrado no estabelecimento e a comanda é aberta no PDV Legal.
{% endstep %}
{% endstepper %}

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F0WWe1UoAlldfEApH3v1K%2Frecepcao_telaDeLogin.gif?alt=media&#x26;token=905995fa-f606-4f27-8663-ad14812762a6" alt=""><figcaption></figcaption></figure>

***

#### 6.3 Menu de operação

> Durante o atendimento, o menu de três pontos dá acesso às funções de gestão da casa.

**Controle de lotação**

Exibe em tempo real:

* Quantidade de pessoas na casa
* Número de entradas realizadas
* Pico de pessoas por hora
* Filtro por período e exportação em PDF

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FEdcRtlVyWCvv4A0rgYgc%2Frecepcao_lotacao1.gif?alt=media&#x26;token=e1f38cac-4f07-4131-8a0e-98c5eedfbac8" alt=""><figcaption></figcaption></figure>

***

**Clientes na casa**

Lista todos os clientes recepcionados com comanda em aberto. Permite:

{% stepper %}
{% step %}
Buscar por **nome**, **telefone** ou **produto na comanda**.

{% hint style="info" %}
A busca por produto ajuda a localizar clientes que consumiram um item específico.
{% endhint %}
{% endstep %}

{% step %}
Clicar em um cliente para visualizar a **foto**, os **produtos na comanda** e o **telefone**, com atalho para WhatsApp.
{% endstep %}

{% step %}
**Trocar a comanda** de um cliente em caso de perda ou troca de cartão.

{% hint style="warning" %}
O sistema não permite vincular uma comanda que já esteja em uso por outro cliente.
{% endhint %}
{% endstep %}
{% endstepper %}

***

**Cadastro de Promotores**

Registra os promotores que levam clientes para a casa ou para o evento, como guias de turismo, divulgadores, influenciadores e parceiros.

{% stepper %}
{% step %}
Abra o menu do aplicativo em **Configurações,**
{% endstep %}

{% step %}
Em **Configuração de Leitura** ative o campo: **Ativar Informar Promoter**

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FYk6cSqlk6Nd6LE6j5IAi%2Fimage.png?alt=media&#x26;token=1424eb38-abb5-47fc-b2c6-9642049525bf" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Clique em **Salvar dados**
{% endstep %}

{% step %}
Após a ativação, no Menu do aplicativo parecerá a função: **Cadastro de Promotores**
{% endstep %}

{% step %}
Ao abrir a tela, você poderá:

* Pesquisar um Promotor cadastrado
* Excluir/Editar Promotor cadastrado
* Cadastrar Promotor

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FfGkOYYtl20Pi9EO5Rfrl%2Fimage.png?alt=media&#x26;token=66d0e791-8842-4f6f-a5de-bc991adde944" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Clique em + para adicionar um novo promotor e informe o **nome** e as **observações**.
{% endstep %}

{% step %}
Defina os valores de comissão do promotor:

* **valor fixo** por cliente recepcionado
* **percentual** sobre o valor consumido na comanda daquele cliente

Você pode usar os dois ao mesmo tempo.
{% endstep %}

{% step %}
Grave o cadastro.

O promotor passa a ficar disponível para vínculo na recepção e para consulta no relatório de comissões.
{% endstep %}
{% endstepper %}

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FjORpBCb2L6FUkLF7OVU9%2Fimage.png?alt=media&#x26;token=31a60f50-97f2-49e7-a6ce-619df9d76a4a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
A lista de promotores tem campo de busca e exibe, em cada registro, os valores de comissão configurados.
{% endhint %}

{% hint style="warning" %}
A comissão do promotor é independente da comissão do atendente. O percentual do garçom continua sendo tratado no PDV Legal, com relatório próprio na retaguarda. As duas podem conviver na mesma venda.
{% endhint %}

{% hint style="warning" %}
A comissão percentual considera o valor consumido na comanda. Não é possível comissionar o promotor apenas sobre produtos específicos.
{% endhint %}

***

**Comissões de Promotores**

Consolida as entradas vinculadas a cada promotor e calcula a comissão a pagar.

{% hint style="info" %}
A comissão só entra no relatório depois que a comanda do cliente é fechada no PDV Legal. Enquanto a comanda estiver aberta, a venda ainda não aparece no consolidado.
{% endhint %}

{% stepper %}
{% step %}
Abra o menu do aplicativo, clique em **Relatórios**

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FTWbmvmiAjqDwUB7dJbBJ%2Fimage.png?alt=media&#x26;token=271c6950-b37e-48fd-a971-53c224d77234" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Selecione o relatório: **Comissões de Promotores**.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FpugTFBE06f1zCMWYrikJ%2Fimage.png?alt=media&#x26;token=62499aad-ac16-4502-b63c-3c6b7538e4a9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Informe a **data inicial** e a **data final** da consulta.
{% endstep %}

{% step %}
Em **Promotor**, escolha um promotor específico ou mantenha **Todos** para ver a lista geral agrupada.
{% endstep %}

{% step %}
Clique em **Consultar Comissões**.

O aplicativo exibe as vendas do período com data, cliente e valor, além do subtotal por promotor e do total geral.
{% endstep %}

{% step %}
Se precisar, exporte o relatório em **PDF** ou **Excel**, ou imprima o documento para o acerto com os promotores.
{% endstep %}
{% endstepper %}

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2F2eqhCBhpXBKi7rdqNw0o%2Fimage.png?alt=media&#x26;token=7681a65f-f83d-4cf8-ade4-8e3a71392634" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
O subtotal de cada promotor traz a quantidade de vendas, o total vendido, a comissão fixa, a comissão percentual e o total de comissão do período.
{% endhint %}

***

**Sincronizar dados**

Força a atualização manual de produtos, grupos, usuários e configurações. A sincronização automática acontece a cada **15 minutos**.

***

**Comandas perdidas**

Registra e gerencia cartões e pulseiras reportados como perdidos.

{% stepper %}
{% step %}
Clique em **Bloquear Comanda** e informe o número da comanda e o motivo.
{% endstep %}

{% step %}
A comanda bloqueada não poderá ser utilizada para novos lançamentos nem validada na saída.
{% endstep %}

{% step %}
Quando a comanda for localizada, clique em **Desbloquear** para liberá-la novamente.
{% endstep %}

{% step %}
É possível realizar bloqueio e desbloqueio de comandas em lote.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Em breve, as comandas bloqueadas aqui também impedirão novos lançamentos diretamente no PDV Legal.
{% endhint %}

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2Ft7OS7DTwP296mINsssiv%2FComanda_bloqueada.gif?alt=media&#x26;token=d7ec356b-4ce8-4add-9ebd-67f748ef4e37" alt=""><figcaption></figcaption></figure>

***

**Relatórios**

Registro de auditoria de todas as ações realizadas no aplicativo. Inclui logins, trocas de comanda, cadastros de clientes, acessos a informações financeiras e alterações de configuração.

* Filtre por **tipo de ocorrência**, **dispositivo** e **usuário**.
* Exporte em **PDF**.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FmlD6b18ldh8FbDBksYiv%2Frecepcao_relatorios.gif?alt=media&#x26;token=af59183a-1d42-4eda-8ede-cdae5d4f4690" alt=""><figcaption></figcaption></figure>

***

**Consulta de saída**

{% stepper %}
{% step %}
Localize o cliente por **leitura NFC**, nome, telefone ou código de referência.
{% endstep %}

{% step %}
O sistema exibe o **status da comanda**:

* ✅ **Liberado** — comanda quitada, cliente pode sair.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FW0VG6v7bxqOV6dS9DcQT%2Fimage.png?alt=media&#x26;token=0f038d7f-8b0d-4327-aa18-5dfcc6bdbeab" alt=""><figcaption></figcaption></figure>

* ⚠️ **Consumo Pendente** — exibe saldo em aberto, foto do cliente, horários e produtos consumidos.

<figure><img src="https://1320237751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLaIVEmahy7qwD0rmQzED%2Fuploads%2FZiZlDVlX92joo0m8nfga%2Fimage.png?alt=media&#x26;token=fc84c118-a8cf-497e-9a07-3028ac3a6b70" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
O pagamento da comanda é feito no **PDV Legal**, não no aplicativo Recepção. A consulta de saída serve apenas como verificação.
{% endhint %}

***

### 7. Conta Assinada

> Clientes com crédito pré-carregado no PDV Legal podem usá-lo para pagar a comanda por aproximação do cartão ou pulseira NFC diretamente no PDV.

{% stepper %}
{% step %}
Cadastre o cliente no Gestão Legal (Retaguarda Cloud) e acesse a seção de **Conta Assinada**.
{% endstep %}

{% step %}
Lance o crédito desejado.
{% endstep %}

{% step %}
Na recepção, vincule o cartão NFC ao campo **Código de Referência** do cadastro do cliente.
{% endstep %}

{% step %}
No pagamento no PDV, selecione **Conta Assinada** e aproxime o cartão NFC para identificar o cliente e consumir o crédito disponível.

{% hint style="info" %}
Se o consumo ultrapassar o saldo, o cliente deverá pagar a diferença com outra forma de pagamento.
{% endhint %}
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Pronto. Com o ambiente configurado, o aplicativo **Recepção** está preparado para controlar a entrada de clientes, a lotação da casa e a abertura de comandas com integração em tempo real ao PDV Legal.
{% endhint %}

***

{% hint style="danger" %}
**Problema:** comandas informadas na Recepção não registradas corretamente no Centralizador **Raspberry Pi / Linux**.

Esse problema ocorre quando o cliente já utilizou o recurso de **Catraca** no mesmo Centralizador. Como o aplicativo **Recepção** e o recurso de **Catraca** usam estruturas incompatíveis, a coexistência das tabelas pode impedir o registro correto das comandas.

**Solução:** acesse o phpMyAdmin em `http://[IP do servidor]/phpmyadmin` e execute o comando abaixo na base do Centralizador:

```sql
DROP TABLE TBCOMANDA;
```

Depois disso, feche o aplicativo **Recepção** e abra novamente. O sistema recria a tabela no padrão correto e volta a registrar as comandas normalmente.

{% hint style="warning" %}
`DROP TABLE` remove a tabela e todos os dados dela de forma permanente. Execute esse comando apenas quando não houver comandas em aberto, ou depois de confirmar que esses dados não são mais necessários.
{% endhint %}
{% endhint %}

### Manuais relacionados

* [Cartões e Pulseiras NFC no PDV Legal, o que preciso saber?](https://ajuda.pdvlegal.com.br/integracoes/cartoes-e-pulseiras-nfc-no-pdv-legal)
* [Módulo Conta Assinada: O que preciso saber?](https://ajuda.pdvlegal.com.br/pdv/modulos-de-operacao/modulo-conta-assinada)
* [Centralizador Windows (Servidor Local)](https://ajuda.pdvlegal.com.br/integracoes/centralizador-windows-servidor-local)
* [Servidor Legal (Servidor em Nuvem)](https://ajuda.pdvlegal.com.br/integracoes/servidor-legal-servidor-em-nuvem)
* [Como Configurar Terminais?](https://ajuda.pdvlegal.com.br/retaguarda/administrativo/configuracao-de-terminais-no-gestao-legal-retaguarda-cloud)


---

# 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, and the optional `goal` query parameter:

```
GET https://ajuda.pdvlegal.com.br/integracoes/recepcao-de-clientes-controle-de-portaria.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
