CONTEÚDO

  1. Visão geral
  2. Exemplo de utilização
    1. Caminho
    2. Parâmetros dinâmicos
    3. Pré-requisitos, restrições e parametrizações
    4. Pré-requisitos técnicos
    5. Passo a passo 
  3. Tecnologias homologadas
  4. Documentação e assuntos relacionados
  5. Documentação de versões e atualizações

01. VISÃO GERAL

Realizar o cadastro, e o controle de licenciamento das empresas.

02. EXEMPLO DE UTILIZAÇÃO

Caminho

Módulo Segurança Desktop > Menu Manutenção > Empresas - GLSGEMP001

Parâmetros dinâmicos

Não há.

Pré-Requisitos, Restrições e Parametrizações

Não há.

Pré-Requisitos técnicos

Para usar o recurso de busca de logradouro por CEP, com base na API dos Correios, não é necessário nenhuma aquisição ou contrato adicional.
Apenas deve ser instalada a API de dependência e realizar a configuração da URL de instalação, no módulo Parâmetros>Parâmetros> Gerais>aba Integrações> campo URL base de API local.

Passo a passo

Cadastrar a Empresa

Entre na aplicação

Imagem 1 - Empresas - GLSGEMP001


Informe os campos:

  • Razão Social: nome de razão social.
  • Código: código da empresa.
  • Fantasia: nome fantasia.
  • Nome Reduzido: nome reduzido da empresa.
  • Pessoa: nome da pessoa jurídica responsável pela empresa. O cadastro Pessoas - GEPES0010  deve ser feito antes do cadastro da empresa.
  • Empresa Matriz: define qual será a empresa matriz, compreende a estrutura de matriz e filiais. Utilizada no financeiro, fiscal e contábil. Quando este campo fica em branco, automaticamente a empresa será a matriz.
  • Empresa Segurança: define qual será a empresa segurança para centralizar as permissões.
  • Status Empresa: se está ativou ou inativo.

Imagem 2 - Empresas - GLSGEMP001


Informe os campos:

  • CEP: CEP da empresa.
  • Cidade: cidade em que a empresa está localizada.
  • UF: estado em que a empresa está localizada.
  • Bairro: bairro em que a empresa está localizada.
  • Logradouro: nome da rua/avenida que a empresa está localizada.
  • Número: número do endereço da empresa.
  • Complemento: complemento para facilitar a localização da empresa.
  • E-mail: e-mail utilizado para contato.
  • Home Page: site da empresa.
  • Fone: Telefone para contato.
  • Fax: Fax para contato.

Imagem 3 - Empresas - GLSGEMP001

A aplicação possui o recurso de busca das informações, utilizando endpoint específico da nova API Conector Dados Globais.
Para isso, deve-se instalar a API no ambiente e configurar a URL de instalação na rotina Parâmetros Gerais, na guia Integrações, no campo URL base de API local.
Para usar o recurso de busca de logradouro por CEP, com base na API dos Correios, não é necessário nenhuma aquisição ou contrato adicional.
Apenas instalar a API de dependência e realizar a configuração da URL de instalação, no módulo Parâmetros>Parâmetros> Gerais>aba Integrações> campo URL base de API local.


Funcionamento do recurso de busca de logradouro por CEP, com base na API dos Correios:

  • Consulta Inicial:
    • Quando um CEP é informado pela primeira vez, o sistema faz uma chamada à API dos Correios.
    • Os dados retornados, incluindo informações de logradouro, são armazenados na base de dados do ERP junto com a data da consulta.
  • Verificações
    • Ao consultar um CEP já existente:
    • O sistema verifica a data da última consulta armazenada.
    • Se a consulta foi realizada dentro dos últimos 12 meses, os dados são recuperados diretamente do base de dados sem acionar a API.
    • Se a consulta ultrapassou os 12 meses, o sistema faz uma nova chamada à API, atualizando as informações e a data da consulta.
  • Quando se tratar de um CEP por logradouro, a aplicação deve carregar as informações de cidade, UF, bairro e logradouro conforme a pesquisa realizada, ficando o cursor no campo Nº. As informações pesquisadas devem serão automaticamente atualizadas nas tabelas pertinentes ao Logradouro.

Imagem 4 - Busca de informações baseado no CEP


Para habilitar o campo Cidade, quando existe uma URL configurada para a API de Conector dados Globais, será necessário pressionar TAB quando o cursor estiver no campo CEP.

  • Caso o usuário não saiba o CEP, poderá sair do campo CEP.
    Automaticamente os campos Cidade, UF e Logradouro são habilitados para que ele possa informá-los, e assim a rotina buscar pela API Conector Dados Globais do CEP e Bairro correspondente a aquelas informações.

