Histórico da Página

Informações Gerais

Informações Gerais 

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

Objetivo

Desenvolver a estrutura para a integração de tabelas e negociações de fretes com o módulo MLA do ERP Datasul.

Definição da Regra de Negócio

O Módulo de MLA (Módulo Logístico de Aprovação) serve para controlar  permite controlar eletronicamente a aprovação de documentos conforme parametrização.

Por seu intermédio o Aprovador pode Através dele é permitido ao aprovador visualizar as principais informações do documento e aprová-lo através de por e-mail (Microsoft Outlook ou Lotus Notes) ou pelo Portal do MLA, sem necessariamente acessar o ERP. Ele permite

Este módulo também permite a aprovação de diversos tipos de documentos do Datasul - EMS, inclusive os que estiverem sendo controlados por rotinas específicas, ou seja, documentos específicos.

Através Por meio deste requisito, será possível utilizar o módulo para a aprovação de tabelas de fretes e negociações criadas no SIGAGFE. Para tanto, será criado um novo tipo de documento no MLA, denominado "Negociação de fretes", código 029.

A chave definida para o documento será (cadastrado no programa MLA0102 ):

Referência:

A referência poderá ser utilizada como diferencial de aprovação do documento e, para a negociação de frete, será utilizado o Tipo de lotação Transportador (GV9_TPLOTACDEMIT), permitindo assim um direcionamento da aprovação particular entre as tabelas de carga fracionada, carga fechada e veículo dedicadocada fornecedor de serviço de fretes.

 A integração da negociação será efetuada via Web Service Protheus, seguindo o modelo atual de integração entre ERP Totvs TOTVS 12/Datasul e SIGAGFE, para os processos de frete, passando pelas etapas de Solicitação dos registros pendentes - Recebimento e processamento > Execução Integração MLA (API) > Retorno das informações.

Nos programas de solicitação de registros para integração, CD0433, CDF433 e CDF433RP, será feita será realizada a chamada para a API que gera a pendência do documento no MLA , e aguarda a aprovação.

Utilizando o processo de aprovação do MLA, as aprovações podem ser realizadas de diversas formas:

• Pelo Progress (MLA0301)

• .

• Aprovação por e-mail

• .

• Pelo portal do

• MLA (HTML)

• .

• Pela utilização da tela HTML do MLA

• no Fluig

• .
  
  

CD0433.W,

 CDF433.P,

 CDF433RP.P:

 Neste Nestes programas , serão criadas as chamadas para a include CDF433.I11, que fará a interpretação da mensagem enviada pelo GFE e a chamada da include de integração com o MLA.

Segue o padrão de integração de outros processos do SIGAGFE com o ERP Totvs ERP TOTVS 12 / Datasul (Ex.: cdf433.i1).

Esta chamada será condicionada com ao condicionada ao campo de integração da negociação de fretes com o MLA, no cabeçalho do CD0433 ou nos parâmetros de entrada do CDF433 e CDF433RP.

A chamada do registro e a geração da pendência com sucesso, altera a situação do campo GV9_SITMLA para 7-Enviado/aguardando aprovação, para evitar que seja chamado novamente pelo Agent Listener.

Incluir na tela do programa CD0433 a opção para marcar assinalar a integração de negociações de frete com o MLA (conforme protótipo de tela apresentado na respectiva seção). 

cdp\cdf433.i11

Este programa será o responsável por receber a informação enviada do GFE e seu processamento para o envio correto das informações solicitadas pela API de integração MLAAPI010vMLAAPI001. 

Ele segue o padrão de estrutura de integrações do SIGAGFE com o ERP Totvs 12TOTOVS 12/Datasul (Ex.: cdf433.i1)

As informações enviadas pelo Web Service do SIGAGFE para o MLA terá a  estrutura de toda a tabela de frete e será necessária a quebra dos registro para a chamada do programa de integração: 

#GV9|GV9_FILIAL|GV9_CDEMIT|GV9_NRTAB|GV9_NRNEG|GV9_CDCLFR|GV9_CDTPOP|GV9_DTVALI|GV9_TPLOTA|GV9_DTCRIA|GV9_USUCRI|GV9_SITMLA|

