Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Servidor Legal (Servidor em Nuvem)

Habilite o Servidor Legal, conecte aplicativos compatíveis e acompanhe contas no Cloud.

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.

O recurso também pode aparecer como Servidor em Nuvem, DNS ou Servidor Legal dentro dos aplicativos.

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

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.

2. Liberação no OEM

Antes de ativar o servidor nos aplicativos, libere o recurso na filial correta.

1

Acesse o sistema OEM.

2

Pesquise o cliente pelo Código, CNPJ ou Nome.

3

Clique no ícone Filiais e localize a filial desejada.

4

Clique no ícone Editar.

Use o lápis para abrir a configuração da filial.

5

Role a tela para baixo, habilite o recurso de Servidor Legal para a filial e clique em Gravar.

3. Habilitação na Retaguarda

Depois da liberação no OEM, habilite o terminal na filial correta dentro da Retaguarda.

1

Acesse a Retaguarda.

2

Entre em Gestão Legal → Administrativo → Filiais.

3

Abra a filial correta e acesse Meus Terminais.

4

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.

5

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.

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.

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.

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.

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.

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.

1

Abra a tela de configuração do aplicativo.

2

Ative a opção de usar Servidor Legal, DNS ou Servidor em Nuvem.

3

Informe o CNPJ da licença da filial e toque em Pesquisar, Validar ou opção equivalente.

4

Confirme o servidor localizado.

5

Aguarde a sincronização inicial.

Nesse momento, o app pode validar estrutura, tabelas e permissões antes de concluir.

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.

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.

5. Comportamento esperado

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.

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.

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.

Contas abertas no servidor anterior não são transferidas automaticamente. Feche e sincronize todas as contas antes de alterar o apontamento.

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.

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.

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.

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

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.

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

Atualizado

Isto foi útil?