> 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**
{% 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 %} {% 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 como **Balança 2.0**, **KDS**, **Recepção**, **App do Garçom**, **Autoatendimento Mesa** e outros compatíveis. {% 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 %} *** ### 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. Mapa de mesas em aberto no Cloud > O **Dashboard** do Cloud pode exibir um atalho adicional para acompanhar mesas em aberto. Sempre que o **grupo econômico** tiver ao menos uma filial com **Rasp PDV Legal**, o link da página de visualização do **mapa de mesas em aberto** ficará disponível no **Dashboard**. Esse link aparece ao lado de **Painel de Equipamentos**.
*** ### 7. 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 %} *** ### 8. 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. *** ### 9. Manuais relacionados * [Balança Autônoma 2.0](/integracoes/balanca-autonoma/balanca-autonoma-2.0.md) * [Autoatendimento Mesa (Tablet na Mesa, QR Code na Mesa e Comanda QR)](/integracoes/autoatendimento-mesa-tablet-na-mesa-qr-code-na-mesa-e-comanda-qr.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: ``` GET https://ajuda.pdvlegal.com.br/integracoes/servidor-legal-servidor-em-nuvem.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.