Gestão Agro — Manual do Usuário > App AgroVerus > Configurações do aplicativo AgroVerus

Configurações do aplicativo AgroVerus

O aplicativo AgroVerus possui integração com o Gestão Empresarial | ERP da Senior e também com os demais ERPs, pois permite a configuração para o envio de informação entre os sistemas.

Configuração Inicial

Integração ERP

Fluxo completo do aplicativo AgroVerus

Configuração inicial

Para a utilização do aplicativo AgroVerus, é necessário que sejam feitas as seguintes configurações:

Integração com o ERP

Para a integração com o Gestão Empresarial | ERP da Senior, é necessário seguir as etapas:

Envio ERP ao AgroVerus

Atualize o Gestão Empresarial | ERP da Senior para a versão 5.10.3 ou superior;
Crie um tenant para a Empresa Agro, caso ainda não tenha um tenant criado;
Configure a integração via API REST:
- No Gestão Empresarial | ERP da Senior:
  1. Na Central de Configurações Senior, parametrize o tenant, Access key e Secret key;
  2. Na tela Sistemas Integrados (F000SIS), cadastre o Tipo de Sistema como 11 – Agronegócio Senior. O campo Sigla é obrigatório, podendo ser informada qualquer sigla de sua preferência;
  3. Na tela Configuração de Tipos de Informação (F000SXT), habilite para todas as Filiais os tipos de informações para a integração:
    - Tipo de Informações a ser habilitada: é necessário que o código 236 seja parametrizado em relação ao cadastro do Romaneio de Cargas
  4. Cadastre os processos agendados 151 - Integração ERP x Agronegócio Senior - Envio e 152 - Integração ERP x Agronegócio Senior - Confirmação na tela Cadastro de Processo Automático (F000AGE);
    - Para esta parte da configuração, recomendamos uma periodicidade de 15 a 30 minutos para a execução do processo. Já para a carga inicial, recomendamos que o tempo mínimo não seja menor que 15 minutos, devido ao grande volume de dados.

Envio AgroVerus ao ERP

Quando finalizada uma classificação com o aplicativo AgroVerus, é feito então o envio de informações ao Gestão Empresarial | ERP através do Erp_service.

Confira os componentes e pré-requisitos desta configuração através da seguinte documentação:

Erp_service

Importante

Para esta etapa, destacamos que deve ser reaplicado o Shovel, conforme descrito na documentação do Erp_Service, localizado no botão acima.

Passo a passo da integração

Criação do tenant

Para que a Empresa integre seu dados no Gestão Empresarial | ERP com o App AgroVerus, é necessário que um tenant seja criado dentro da Senior X. Essa é uma etapa fundamental para que o aplicativo funcione.

A criação do tenant pode ser feita através da Sara. Para isso, basta escolher a opção Tenant. Caso a Empresa já possua um tenant criado na Senior X, essa etapa pode ser pulada.

Atenção

Sempre que um tenant for criado, é preciso configurar um agendamento para ele. Esse agendamento é necessário, pois há uma rotina no sistema que deve ser executada diariamente em todos os tenants. A rotina, por sua vez, é disparada ao chamar o método dailyScheduledJob.

Para criar o agendamento, siga os seguintes passos:

Acesse a Senior X e, então, o menu Tecnologia > Customização > Agendamentos;
Na tela Domínios e Serviços, clique na guia Agro e, então, em Agrox;
Clique em Criar agendamento;
Para criar um agendamento, preencha o campo Nome do agendamento (pode ser qualquer nome de sua preferência, ou um nome que melhor identifique o agendamento que está sendo criado);
No campo Situação, selecione a opção Ativo;
Selecione a opção dailyScheduledJob no campo Funcionalidade;
No campo Parâmetro de entrada, selecione a opção JSON;
Já no campo Entrada, digite os seguintes comandos:
```
{
  "deleteLogs":"TRUE",
  "createDefaultTemplateTypes":"TRUE",
  "createDefaultCategoryMessage":"TRUE"
}
```
Onde:
- O comando "deleteLogs":"TRUE" refere-se à exclusão dos logs;
- O comando "createDefaultTemplateTypes":"TRUE" refere-se à criação de templates que são padrão do sistema;
- O comando "createDefaultCategoryMessage":"TRUE" refere-se à criação de categorias que são padrão do sistema.
Escolha a data e horário que o agendamento será executado. Para que o agendamento se repita, basta clicar na opção Repetir e preencher as configurações de repetição, conforme desejado;
Clique em Salvar.

Configuração da integração via API Rest

Para que os dados exibidos sejam importados para o aplicativo, existe uma API que pode ser consumida para o envio desses dados. Para integrar os dados do Gestão Empresarial | ERP da Senior ao aplicativo, é necessário realizar as configurações abaixo.

Na Senior X:

Realize login na Senior X com a conta de Administrador e, no menu, acesse: Tecnologia > Administração > Gerenciamento de Aplicações;
Na tela que será aberta, serão exibidas as aplicações já cadastradas na Plataforma. É necessário cadastrar uma nova aplicação para que o Gestão Empresarial | ERP faça a autenticação na Senior X. Para isso, basta clicar em Nova aplicação;
A tela para cadastro de aplicações conta com os seguintes campos obrigatórios:
- Nome;
- Descrição;
- Geração de tokens (deve-se gerar um token diferente para cada tipo de operação).
O cadastro de uma aplicação, por sua vez, é indispensável para a utilização do aplicativo. Pode-se utilizar qualquer aplicação ou cadastrar o padrão do ERP XT.
No campo Geração de tokens, é necessário que a opção Gerar um novo token diferente para cada sessão da aplicação seja selecionada;
Após selecionar e clicar em Salvar, os campos Chave de acesso e Secret são apresentados;
Os novos campos apresentados possuem valores que devem ser preenchidos respectivamente na Central de Configurações Senior, nas opções Access key e Secret key;
O tenant da Empresa Agro pode ser obtido na Senior X, no menu Tecnologia > Administração > Gestão dos tenants > Configurar;
Após cadastrar a aplicação e informar os dados de acesso na Central de Configurações Senior, é necessário habilitar a aplicação. Para isso, acesse o menu Tecnologia > Administração > Autorização > Gestão de papéis;
Por padrão, o papel de Administrador já estará atribuído a sua conta de Administrador. Porém, ainda é necessário ativar a aplicação previamente cadastrada dentro do papel de Administrador. Para isso, acesse a tela Gestão do papel no menu Senior X > Tecnologia > Administração > Autorização > Gestão dos papéis;
Em seguida, basta associar a aplicação na conta de Administrador.

Realizadas essas configurações, será possível ativar a integração das informações utilizando a API de integração.

No Gestão Empresarial | ERP da Senior:

Acesse a Central de Configurações da Senior;
Em Sistemas > Gestão Empresarial | ERP > Configuração ERP XT, preencha os campos:
- Nome do tenant da Plataforma: obtido na Senior X;
- Access key da Plataforma: obtido na Senior X;
- Secret key da Plataforma: obtido na Senior X;
- URL da Plataforma.

As informações listadas acima podem ser encontradas acessando a conta de Administrador da Senior X, disponibilizada para a Empresa Agro.

PORTAL DE DOCUMENTAÇÃO
Gestão Agro