Á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

 Manufatura

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 mesmo que não tenham relacionamento com pedido de compra. Atualmente o extrator extrai apenas informações de recebimento que tenham vínculo com pedido de compra.
2.
Criar
 Implementar um relatório que permita validar as informações extraídas. A saída do relatório deve ser um arquivo em formato de planilha que possa ser aberta com Excel e Libre Office.
Chamado relacionado: TTEOJ4 - Sulbras

  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  Não estão aparecendo no GoodData as informações referentes a todas as notas fiscais digitadas no recebimento fiscal, apenas é possível a visualização das de entrada sem pedido de compra, estão sendo extraídas somente 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 de itens recebidos onde seja possível validar a totalização dos recebimentos e valores recebidos , portanto deverá ser criado (Ex.: planilha). Será implementado 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., com exceção dos seguintes:

* devolução de cliente
* transferência 
* terceiros: beneficiamento, remessa e retorno

Dica: Pode 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.

 

Importante: Nas sequências de item da NF que são recebidos por FIFO será gerado para o BA o primeiro Pedido/Ordem/Parcela daquela sequência de item. Não haverá geração de registros no Stage do BA para cada registro do FIFO. A totalização dos valores e quantidades da sequência de item da NF não será prejudicada. Caso essa informação de qual Pedido/Ordem/Parcela do FIFO seja crucial para o cliente ele deverá utilizar o parâmetro ALLDOCS igual a NAO, dessa forma o extrator irá gerar as informações conforme o FIFO.

 

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 (poderá ser aberto em Excel ou Libre office).

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:
EstabelecimentoCriar 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 estabel (faixa aberta)
SérieData Transação: docum-est.seriedt-docto (faixa aberta)
Documentotrans (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 de cliente / 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_
fornec
sernf
Fornecedor
Série Notadocum-est.
cod
serie-
emitente
docto
4
 Nome Abrev Forn
hkm_numnfNr Nota Fiscaldocum-est.nro-docto
emitente.nome-abrev
5hkm_
grpforGrupo Fornecedor
datanfDt Nota Fiscaldocum-est.dt-emissao
emitente.cod-gr-forn
6hkm_
transp
data
Transportadora
Dt Transaçãodocum-est.dt-trans
transporte.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
hkm_natoprNat Oper Doctodocum-est.nat-operacao
8hkm_cfopCFOP Doctonatur-oper.cod-cfop
9hkm_fornecFornecedordocum-est.cod-emitente
10 Nome Abrev Fornemitente.nome-abrev
11 Tipo Operação

NF-e: usar mesma lógica para determinar o tipo de operação da include reapi320.i.  Ex: Compra, Transferência e etc.

Serviço: Quando for Serviço (campo: docum-est.cod-observa), exibir "Serviço" e ignorar as regras da reapi320.i.

Frete: olhar o campo "Tipo Compra" da natureza de operação (Frete). Se for frete ignorar as regras da reapi320.i.

8
12hkm_
fammat
grpfor
Familia Material
Grupo Forn
item
emitente.
fm
cod-gr-
codigo
forn
9
13
 Desc Fam Materialfamilia.descricao10
hkm_transpTransportadoratransporte.cod-transp
14hkm_
famcomFamilia Comercial
seqciaSeq Item NFitem
.fm
-
cod
doc-
com
est.sequencia
11
15
 Desc Fan Comercialfam-comerc.descricao
hkm_itemItemitem-doc
12hkm_grpestGrupo Estoqueitem.ge-estoque13 Desc Grupo Estoquegrup-estoque.descricao14hkm_itemItemitem-doc
-est.it-codigo
15
16 Desc Itemitem.desc-item
16
17hkm_unitemUnid Medida Itemitem.un
1718hkm_cmprdrCompradorordem-compra.cod-comprado19 Nome Compradorusuar-mater.nome-usuar (usuar-mater.cod-usuario = ordem-compra.cod-comprado)20hkm_pedidoPedido Comprastring
18 
Origemdocum-est.origem (em branco ""-documento digitado, "I"-EDI ou TOTVS Colaboração, "T"-TMS)
Nat Oper Itemitem-doc-est.nat-of
19 CFOP Itemnatur-oper.cod-cfop
20hkm_qrecebQtde Recebidaitem-doc-est.quantidade
21hkm_qrecfmQtde Receb Fam Mat
(item-doc-est.
num-pedido
quantidade * de-ft-conv-mat)
21string(
22
hkm_ordemOrdem Compra
 Preço Total
item-doc-est.
numero-ordem)22hkm_numprg
preco-total[1]
23 Despesa
Parcela Compra
item-doc-est.
parcela23
despesas[1]
24 
Ordem Produção
Descontoitem-doc-est.
nr-ord-produ24 Ordem Investimento
desconto[1]
25hkm_vrecebVl Recebidoround((item-doc-est.
num-ord-inv25hkm_condpgCondição Pagamentoordem-compra.cod-cond-pag
preco-total[1] + item-doc-est.Despesas[1] - item-doc-est.desconto[1]),2)
26hkm_
plccstPlano C CustoRUN pi_busca_plano_ccusto_empresa IN h_api_ccusto (prgint/utb/utb742za.py)
grpestGrupo Estoqueitem.ge-estoque
27 
Conta Contábil
Desc Grupo Estoquegrup-estoque.descricao
item-doc-est.ct-codigo
28hkm_
ccusto
fammat
Centro Custo
Familia Materialitem
-doc-est
.
sc
fm-codigo
29
hkm_undnegUnidade de Negócio
 Desc Fam Matfamilia.descricao
item-doc-est.cod-unid-negoc
30hkm_
sernf
famcom
Série Nota
Familia Comercialitem.fm-cod-com
docum-est.serie-docto
31
hkm_numnfNr Nota Fiscal
 Desc Fam Comfam-comerc.descricao
docum-est.nro-docto
32
hkm_datanf
 Origem
Dt Nota Fiscal
docum-est.
dt-emissao
origem (em branco ""-documento digitado, "I"-EDI ou TOTVS Colaboração, "T"-TMS)
33
hkm_dataData Transação
 FIFO?SIM/NÃO  -  item-doc
docum
-est.
dt
log-
trans
1
34hkm_
natopr
refer
Nat Oper Docto
Referênciaitem-doc
docum
-est.
nat
cod-
operacao
refer
35
hkm_cfopCFOP Docto
 Ordem Proditem-doc-est.nr-ord-produ
natur-oper.cod-cfop
36 
Nat Oper Item
Ordem Investitem-doc-est.
nat
num-ord-
of37 CFOP Itemnatur-oper.cod-cfop38hkm_dteordEmissão Ordemordem-compra.data-emissao39hkm_dtepedData Pedido Compraordem-compra.data-pedido40hkm_dtprevData Prev Recebimentoprazo-compra.data-entrega41hkm_qdiaanDias Antecipaçãoi-dd-antec42hkm_qdiaatDias Atrasadoi-dd-atras43hkm_qreceb
inv
37hkm_plccstPlano C CustoRUN pi_busca_plano_ccusto_empresa IN h_api_ccusto (prgint/utb/utb742za.py)
38 Conta Contábilitem-doc-est.ct-codigo
39hkm_ccustoCentro Custoitem-doc-est.sc-codigo
40hkm_undnegUnidade Negócioitem-doc-est.cod-unid-negoc
41hkm_pedidoPedido Comprastring(item-doc-est.num-pedido)
42hkm_ordemOrdem Comprastring(item-doc-est.numero-ordem)
43hkm_numprgParcela Compra
Qtde Recebida
item-doc-est.
quantidade
parcela
44
hkm_qrecfmQtde Recebida Familia
 Nr Contratopedido-compr.nr-contrato
(item-doc-est.quantidade * de-ft-conv-mat)
45hkm_
emerg
cmprdr
Pedido Emergencial
Comprador
pedido
ordem-
compr
compra.
emergencial
cod-comprado
46
hkm_sitcmpSituação Compraentry(ordem-compra.situacao, {ininc/i02in274.i 03}
 Nome Compradorusuar-mater.nome-usuar (usuar-mater.cod-usuario = ordem-compra.cod-comprado)
47hkm_
natcmp
condpg
Natureza Compra
Cond Pagto
entry(
ordem-compra.
natureza, {ininc/i01in274.i 03})
cod-cond-pag
48hkm_
refer
dteord
Referência
Emissão Ordem
item
ordem-
doc-est
compra.
cod
data-
refer
emissao
49hkm_
seqciaSeq Item NF
dtepedDt Ped Compraordem-compra.data-pedido
item-doc-est.sequencia
50hkm_
qrecan
dtprev
Qtd
Dt Prev Receb
Antecipado
IF i-ent-antec > 0 THEN 1 ELSE 0
prazo-compra.data-entrega
51hkm_
qrecatQtd Receb em AtrasoIF
qdiaanDias Antecipação
i-
ent-atras > 0 THEN 1 ELSE 0
dd-antec
52hkm_
qrecdt
qdiaatDias Atrasado
Qtd Receb em Dia
i-
nr
dd-
ent-dt
atras
53hkm_
qrecunQtd Receb Único
emergPedido Emerglpedido-compr.emergencial
i-entrega-unica
54
 Cód Trib ICMSUsar mesma lógica do relatório RE0401 (Exibir a descrição: Tributado, Isento, Reduzido, Outras
hkm_sitcmpSituação Compraentry(ordem-compra.situacao, {ininc/i02in274.i 03})
55
 Alíquota ICMSitem-doc-est.aliquota-icm56 Vl ICMSitem-doc-est.valor-icm[1]57 Cód Trib PISUsar mesma lógica do relatório
hkm_natcmpNatureza Compraentry(ordem-compra.natureza, {ininc/i01in274.i 03})
56hkm_qrecanQtd Receb AntecipIF i-ent-antec > 0 THEN 1 ELSE 0
57hkm_qrecatQtd Receb em AtrasoIF i-ent-atras > 0 THEN 1 ELSE 0
58hkm_qrecdtQtd Receb em Diai-nr-ent-dt
59hkm_qrecunQtd Receb Únicoi-entrega-unica
60 Cód Trib ICMSUsar mesma lógica do relatório RE0401 (Exibir a descrição: Tributado, Isento, Reduzido, Outras)
58
61 Alíquota
PISrecupera-aliquotas in h-cdapi995 (se alíquota = 0, pega alíquota de item
ICMSitem-doc-est.
val-aliq-pis)
aliquota-icm
62
59
 Vl
PIS
ICMSitem
.
-doc-est.valor-
pis
icm[1]
63
60
 Cód Trib
COFINS
PISUsar mesma lógica do relatório RE0401 (Exibir a descrição: Tributado, Isento, Reduzido, Outras)
61
64 Alíquota
COFINS
PISrecupera-aliquotas in h-cdapi995 (se alíquota = 0, pega alíquota de item-doc-est.val-aliq-
cofins
pis)
62
65 Vl
COFINS
PISitem.doc-est.valor-
cofins
pis
63
66 Cód Trib
IPI
COFINSUsar mesma lógica do relatório RE0401 (Exibir a descrição: Tributado, Isento, Reduzido, Outras)
64
67 Alíquota
IPI
COFINSrecupera-aliquotas in h-cdapi995 (se alíquota = 0, pega alíquota de item-doc-est.
aliquota-ipi
val-aliq-cofins)
68
65
 Vl
IPI
COFINSitem
-
.doc-est.valor-
ipi[1]
cofins
69
66
 Cód Trib
ISS
IPIUsar mesma lógica do relatório RE0401 (Exibir a descrição: Tributado, Isento, Reduzido, Outras)
67
70 Alíquota
ISS
IPIitem-doc-est.aliquota-
iss
ipi
68
71 Vl
ISS
IPIitem-doc-est.valor-
iss
ipi[1]
69
72 
Preço Total
Cód Trib ISSUsar mesma lógica do relatório RE0401 (Exibir a descrição: Tributado, Isento, Reduzido, Outras)
73 Alíquota ISSitem-
item-
doc-est.
preco-total[1]
aliquota-iss
74
70
 
Despesa
Vl ISSitem-doc-est.
despesas
valor-iss[1]
71
75 
Desconto
Narrativa Itemitem-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)
narrativa (truncar primeiros 200 caracteres)

 

Importante: Nas sequências de item da NF que são recebidos por FIFO de ordem de compra será listado o primeiro Pedido/Ordem/Parcela do FIFO daquela sequência de item. A totalização dos valores e quantidades da sequência de item da NF não será prejudicada.

Fora de escopo: Campos específicos referentes ao módulo de Contratos e outras integrações do recebimento estão fora do escopo deste relatório.

 


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

(Verificar lista de opções no man01211)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.