Histórico da Página

01. DADOS GERAIS:

...

02. PRÉ-REQUISITOS:

Link para download: https://suporte.totvs.com/portal/p/10098/download?e=

...

1107275

03. Objetivo         

          Sincronizar os pedidos de compra com o Agendador e seus respectivos cadastros com a API do Agendamento Web.

04. Parametrização

Localizar o arquivo appsettings.json na pasta e editá-lo conforme as seguintes definições:

• CaminhoRaiz                                       : Caminho onde será serão adicionados os arquivos do serviço, é fortemente recomendado . Deve-se criar uma pasta chamada RMSAgendadorWeb AgendamentoWeb no disco C e informar o seguinte caminho: "C:\\RMSAgendadorWebAgendamentoWeb".
• Url                                                        : Url da API do Agendador Agendamento WEB (com a porta). Exemplo: "localhost:8343".
• LoginAPI (Company)                          : Código da Empresa da API do Agendamento WEB.
• LoginAPI (Username)                         : Usuário de acesso da API do Agendamento WEB.
• LoginAPI (Password)                          : Senha de acesso da API do Agendamento WEB.
• LoginAPI (Criptografado (LoginAPI )                  : Utilizado para saber se os dados de acesso da API estão criptografados (deixar "NAO" como padrão). Ao executar o serviço pela primeira vez os dados serão criptografados e essa tag chave será alterada automaticamente para "SIM".
• EnviarTipoCarga                                 : Utilizado para saber se é para enviar o cadastro de Tipos de Carga. Esse cadastro será enviado apenas na primeira vez que o serviço executar (não precisa alterar). Deixar por padrão = "SIM".
• Logs (GeraLogs)                                  : SIM/NAO - Ativa/Desativa Logs.
• Logs (Pasta)                                         : Caminho absoluto da pasta que irá armazenar os logs, exemplo: "C:\AgendamentoWeb\Logs".
• Temporizador (Ativo)                         : SIM/NAO - Ativa/Desativa o tempo parametrizado para aguardar a cada reinicio reinício do processo. Mesmo desativado o tempo mínimo será 10 segundos.
• Temporizador (Tempo)                       : Tempo em segundos para aguardar o reinicio reinício do processo.
• ConnectionStrings (ConexaoOracle) : Limite de Consultas por GTIN. Caso um GTIN que alcance esta quantidade de consultas só voltará a ser consultado depois de 1h. String de conexão do Oracle. Deverá ser informado IP, porta, usuário e senha de conexão do banco RMS.
• ConnectionStrings (Criptografado)   : Utilizado para saber se os dados de acesso do Oracle estão criptografados (deixar "NAO" como padrão). Ao executar o serviço pela primeira vez os dados serão criptografados e essa tag chave será alterada automaticamente para "SIM"..

Lembrete: Na primeira execução os dados de conexão do Oracle e os dados de acesso da API serão criptografados e a chave Criptografado será atualizada automaticamente para SIM. Caso os dados precisem ser alterados, deve-se retornar a chave Criptografado para NAO manualmente.

Image AddedImage Removed

É necessário cadastrar

...

3 parâmetros no RMS:

Código 30 - SISTEMAAPI: Parâmetro utilizado para informar o nome do sistema que está enviando as informações para a API. O valor do parâmetro deverá ser o nome do sistema, por exemplo "RMS".

Código 30 - AGENDADORW: Parâmetro utilizado para ativar as triggers do Agendador. O parâmetro deve estar ativo para atualizar as informações nas tabelas e enviá-las para a API do Agendamento Web. S = Ativado / N = Desativado.

Código 30 - AGD + Código da Filial com dígito (completando com zeros à esquerda até somar 10 caracteres): Este parâmetro é utilizado para definir quais filiais enviarão as informações para o Agendamento Web. O parâmetro deve estar ativo para atualizar as informações nas tabelas e enviá-las para a API do Agendamento Web. S = Ativado / N = Desativado.

Deverá ser cadastrado um parâmetro para cada filial que fará a integração com o Agendamento Web.

Neste exemplo o parâmetro foi cadastrado para a filial 1-9:

• O campo Acesso deve conter o tamanho de 10 caracteres (completar com zeros à esquerda do código da filial): AGD0000019

Image Added

05. Instalação

         Este serviço deverá ser instalado em apenas uma máquina.

• Etapa 1 - Após configurar o arquivo appsettings.json conforme as definições da etapa anterior, copiar o conteúdo da pasta RMSAgendadorWeb para  AgendamentoWeb para C:\RMSAgendadorWebAgendamentoWeb.
• Etapa 2 - Acessar a pasta C:\RMSAgendadorWebAgendamentoWeb\Instalador e executar o arquivo Intalador Instalador.exe como administrador.
• Etapa 3 - Informar os dados em seus respectivos campos:

...

Arquivo AppSettings: Informar o caminho do arquivo appsettings.json (pasta anterior da pasta Instalador). Este arquivo será utilizado para obter os dados de conexão com o Oracle.

TableSpace para tabelas: Este campo apenas deve Deve ser informado apenas se o usuário quiser criar um TableSpace para as tabelas do Agendador Web. Se não quiser criar TableSpace poderá deixar vazio.

TableSpace para índices: Este campo apenas deve Deve ser informado apenas se o usuário quiser criar um TableSpace para os índices do Agendador Web. Se não quiser criar TableSpace poderá deixar vazio.

Image RemovedImage Added

Após informar todos os dados basta clicar em Instalar, então . Ao finalizar a instalação será exibida uma a mensagem informando que a instalação foi concúidaconcluída:

• Etapa 4 - Configurar dados do banco de dados no arquivo appsettings.json na chave ConexaoOracle. 

Image Removed

• Etapa 5 - Criar a pasta Logs, XmlEnvio e XmlRetorno e remover a flag de somente leitura. 

Obs.: Na primeira execução os dados de conexão serão criptografados e a chave Criptografado será atualizada automaticamente para SIM. Caso os dados de conexão precisem ser alterados, deve-se preencher a chave ConexaoOracle com o conteúdo da chave ConexaoExemploOracle e retornar a chave Criptografado para NAO manualmente.

04. Parametrização

• URL                                : Url de consumo do webservice para validação de GTIN.
• Logs (GeraLogs)           : SIM/NAO - Ativa/Desativa Logs.
• Logs (Pasta)                  : Caminho absoluto da pasta que irá armazenar os logs.
• XML (GeraXML)            : Caminho absoluto da pasta que irá armazenar os logs.

• XML (PastaEnvio)         : Caminho absoluto da pasta que irá armazenar os XMLs de Envio.
• XML (PastaRetorno)     : Caminho absoluto da pasta que irá armazenar os XMLs de Retorno.

• Temporizador (Ativo)   : SIM/NAO - Ativa/Desativa o tempo parametrizado para aguardar a cada reinicio do processo. Mesmo desativado o tempo mínimo será 10 segundos.
• Temporizador (Tempo): Tempo em segundos para aguardar o reinicio do processo.

• LimiteDeConsultas       : Limite de Consultas por GTIN. Caso um GTIN que alcance esta quantidade de consultas só voltará a ser consultado depois de 1h. 

Image Removed

05. Programa VABUGTIN:

O programa VABUGTIN deverá ser adicionado ao menu (de preferência no menu de Cadastros).

Image Removed

O programa possui uma opção para o usuário definir quantas linhas por página deseja carregar.

O número padrão de linhas por página é 1000, a tela sempre abrirá com a sugestão de 1000 linhas por página.

O mínimo de linhas por página é 100, se colocar um número inferior será alterado automaticamente para 100. 

Image Removed

F6-Filtrar: Abre a tela de filtros para consultar os GTINS conforme a seleção que o usuário desejar. Serão considerados apenas GTINS com tamanho entre 8 e 14 dígitos e que contemplem o prefixo 789 ou 790 conforme o item 04.7.1 do documento NT2022.001_v1.00 disponibilizado pelo SEFAZ.

• Fornecedor: Pode ser informado uma lista de Fornecedores.
• Seção: Pode ser informado uma lista de Seções.
• Grupo: Pode ser informado apenas um Grupo por vez.
• Subgrupo: Pode ser informado apenas um Subgrupo por vez.
• Produto: Pode ser informado uma lista de Produtos.
• Cadastrados a partir de: Filtrará Produtos cadastrados a partir da data informada.
• Posição: Posição do GTIN em relação à consulta:
  • Não validado
  • Aguardando validação
  • Validado
  • Rejeitado

Image Removed

Após aplicar o filtro, se a consulta encontrar registros serão carregados os GTINS na grid e o restante dos botões serão habilitados, se não encontrar registros exibirá a mensagem "Nenhum produto localizado!" e a tela de Filtro será aberta novamente.

Podemos ver que os registros são carregados em páginas, respeitando a quantidade de linhas por página informado.

Image Removed

O programa VABUGTIN possui checkbox na grid para o usuário selecionar os GTINS que deseja validar, é possível selecionar apenas um GTIN ou todos conforme a preferência do usuário:

Image Removed

F7-Validar: Os GTINS selecionados na grid serão validados junto ao SEFAZ. Após validar é necessário aguardar um certo tempo (depende da quantidade de GTINS selecionados) para realizar a consulta novamente e verificar o retorno do SEFAZ. Neste exemplo temos 2 GTINS que foram rejeitados e 4 GTINS que estão aguardando validação:

Image Removed

F8-Imprimir: Será impresso um relatório dos GTINS da página carregada na grid.

F9-Voltar Página: Voltar para a página anterior. É habilitado somente se existir mais que uma página e quando o usuário não estiver na primeira página.

Ct+F9-Primeira Página: Voltar para a primeira página. É habilitado somente se o botão "F9-Voltar Página" estiver habilitado.

F10-Avançar Página: Avança para a página seguinte. É habilitado somente se existir mais que uma página e quando o usuário não estiver na última página. 

Ct+F10-Última Página: Avança para a última página. É habilitado somente se o botão "F10-Avançar Página" estiver habilitado.

F11-Marcar Todos: Marca todos os GTINS de todas as páginas.

Image Added

06. Inserção dos registros nas tabelas

Acessar Menu - Inserir Registros:

Opção para inserir os registros nas tabelas do Agendamento Web. Utilizado apenas para envio da primeira carga de dados. Serão inseridos os cadastros iniciais de Box, Compradores, Fornecedores, Transportadores e Pedidos de compra, e assim que o serviço iniciar a execução, esses cadastros serão enviados para a API do Agendamento Web.

Image Added

Ao finalizar será exibido uma mensagem informando que a inserção foi concluída:

Image Added

07. Criação do serviço no windows

Acessar Menu - Criar Serviço:

Image Added

Após criar o serviço será exibida a mensagem: Serviço criado com sucesso!

Image Added

Após criar o serviço, acessar os serviços do windows (services.msc) e conferir se o serviço AgendamentoWeb foi criado e se está executando.

Dica: Para confirmar que o serviço está executando, pode-se ativar os logs no arquivo appsettings.json e verificar na pasta C:\AgendamentoWeb\Logs se está gerando log.

Existe também uma opção para remover o serviço em Menu - Remover Serviço.

Obs. Se ocorrer algum erro ao criar o serviço, pode ser executado manualmente o arquivo InstalarService.bat localizado na pasta C:\AgendamentoWeb\Instalador.

Para a exclusão do serviço, pode ser utilizado o arquivo DesinstalarService.bat.

Ct+F11-Desmarcar Todos: Desmarca todos os GTINS de todas as páginas.