English
Español
Integração Gestão Empresarial | ERP com Gestão de Pátio para o Agronegócio
A solução integrada entre Gestão Empresarial | ERP e Gestão de Pátio | YMS permite realizar o planejamento, agendamento e execução de carregamentos e descarregamentos, até a liberação do veículo. A sincronização das soluções, gera agilidade em todo o processo de entrada e saída de veículos, potencializando mais a produtividade da empresa, ganhando visibilidade dos processos dentro do pátio. A troca de informações com o ERP é necessárias para validações físicas, fiscais e alimentação dos dados da operação nas estruturas nativas do ERP, como contratos, ordens de compras e pedidos de vendas, transferências, remessas, entre outras estruturas.
Com o parceiro de negócio, seja fornecedor, cliente ou transportadora, crie e organize agendamentos e acompanhe toda operação da agenda. A validação das informações da agenda e dos dados fiscais é realizado na recepção do veículo, por meio de totém de auto atendimento, inserindo o veículo na operação do pátio, capturando peso e imagens no decorrer do circuito até a saída do mesmo, aguardando processos de finalização do ERP e liberando o veículo do pátio.
Confira a arquitetura simplificada da integração.
Conheça também os pré-requisitos antes de seguir para os próximos passos.
Conheça os processos de negócio específicos:
Recursos que podem ser utilizados na integração:
No Gestão Empresarial | ERP
No sistema, as telas responsáveis por alimentar esses dados referentes à integração, que emitem notificações de andamento do processo, são:
- Controle de Entradas e Saídas (Expedição via Contrato com Classificação) (F435CCC)
Acessada no caminho: Suprimentos > Gestão de Recebimento > Entrada via Balança > Via Contrato com Classificação, essa tela tem por finalidade o recebimento de produtos a granel, permitindo o controle de pesagem via balança.
- Entrada via Balança (Expedição Manual) (F435CST)
Acessada no caminho: Suprimentos > Gestão de Recebimento > Entrada via Balança > Manual, essa tela é destinada à expedição manual do controle de entradas e saídas via rotinas de balança.
- Saída via Balança (Expedição via Nota Entrada) (F115COE)
Acessada no caminho: Mercado > Gestão de Faturamento e Outras Saídas > Saída via Balança > Expedição via Nota Entrada (Devolução), o objetivo desta tela é possibilitar uma saída por devolução de uma ou mais notas fiscais de entrada, com integração via balança (capturando peso de sacas, caminhão, vagões, entre outros).
- Classificação de Produtos (Recebimento) (F435CLA)
Acessada no caminho: Suprimentos > Gestão de Recebimento > Classificação de Produtos (Recebimento), essa tela permite que a classificação de produtos seja estendida para um momento diferente do realizado nas pesagens de recebimento pela tela Compras - Controle de Entradas e Saídas (Expedição via Contrato com Classificação) (F435CCC).
Tabelas e armazenamento de logs
Todos os logs dessa integração serão armazenados na tabela Logs de Integração de Controles de Entrada/Saída (E115LEI) e podem ser visualizados no Painel de Integrações (F115IPL) através do botão Detalhar Eventos.
- Acesse: Cadastros > Integrações > Plataforma > Painel de integrações em andamento (F115IPL) no ERP;
- Na tela, basta selecionar uma informação e em seguida clicar no botão Detalhar Eventos, na inferior da tela.
- Após será aberta a tela com detalhamento do log.
- A imagem abaixo apresenta um exemplo de erro que pode ocorrer na integração.
Nesse exemplo em específico, o erro trata-se da falta de parâmetro na Central de Configurações Senior, onde não era possível o ERP se comunicar com a plataforma. - Na tela de log são apresentadas as etapas que foram concluídas (Registro Iniciado e Peso de Entrada) e também é apontado aonde o processo travou, na classificação do produto com erro na comunicação.
- Já os logs registrados na plataforma, somente é possível visualizar direto na plataforma. Acesse: Gestão Logística > Otimização Logística > Gestão de Pátio > Integrações > Logs de integração - ERP, no ERP XT;
- Nessa tela é possível visualizar todos os logs entre o Gestão de Pátio | YMS e o Gestão Empresarial | ERP e ainda é possível realizar diversos filtros, como: Nome do EndPoint, Data de Entrada/Saída, Parâmetros de Entrada/Saída e Resposta com erro.
- É possível visualizar tanto o Payload enviado para o ERP quanto o Payload recebido de resposta do ERP.
- No payload de resposta a principal tag que sinaliza uma comunicação efetiva é a mensagemRetorno: Processo com sucesso, caso ocorra algum erro será exibida da seguinte forma:
No exemplo de erro acima, o identificador de regras não foi cadastrado e configurado no ERP, dessa forma, o depósito padrão não foi informado e ocasionou o erro.
A tabela Logs de Integração de Controles de Entrada/Saída (E115LEI) possui os seguintes campos:
| Campo | Descrição |
|---|---|
| IdeUni | Identificador único da tabela. |
| IdeExt | Identificador da origem do registro (esse campo é a referencia que o YMS manda ao ERP). |
| UsuGer | Usuário responsável pela geração do registro. |
| DatEve | Data que ocorreu o evento/registro. |
| HorEve | Hora que ocorreu o evento/registro. |
| UsuAca | Ação definida pelo usuário - (1-Aguardar; 2-Enviar; 3-Pular Etapa). |
| SitInt | Situação da ultima tentativa de integração - (1-Recebido; 2-Enviando; 3-Enviado com Sucesso; 4-Erro Plataforma; 5-Erro Comunicação; 6-Aguardando; 7-Pular Etapa; 8-Falha Motor de Integração; 99-Não Catalogado). |
| MsgInt | Mensagem da ultima tentativa de integração. |
| EtaErp |
Etapa atual do registro no ERP - (0-Inicio; 1-Pre-Agenda; 2-Pre-Cadastro; 3-Pesagem de Entrada; 4-Classificado; 5-Pesagem de Saída; 6-Aguardando Faturamento; 7-Faturado; 8-Cancelamento; 9-Envio Customizado; 10-Carregamento Finalizado; 11-Documento Fiscal Emitido; 12-Devolução Gerou Tasks; 13-Ação Manual F115IPL). |
Importante
No ERP é possível cadastrar um processo agendado e configurar para o sistema reprocessar os registros pendentes de integração. O processo agendado deve ser do tipo Rotina e a Rotina Sapiens cadastrada de ser a 135 - Enviar Registros para Integração com a Plataforma.
Esse processo agendado poderá receber três parâmetros:
- EMPRESA: Empresa para realização dos filtros (Campo obsoleto no momento);
- DIASMANTER: Quantidade de dias menos a data atual em que o ERP irá manter os registros integrados na tabela E115EXT, depois desse limite os registros serão excluídos e levados para uma nova tabela (backup) chamada E115EXB - Registros já integrados que estavam na tabela E115EXT são movidos para essa;
- TIPOREGISTRO: 0-Todos; 1-Só com o YMS; 2-Customizados.
Web Service
Em XPlatform > Gestão Logística > Otimização Logística > Gestão de Pátio > Integrações > Configuração de Processo ERP, é possível verificar todos os processos do ERP que o Gestão de Pátio | YMS faz uso, inclusive, a própria tela faz sugestão dos processos para facilitar.
| Web service | Porta | Processo |
|---|---|---|
| Com.senior.g5.co.int.agr.pesagem | AtualizarPlacaPesagem | |
| Com.senior.g5.co.int.agr.pesagem | Cancelar | Cancelamentos |
| Com.senior.g5.co.int.agr.pesagem | ExpedicaoManual | |
| Com.senior.g5.co.int.agr.pesagem | RegistrarDevolucao | Devolução |
| Com.senior.g5.co.int.agr.pesagem | RegistrarEntradaManual | Recebimento por ordem de compra |
| Com.senior.g5.co.int.agr.pesagem | RegistrarEntradaViaBalancaContrato | Recebimento por contrato |
| Com.senior.g5.co.int.agr.pesagem | RegistrarPesagemAvulsa | Processo Avulso |
| Com.senior.g5.co.int.agr.pesagem | RegistrarPeso | Expedição |
Importante
Vale ressaltar que todos os processos são customizados no Gestão de Pátio | YMS de acordo com a operação do cliente. Essa operação é configurada por planta e circuito, ou seja, o web service chamado irá depender do tipo de circuito configurado.
Identificadores de regras
Confira a lista de identificadores de regras que podem ser usados na integração:
English
Español
