Histórico da Página

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 Documentos de Fretes e Faturas com o módulo MLA do ERP Datasul.

Definição da Regra de Negócio

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

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 deste requisito, Por meio deste requisito será possível utilizar o módulo para a aprovação de documentos de frete e faturas criadas no SIGAGFE e bloqueadas pelo processo de auditoriaAuditoria. Para tanto, serão criados dois novos tipos de documento no MLA, denominados ":

• Documento de fretes

• , código 030

• Fatura de fretes

• , código 031.

A chave definida As chaves definidas para esses documentos serão: 

Referência:

• A referência poderá ser utilizada como diferencial de aprovação do documento e, para os documentos de frete e faturas será utilizado o Transportador, permitindo assim um direcionamento da aprovação particular entre as documentos de cada fornecedor de serviço de fretes.
• A integração da negociação será efetuada via

• WebService 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á

• efetuada 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:

•  
  •Através do progress
  • • • Pelo Progress (MLA0301)
  ;
  • • • .
  •Aprovação
  • • • Aprovação por e-mail
  ;
  • • • .
  •Através do
  • • • Pelo portal do MLA (HTML)
  ;
  • • • .
  •Utilização
  • • • Utilização da tela HTML do MLA dentro do Fluig
  ;
  • • • .

   

  • Para o retorno destas aprovações ou rejeições ao módulo SIGAGFE

  ,

  • é necessária a criação dos programas de aprovação/rejeição, os quais executam a atualização no módulo de origem, assim que ocorrer a aprovação ou rejeição do documento no MLA. Estes programas contém as chamadas para os métodos de alteração do registro no SIGAGFE, não aguardando a execução pelo CD0433. Esses programas são cadastrados no MLA0101 – Tipos de Documentos.

   

   

  • Serão realizadas implementações no programa

  “MLA0122

  • MLA0122 – Inclusão Facilitada Tipo

  Documento”

  • Documento, para que os novos documentos e suas chaves possam ser gerados de forma automatizada pelo usuário.
  • Também serão desenvolvidos novos programas para a consulta da pendência

  através do

  • pelo programa MLA0301, para aprovação no Portal HTML e Aprovação por e-mail.
  • Os documentos de frete e faturas aprovadas pelo sistema SIGAGFE e que não necessitam de aprovação no MLA serão integrados apenas para a visualização nos respectivos programas de consulta dos documentos 30 e 31.

   

  Rotina	Tipo de Operação	Opção de Menu	Regras de Negócio
  cdp\cd0089.w - Parâmetros de integração EMS x GFE	Alteração	Logística - > Gestão de Frete Embarcador - > Tarefas	-
  cdp\cd0433.W – Monitor Integração GFE	Alteração	Logística - > Gestão de Frete Embarcador - > Tarefas	-
  cdp\cdf433.P - Agent Listener GFE	Alteração	NA	-
  cdp\cdf433RP.P - integração via RPW	Alteração	NA	-
  cdp\cdf433.i12 - Integração	Criação	NA	-
  laphtml\ mlahtml030e.p -  Aprovação por e-mail	Criação	NA	-
  lapepc\mla030.p - Retorno da aprovação	Criação	NA	-
  MLA0122 - Inclusão Facilitada	Alteração	NA	-
  laphtml/mlahtml030p.p - Novo portal MLA	Criação	NA	-
  laphtml\ mlahtml031e.p -  Aprovação por e-mail	Criação	NA	-
  lapepc\mla031.p - Retorno da aprovação	Criação	NA	-
  laphtml/mlahtml031p.p - Novo portal MLA	Criação	NA	-
  cdp\cdf007.w	Criação	NA	-
  cdp\cdf008.w	Criação	NA	-

   

  CD0089:

  • Criar novos parâmetros de integração para cada processo de aprovação do GFE  no MLA, na
  aba "Integrações" seção "
  • pasta Integrações, seção Processos (GFE para Datasul)
  "
  • . Salvar a opção na tabela tab-generica, utilização
  "
  • SETUP
  "
  • nas posições:
  • Aprov. Docto Frete (MLA)  - substring(tab-generica.char-2,705,1)
  • Aprov. Fatura Frete (MLA) -
   
  • substring(tab-generica.char-2,706,1)

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

   Neste
  • Neste programas, serão criadas as chamadas para a include CDF433.I12, que fará a interpretação da mensagem enviada pelo GFE e a chamada da include de integração com o MLA.
  •  Este programa segue o padrão de integração de outros processos do SIGAGFE com o ERP
  Totvs
  • TOTVS 12 /
  Datasul 
  • Datasul (Ex.: cdf433.i3).
  •  A chamada será condicionada ao campo de integração das Aprovações logísticas via MLA, no cabeçalho do CD0433 ou nos parâmetros de entrada do CDF433 e CDF433RP.
  •  A
  Chamada
  • chamada do registro
  ,
  • altera a situação do campo GV9_SITMLA para 7-Enviado/aguardando aprovação, para evitar que seja chamado constantemente pelo Listener.
  •  Incluir na tela do programa CD0433 a opção para
  marcar
  • assinar a
  integração de com
  • integração com o MLA, campo
  "
  • Aprovação Log. (MLA)
  "
  • , conforme protótipo de tela apresentado na respectiva seção.
   
  cdp

  CDP\

  cdf433

  CDF433.i12

  • 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 MLAAPI001.
   
  • Ele segue o padrão de estrutura de integrações do SIGAGFE com o ERP
  Totvs
  • TOTVS 12 / Datasul (Ex.: cdf433.i3).
  • As informações enviadas pelo
  Web Service
  • WebService do SIGAGFE para o MLA terá a  estrutura do documento de frete e será necessária a quebra dos registro para a chamada do programa de integração:

  #GW3|GW3_FILIAL|GW3_CDESP|GW3_EMISDF|GW3_SERDF|GW3_NRDF|GW3_DTEMIS|GW3_TPDF|GW3_DTENT|GW3_CFOP|GW3_SIT|GW3_USUIMP|GW3_CDREM|GW3_CDDEST|GW3_VLDF|GW3_TAXAS|GW3_FRPESO|GW3_FRVAL|GW3_PEDAG|GW3_QTDCS|GW3_QTVOL|GW3_VOLUM|GW3_PESOR|GW3_PESOC|GW3_VLCARG|GW3_TPIMP|GW3_TRBIMP|GW3_BASIMP|GW3_PCIMP|GW3_VLIMP|GW3_CTE|GW3_MOTBLQ|GW3_DTBLQ|GW3_USUBLQ|GW3_ORIGEM|GW3_TPCTE|GW3_SITMLA|

  • As informações da Fatura de frete enviados para o
  Web-Services
  • WebService serão:

  #GW6|GW6_FILIAL|GW6_EMIFAT|GW6_SERFAT|GW6_NRFAT|GW6_DTEMIS|GW6_VLFATU|GW6_VLDESC|GW6_VLICMS|GW6_VLICRE|GW6_VLISS|GW6_VLISRE|GW6_VLJURO|GW6_DTCRIA|GW6_DTVENC|GW6_ORIGEM|GW6_SITAPR|GW6_DTBLOQ|GW6_HRBLOQ|GW6_USUBLO|GW6_MOTBLO|GW6_OBS|GW6_SITMLA|

  • O programa chama em seguida a API de criação de pendência de negociações de frete no MLA - mlaapi001.p, passando os 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
  • do TOTVS12 / 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_GW3", para documentos de fretes e utilização = "GFE_MLA_GW6" para as faturas de fretes, 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 nos respectivos campos de motivo de rejeição "GW3_MOTMLA" ou "GW6_MOTMLA", conforme o tipo de documento em aprovação.
  • Para a criação da pendência de aprovação no MLA, deve-se confirmar se o documento em questão está bloqueado no GFE, verificando se o campo GW3_SIT  ou GW6_SITAPR foi enviado com o valor
  '
  • 2
  '
  • (bloqueado). 
  • Outro valor possível para os campos anteriormente citados será
  '
  • 3=Aprovado Sistema
  '
  • . Neste caso, apenas deve ser gerado o registro na Tab-generica para futura consulta dos documentos no MLA e retornado ao GFE,
  através da
  • pela função setdataws, retornando o valor 4=Atualizado.
  •  
  • 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

  Parâmetros - MLAAPI001

  Parâmetro	Tipo	Formato	Descrição	Entrada/Saída
  i-cod-tip-doc	Inteiro	>>9	Código do tipo do documento para o qual deve ser gerada, alterada ou eliminada a(s) pendência(s) Utilizar: 30 para Documentos de fretes e 31 para Faturas de fretes.	Entrada
  i-tipo-trans	Inteiro	9	Transação que está sendo realizada (criação, alteração ou eliminação) Utilizar: 1 – Inclusão 2 – Modificação 3 – Eliminação	Entrada
  c-motivo	Caractere	x(40)	“Aprovação de processos de fretes”	Entrada
  de-valor	Decimal	->>,>>>,>>9.99	Doc. frete: GW3_VLDF Fatura: GW6_VLFATU	Entrada
  i-moeda	Inteiro	>9	0	Entrada
  c-usuar-trans	Caractere	x(12)	Doc. frete: GW3_USUBLQ Fatura: GW6_USUBLO	Entrada
  c-usuar-doc	Caractere	x(12)	Doc. frete: GW3_USUIMP Fatura: GW6_USUBLO	Entrada
  c-lotacao-doc	Caractere	x(20)	“ ”	Entrada
  c-item	Caractere	x(16)	“ ”	Entrada
  c-referencia	Caractere	x(20)	GW3_EMISDF GW6_EMIFAT	Entrada
  c-ep-codigo	Caractere	x(3)	Empresa corrente	Entrada
  c-cod-estabel	Caractere	x(5)	Estabelecimento para o qual a pendência será gerada. – GW3_FILIAL / GW6_FILIAL	Entrada
  tt-mla-chave	Temp-table		Informações da chave do documento. Enviar cada um dos registros de chave do documento como um registro diferenciado de "extent" na temp-table. (input  table tt-mla-chave)	Entrada
  tt-erro	Temp-table		Retorno de erros do MLA	Saída

   

  • Após a criação da pendência de aprovação no MLA, enviar mensagem ao GFE para alterar a situação do campo GW3_SITMLA ou GW6_SITMLA para
  '
  • 7-Enviado/aguardando aprovação
  '
  • ,
  através da
  • pela função setdataws.
   Esta
  •  
  • Esta alteração é necessária para que o registro não seja chamado novamente pelo
  Web Service
  • WebService enquanto não for aprovado ou rejeitado no MLA.
  •  

  laphtml\ mlahtml030e.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 MLAHTML030e 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 possuir
  • , 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

  INPUT).

  HTML do e-mail - tt-html (TEMP-TABLE - definição na include: laphtml/mlahtml.i - OUTPUT)

  .

  • Neste programa será

   

  Dentro deste programa será
  • estruturado o e-mail de aprovação, no formato'.html
  '
  • , com as informações do documento de fretes.
  • Apresentar as informações disponíveis no registro da tab-genérica.utilização = "GFE_MLA_GW3", criada no programa cdf433.i12 com os dados enviados pelo SIGAGFE.
    

  laphtml\ mlahtml031e.p :

  • Este programa trata da criação e envio do e-mail aos usuários cadastrados como aprovadores da pendência de faturas de fretes
  . O programa possui
  • , sendo que este possui os mesmos parâmetros definidos para o programa MLAHTML030E.
  • Apresentar as informações disponíveis no registro da tab-genérica.utilização = "GFE_MLA_GW6", criada no programa cdf433.i12 com os dados enviados pelo SIGAGFE.

   lapepc\mla030.p :

  • Programa para tratamento e envio do retorno da aprovação ou rejeição de documento de frete efetuado pelo usuário no MLA. 
  • Este programa será executado quando o usuário aprovador realizar a intervenção na pendência 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 sobre a pendência deve ativar a chamada para a função do
  Web Service
  • WebService 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, por exemplo (cdp/cdf433.i2).

  lcTabela  := "GW3"

  lcIntegracao  := '6'

            cRetornoToSetData 

  cRetornoToSetData :=  Cod. Estabel ; Espécie doc.; Transportador ; Serie ; Nr. doc. frete ; Dt. Emissão ; Situação da integração(3=Rejeitado ou 4=Aprovado) ; Motivo aprovação/rejeição ; Data Aprov. MLA ;  User Aprov. MLA ; Observacao ;

            cSetData

  cSetData :=  Cod. Estabel ; Espécie doc.; Transportador ; Serie ; Nr. doc. frete ; Dt. Emissão ;

  Ex
  • Exemplo.: RUN setdataws IN  hcdf600(INPUT lcTabela, INPUT lcIntegracao, INPUT cRetornoToSetData, INPUT cSetData).
   

  lapepc\mla031.p :

  • Tem a mesma função do  Programa mla030.p, porém voltado para o tratamento e envio do retorno da aprovação ou rejeição de faturas de frete no MLA.
  •  
  • Será executado quando o usuário aprovador realizar a intervenção na pendência de fatura de fretes no MLA e deve ser cadastrado no MLA0101 (FAQ 58026 - Quais informações devem ser preenchidas no programa MLA0101?).
  •  Chama a função do Web Service Protheus setdataws, passando a atualização do registro no GFE. Passa os parâmetros de retorno:

  lcTabela  := "GW6"

  lcIntegracao  := '6'

            cRetornoToSetData 

  cRetornoToSetData :=  Cod. Estabel ; Transportador ; Série ; Nr. Fatura ; Dt. Emissão ; Situação da integração(3=Rejeitado ou 4=Aprovado) ; Motivo aprovação/rejeição ; Data Aprov. MLA ; Hr. Aprov. MLA ; User Aprov. MLA ;

            cSetData

  cSetData := Cod. Estabel ; Transportador ; Série ; Nr. Fatura ; Dt. Emissão;

  Ex
  • Exemplo.: RUN setdataws IN  hcdf600(INPUT lcTabela, INPUT lcIntegracao, INPUT cRetornoToSetData, INPUT cSetData).
  Obs.
  • Obsevação:
  Tratar
  •  Tratar o erro do
  webservice
  • WebService para não permitir a aprovação da pendência quando retornar erro de comunicação.

  MLA0122 - Inclusão Facilitada:

  • Será alterado o programa MLA0122,
  Programa
  • programa de inclusão facilitada da
  pendencia
  • pendência de aprovação, para que os documentos de frete e faturas e suas chaves  possam ser gerados de forma automatizada pelo usuário.
  •  A exemplo dos demais tipos de documentos do MLA, criar o bloco de tratamento para os documentos de tipo 30 e 31.

  laphtml/mlahtml030p.p

  • Programa 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  
  • documentado em: DMLA0003_Como_criar_documentos_para_o_novo_portal_do_MLA_ou_customizar_existentes_(a_partir_12.1.8).
  • Estrutura de apresentação do documento de negociação de fretes no Portal:
  • • Dados principais (lista de pendências):
      • Filial
      • Solicitante (usuário de criação da pendência)
      • Data da solicitação (solicitação da pendência)
      • Transportador 
      • Nr. do Doc. Frete
      • Espécie do doc.
      • Valor do documento de frete
    • Detalhamento:
      • Apresenta os valores do comparativo de fretes x doc. frete.

  laphtml/mlahtml031p.p

  • Programa com a mesma funcionalidade do mlahtml030, porém, voltado para a aprovação das faturas de frete pendentes.
  • Utilizar o mesmo padrão de desenvolvimento do mlahtml030.
  • A estrutura do programa deve seguir o padrão orientado pela equipe de desenvolvimento do módulo MLA,
  documetado
  • documentado em: DMLA0003_Como_criar_documentos_para_o_novo_portal_do_MLA_ou_customizar_existentes_(a_partir_12.1.8).

   

  • Estrutura de apresentação do documento de negociação de fretes no Portal:
    • Dados principais (lista de pendências):
      • Filial
      • Solicitante
      • Data da solicitação
      • Transportador
      • Série  
      • Nr. Fatura  
      • Dt. Emissão
      • Valor da fatura.
    • Detalhamento:
      • Apresenta o detalhamento dos valores da fatura x pré-fatura (quando houver) ou os dados da fatura somente.
   

  CDP/CDF007.W:

  • Criar novo programa para a consulta da pendencia de aprovação de documento de fretes no MLA0301.
  • O programa apresentará as informações do documento de frete enviado pelo SIGAGFE e gravadas na tab-generica (#GW3). Serão as mesmas visualizadas no recebimento do e-mail ou no portal.
  • Este programa poderá ser acessado
  através dos programas
  • 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). Deverá ser cadastrado no MLA0121.
  • Verificar sugestão de tela apresentada na seção
  "
  • Protótipo de tela
  "
  • .

  CDP/CDF008.W:

  • Criar novo programa para a consulta da pendencia de aprovação de faturas de fretes no MLA0301.
  • O programa apresentará as informações da fatura de frete enviada pelo SIGAGFE e gravadas na tab-generica (#GW6). Serão as mesmas visualizadas no recebimento do e-mail ou no portal.
  • Este programa poderá ser acessado
  através dos
  • 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). Deverá ser cadastrado no MLA0121. 
  • Verificar sugestão de tela apresentada na seção
  "
  • Protótipo de tela
  "
  • .
  •  
  Obs

  Observação.:

  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

    genérica

   

Protótipo de Tela

Image Removed

CD0433 -

Monitor Integração - EMS x GFE

Image ModifiedCD0089

CD0089 - Parâmetros Integração -

 EMS x GFE

Image Added

 Image RemovedImage Removed

CDF007 - Consulta de Documentos de Frete MLA 

Image AddedImage Added documentos de frete MLA

Image RemovedImage Removed

CDF008 - Consulta de Faturas de Fretes

Image AddedImage Added fretes

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 Menu

Não se aplica.  

Programas

Cadastro de Papéis

Não se aplica.