Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

 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

TOTVS BA

Módulo

Materiais

Segmento Executor

 

Projeto1

D_MAN_MAT002

IRM1

PCREQ-273

Requisito1

PCREQ-8124

Subtarefa1

PDRMAN-6282

Chamado2

 

Release de Entrega Planejada

12.1.9

Réplica

Não há

País

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

(  ) USA  (  ) Colombia   (  ) Outro _____________.

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


Objetivo

1. Alterar o extrator do BA "HKM-Recebimento das compras" para considerar todos os documentos lançados no recebimento fiscal. Atualmente o extrator extrai apenas informações de recebimento que tenham vínculo com pedido de compra.

2. Criar um relatório que deve ser gerado em formato XML (planilha) que permita validar as informações extraídas.

Chamado relacionado: TTEOJ4 - Sulbras


Definição da Regra de Negócio

 

Situação: Não é possível visualizar no GoodData as informações referentes a todas as notas fiscais digitadas no recebimento fiscal, apenas é possível a visualização das notas de entrada vinculadas a pedido de compra.

Contexto do Cliente: Estou refazendo minhas consultas do Datasul BI 2.0 para o Gooddata. No caso do recebimento de materiais, não consigo visualizar todos os dados de notas fiscais recebidas no ERP. Não encontrei um cubo que mostrasse todos os documentos lançados no RE1001, somente encontrei os documentos com referências à pedidos de compra (Recebimento de compras).

Solução: Necessário alterar o extrator do BA "HKM-Recebimento das compras" para que o mesmo considere todos os documentos lançados no recebimento fiscal. Para isso pode ser usado como base o extrator já existente do Datasul BI 2.0 (ems0306.p).

 

Não há no ERP atualmente um relatório onde seja possível validar a totalização dos recebimentos e valores recebidos, portanto deverá ser criado um relatório que permita validar as informações extraídas.

Atualizar a documentação do BA referente ao extrator HKM.

 

Rotina

Tipo de Operação

[EMS2_BI_HKM – Extrator Recebimento das compras ]

[Alteração]

[EMS2_BI_DATALOADER - Carrega parâmetros padrões dos extratores]

[Alteração]

[RE0523 - Novo relatório de extração de notas de entrada]

[Criação]

[BFP001AB - Parâmetros BA][Envolvido]

 

Protótipo de Tela

Os protótipos estão sendo detalhados no tópico diagrama de ação.

 

Diagrama de ação

 

1. Tela de parâmetros do BA (MBA\BFP001AB)

Adicionar na tela de parâmetros do BA um parâmetro 'ALLDOCS' na configuração do extrator HKM onde será possível parametrizar a extração de todos os documentos.

-Se o parâmetro estiver igual a 'NAO', serão extraídos somente os documentos de compra (com pedido de compra vinculado).

-Se informar 'SIM' serão extraídas informações de quase todos os documentos de entrada (com exceção de alguns tipos de documentos detalhados no tópico 2).

- Alterar o extrator para utilizar a procedure "GetFactParameter" para buscar o valor do parâmetro 'ALLDOCS' e criar duas procedures separadas:

Uma para  a consulta atual da tabela "recebimento" e outra para a consulta completa (tabela docum-est).

Programa que faz a carga de parâmetros: ems_bi_dataloader.p
Adicionar o trecho de código abaixo para inclusão do parâmetro novo:
/* Parametro Extrai todos os documentos - Fato Recebimento das compras */
FIND FIRST HJK
WHERE HJK.HJK_CPARAM = 'ALLDOCS' AND HJK.HJK_CDFATO = 'HKM' NO-ERROR.

IF NOT AVAIL HJK THEN DO:
     CREATE HJK.
     ASSIGN HJK.HJK_FILIAL = ''
     HJK.HJK_CDFATO = 'HKM'
     HJK.HJK_CPARAM = 'ALLDOCS'
     HJK.HJK_DPARAM = 'Extrai todos os documentos'
     HJK.HJK_APARAM = 'Informe SIM para considerar todos os documentos de entrada do recebimento fiscal, ou informe NAO para considerar somente as notas referentes ao recebimento de compras.'
     HJK.HJK_VPARAM = 'NAO'.
END.

 

 

2. Extrator HKM - Recebimento das compras

Alterar o extrator para considerar o novo parâmetro, e caso ALLDOCS = SIM, todos os documentos lançados no recebimento fiscal serão extraídos para o BA.

Para isso pode ser usado como base o extrator já existente do Datasul BI 2.0 (ems0306.p).

Extrator BA da fato HKM Recebimento das Compras:
$/EMS2/Fontes_Doc/Sustentacao/V11/V11/progress/src/mba/ems2_bi_hkm.p

Extrator BI
$/BI/Fontes_Doc/Sustentacao/V11.0/V11.0/progress/bi.extractor/src/ems0306.p

