Pré-requisitos de configuração do Gestão Safra

Para o correto funcionamento da solução, é necessário utilizar a versão 5.10.2.58 ou superior do Gestão Empresarial | ERP Senior. Esta versão conta com as rotinas de integração entre o Gestão Empresarial | ERP e o Gestão Safra, viabilizando a integração das informações entre os sistemas.

Para que a empresa integre os dados do Gestão Empresarial | ERP com o Gestão Safra, é necessário que seja criado um tenant dentro da Senior X. Esta é uma etapa fundamental para que a solução funcione, e pode ser feita através da Sara. Para isto, basta escolher a opção Tenant. Caso a empresa já possua um tenant criado, esta etapa pode ser ignorada.

Para maiores informações sobre a criação de tenants pela Sara, consulte a documentação.

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

1. Realize login na Senior X, com a conta de administrador e, no menu, acesse: Tecnologia > Administração > Gerenciamento de Aplicações;
2. 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 autenticação na plataforma. Para isso, basta clicar em Nova aplicação;
   Importante

   Caso a aplicação seniorxt-application já esteja cadastrada, não é necessário criar uma nova aplicação.

3. A tela para cadastro de aplicações conta com os campos obrigatórios: Nome, Descrição e Geração de tokens, conforme imagem abaixo:
   
   

4. 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;
5. Após selecionar e clicar em Salvar, os campos Chave de acesso e Secret são apresentados;
6. Os novos campos apresentados possuem valores que devem ser preenchidos na Central de Configurações Senior, nas opções Chave de acesso a plataforma e Chave secreta de acesso;

No Gestão Empresarial | ERP Senior:

1. Na Central de Configurações Senior, acesse Plataforma XT > Configuração de integração;
2. Defina se o ambiente a ser integrado, é de Homologação ou Produção, no campo Ambiente;
3. Informe em Nome do tenant, o nome do tenant obtido na plataforma;
4. Em Chave de acesso à plataforma, insira a chave de acesso gerada para a aplicação na Senior X, obtida em Tecnologia > Administração > Gerenciamento das aplicações;
5. Em Chave secreta de acesso, informe a senha gerada para a aplicação na plataforma;

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 plataforma:

Ambiente de Produção

• Nome: com.senior.sapiens.internal.posicaosafra.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.posicaosafra.urlplataforma
• Valor: https://platform.senior.com.br:8243/t/senior.com.br/bridge/1.0/rest/

 

Ambiente Cloud Leaf

• Nome: com.senior.sapiens.internal.posicaosafra.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.posicaosafra.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.posicaosafra.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.posicaosafra.urlplataforma
• Valor: https://platform-homologx.senior.com.br:8243/t/senior.com.br/bridge/1.0/rest/

Após cadastrar a aplicação e informar os dados de acesso na Central de Configurações Senior, é necessário configurar um chave de acesso e um token para que a plataforma consiga identificar o origem/destino das mensagem enviadas, bem como habilitar a aplicação cadastrada. Para isso:

1. Acesse Tecnologia > Administração > Autorização > Gestão de papéis;
2. Nessa tela, no quadro Papéis, localize o registro de administrador do sistema, geralmente denominado como admin e clique em Editar. Caso necessário, é possível criar um novo papel através do botão Novo papel;
3. Na tela Dados do Papel, aberta pelo botão Editar, selecione a guia Usuários da sessão Configurações. Nessa guia é possível pesquisar pelo usuário cadastrado como responsável pela integração. Localize o registro do responsável e faça a associação desse usuário com o papel em edição, marcando a opção Associado;
   Nota

   Usualmente o usuário responsável pela integração é criado com a denominação de integrador, contudo, pode conter outra nomenclatura conforme implantação do sistema.

4. Após, é necessário ativar os serviços/recursos que estarão disponíveis para acesso à este papel. Para isso selecione a guia Permissões e encontre Domínio/Serviço chamado agro/posicaosafra;
5. Clique no botão (ícone de seta), localizado na lateral esquerda do registro, para visualizar os recursos e as ações contidas nele. Neste momento, será necessário encontrar os serviços utilizados pela integração do Gestão Empresarial | ERP e efetuar as devidas configurações, conforme lista abaixo:
   • res://senior.com.br/agro/posicaosafra/queries/getProcessedRecords - ativar a ação de Visualizar;
   • res://senior.com.br/agro/posicaosafra/actions/createMeasurementUnits - ativar a ação de Incluir e/ou Editar;
   • res://senior.com.br/agro/posicaosafra/actions/createOriginFeedStocks - ativar a ação de Incluir e/ou Editar;
   • res://senior.com.br/agro/posicaosafra/actions/createOriginHarvests - ativar a ação de Incluir e/ou Editar;
   • res://senior.com.br/agro/posicaosafra/actions/createChartOfAccount - ativar a ação de Incluir e/ou Editar;
   • res://senior.com.br/agro/posicaosafra/actions/createOriginCultures - ativar a ação de Incluir e/ou Editar;
   • res://senior.com.br/agro/posicaosafra/actions/createDistributionMatrices - ativar a ação de Incluir e/ou Editar;
   • res://senior.com.br/agro/posicaosafra/actions/createAccountingLots - ativar a ação de Incluir e/ou Editar;
   • res://senior.com.br/agro/posicaosafra/actions/createDepositMovements - ativar a ação de Incluir e/ou Editar;
   • res://senior.com.br/agro/posicaosafra/actions/createProjects - ativar a ação de Incluir e/ou Editar;
   • res://senior.com.br/agro/posicaosafra/actions/createPhases - ativar a ação de Incluir e/ou Editar;
   • res://senior.com.br/agro/posicaosafra/actions/createInvoice - ativar a ação de Incluir e/ou Editar;
   • res://senior.com.br/agro/posicaosafra/actions/createTaxInvoice - ativar a ação de Incluir e/ou Editar;
   • res://senior.com.br/agro/posicaosafra/actions/createFeedStockAssessments - ativar a ação de Incluir e/ou Editar;
   • res://senior.com.br/agro/posicaosafra/actions/createOriginClassification - ativar a ação de Incluir e/ou Editar;
   • res://senior.com.br/agro/posicaosafra/actions/createOriginGrainClassification - ativar a ação de Incluir e/ou Editar;
   • res://senior.com.br/agro/posicaosafra/actions/createOrigins - ativar a ação de Incluir e/ou Editar.

6. Por fim, é necessário ativar a aplicação previamente cadastrada na tela Gerenciamento de Aplicações, dentro do papel de administrador. Para isso, acesse a guia Aplicações e associe a aplicação na conta de administrador, conforme imagem abaixo:
   
7. Ao final, clique em Salvar.