Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

  

Informações Gerais

 

Especificação

Produto

PROTHEUS

Módulo

SIGAGFE

Segmento Executor

 

Projeto1

M_DL_GFE002

IRM1

PCREQ-9315

Requisito1

PCREQ-9318

Subtarefa1

PDRDL-2399

Chamado2

 

País

( X ) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Outros

 

   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á:

 INIFIMDESCRIÇÃO
29 - Negociação de Fretes15Cod. Estabel
 620Fornecedor
 2127Tabela
 2833Negociação

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 Comparativo de frete relacionado à negociação.

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:

•Através do progress (MLA0301);
•Aprovação por e-mail;
•Através do portal do MLA (HTML);
•Utilização da tela HTML do MLA dentro do Fluig;
Para o retorno destas aprovaçõ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 – Inclusão Facilitada Tipo Documento”, para que o novo documento e sua chave 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 programa MLA0301, para aprovação no Portal HTML e Aprovação por e-mail.


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.i11 - IntegraçãoCriaçãoNA-
lap\mlaapi010v - API Neg. FretesCriaçãoNA-
laphtml\ mlahtml029e.p -  Aprovação por e-mailCriaçãoNA-
lapepc\mla029.p - Retorno da informaçãoCriaçãoNA-
MLA0122 - Inclusão FacilitadaAlteraçãoNA-
laphtml/mlahtml029p.p - Novo portal MLACriaçãoNA-

 

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.

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.

 

cdp\cdf433.i11



 

Pois normalmente só é repassado o seguinte:

 

run lap/mlaapi070.p (    input i-tipo,

 

                  input i-transacao,

 

                  input r-documento,

 

                  output table tt-erro).

 

                E dentro dessa MLAAPI070.P que é buscado o conteúdo de acordo com o Raw-Id do documento, pelo campo r-documento.

 

 

 

                Neste caso nós vamos criar registros dentro da tabela tab-generica com a utilização = “GFE_MLA”.

 

No char-1 vamos gravar a tabela GV9 e no char-2 as demais tabelas.


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.

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|GVQ_VALCOT|

#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|


lap\mlaapi010v:

Este programa será o responsável pela integração dos dados do GFE traduzidos com o módulo MLA. É 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 e fará a geração ou eliminação da pendência de aprovação.

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

 

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:

29 – Negociação 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 (Se o GV9_SITMLA = “2”)

2 – Modificação

3 – Eliminação (Se o GV9_SITMLA = “5”)

 Entrada

c-motivo

Caractere

x(40)

“Aprovação de nova tabela de fretes”

Entrada

de-valor

Decimal

->>,>>>,>>9.99

GVQ_VALCOT

Entrada

i-moeda

Inteiro

>9

0

Entrada

c-usuar-trans

Caractere

x(12)

GV9_USUCRI

Entrada

c-usuar-doc

Caractere

x(12)

GV9_USUCRI

Entrada

c-lotacao-doc

Caractere

x(20)

“ ”

Entrada

c-item

Caractere

x(16)

“ ”

Entrada

c-referencia

Caractere

x(20)

Referência a ser considerada para geração da pendência. Para informações sobre a referência de cada documento consultar: DMLA0004 - Quais são as informações consideradas como referência para os documentos do MLA?

Neste caso, se passada essa informação, e o documento deva utilizar a aprovação por referência, ela será utilizada para busca dos tipos de aprovação/aprovadores. 

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. – GV9_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

 


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. 


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?


Tabelas Utilizadas

  • tab-generica - Tabela genérica.

Opcional

Protótipo de Tela 

 

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 Menu

 

Procedimentos

 

Procedimento

 

 

 

Descrição

(Max 40 posições)

(Max 40 posições)

(Max 40 posições)

Módulo

 

 

 

Programa base

 

 

 

Nome Menu

(Max 32 posições)

(Max 32 posições)

(Max 32 posições)

Interface

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

Registro padrão

Sim

Sim

Sim

Visualiza Menu

Sim/Não

Sim/Não

Sim/Não

Release de Liberação

 

 

 

 

Programas

 

Programa

 

 

 

Descrição

(Max 40 posições)

(Max 40 posições)

(Max 40 posições)

Nome Externo

 

 

 

Nome Menu/Programa

(Max 32 posições)

(Max 32 posições)

(Max 32 posições)

Nome Verbalizado[1]

(Max 254 posições)

(Max 254 posições)

(Max 254 posições)

Procedimento

 

 

 

Template

(Verificar lista de opções no man01211)

(Verificar lista de opções no man01211)

(Verificar lista de opções no man01211)

Tipo[2]

Consulta/Manutenção/ Relatório/Tarefas

Consulta/Manutenção/ Relatório/Tarefas

Consulta/Manutenção/ Relatório/Tarefas

Interface

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

Categoria[3]

 

 

 

Executa via RPC

Sim/Não

Sim/Não

Sim/Não

Registro padrão

Sim

Sim

Sim

Outro Produto

Não

Não

Não

Visualiza Menu

Sim/Não

Sim/Não

Sim/Não

Query on-line

Sim/Não

Sim/Não

Sim/Não

Log Exec.

Sim/Não

Sim/Não

Sim/Não

Rotina (EMS)

 

 

 

Sub-Rotina (EMS)

 

 

 

Localização dentro da Sub Rotina (EMS)

 

 

 

Compact[4]

Sim/Não

Sim/Não

Sim/Não

Home[5]

Sim/Não

Sim/Não

Sim/Não

Posição do Portlet[6]

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

Informar os papeis com os quais o programa deve ser vinculado

 

 

 

 

[1] Nome Verbalizado é obrigatório para desenvolvimentos no Datasul 10 em diante.

[2] Tipo é obrigatório para desenvolvimento no Datasul 10 em diante

[3] Categorias são obrigatórias para os programas FLEX.

[4] Obrigatório quando o projeto for FLEX

[5] Obrigatório quando o projeto for FLEX

[6] Obrigatório quando o projeto for FLEX

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.