#GV8|GV8_NRROTA|GV8_TPORIG|GV8_NRCIOR|GV8_DSTORI|GV8_DSTORF|GV8_NRREOR|GV8_CDPAOR|GV8_DSPAOR|GV8_CDUFOR|GV8_CDFIOR|GV8_TPDEST|GV8_NRCIDS|GV8_DSTDEI|GV8_DSTDEF|GV8_NRREDS|GV8_CDPADS|GV8_CDUFDS|GV8_CDFIDS|GV8_NMREM|GV8_CDDEST|

#GV7|GV7_CDFXTV|GV7_CDTPVC|GV7_DSTPVC|GV7_QTFXFI|GV7_UNICAL|GV7_VLALUG|GV7_FRQKM|GV7_VLKMEX|

#GV1|

GV1_

CDCOMP|

GV1_VLFIXN|GV1_PCNORM|GV1_VLUNIN|GV1_VLFRAC|GV1_VLMINN|GV1_VLLIM|GV1_VLFIXE|GV1_PCEXTR|GV1_VLUNIE|GV1_CALCEX

|

#GVQ|GVQ_CODCOT|GVQ_SEQCOT|GVQ_OBSCOT|GVQ_VALCOT|

O programa chama em seguida a API de criação de pendência de negociações de frete no MLA - mlaapi010vmlaapi001.p, passando os parâmetros:

run lap/mlaapi010v.p ( input 29 /* i-tipo*/ , 

                                     input i-transacao,  /*Inclusão, modificação, eliminação*/

                                     input tt-documento,

                                     output table tt-erro).

A variável i-transação leva em conta o valor do campo GV9_SITMLA enviado pelo GFE, se o GV9_SITMLA = “2” então enviar 1 /*Inclusão*/, se GV9_SITMLA = “5”, 3 /* Eliminação */.

A temp-table tt-documento será criada com os registros da tabela de frete retornados do Web Services Protheus para repassar ao MLA.

Como o processo de aprovação no MLA não prevê documentos de outros sistemas, fora das tabelas do Totvs 12 / Datasul, será necessário gravar um registro na tab-generica com os dados que serão utilizados para apresentação no e-mail de aprovação, programa de consulta e no detalhamento do documento no portal MLA.

A criação do registro na tab-generica terá a utilização = "GFE_MLA_TF", gravando a chave do registro no campo char-1 e os demais da estrutura no char-2.

O retorno da temp-table tt-erro deve ser direcionado para o GFE para ser gravado no campo "GV9_MOTMLA".

lap\mlaapi010v:

É o programa responsável pela criação da pendência de aprovação no MLA através da API MLAAPI001.

A API irá receber os parâmetros enviados pelo programa cdp\cdf433.i11 e fará a geração ou eliminação da pendência de aprovação. Deve seguir o padrão de estruturação dos programas de geração de pendencias de outros documentos no MLA, (Ex.: ap\mlaapi010u.p).

A sintaxe para a chamada da API (baseada no  documento MLAAPI001 - API - Geração de pendência de aprovação (MLA) ): 

