F115IPL - Painel de Integrações em Andamento

O Painel de Integrações do ERP (Gestão Empresarial | ERP), permite acompanhar as integrações realizadas e acionar as transações correspondentes no ERP para que as ações requeridas sejam executadas. Além das operações de movimentação de commodities, a solução também atende entradas de suprimentos e permite realizar o controle de entrada e saída de outros veículos, independentemente de controle de pesagem.

Além disso, é possivel monitorar as integrações e dar andamento nos processos. Na tela estão visíveis todas as integrações em andamento, sendo possível visualizar também as concluídas, desde que, não foram movidas para histórico ainda.

Fluxo do Processo

Exemplo de Fluxo - Recebimento.

Por se tratar de uma tela multi empresa e multi filial, pode-se avaliar a abrangência de filiais, ficando visível somente empresas/filiais nas quais o usuário possui permissão.

Filtros

Filial
Permite informar um código de filial específico para filtro.

Etapa
Permite informar uma das etapas nas quais os registros se encontram.

Encontrar Placa
Procura na lista de registros mostrados na tela uma placa conforme digitado no valor.

Mostrar registros não pertencentes a controles de chegada
Indica que devem ser listados registros de integração customizados.

Mostrar Registros Finalizados
Indica que os registros finalizados e que ainda não foram movidos para o backup do registro devem ser listados na tela.

Atualizar automaticamente a cada XX segundos
Indica que o ERP (Gestão Empresarial | ERP), passados tantos segundos atualiza automaticamente a interface, recarregando os dados do banco de dados.

Cancela/Consultar Cancela
Dispara o Identificador de regras GER-000INTPL03 para que seja lida a placa de algum dispositivo. A placa é retornada e uma busca é feita dentro da lista de placas. Estes campos só estarão visíveis caso o identificador GER - 000INTPL04 estiver ativo e possuir regra atrelada a ele.

Campos

Ações
Lista todas as operações cadastradas na tabela Painel de Integração - Comandos Personalizados (E115PIC).

Botões

Mostrar
Carrega os registros da base de dados conforme os filtros realizados.

Cancelar
Limpa a tela.

Excluir
Exclui o registro da fila de integração. Este registro é movido para a tabela de histórico e não aparece mais na tela.

Reenviar
Reenvia para a integração os registros selecionados, respeitando se o registro atual, pelas etapas, está com o ERP (Gestão Empresarial | ERP) ou Gestão de Pátio.

Classificar
Em operações que demandam de classificação abre a tela F435CLA para realizar a classificação. Em caso de registro já finalizado, uma mensagem será exibida identificando que não é possível carregar pois já foi finalizado.

Fechar pesagem
Conforme a Operação ERP (Gestão Empresarial | ERP) do registro, abre a interface correspondente para o processamento:

