Comprovei

A integração envia para a Comprovei os dados de Rota de Entrega que são produzidos via addon indústria.

O Addon insere no tópico do Kafka dados de Rota de Entrega. E então, o Docker que executará a integração conectada a fila do KAFKA que lê a Rota de Entrega, busca na Service Layer (Calculation View) dados de configurações da Comprovei (usuário, senha e url) e então envia a Rota de Entrega para a API da Comprovei.

Addon AgrotisIndústria

O addon é responsável por enviar ao Kafka as adições de Rota de Entrega.


Configurando a Integração

Menu >> AgrotisOne >> Integrações >> Configuração Integrações

Aba: Broker
Preencher o campo "Broker URL"

Menu >> AgrotisOne >> Integrações >> Configuração Integrações >> Aba Comprovei

Preencher os dados de usuário, senha, url, urlcontigência e Integração ativa.

Enviando Rotas para Comprovei

As rotas podem ser enviadas de duas formas para comprovei:

1 - Automática: Nesse modo o próprio Addon envia automaticamente após identificar que todas as notas vinculadas aquela entrega estão faturadas. No momento em que é alterado o status da Entrega (Via tela de gestão de Entrega) para faturado a Rota é enviada para comprovei.

2 - Manual: Caso necessite reenviar a rota, ou deseje enviar mesmo que todas as notas não estejam faturadas, pode navegar até a Entrega que deseja enviar e clicar com o botão direito do mouse e ir na opção Reenviar Rota - Comprovei:

Acompanhando log de envio de Rota a Comprovei

Após enviado a Entrega para Comprovei para acompanhar se a foi integrado pode acessar o log, para isso é necessário estar com a Entrega aberta e clicar com o botão direito do mouse e ir na opção Log de integração - Comprovei:

Após isso, será exibido a tela de log:

Diagrama da Integração

Integrador

.NET 5

A aplicação será executada em background conectada nos tópicos do kafka:
SapRotaEntrega- "Rota de Entrega"

Docker

O Docker de integração de Rota executa como AppName: integracaocomprovei-green

Identificadores no AppName

  • green para produção

  • blue para homologação ou desenvolvimento

Branchs

Trabalhe na branch blue quando precisar subir algum teste ou validação no ambiente de Homologação. Só faça merge na branch master quando estiver tudo ok.
Importante: Alterações na branch Master implica em deploy automático em PRODUÇÃO.

Repo de configuração

Nesse repositório fica as configurações do appsettings.json para que o Docker utilize no build e suba corretamente.

https://bitbucket.org/agrotis/aws-k3deploycontroler-workers/src/master/config/integracaocomprovei/

Variáveis de ambiente

As variáveis são injetadas pelo kubernetes e a aplicação sobrescreverá as configurações do appsettings.json

  • CONFIG_DIR
    -- Se esta variável estiver definida, o appsettings.json buscará do diretório informado.

  • APP_NAME
    -- Nome da aplicação

  • LOG_LEVEL
    -- Level de log (Debug, Information, Error)

  • LOGSTASH_SERVER
    -- Endereço do LogStash

  • LOGSTASH_PORT
    -- Porta do LogStash

  • KAFKA_GROUP_NAME
    -- Nome do grupo que se conectará ao Kafka

  • SCHEMA_REGISTRY_SERVER_PORT
    -- Endereço e porta do Schema Registry.

As variáveis que não existirem ou não estiverem preenchidas passarão a utilizar os dados definidos no appsettings.json

AppSettings.json

  • Tenant
    -- Nome do Tenant

  • ServiceLayer
    -- Dados da ServiceLayer, para conexão.

  • 1 2 3 4 5 6 7 8 9 10 11 { "Tenants":[ { "Tenant":"SBOGGPPRD", "ServiceLayer":{ "Url":"https://slgoplan.agrotis.one", "User":"agrotis\\roi001", "Password":"XPTO" } ] }