parâmetros abaixo informados na tabela de parâmetros do programa MLAAPI001.

 Como o processo de aprovação no MLA não prevê documentos de outros sistemas, fora das tabelas do TOTVS 12 / Datasul, será necessário gravar um registro na tab-generica com os dados que serão utilizados para apresentação no e-mail de aprovação, programa de consulta e no detalhamento do documento no portal MLA.

 A criação do registro na tab-generica terá a utilização = "GFE_MLA_GV9", gravando a chave do registro no campo char-1 e os demais da estrutura no char-2.

 Cada registro de tabela vindo do GFE (#GV9, #GV8 etc.) será gravada em uma tab-generica diferente, sempre diferenciando pelo campo utilização, que terá a nomenclatura da tabela ao final do código "GFE_MLA_XXX" (Ex.: GFE_MLA_GV9, GFE_MLA_GV8).

O retorno da temp-table tt-erro deve ser direcionado para o GFE para ser gravado no campo GV9_MOTMLA.

A sintaxe para a chamada da API (baseada no  documento MLAAPI001 - API - Geração de pendência de aprovação (MLA) ): 

Tabela de Parâmetros - MLAAPI001

Após a criação da pendência de aprovação no MLA, enviar mensagem ao GFE para alterar a situação do campo GV9_SITMLA para 7-Enviado/aguardando aprovação, pela função setdataws.

Esta alteração é necessária para que o registro não seja chamado novamente pelo Web Service enquanto não for aprovado ou rejeitado no MLA.

laphtml\ mlahtml029e.p :

Quando forem geradas as pendências de aprovação, o usuário receberá em seu e-mail o HTML com as informações do documento em questão e opções para aprovação (Para para este processo é necessário configurar o usuário para o recebimento do e-mail).

O programa MLAHTML029e terá a função de criação e envio do e-mail aos usuários cadastrados como aprovadores da pendência de negociação de fretes. O programa deve , sendo que este deve possuir os seguintes parâmetros: 

Código do tipo do documento (INTEGER - INPUT)
Código do aprovador (CHARACTER - INPUT)
Chaves do documento - tt-mla-chave (TEMP-TABLE - definição na include: lap/mlaapi001.i99 - INPUT)
HTML do e-mail - tt-html (TEMP-TABLE - definição na include: laphtml/mlahtml.i - OUTPUT)

 Dentro deste programa é que será estruturado o e-mail de aprovação, no formato '.html' , com as informações da tabela de fretes.

 Apresentar as informações disponíveis no registro datab-genérica.utilização = "GFE_MLA_TF" que for criado GV9", e relacionadas, que forem criadas no programa cdf433.i11 com os dados enviados pelo SIGAGFE.

cdp\

cd0089.

w:

Programa para tratamento e envio do retorno da aprovação ou rejeição efetuado pelo usuário no MLA. 

Este programa será executado quando o usuário aprovador realizar a intervenção na pendência de negociação de fretes no MLA e deve ser cadastrado no programa MLA0101 (FAQ 58026 - Quais informações devem ser preenchidas no programa MLA0101?).

Criar o parâmetro de integração do processo de aprovação de negociações de fretes, conforme protótipo apresentado na seção Protótipo de tela.

Este parâmetro será gravado na tab-generica.utilização = Setup, posição 704 do campo char-2.

Terá a função de habilitar ou desabilitar a opção de integração das negociações de frete com o MLA no CD0433/ CDF433 e CD0433rp.

lapepc\mla029e.p :

Programa para tratamento e envio do retorno da aprovação ou rejeição efetuado pelo usuário no MLA. 

Este programa será executado quando o usuário aprovador realizar a intervenção na pendência de negociação de fretes no MLA e deve ser cadastrado no programa MLA0101 (FAQ 58026 - Quais informações devem ser preenchidas no programa MLA0101?).

A ação do usuário A ação do usuário sobre a pendência deve ativar a chamada para a função do Web Service Protheus setdataws, passando a atualização do registro no GFE. Segue a estrutura utilizadas nas integrações de processos do SIGAGFE no Datasul, como a integração de doc. frete com fiscal, etc.

ExExemplo.: RUN setdataws IN  hcdf600(INPUT lcTabela, INPUT lcIntegracao, INPUT cRetornoToSetData, INPUT cSetData).

MLA0122 - Inclusão Facilitada:

Será alterado o programa MLA0122, Programa de inclusão facilitada da pendencia de aprovação, para que o documento 029-Negociação de fretes e sua chave  possam ser gerados de forma automatizada pelo usuário.

A exemplo dos demais tipos de documentos do MLA, criar o bloco de tratamento para o documento tipo 29.

laphtml/mlahtml029p.p

Programa progress Progress que irá retornar retornará os dados para a interface HTML (tanto para a listagem de documentos, quando para o detalhamento).

Para a construção desse programa utilizar os programas laphtml/mlahtml000p.p e laphtml/mlahtml000p.i como exemplo (que estão expedidos com fonte aberto). Eles contêm orientações e exemplos para construção deste programa.

Criar os HTMLs que funcionem de forma responsiva, para que possam ser executados em dispositivos móveis também.

A estrutura do programa deve seguir o padrão orientado pela equipe de desenvolvimento do módulo MLA, documetado em: DMLA0003_DMLA0026 - Como _ criar _ documentos _ para _ o _ novo _ portal _ do _ MLA _ ou _ customizar _ existentes _( a _ partir _da versão 12.1.8).

Obs.: Atualizar a documentação no TDN: 

 FAQ 58026 - Quais informações devem ser preenchidas no programa MLA0101?

FAQ 58025 - Quais informações devem ser preenchidas no programa MLA0102?

DMLA0004_Quais_são_as_informações_consideradas_como_referência_para_os_documentos_do_MLA?

Tabelas Utilizadas

• tab-generica - Tabela genérica.

Opcional

Protótipo de Tela 

Image Removed 

CD0433 - Monitor de integração TOTVS 12 X SIGAGFE.

Fluxo do Processo

Não se aplica. 

Dicionário de Dados

Não se aplica.

Grupo de Perguntas

Não se aplica.

Consulta Padrão

Não se aplica.

Estrutura de apresentação do documento de negociação de fretes no Portal e E-mail:

• Dados principais (lista de pendências):
  • Empresa
  • Filial
  • Solicitante
  • Data da solicitação
  • Transportador 
  • Número da tabela 
  • Nr. da Negociação
  • Classificação Frete
  • Tipo Operação
  • Vigência De:_____ até_______
  • Tipo Lotação 
• Cotação
  • Código
  • Sequência
  • Valor do comparativo de fretes
  • Observação
• Detalhamento (em sequência, conforme quantidade de registros):
  • Tarifa
    • Sequência
    • Rota
    • Componente
    •  Valor tarifa. (Todos os campos da GV1)
  • Rota
    • Nr. Rota 
    • Tipo Origem
    • Cidade Origem
    • Distância Origem
    • Região Origem
    • País/UF Origem
    • Nome Remetente
    • Tipo Destino
    • Cidade Destino
    • Distância Destino
    • Região Destino
    • País/UF Destino
    • Nome Destinatário
  • Faixa
    • Cod. Faixa
    • Cod. tp. veículo
    • Descr. tipo de veículo
    • Quantidade Final
    • Unidade de Medida
    • Valor Locação
    • Franquia Km
    • Valor Km Excedido

CDF006:

Consulta de Tabela de Frete para aprovações no ERP.

Será criado o programa de consulta cdp\cdf006.w que apresentará os dados detalhados da tabela e negociação de frete que está em análise de aprovação.

Este programa poderá ser acessado pelos programas CD0433 - Monitor Integração, MLA0301 - Aprovação de Pendências , MLA0201 - Consulta de Pendências ou por acesso direto pela chamada (nome do programa).

Este deverá ser cadastrado no MLA0121.

As informações apresentadas na tela serão as mesmas visualizadas no recebimento do e-mail ou no Portal.

Verifique sugestão de tela na seção Protótipo de Tela.

• Dados principais:

• • Filial
  • Solicitante
  • Transportador 
  • Número da Tabela
  • Número Negociação
  • Vigência
• Aba Dados Gerais:
  •  Data da solicitação
  • Código
  • Sequência
  • Valor do comparativo de fretes
  • Observação
  • Classificação de Frete
  • Tipo Operação
• Aba Tarifa
  •  Componente
  •   Valor tarifa. (Todos os campos da GV1)
• Aba Rota
  • Nr. Rota
  • Tipo Origem
  • Cidade Origem
  • Distância Origem
  • Região Origem
  • País/UF Origem
  • Nome Remetente
  • Tipo Destino
  • Cidade Destino
  • Distância Destino
  • Região Destino
  • País/UF Destino
  • Nome Destinatário
• Aba Faixa
  • Cod. Faixa
  •  Cod. tp. veículo
  •  Descr. tipo de veículo
  •  Quantidade Final
  •  Unidade de Medida
  •  Valor Locação
  •  Franquia Km
  •  Valor Km Excedido

Observação:

Atualizar a seguinte documentação no TDN:

Informações Gerais

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

Objetivo

Desenvolver estrutura para a integração de tabelas e negociações de fretes com o módulo MLA do ERP Datasul.

Definição da Regra de Negócio

O Módulo de MLA (Módulo Logístico de Aprovação) serve para controlar eletronicamente a aprovação de documentos conforme parametrização. Através dele é permitido ao aprovador visualizar as principais informações do documento e aprová-lo através de e-mail (Microsoft Outlook ou Lotus Notes) ou pelo Portal do MLA, sem necessariamente acessar o ERP. Ele permite a aprovação de diversos tipos de documentos do Datasul-EMS, inclusive os que estiverem sendo controlados por rotinas específicas, ou seja, documentos específicos.

Através deste requisito, será possível utilizar o módulo para a aprovação de tabelas de fretes e negociações criadas no SIGAGFE. Para tanto, será criado um novo tipo de documento no MLA denominado "Negociação de fretes", código 029.

A chave definida para o documento será:

Referência:

A referência poderá ser utilizada como diferencial de aprovação do documento e, para a negociação de frete, será utilizado o Tipo de lotação (GV9_TPLOTA) 

A integração da negociação será efetuada via Web Service Protheus, seguindo o modelo atual de integração entre ERP Totvs 12/Datasul e SIGAGFE para os processos de frete, passando pelas etapas de Solicitação dos registros pendentes - Recebimento e processamento > Execução Integração MLA (API) > Retorno das informações.

Nos programas de solicitação de registros para integração, CD0433, CDF433 e CDF433RP, será feita a chamada para a API que gera a pendência do documento no MLA, e aguarda a aprovação.

Utilizando o processo de aprovação do MLA, as aprovações podem ser realizadas de diversas formas:

CD0433.W, CDF433.P, CDF433RP.P:

 Neste programas, serão criadas as chamadas para a include CDF433.I11 que fará a interpretação da mensagem enviada pelo GFE e a chamada da include de integração com o MLA.

Segue o padrão de integração de outros processos do SIGAGFE com o ERP Totvs 12 / Datasul (Ex.: cdf433.i1).

Esta chamada será condicionada com ao campo de integração da negociação de fretes com o MLA, no cabeçalho do CD0433 ou nos parâmetros de entrada do CDF433 e CDF433RP.

Incluir na tela do programa CD0433 a opção para marcar a integração de negociações de frete com o MLA (conforme protótipo de tela apresentado na respectiva seção).

cdp\cdf433.i11

Este programa será o responsável por receber a informação enviada do GFE e seu processamento para o envio correto das informações solicitadas pela API de integração MLAAPI010v. 

Ele segue o padrão de estrutura de integrações do SIGAGFE com o ERP Totvs 12/Datasul (Ex.: cdf433.i1)

As informações enviadas pelo Web Service do SIGAGFE para o MLA terá a  estrutura de toda a tabela de frete e será necessária a quebra dos registro para a chamada do programa de integração:

#GV9|GV9_FILIAL|GV9_CDEMIT|GV9_NRTAB|GV9_NRNEG|GV9_CDCLFR|GV9_CDTPOP|GV9_DTVALI|GV9_TPLOTA|GV9_DTCRIA|GV9_USUCRI|GV9_SITMLA|

#GV8|GV8_NRROTA|GV8_TPORIG|GV8_NRCIOR|GV8_DSTORI|GV8_DSTORF|GV8_NRREOR|GV8_CDPAOR|GV8_DSPAOR|GV8_CDUFOR|GV8_CDFIOR|GV8_TPDEST|GV8_NRCIDS|GV8_DSTDEI|GV8_DSTDEF|GV8_NRREDS|GV8_CDPADS|GV8_CDUFDS|GV8_CDFIDS|GV8_NMREM|GV8_CDDEST|

#GV7|GV7_CDFXTV|GV7_CDTPVC|GV7_DSTPVC|GV7_QTFXFI|GV7_UNICAL|GV7_VLALUG|GV7_FRQKM|GV7_VLKMEX|

#GV6|GV6_INFFXA|GV6_NRROTA|GV6_QTMIN|GV6_FRMIN|GV6_COMFRG|GV6_QTPRAZ|GV6_DTATU|GV6_HRATU|GV6_USUATU|

#GV1|GV1_CDCOMP|GV1_VLFIXN|GV1_PCNORM|GV1_VLUNIN|GV1_VLFRAC|GV1_VLMINN|GV1_VLLIM|GV1_VLFIXE|GV1_PCEXTR|GV1_VLUNIE|GV1_CALCEX|

#GUY|GUY_TOTFRE|GUY_BASIMP|GUY_BAPICO|GUY_FREMIN|

#GVQ|GVQ_CODCOT|GVQ_SEQCOT|GVQ_OBSCOT|GVQ_VALCOT|

O programa chama em seguida a API de criação de pendência de negociações de frete no MLA - mlaapi010v.p, passando os parâmetros:

run lap/mlaapi010v.p ( input 29 /* i-tipo*/ , 

                                     input i-transacao,  /*Inclusão, modificação, eliminação*/

                                     input tt-documento,

                                     output table tt-erro).

A variável i-transação leva em conta o valor do campo GV9_SITMLA enviado pelo GFE, se o GV9_SITMLA = “2” então enviar 1 /*Inclusão*/, se GV9_SITMLA = “5”, 3 /* Eliminação */.

A temp-table tt-documento será criada com os registros da tabela de frete retornados do Web Services Protheus para repassar ao MLA.

O retorno da temp-table tt-erro deve ser direcionado para o GFE para ser gravado no campo "GV9_MOTMLA".

lap\mlaapi010v:

É o programa responsável pela criação da pendência de aprovação no MLA através da API MLAAPI001.

A API irá receber os parâmetros enviados pelo programa cdp\cdf433.i11 e fará a geração ou eliminação da pendência de aprovação. Deve seguir o padrão de estruturação dos programas de geração de pendencias de outros documentos no MLA, (Ex.: ap\mlaapi010u.p).

A sintaxe para a chamada da API (baseada no  documento MLAAPI001 - API - Geração de pendência de aprovação (MLA) ): 

laphtml\ mlahtml029e.p :

Quando forem geradas as pendências de aprovação, o usuário receberá em seu e-mail o HTML com as informações do documento em questão e opções para aprovação (Para este processo é necessário configurar o usuário para o recebimento do e-mail).

O programa MLAHTML029e terá a função de criação e envio do e-mail aos usuários cadastrados como aprovadores da pendência de negociação de fretes.

lapepc\mla029.p :

Programa para tratamento e envio do retorno da aprovação ou rejeição efetuado pelo usuário no MLA. 

Este programa será executado quando o usuário aprovador realizar a intervenção na pendência de negociação de fretes no MLA e deve ser cadastrado no programa MLA0101 (FAQ 58026 - Quais informações devem ser preenchidas no programa MLA0101?).

MLA0122 - Inclusão Facilitada:

Será alterado o programa MLA122, Programa de inclusão facilitada da pendencia de aprovação, para que o documento 029-Negociação de fretes e sua chave  possam ser gerados de forma automatizada pelo usuário.

laphtml/mlahtml029p.p

Programa progress que irá retornar os dados para a interface HTML (tanto para a listagem de documentos, quando para o detalhamento).

Para a construção desse programa utilizar os programas laphtml/mlahtml000p.p e laphtml/mlahtml000p.i como exemplo (que estão expedidos com fonte aberto). Eles contêm orientações e exemplos para construção deste programa.

Criar os HTMLs que funcionem de forma responsiva, para que possam ser executados em dispositivos móveis também.

Obs.: Atualizar a documentação no TDN: 

•  FAQ 58026 - Quais informações devem ser preenchidas no programa MLA0101?
• FAQ 58025 - Quais informações devem ser preenchidas no programa MLA0102?
• DMLA0004_Quais_são_as_informações_consideradas_como_referência_para_os_documentos_do_MLA?
• FAQ 58183 – Quais programas de consultas podem ser informados no MLA0121?

Tabelas Utilizadas

• tab-generica - Tabela genérica.

Opcional

Protótipo de

Tela 

CD0433 - Monitor de integração Integração TOTVS 12 X SIGAGFE.

Image Added

CD0089 - Parâmetros de Integração EMS x GFE 

Image Added

HTML da Aprovação por E-mail

Image Added

Image AddedImage AddedImage Added

CDF006 - Consulta da Pendência de Aprovação da Negociação de Fretes

Fluxo do Processo

Não se aplica.  

Dicionário de Dados

Não se aplica.

Grupo

Não se aplica.

Consulta Padrão

Não se aplica.

de Perguntas

Não se aplica.

Consulta Padrão

Não se aplica.

Estrutura de Menu

Procedimentos

Não se aplica.

Programas

Estrutura de Menu

Procedimentos

Programas