Imagem 5 - Busca de informações do CEP através da Cidade, UF e Logradouro

  • Quando os dados informados de Cidade, UF e Logradouro, possuírem mais de um CEP vinculado, junto aos Correios, será exibida uma dialog com todos os resultados encontrados para que o usuário possa selecionar a informação correta.

Imagem 6 - Retorno de vários CEPs para uma mesma Cidade, UF e Logradouro


Importante ressaltar, que as novas implementações só terão efeito se a API Conector Dados Globais estiver devidamente instalada no ambiente do cliente, caso a API não esteja instalada e configurada, o processo padrão anterior existente continuará sendo executado.

Padrão de configuração de CEP, Cidade, Bairro e Logradouro sem as configurações da API Conector Dados Globais, com a comunicação dos CEP´s dos correios.

  • Informe a cidade. Quando adicionar a cidade a pessoa, os campos UF e CEP serão preenchidos automaticamente. O campo CEP poderá sofrer alteração quando adicionar o bairro e o logradouro:
  • informe o bairro. Ao adicionar o bairro o campo CEP poderá reajustar automaticamente.
  • Informe o logradouro. Quando adicionar o logradouro o campo CEP poderá reajustar automaticamente.
  • Adicionar o número da residência.


Imagem 7 - Informar dados de endereço sem API Conector Dados Globais vinculada

Informe os campos:

  • CNPJ: número do CNPJ.
  • Inscrição Estadual: número da inscrição estadual.
  • PIS/PASEP/CISUS: número do PIS/PASEP/CISUS.
  • Inscrição Municipal: número da inscrição municipal.
  • Outra Inscrição: qualquer outra inscrição que a empresa possua.
  • INSS: número do INSS.
  • Suframa: caso possua o código da Superintendência da Zona Franca de Manaus.
  • Logotipo da Empresa: logotipo da empresa.


Imagem 8 - Empresas - GLSGEMP001


Informe os campos:

  • Logotipo da Empresa: logotipo da empresa.

Imagem 9 - Empresas - GLSGEMP001


Propriedades Servidor SMTP

  • E-mail
    • Nome de Usuário: nome que será exibido para o destinatário.
    • E-mail Remetente: é o e-mail que será exibido para o destinatário.
    • Servidor de Saída (SMTP): endereço do servidor. Ex.: smtp.gmail.com
    • Porta de Saída (SMTP): é a porta de conexão do servidor. Ex.: 587
    • Comando de Autenticação: conforme exigido por cada servidor SMTP, e pode ser utilizados os comandos Helo e Ehlo.
    • E-mail de Validação TNSRV: conta de e-mail para receber as validações do módulo TNSRV.

Imagem 10 - Empresas - GLSGEMP001

  • Autenticação
    • Servidor requer autenticação: sim ou não.
    • Nome da conta: credencial de acesso. Ex.: [email protected]
    • Senha da conta: senha da credencial.

Imagem 11 - Empresas - GLSGEMP001

  • Certificado 
    • Servidor requer certificado: se exige certificado de segurança: sim ou não. 
    • Tipo de Certificado: é o tipo de certificado utilizado SSL ou TLS.
    • Diretório Certificado Oracle Wallet: é o caminho onde se encontra o certificado dentro do oracle. Ex.: file:/oracle/wallet
    • Senha Oracle Wallet: senha definida para acessar o wallet. Opcional.

Imagem 12 - Empresas - GLSGEMP001

E clique para incluir <F3> as empresas.


Propriedades Servidor SMTP

E clique para incluir <F3> as empresas.

Controle de Licenciamento

Após ter cadastrado a empresa, é necessário informar as licenças, para isso selecione uma das empresas que refere-se à chave de ativação em questão.

Imagem 2 - Empresa

Se o time de CST Senhas Totvs fornecer a chave por meio de um arquivo, este deverá ser importado pelo botão Importar a licença utilizando arquivo. Se o pós-venda fornecer a chave por meio de um texto, este deverá ser informado (colado) no campo editável Chave de Ativação, conforme figura abaixo.

Imagem 3 - Licença

Após informar a chave de ativação, atualize o cadastro da empresa pela opção Atualizar . Neste momento, será apresentada a tela a seguir, que mostrará as empresas que serão atualizadas com a nova chave de ativação automaticamente. Assim, não é necessário repetir este procedimento para as demais empresas da chave.

Imagem 4 - Atualização da chave

Confira se todas as empresas referentes à chave de ativação estão na relação de empresas apresentada. Se tudo estiver correto, escolha a opção Confirmar, caso contrário, escolha a opção Cancelar, e entre em contato com o nosso pós-venda. Após a confirmação, o sistema perguntará se o log de quantidade de licenças utilizadas deve ser reiniciado.

