Integração e Configurações Iniciais
O Hub de Royalties é nativamente integrado ao Gestão Empresarial | ERP da Senior, além de ser possível a integração com os demais ERPs do mercado através de APIs.
Pré-requisitos
Para a utilização do Hub de Royalties é necessário os seguintes pré-requisitos:
- Possuir um tenant ativo;
- Ter a autorização e possuir as chaves de acesso aos ambientes de homologação e produção, disponibilizadas pela empresa Bayer (Client ID e Client Secret);
- Estar na versão 5.10.3.116 ou superior (para clientes do Gestão Empresarial | ERP). Recomenda-se a utilização da última versão.
Integração com o Gestão Empresarial | ERP
Para a configuração de integração com o Gestão Empresarial | ERP, alguns passos precisam ser feitos, como:
- Crie um tenant na Senior X;
- Crie um Papel e Usuário, também na Senior X ao acessar Tecnologia > Administração > Autorização > Gestão de Papéis. Confira os detalhes desta etapa em nossa documentação sobre Gestão de Papéis;
- Configure a integração com a Bayer;
- Faça a criação do Acess key e Secret Key;
- Na tela Sistemas Integrados (F000SIS) do Gestão Empresarial | ERP, cadastre o Tipo de Sistema como 11 – Agronegócio Senior. O campo Sigla é obrigatório, podendo ser informada qualquer sigla de sua preferência;
- Na tela Configuração de Tipos de Informação (F000SXT), habilite para todas as Filiais os tipos de informações para a integração:
- Já em Cadastro de Processo Automático (F000AGE), cadastre os processos agendados :
- Faça a parametrização dos cadastros de empresa, filial, produto e variedade;
- Realize a configuração do Erp_service para que seja realizado o retorno das informações para o ERP.
Para demais detalhes em relação a integração com o Gestão Empresarial | ERP, acesse o botão abaixo e configura nossa documentação:
Observação
Caso o usuário utilize o processo de originação pelo Gestão Empresarial | ERP, indicamos o acompanhamento deste processo através da nossa documentação de Recebimento de Produtos.
Passo a passo da integração
Criação do tenant
Para que a Empresa integre seu dados no Gestão Empresarial | ERP com o Hub de Royalties é necessário que um tenant seja criado dentro da Senior X. Essa é uma etapa fundamental para que o sistema 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
Para que os dados exibidos sejam importados para Gestão Agro, existe uma API que pode ser consumida para o envio desses dados. Para integrar os dados do Gestão Empresarial | ERP da Senior ao sistema, é 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 sistema. 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.
Para profissionais Senior e consultores credenciados
Dentro de ambientes conectados na rede da Senior, é necessário na tela Chaves, da Central de Configurações Senior, incluir duas chaves para permitir a integração com a Senior X:
Ambiente de Produção
- Nome: com.senior.sapiens.internal.agroinfo.autenticacao.urlapi
- Valor: https://platform.senior.com.br:8243/t/senior.com.br/bridge/1.0/anonymous/rest/platform/authentication/actions/loginWithKey
- Nome: com.senior.sapiens.internal.agroinfo.urlplataforma
- Valor: https://platform.senior.com.br:8243/t/senior.com.br/bridge/1.0/rest/
Ambiente Cloud Leaf
- Nome: com.senior.sapiens.internal.agroinfo.autenticacao.urlapi
- Valor: https://cloud-leaf.interno.senior.com.br:8243/t/senior.com.br/bridge/1.0/anonymous/rest/platform/authentication/actions/loginWithKey
- Nome: com.senior.sapiens.internal.agroinfo.urlplataforma
- Valor: https://cloud-leaf.interno.senior.com.br:8243/t/senior.com.br/bridge/1.0/rest/
Ambiente HomologX
- Nome: com.senior.sapiens.internal.agroinfo.autenticacao.urlapi
- Valor: https://platform-homologx.senior.com.br:8243/t/senior.com.br/bridge/1.0/anonymous/rest/platform/authentication/actions/loginWithKey
- Nome: com.senior.sapiens.internal.agroinfo.urlplataforma
- Valor: https://platform-homologx.senior.com.br:8243/t/senior.com.br/bridge/1.0/rest/
English
Español
