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

Subtarefa1

PDRDL-2428

Chamado2

 

País

(  ) 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 Documentos de fretes e faturas 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 documentos de frete e faturas criadas no SIGAGFE e bloqueadas pelo processo de auditoria. Para tanto, serão criados dois novos tipos de documento no MLA denominados "Documento de fretes", código 030 e "Fatura de fretes", código 031.

A chave definida para esses documentos serão: 

 
INI
FIM
DESCRIÇÃO
30 - Documento de Fretes15Cod. Estabel
 610Espécie doc.
 1125Transportador
 2630Serie
 3147nr. doc. frete
 4856Dt. Emissão
 
INI
FIM
DESCRIÇÃO
31 - Fatura de Fretes15Cod. Estabel
 620Transportador
 2125Série
 2642Nr. Fatura
 4350Dt. Emissã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 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 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 – Inclusão Facilitada Tipo 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 programa MLA0301, para aprovação no Portal HTML e Aprovação por e-mail.

 

Rotina

Tipo de Operação

Opção de Menu

Regras de Negócio

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çãoCriaçãoNA-
laphtml\ mlahtml030e.p -  Aprovação por e-mailCriaçãoNA-
lapepc\mla030.p - Retorno da aprovaçãoCriaçãoNA-
MLA0122 - Inclusão FacilitadaAlteraçãoNA-
laphtml/mlahtml031p.p - Novo portal MLACriaçãoNA-
laphtml\ mlahtml031e.p -  Aprovação por e-mailCriaçãoNA-
lapepc\mla031.p - Retorno da aprovaçãoCriaçãoNA 
laphtml/mlahtml031p.p - Novo portal MLACriaçãoNA 

 

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

 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 12 / Datasul (Ex.: cdf433.i3).

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.

A 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 a integração de negociações de frete com o MLA (conforme protótipo de tela apresentado na respectiva seção).

 

cdp\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 12/Datasul (Ex.: cdf433.i3).

As informações enviadas pelo Web Service 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|

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

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)

GV9_CDEMIT

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

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', através da 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.

Tabelas Utilizadas

  • tab-generica

Opcional

Protótipo de Tela

 

<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.

 

Protótipo 01

 

 

 

 

 

 

 

 

 

Opcional

Fluxo do Processo

 

<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>. 

Opcional

Dicionário de Dados

 

Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/

  

Índice

Chave

01

<FI9_FILIAL+FI9_IDDARF+FI9_STATUS>

02

<FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_EMISS+FI9_IDDARF>

03

<FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_PREFIX+FI9_NUM+FI9_PARCEL+FI9_TIPO>

Campo

<AAA_PERESP>

Tipo

<N>

Tamanho

<6>

Valor Inicial

<Varia de acordo com o tipo informado. Por exemplo, quando o campo “tipo” for date, neste campo pode ser informado uma data>. 

Mandatório

Sim (  ) Não (  )

Descrição

<Referência Mínima para Cálculo>

Título

<Ref.Calc.>

Picture

<@E999.99>

Help de Campo

<Informar o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação>

 

(Opcional)

Grupo de Perguntas

 

<Informações utilizadas na linha Protheus>.

 

Nome: FINSRF2

X1_ORDEM

01

X1_PERGUNT

Emissão De

X1_TIPO

D

X1_TAMANHO

8

X1_GSC

G

X1_VAR01

MV_PAR01

X1_DEF01

Comum

X1_CNT01

'01/01/08'

X1_HELP

Data inicial do intervalo de emissões das guias de DARF a serem consideradas na seleção dos dados para o relatório 

 

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

 

Consulta: AMB

Descrição

Configurações de Planejamento

Tipo

Consulta Padrão

Tabela

“AMB”

Índice

“Código”

Campo

“Código”; ”Descrição”

Retorno

AMB->AMB_CODIGO

 

(Opcional)

Estrutura de Menu

 

<Informações utilizadas na linha Datasul>.

 

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

 

 

 

 

Cadastro de Papéis

<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.

<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.

 

Código Papel

(máx 3 posições)

Descrição em Português*

 

Descrição em Inglês*

 

[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.