Este log auxilia a visualizar a quantidade de licenças contratadas que estão sendo efetivamente utilizadas, tornando transparente o controle e facilitando a negociação junto time de CST Senhas Totvs. A característica deste log é manter sempre o maior número (como uma espécie de marca d’água) já atingido de licenças simultaneamente em uso. O log pode ser reiniciado sempre que desejado, possibilitando assim obter um novo valor referente à realidade atual. O seu preenchimento será automático e o seu incremento ocorrerá conforme a utilização do sistema pelos usuários, sendo necessário aguardar um período que contemple o uso do ERP pelo maior número de usuários para que o valor chegue a um número definitivo.

A atualização deste campo é condicionada pela chave de ativação, por isso, o campo será simultaneamente atualizado para todas as empresas que possuem a mesma chave. O mesmo ocorrerá ao realizar o reinicio deste log. Este log não interfere em nenhuma verificação do controle de licenciamento, portanto, pode ser reiniciado a qualquer momento e quantas vezes for desejado.

Imagem 5 - Limpar chave

Não é permitida a criação de novas empresas sem a chave de ativação. Para empresas já cadastradas e que não possuem a chave de ativação informada, somente será permitido atualizar os dados de cadastro da empresa se a chave for informada, for válida e for correspondente ao CNPJ da empresa.

Quando o número de usuários licenciados for atingido, uma mensagem será exibida ao usuário e o acesso ao produto será bloqueado, independente do seu nível de acesso como usuário no ERP (ex: usuário, gerente, diretor, administrador). Esse usuário somente conseguirá o acesso caso outro usuário já logado encerre as suas conexões. Nesse cenário, é indicado que a empresa reavalie a sua necessidade de licenças para que o acesso dos usuários não fique prejudicado.

Imagem 6 - Máximo de usuários permitidos

A chave de ativação possui uma data de validade, e por isso, quando esta data de validade estiver próxima do seu vencimento (menos de 30 dias), o sistema começará alertar a cada acesso de usuário, solicitando que o responsável pela administração do sistema providencie a atualização da chave enviada previamente pelo time de CST Senhas Totvs, conforme mensagem abaixo.

Imagem 7 - Validade da Licença

É possível verificar em tempo real as licenças de uso que estão sendo consumidas pelos usuários, verificando o Nome de Usuário S.O, Nome Máquina/Terminal, Sessão Windows e Código de Usuário no ERP em que a licença está sendo utilizada. Essa opção pode ser consultada na aplicação Cadastro de Empresas do módulo Segurança, botão Visualizar licenças em uso.

Com essa opção, o cliente poderá verificar em tempo real como as licenças estão sendo utilizadas, e assim administrar de forma eficiente as suas licenças de uso. A quantidade Total de Licenças em uso está relacionada à quantidade de linhas que a consulta retorna, ou seja, cada linha refere-se a uma licença em uso, conforme imagem abaixo.


Imagem 8 - Licenças em uso

A coluna Sessão refere-se ao ambiente Windows no qual o ERP está sendo executado. Quando o ambiente for uma estação de trabalho comum (ex: desktop, notebook), a coluna exibirá o texto Local. Quando o ambiente for um servidor remoto (ex: MS Terminal Service, Citrix), a coluna exibirá o ID da sessão Windows no qual o usuário logou, conforme imagem abaixo.

Imagem 9 - ID

A coluna Módulos logados * exibe quantos módulos estão abertos para aquela licença (máquina/usuário/sessão), e, ao dar um duplo clique sobre esta coluna, é possível visualizar os detalhes de cada módulo logado.

Imagem 10 - Detalhes da Licença

03. TECNOLOGIAS HOMOLOGADAS

O uso do Tipo de Produto em diferentes tecnologias não homologadas, como em Sistema Operacional, Plataforma, Navegadores e outros dispositivos, pode comprometer a segurança dos sistemas e está sujeito a situações não previstas, sem cobertura de suporte.
Tipo de produtoERP
Sistema OperacionalWindows Desktop
PlataformaDesktop
NavegadorN/A (não se aplica)
Utilização/ExperiênciaAplicações Desktop em geral

04. DOCUMENTOS E ASSUNTOS RELACIONADOS


AçãoDescrição
Empresas - GLSGEMP001Realizar o cadastro, e o controle de licenciamento das empresas.
Permissão nas Aplicações - GLSGMPERM01Definir o acesso tanto aos grupos como diretamente aos usuários, nas aplicações que compõem o sistema.
Permissão nos Módulos - GLSGMPERM02Definir o acesso tanto aos grupos como diretamente aos usuários, nos módulos que compõem o sistema.

05. DOCUMENTOS DE VERSÕES E ATUALIZAÇÕES

Clique para expandir

Service packDocumentação


Service packDocumentação


Service packDocumentação



Atividades Relacionadas

Grupos de Empresas - GE00003