Análise do extrator do BI ems0306.p (parte que consulta as informações na docum-est):
- Realiza a consulta baseando-se na data de atualização. No extrator do BA usar como base a data de transação.
- Implementar condição para que o extrator faça a leitura somente de documentos atualizados (ce-atual = yes).
- Para gerar as informações da docum-est no extrator de recebimento das compras do BA é necessário analisar campo a campo, pois os campos tem nomes bem diferentes no extrator do BI em relação ao extrator do BA.
- Na consulta do extrator deverão ser desconsiderados os documentos dos tipos:
* devolucão de cliente
* transferência
* terceiros: beneficiamento, remessa e retorno

 

3. Implementar novo relatório para listagem de documentos de entrada item a item

Para possibilitar a validação das informações no BA, deverá ser criado um novo relatório no módulo de recebimento que liste as informações referentes as notas de entrada.

Cada linha do relatório deverá representar um item da nota (item-doc-est).

Código do novo relatório: RE0523. Nome: Listagem de itens recebidos

Este relatório deve ser gerado em formato XML (pode ser aberto em Excel ou Libre office) para permitir a sumarização das informações e criação de tabela dinâmica.

O código fonte base de consulta do relatório estará disponível no diretório do projeto.

 

Criar seleção do relatório por:
Estabelecimento: docum-est.cod-estabel (faixa aberta)
Data Transação: docum-est.dt-trans (Padrão da tela deverá ser a faixa do último mês, se hoje é 15/10/15, a faixa deve ser de 01/09/15 a 31/09/15)
Data Emissão: docum-est.dt-emissao (faixa aberta)
Emitente: docum-est.cod-emitente (faixa aberta)
Série: docum-est.serie-docto (faixa aberta)
Documento: docum-est.nro-docto (faixa aberta)
Nat Operação: docum-est.nat-operacao (faixa aberta)

 

No folder "Parâmetros" implementar a seguinte opção:

-Listar: Usar campo docum-est.ce-atual (Atualizados/Pendentes/Todos)

-Considerar documentos: Devolução / Transferência / Operação com terceiros. Como padrão as três opções devem vir desmarcadas, ou seja, o relatório não irá considerar estes tipos de documento.


No folder "Impressão":

O campo Destino terá somente a opção Planilha.

OBS: Verificar implementação do CE0302 que tem a opção de imprimir em formato XML que pode ser aberto pelo Excel ou Libre Office.

Exibir as seguintes informações nas colunas do relatório XML:

SequênciaCampo no Stage do BADescrição ColunaObservação útil para codificação
1hkm_empresEmpresaestabelec.ep-codigo
2hkm_establEstabeldocum-est.cod-estabel
3hkm_fornecFornecedordocum-est.cod-emitente
4 Nome Abrev Fornemitente.nome-abrev
5hkm_grpforGrupo Fornecedoremitente.cod-gr-forn
6hkm_transpTransportadoratransporte.cod-transp
7 Tipo OperaçãoPara NF-e usar lógica para determinar o tipo de operação (include reapi320.i).  Ex: Transferência. Quando for Serviço (docum-est.cod-observa), mostrar "Serviço" e ignorar as regras da reapi320.i. Para ver se é frete, olhar o campo Tipo Compra da natureza de operação (Frete), ignorar também as regras da reapi320.i.
8hkm_fammatFamilia Materialitem.fm-codigo
9 Desc Fam Materialfamilia.descricao
10hkm_famcomFamilia Comercialitem.fm-cod-com
11 Desc Fan Comercialfam-comerc.descricao
12hkm_grpestGrupo Estoqueitem.ge-estoque
13 Desc Grupo Estoquegrup-estoque.descricao
14hkm_itemItemitem-doc-est.it-codigo
15 Desc Itemitem.desc-item
16hkm_unitemUnid Medida Itemitem.un
17 Origemdocum-est.origem (em branco ""-documento digitado, "I"-EDI ou TOTVS Colaboração, "T"-TMS)
18hkm_cmprdrCompradorordem-compra.cod-comprado
19 Nome Compradorusuar-mater.nome-usuar (usuar-mater.cod-usuario = ordem-compra.cod-comprado)
20hkm_pedidoPedido Comprastring(item-doc-est.num-pedido)
21hkm_ordemOrdem Comprastring(item-doc-est.numero-ordem)
22hkm_numprgParcela Compraitem-doc-est.parcela
23 Ordem Produçãoitem-doc-est.nr-ord-produ
24 Ordem Investimentoitem-doc-est.num-ord-inv
25hkm_condpgCondição Pagamentoordem-compra.cod-cond-pag
26hkm_plccstPlano C CustoRUN pi_busca_plano_ccusto_empresa IN h_api_ccusto (prgint/utb/utb742za.py)
27 Conta Contábilitem-doc-est.ct-codigo
28hkm_ccustoCentro Custoitem-doc-est.sc-codigo
29hkm_undnegUnidade de Negócioitem-doc-est.cod-unid-negoc
30hkm_sernfSérie Notadocum-est.serie-docto
31hkm_numnfNr Nota Fiscaldocum-est.nro-docto
32hkm_datanfDt Nota Fiscaldocum-est.dt-emissao
33hkm_dataData Transaçãodocum-est.dt-trans
34hkm_natoprNat Oper Doctodocum-est.nat-operacao
35hkm_cfopCFOP Doctonatur-oper.cod-cfop
36 Nat Oper Itemitem-doc-est.nat-of
37 CFOP Itemnatur-oper.cod-cfop
38hkm_dteordEmissão Ordemordem-compra.data-emissao
39hkm_dtepedData Pedido Compraordem-compra.data-pedido
40hkm_dtprevData Prev Recebimentoprazo-compra.data-entrega
41hkm_qdiaanDias Antecipaçãoi-dd-antec
42hkm_qdiaatDias Atrasadoi-dd-atras
43hkm_qrecebQtde Recebidaitem-doc-est.quantidade
44hkm_qrecfmQtde Recebida Familia(item-doc-est.quantidade * de-ft-conv-mat)
45hkm_emergPedido Emergencialpedido-compr.emergencial
46hkm_sitcmpSituação Compraentry(ordem-compra.situacao, {ininc/i02in274.i 03})
47hkm_natcmpNatureza Compraentry(ordem-compra.natureza, {ininc/i01in274.i 03})
48hkm_referReferênciaitem-doc-est.cod-refer
49hkm_seqciaSeq Item NFitem-doc-est.sequencia
50hkm_qrecanQtd Receb AntecipadoIF i-ent-antec > 0 THEN 1 ELSE 0
51hkm_qrecatQtd Receb em AtrasoIF i-ent-atras > 0 THEN 1 ELSE 0
52hkm_qrecdtQtd Receb em Diai-nr-ent-dt
53hkm_qrecunQtd Receb Únicoi-entrega-unica
54 Cód Trib ICMSUsar mesma lógica do relatório RE0401 (Exibir a descrição: Tributado, Isento, Reduzido, Outras)
55 Alíquota ICMSitem-doc-est.aliquota-icm
56 Vl ICMSitem-doc-est.valor-icm[1]
57 Cód Trib PISUsar mesma lógica do relatório RE0401 (Exibir a descrição: Tributado, Isento, Reduzido, Outras)
58 Alíquota PISrecupera-aliquotas in h-cdapi995 (se alíquota = 0, pega alíquota de item-doc-est.val-aliq-pis)
59 Vl PISitem.doc-est.valor-pis
60 Cód Trib COFINSUsar mesma lógica do relatório RE0401 (Exibir a descrição: Tributado, Isento, Reduzido, Outras)
61 Alíquota COFINSrecupera-aliquotas in h-cdapi995 (se alíquota = 0, pega alíquota de item-doc-est.val-aliq-cofins)
62 Vl COFINSitem.doc-est.valor-cofins
63 Cód Trib IPIUsar mesma lógica do relatório RE0401 (Exibir a descrição: Tributado, Isento, Reduzido, Outras)
64 Alíquota IPIitem-doc-est.aliquota-ipi
65 Vl IPIitem-doc-est.valor-ipi[1]
66 Cód Trib ISSUsar mesma lógica do relatório RE0401 (Exibir a descrição: Tributado, Isento, Reduzido, Outras)
67 Alíquota ISSitem-doc-est.aliquota-iss
68 Vl ISSitem-doc-est.valor-iss[1]
69 Preço Totalitem-doc-est.preco-total[1]
70 Despesaitem-doc-est.despesas[1]
71 Descontoitem-doc-est.desconto[1]
72hkm_vrecebVl Recebidoround((item-doc-est.preco-total[1] + item-doc-est.Despesas[1] - item-doc-est.desconto[1]),2)
73 Narrativa Itemitem-doc-est.narrativa (truncar primeiros 200 caracteres)


Dicionário de Dados

Não se aplica.

 

 


Estrutura de Menu


Procedimentos

 

Procedimento

 re0523

Descrição

Listagem itens recebidos

Módulo

 Recebimento

Programa base

 re0523

Nome Menu

Listagem itens recebidos

Interface

GUI

Registro padrão

Sim

Visualiza Menu

Sim

Release de Liberação

12.1.9

 

 

 

Programas 

Programa

 re0523

Descrição

Listagem itens recebidos

Nome Externo

rep/re0523.r

Nome Menu/Programa

Listagem itens recebidos

Nome Verbalizado[1]

Listagem itens recebidos

Procedimento

re0523 

Template

Relatórios

Tipo[2]

Relatório

Interface

GUI

Categoria[3]

Não se aplica

Executa via RPC

Não

Registro padrão

Sim

Outro Produto

Não

Visualiza Menu

Sim

Query on-line

Não

Log Exec.

Não

Rotina (EMS)

Não se aplica

Sub-Rotina (EMS)

Não se aplica

Localização dentro da Sub Rotina (EMS)

Não se aplica

Compact[4]

Não se aplica

Home[5]

Não se aplica

Posição do Portlet[6]

Não se aplica

Informar os papeis com os quais o programa deve ser vinculado

Não se aplica 

 

Cadastro de Papéis

Não se aplica.


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