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.
Observação
O filtro Filial respeita o campo Empresa Selecionada.
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.
Observação
Os dados da integração são omitidos após a conclusão do processo de integração e, posterior a alguns dias, são movidos da tabela Vendas/Compras - Controle de Entrada e Saída - Pesagem com origem de sistema externo (E115EXT) para a tabela Registros já integrados que estavam na tabela E115EXT são movidos para essa (E115EXB).
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
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.
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
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.
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
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.
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
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.