# Recepção de Clientes (Controle de Entrada) > O **Recepção** é um aplicativo Android 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** * **Centralizador em nuvem** Sem o Centralizador, o aplicativo não sincroniza dados nem abre comandas. {% endhint %} {% hint style="info" %} O aplicativo está disponível na **Google Play Store**. Recomendamos instalar por lá para receber atualizações automáticas. {% 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 %} {% 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="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 e instale o aplicativo **Recepção**. {% endstep %} {% step %} Abra o aplicativo. No primeiro acesso, ele exibirá a **tela de configuração inicial**. {% endstep %} {% step %} Informe o **IP do Centralizador** utilizado pelo PDV Legal na rede local. {% 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 %}
*** ### 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 %}
*** #### 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 %}
*** #### 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 %}
*** #### 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**. {% 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. {% 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 %}
Para mais detalhes sobre leitura e uso de cartões, consulte [Cartões e Pulseiras NFC no PDV Legal](/integracoes/cartoes-e-pulseiras-nfc-no-pdv-legal-o-que-preciso-saber.md). *** #### 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 %}
Se você usa crédito pré-carregado, veja também [Módulo Conta Assinada: O que preciso saber?](/pdv/modulos-de-operacao/modulo-conta-assinada-o-que-preciso-saber.md). *** #### 5.6 Configurações de leitura {% stepper %} {% step %} Selecione o tipo de leitura que o estabelecimento utilizará: **NFC** e ou **Código de Barras**. {% 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 %} ***
#### 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, busque o cliente pelo nome. * Se encontrado, clique no cadastro para carregá-lo. * Se não encontrado, clique em **Cadastrar Novo**. {% 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. {% 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 %} 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 %}
*** #### 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
*** **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 %} *** **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 %}
*** **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**.
*** **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.
* ⚠️ **Consumo Pendente** — exibe saldo em aberto, foto do cliente, horários e produtos consumidos.
{% 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?](/integracoes/cartoes-e-pulseiras-nfc-no-pdv-legal-o-que-preciso-saber.md) * [Módulo Conta Assinada: O que preciso saber?](/pdv/modulos-de-operacao/modulo-conta-assinada-o-que-preciso-saber.md) * [Centralizador Windows (Servidor Local)](/integracoes/centralizador-windows-servidor-local.md) * [Como Configurar Terminais?](/retaguarda/administrativo/como-configurar-terminais.md) --- # Agent Instructions: 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://ajuda.pdvlegal.com.br/integracoes/recepcao-de-clientes-controle-de-entrada.md?ask= ``` 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.