• Operação ERP (Gestão Empresarial | ERP) "Entrada Recebimentos”: (Orices 3,4,5,8) abre a tela F435CCC para processamento;
• Operação ERP (Gestão Empresarial | ERP) “Saída – Vendas”: (Orices (1,6) abre a tela F135GNA, caso tenha acesso;
• Operação ERP (Gestão Empresarial | ERP) “Saidas – Exp Diversas”: (Orices = 2) abre a tela F435CST;
• Operação ERP (Gestão Empresarial | ERP) “Devoluções”: (Orices = 7) abre a tela F115COE;
• Operação ERP (Gestão Empresarial | ERP) “Outros”: customizados.

Reenviar
Reenviar a integração para o sistema Gestão de Pátio. São reenviadas integrações no qual o responsável é o ERP (Gestão Empresarial | ERP). No momento do reenvio o registro é recarregado do banco de dados para verificar a atual situação, que pode estar desatualizada na tela e verificar o responsável atual.

Detalhes
Abre a tela de log (F115LOI) para verificar os detalhes referentes à integração do registro selecionado.

Enviar Comando
Esse botão tem a função de capturar a opção escolhida no campo Ações e comunicar com a plataforma por meio de um payload customizado na base do cliente (tabela E115PIC - Painel de Integração - Comandos Personalizados). Esse comando por default, aguarda o Identificador Único da Agenda e passa para a plataforma com os comandos personalizados cadastrados em PIdCmd.

Identificadores de regra

Os seguintes identificadores fazem parte do processo. Os identificadores 000INTPL01 e 000INTPL02 trabalham exclusivamente com a integração, enquanto os identificadores 000INTPL03 e 000INTPL04 podem ser utilizados para o tratamento das cancelas.

GER- 000INTPL01

Esse identificador permite que sejam feitas validações antes do envio de um registro para a integração na plataforma. Nele podem ser feitas validações, como por exemplo, verificar se o documento fiscal foi autorizado. A execução acontece no resultado de uma integração customizada para a plataforma, ou seja, quando o ERP (Gestão Empresarial | ERP) receber o Ok ou Erro de integração.

Nome	Tipo	Observações	Retorna Valor
NIdentificadorUnico	Número	Identificador Único gravado na E115EXT. Variável que representa a chave da tabela E115EXT.	N
AIdentificadorExterno	Alfa	Identificador externo do registro – Gravado pelo sistema externo. Variável que representa o identificador do registro no sistema externo. Para a integração com oGestão de Pátio é a chave do registro no Gestão de Pátio e é representada por um Guid (Formato 7d1a3b44-1ac9-4fff-a672-caba71a4783d).	N
AIdentificadorAuxiliar	Alfa	Identificador auxiliar do registro – gravado pelo sistema externo. Variável que pode ser utilizada para algum tratamento próprio. O ERP (Gestão Empresarial | ERP) não alimenta a mesma e a integração com o Gestão de Pátio também não.	N
NEtapaAtual	Número	Sequência de entrada da pesagem. Última etapa do registro no ERP (Gestão Empresarial | ERP).	N
NAcaoUsuario	Número	Ação de usuário a executar no término do identificador. A variável é inicializada com a ação de Integrar registro à plataforma, valor = 1. Ela pode ser manipulada para identificar que o registro seja enviado ou aguarde um próximo momento para envio. Valores possíveis de retorno (0= Nenhuma ação, 1 = Enviar, 2 = Aguardar). Em caso de retorno = 2 da regra, o registro não é enviado nesse momento para a plataforma, aguardando o próximo ciclo de integração (processo agendado).	S

GER- 000INTPL02

Permite que sejam feitas ações ao concluir o envio de uma integração para a plataforma. Esta regra se aplica somente à integrações customizadas que passam pelo motor de integração, sendo que as nativas as ações já são tomadas conforme o retorno. A execução acontece no resultado de uma integração customizada para a plataforma, ou seja, quando o ERP (Gestão Empresarial | ERP) receber o OK ou Erro de integração.

Nome	Tipo	Observações	Retorna Valor
NIdentificadorUnico	Número	Identificador Único gravado na E115EXT. Variável que representa a chave da tabela E115EXT.	N
AIdentificadorExterno	Alfa	Identificador externo do registro – Gravado pelo sistema externo. Variável que representa o identificador do registro no sistema externo. Para a integração com oGestão de Pátio é a chave do registro no Gestão de Pátio e é representada por um Guid (Formato 7d1a3b44-1ac9-4fff-a672-caba71a4783d).	N
AIdentificadorAuxiliar	Alfa	Identificador auxiliar do registro – gravado pelo sistema externo. Variável que pode ser utilizada para algum tratamento próprio. O ERP (Gestão Empresarial | ERP) não alimenta a mesma e a integração com o Gestão de Pátio também não.	N
NEtapaAtual	Número	Sequência de entrada da pesagem. Última etapa do registro no ERP (Gestão Empresarial | ERP).	N
NCodigoRetorno	Número	Código que retornou a tentativa de integração.	N
aMensagemRetorno	Alfa	Mensagem de retorno da integração. Poder manipular a mensagem de retorno para que, em caso de erro, apresente uma mensagem mais amigável ao usuário na tela F115IPL.	S
nSucesso	Número	Indicativo de sucesso na comunicação.	N
NAcaoExecutar	Número	Ação a ser marcada para executar pelo sistema.	S
NAcaoExecutar NResponsavel	Número	Responsável pelo registro.	S
NStatusIntegracao	Número	Status da Integração.	S

GER- 000INTPL03

Esse identificador permite que seja realizada uma chamada para a busca da placa que está na cancela. Ao clicar no botão Consultar Cancela o identificador entra em execução.

Nome	Tipo	Observações	Retorna Valor
nUsuarioLogado	Número	Código do Usuário que está executando o ERP (Gestão Empresarial | ERP).	N
aCancelaSelecionada	Alfa	Código da cancela selecionada.	N
aPlacaIdentificada	Alfa	Número da placa identificada e retornada.	S

GER- 000INTPL04

O objetivo desse identificador é gerar uma lista de cancelas para consulta de placa posteriormente.

Quando este identificador estiver ativo e com uma regra associada, a lista de cancelas e o botão Consultar Cancelas ficam visíveis. Através dessa regra são retornadas as cancelas disponíveis, por meio de uma lista.

Nome	Tipo	Observações	Retorna Valor
nEmpresa	Número	Código da Empresa.	N
nUsuario	Número	Código do Usuário que está executando o ERP (Gestão Empresarial | ERP).	N
AEstacao	Alfa	Nome da Máquina.	N
ACancelaAtual	Alfa	Código da Cancela pra identificar qual é a cancela para o usuário.	S
ListaCancela	Número	Lista para retornar as cancelas.	S

Variáveis da Lista de Cancelas:

Nome	Tipo	Observações	Retorna Valor
ACodigo	Alfa	Código – String única que represente código de cancela.	S
ACodigo	Alfa	Descrição – Descrição para identificar a cancela.	N

Observação

A cancela atual é armazenada por usuário/estação de trabalho. Quando da execução da regra, já tendo um código de cancela preenchido para o usuário, o mesmo é atribuído à variável ACancelaAtual. Caso o usuário mude sua cancela através de seleção em tela, o novo valor é armazenado e esse valor será sugerido novamente ao entrar na tela no mesmo computador.

Processos agendados

Sempre que uma etapa é concluída no ERP (Gestão Empresarial | ERP), o sistema notifica o Gestão de Pátio para que possa seguir com os processos. Caso haja algum problema de comunicação e o registro não possa ser enviado, o mesmo fica em uma fila e o processo agendado pode reenviá-lo.

Este processo também é o responsável por retirar da tabela de integração e mover para uma tabela de histórico registros cuja integração já foi finalizada.

Exemplo

Em um recebimento quando o processo todo já foi finalizado, a integração está concluída e o registro pode ser movido para uma tabela de histórico para deixar a tabela de integração com poucos registros a serem processados.

Tipo do processo: Rotina

Código da Rotina: 135

Parâmetros da rotina

Empresa
Opcional, indica qual a empresa deve ser processada (Empresa = 0 significa todas as empresas).

Tiporegistro
Indica o tipo da integração.

• Somente registros de integração nativa.
• Registros de integrações customizadas.

Diasmanter
A quantidade de dias que um registro deve ser mantido na tabela do processo de integração.
Este parâmetro é destinado à limpeza dos registros e seu valor default é 1, ou seja, mantem as integrações por 1 dia até a data de hoje.

Exemplo

Diasmanter=2: mantém o dia atual – 2 dias.
Supondo que hoje é dia 10/08, irá remover da tabela registros que foram processados até o final do dia 07/08.

O funcionamento desse parâmetro carrega todas as integrações cuja ação = que envia para a plataforma.
Após o término do envio de todas as integrações, é executado oprocesso para mover os registros finalizados, respeitando o parâmetro de dias, para a tabela de histórico. Os identificadores de regra de envio e de retorno são executados da mesma forma.