> 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/servidor-legal-servidor-em-nuvem.md). # Servidor Legal (Servidor em Nuvem) > O **Servidor Legal** é a opção de centralização em nuvem do ecossistema PDV Legal. Ele substitui a configuração manual por IP em aplicações compatíveis e permite localizar o ambiente pela licença da filial. {% hint style="info" %} O recurso também pode aparecer como **Servidor em Nuvem**, **DNS** ou **Servidor Legal** dentro dos aplicativos. {% endhint %} *** ### 1. O que muda na prática > Em vez de apontar cada aplicativo para um IP fixo, você ativa o uso do servidor em nuvem e valida a licença da filial. Depois disso, o aplicativo: * localiza o ambiente automaticamente * sincroniza as tabelas necessárias * passa a usar o Servidor Legal no lugar do servidor local {% hint style="warning" %} Quando o aplicativo está usando o servidor em nuvem, o campo de **IP** pode ficar bloqueado. Para voltar ao modo local, use a opção de **voltar para IP** no próprio app. {% endhint %} *** ### 2. Liberação no OEM > Antes de ativar o servidor nos aplicativos, libere o recurso 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, habilite o recurso de **Servidor Legal** para a filial e clique em **Gravar**. {% endstep %} {% endstepper %} *** ### 3. Habilitação na Retaguarda > Depois da liberação no OEM, habilite o terminal na filial correta dentro da Retaguarda. {% stepper %} {% step %} Acesse a **Retaguarda**. {% endstep %} {% step %} Entre em **Gestão Legal → Administrativo → Filiais**. {% endstep %} {% step %} Abra a filial correta e acesse **Meus Terminais**. {% endstep %} {% step %} Habilite ao menos um terminal vinculado ao **Servidor Legal**. * Clique no terminal que será vinculado e no campo: **Busca Compartilhamento**, selecione a opção **Servidor Legal** * Use **Servidor Legal** para definir o endereço automaticamente. Use **Servidor Próprio** apenas para um servidor local ou de terceiro, informado por IP ou DNS.
{% endstep %} {% step %} Grave a alteração e confirme o documento da licença. Na ativação dos apps, use o mesmo **CNPJ** da licença onde o servidor em nuvem foi liberado. Em alguns fluxos, o sistema também pode aceitar **CPF ou CNPJ**, conforme o tipo da licença. {% endstep %} {% endstepper %} #### Adicionar outros terminais Para replicar a configuração de um terminal já preparado: 1. Em **Meus Terminais**, selecione **Copiar de um terminal existente**. 2. Escolha um terminal que já esteja usando o Servidor Legal. 3. Informe o nome e o MAC address do novo equipamento. 4. Grave e execute **Baixar Tabelas** no novo PDV. {% hint style="info" %} Um novo terminal também pode herdar a configuração da loja durante o licenciamento. Mantenha os terminais com a configuração desejada e revise o resultado em operações com configurações mistas. {% endhint %} {% hint style="danger" %} Se o sistema não localizar nenhum servidor ou licença liberada, revise a filial, o documento informado e a liberação do recurso antes de seguir. {% endhint %} *** {% hint style="success" %} Até aqui, o **Servidor Legal** já está liberado e habilitado para a filial. As próximas orientações são opcionais. Use apenas se também for configurar aplicações complementares compatíveis. {% endhint %} *** ### 4. Configuração opcional nas aplicações complementares > Esta parte não faz parte da habilitação principal do Servidor Legal. Ela serve apenas para conectar apps compatíveis, como **Balança 2.0**, **KDS**, **Recepção** e **App do Garçom**. {% stepper %} {% step %} Abra a tela de configuração do aplicativo. {% endstep %} {% step %} Ative a opção de usar **Servidor Legal**, **DNS** ou **Servidor em Nuvem**.
{% endstep %} {% step %} Informe o **CNPJ** da licença da filial e toque em **Pesquisar**, **Validar** ou opção equivalente. {% endstep %} {% step %} Confirme o servidor localizado.
{% endstep %} {% step %} Aguarde a sincronização inicial. Nesse momento, o app pode validar estrutura, tabelas e permissões antes de concluir. {% endstep %} {% endstepper %} {% hint style="info" %} Se o seu objetivo era apenas liberar e habilitar o **Servidor Legal** na filial, você pode encerrar o processo na etapa **3. Habilitação na Retaguarda**. {% endhint %} {% hint style="danger" %} **Não compatível:** os módulos **Tablet na Mesa**, **QR Code na Mesa** e **Comanda QR** não funcionam com o **Servidor Legal**. Configure esses módulos com um [Centralizador Windows local](/integracoes/centralizador-windows-servidor-local.md). {% endhint %} *** ### 5. Comportamento esperado {% hint style="info" %} **Primeira abertura e sincronização** O servidor em nuvem pode ficar um pouco mais lento na abertura do app e na primeira carga de dados. Isso é esperado. Depois da sincronização inicial, o uso tende a estabilizar. {% endhint %} {% hint style="warning" %} **Teste de conexão mais demorado** Em alguns apps, o botão de testar conexão faz checagens extras de integridade. Por isso, o retorno pode demorar mais do que em um servidor local. {% endhint %} *** ### 6. Migrar de outro servidor Antes de migrar uma loja do Raspberry, de um servidor local ou de outro servidor: 1. Feche todas as contas abertas nos PDVs. 2. Sincronize as vendas com a nuvem. 3. Altere os terminais para **Servidor Legal**. 4. Execute **Baixar Tabelas** em cada PDV. {% hint style="warning" %} Contas abertas no servidor anterior não são transferidas automaticamente. Feche e sincronize todas as contas antes de alterar o apontamento. {% endhint %} Se necessário, limpe a base local após concluir o backup e a sincronização. A limpeza remove o histórico local de vendas, mas preserva cadastros e configurações. Consulte [Limpeza do banco de dados](/pdv/configuracao-do-pdv/limpeza-do-banco-de-dados.md). *** ### 7. Consultar contas no Servidor Legal > Use **Dashboard → Contas em aberto** para acompanhar as contas da operação. Selecione a filial que deseja consultar. A visualização é individual por filial. O painel é atualizado automaticamente a cada 15 segundos. Ele reúne: * **Contas em aberto** * **Contas fechadas** * **Contas canceladas** Nas contas canceladas, consulte quem lançou, quem cancelou e o horário. Use a busca por conta, comanda ou produto para localizar uma movimentação. Nas contas abertas, use os filtros de **Balcão**, **Mesa** e **Entrega**. Abra a conta para consultar itens, acréscimos, descontos e cancelamentos registrados. Use os filtros de **hoje**, **ontem**, **anteontem** ou **últimos três dias**.
{% hint style="info" %} O painel consulta o servidor que gerencia as contas. Uma conta pode aparecer nele antes do envio da venda para a Retaguarda. Esse envio pode levar até três minutos. {% endhint %} *** ### 8. Quando faz sentido usar > O servidor em nuvem é excelente, mas pode não ser a melhor escolha para toda operação. #### Cenários recomendados * operações distribuídas ou com equipamentos em redes diferentes * ambientes grandes, como clubes ou estruturas com vários pontos de acesso * operações em que o app precisa acessar o ambiente fora da rede local * cenários de **Recepção**, onde a centralização em nuvem pode simplificar a operação #### Cenários em que o servidor local costuma ser melhor * restaurantes com operação concentrada no salão * ambientes com **Balança 2.0**, **Tablet na Mesa** ou fluxos muito dependentes da rede interna * negócios com janela curta de atendimento, como almoço self-service * locais com internet instável ou com risco alto de indisponibilidade #### Onde o Raspberry continua fazendo sentido * operações sem internet estável * ambientes que precisam continuar locais, mas sem um servidor Windows * cenários móveis ou remotos, como embarcações e estruturas temporárias {% hint style="warning" %} Se a internet cair, os apps configurados somente com servidor em nuvem podem perder comunicação com a operação. Avalie esse risco antes de implantar. {% endhint %} Para operações de maior volume, recomenda-se conexão principal e contingência. Use, por exemplo, fibra e 4G/5G de provedores diferentes, com roteador de troca automática. *** ### 9. Erros mais comuns #### Nenhum servidor encontrado Normalmente indica uma destas situações: * documento informado não pertence à licença correta * recurso não foi liberado no OEM * terminal da filial ainda não foi habilitado para o serviço #### Encontrou a licença errada Revise a filial antes de confirmar. Alguns apps seguram a ativação por alguns segundos justamente para evitar vínculo com o ambiente incorreto. #### Lentidão na carga inicial O primeiro carregamento depende da internet da loja e da quantidade de dados a sincronizar. #### Conta não aparece na consulta Confirme a filial, o período e o status da conta. Depois, pesquise pelo número da conta, da comanda ou por um produto. #### Aplicativo parou após atualização de infraestrutura Execute **Baixar Tabelas** uma vez em cada PDV que usa o Servidor Legal. O processo atualiza o endereçamento e não remove dados. *** ### 10. Manuais relacionados * [Balança Autônoma 2.0](/integracoes/balanca-autonoma/balanca-autonoma-2.0.md) * [App do Garçom (Painel Garçom)](/integracoes/app-do-garcom-painel-garcom.md) * [Recepção de Clientes (Controle de Entrada)](/integracoes/recepcao-de-clientes-controle-de-entrada.md) * [KDS (Monitor de Pedidos e Gestor de Filas)](/integracoes/kds-monitor-de-pedidos-e-gestor-de-filas.md) * [Centralizador Windows (Servidor Local)](/integracoes/centralizador-windows-servidor-local.md) --- # 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/servidor-legal-servidor-em-nuvem.md?ask=&goal= ``` `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.