Histórico da Página

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
Projeto¹	D_MAN_MAT002	IRM¹	PCREQ-273
Requisito¹	PCREQ-8124	Subtarefa¹	PDRMAN-6282	Chamado²
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ência	Campo no Stage do BA	Descrição Coluna	Observação útil para codificação
1	hkm_empres	Empresa	estabelec.ep-codigo
2	hkm_establ	Estabel	docum-est.cod-estabel
3	hkm_

fornec

sernf

Fornecedor

Série Nota

docum-est.

cod

serie-

emitente

docto

4

Nome Abrev Forn

hkm_numnf

Nr Nota Fiscal

docum-est.nro-docto

emitente.nome-abrev


5	hkm_

grpforGrupo Fornecedor

datanf

Dt Nota Fiscal

docum-est.dt-emissao

emitente.cod-gr-forn


6	hkm_

transp

data

Transportadora

Dt Transação

docum-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 as regras da reapi320.i.

hkm_natopr	Nat Oper Docto	docum-est.nat-operacao
8	hkm_cfop	CFOP Docto	natur-oper.cod-cfop
9	hkm_fornec	Fornecedor	docum-est.cod-emitente
10		Nome Abrev Forn	emitente.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.
12	hkm_grpfor	Grupo Forn	emitente.cod-gr-forn
13	hkm_transp	Transportadora	transporte.cod-transp
14	hkm_seqcia	Seq Item NF	item-doc-est.sequencia
15	hkm_item	Item	item-doc-est.it-codigo
16		Desc Item	item.desc-item
17	hkm_unitem	Unid Medida Item	item.un
18		Nat Oper Item	item-doc-est.nat-of
19		CFOP Item	natur-oper.cod-cfop
20	hkm_qreceb	Qtde Recebida	item-doc-est.quantidade
21	hkm_qrecfm	Qtde Receb Fam Mat	(item-doc-est.quantidade * de-ft-conv-mat)
22		Preço Total	item-doc-est.preco-total[1]
23		Despesa	item-doc-est.despesas[1]
24		Desconto	item-doc-est.desconto[1]
25	hkm_vreceb	Vl Recebido	round((item-doc-est.preco-total[1] + item-doc-est.Despesas[1] - item-doc-est.desconto[1]),2)
26	hkm_grpest	Grupo Estoque	item.ge-estoque
27		Desc Grupo Estoque	grup-estoque.descricao
28	hkm_fammat	Familia Material	item.fm-codigo
29		Desc Fam Mat	familia.descricao
30	hkm_famcom	Familia Comercial	item.fm-cod-com
31		Desc Fam Com	fam-comerc.descricao
32		Origem	docum-est.origem (em branco ""-documento digitado, "I"-EDI ou TOTVS Colaboração, "T"-TMS)
33		FIFO?	SIM/NÃO - item-doc-est.log-1
34	hkm_refer	Referência	item-doc-est.cod-refer
35		Ordem Prod

8hkm_fammatFamilia Materialitem.fm-codigo9 Desc Fam Materialfamilia.descricao10hkm_famcomFamilia Comercialitem.fm-cod-com11 Desc Fan Comercialfam-comerc.descricao12hkm_grpestGrupo Estoqueitem.ge-estoque13 Desc Grupo Estoquegrup-estoque.descricao14hkm_itemItemitem-doc-est.it-codigo15 Desc Itemitem.desc-item16hkm_unitemUnid Medida Itemitem.un17 Origemdocum-est.origem (em branco ""-documento digitado, "I"-EDI ou TOTVS Colaboração, "T"-TMS)18hkm_cmprdrCompradorordem-compra.cod-comprado19 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.parcela23 Ordem Produção

item-doc-est.nr-ord-produ

24

36

Ordem Investimentoitem-doc-est.num-ord-inv

	Ordem Invest	item-doc-est.num-ord-inv
37

25hkm_condpgCondição Pagamentoordem-compra.cod-cond-pag26

hkm_plccst

Plano C Custo

RUN pi_busca_plano_ccusto_empresa IN h_api_ccusto (prgint/utb/utb742za.py)

27

38

Conta Contábil

item-doc-est.ct-codigo

28

39

hkm_ccusto

Centro Custo

item-doc-est.sc-codigo

29

40

hkm_undneg

Unidade

de

Negócio

item-doc-est.cod-unid-negoc

30

41

hkm_

sernf

pedido

Série Notadocum-est.serie-docto31hkm_numnfNr Nota Fiscal

Pedido Compra

string(item-doc

docum

-est.

nro

num-

docto

pedido)

32

42

hkm_

datanfDt Nota Fiscal

ordem

Ordem Compra

string(item-doc

docum

-est.

dt

numero-

emissao

ordem)

33

43

hkm_

data

numprg

Data Transação

Parcela Compra

item-doc

docum

-est.

dt-trans

parcela

34

44

hkm_natoprNat Oper Doctodocum-est.nat-operacao

	Nr Contrato	pedido-compr.nr-contrato
45

35

hkm_

cfop

cmprdr

CFOP Docto

Comprador

natur

ordem-

oper

compra.cod-

cfop

comprado

36

46

Nat Oper Itemitem-doc-est.nat-of

Nome Comprador	usuar-mater.nome-usuar (usuar-mater.cod-usuario = ordem-compra.cod-comprado)
47	hkm_condpg	Cond Pagto	ordem-compra.cod-cond-pag
48

37 CFOP Itemnatur-oper.cod-cfop38

hkm_dteord

Emissão Ordem

ordem-compra.data-emissao

39

49	hkm_dteped

Data Pedido

Dt Ped Compra

ordem-compra.data-pedido

40

50	hkm_dtprev

Data

Dt Prev

Recebimento

Receb

prazo-compra.data-entrega

41

51

hkm_qdiaan

Dias Antecipação

i-dd-antec

42

52

hkm_qdiaat

Dias Atrasado

i-dd

-atras43hkm_qrecebQtde Recebidaitem-doc-est.quantidade44hkm_qrecfmQtde Recebida Familia(item-doc-est.quantidade * de-ft-conv-mat)

-atras

53

45

hkm_emerg

Pedido

Emergencial

Emergl

pedido-compr.emergencial

46

54

hkm_sitcmp

Situação Compra

entry(ordem-compra.situacao, {ininc/i02in274.i 03})

4750

55

hkm_natcmp

Natureza Compra

entry(ordem-compra.natureza, {ininc/i01in274.i 03})

48hkm_referReferênciaitem-doc-est.cod-refer49hkm_seqciaSeq Item NFitem-doc-est.sequencia

56

hkm_qrecan

Qtd Receb

Antecipado

Antecip

IF i-ent-antec > 0 THEN 1 ELSE 0

51

57

hkm_qrecat

Qtd Receb em Atraso

IF i-ent-atras > 0 THEN 1 ELSE 0

52

58

hkm_qrecdt

Qtd Receb em Dia

i-nr-ent-dt

53

59

hkm_qrecun

Qtd Receb Único

i-entrega-unica

54

60

Cód Trib ICMS

Usar mesma lógica do relatório RE0401 (Exibir a descrição: Tributado, Isento, Reduzido, Outras)

55

61

Alíquota ICMS

item-doc-est.aliquota-icm

56

62

Vl ICMS

item-doc-est.valor-icm[1]

57

63

Cód Trib PIS

Usar mesma lógica do relatório RE0401 (Exibir a descrição: Tributado, Isento, Reduzido, Outras)

58

64

Alíquota PIS

recupera-aliquotas in h-cdapi995 (se alíquota = 0, pega alíquota de item-doc-est.val-aliq-pis)

59

65

Vl PIS

item.doc-est.valor-pis

60

66

Cód Trib COFINS

Usar mesma lógica do relatório RE0401 (Exibir a descrição: Tributado, Isento, Reduzido, Outras)

61

67

Alíquota COFINS

recupera-aliquotas in h-cdapi995 (se alíquota = 0, pega alíquota de item-doc-est.val-aliq-cofins)

62

68

Vl COFINS

item.doc-est.valor-cofins

63

69

Cód Trib IPI

Usar mesma lógica do relatório RE0401 (Exibir a descrição: Tributado, Isento, Reduzido, Outras)

64

70

Alíquota IPI

item-doc-est.aliquota-ipi

65

71

Vl IPI

item-doc-est.valor-ipi[1]

66

72

Cód Trib ISS

Usar mesma lógica do relatório RE0401 (Exibir a descrição: Tributado, Isento, Reduzido, Outras)

73

67 Alíquota ISSitem-doc-est.aliquota-iss68 Vl ISSitem-doc-est.valor-iss[1]69

Preço Total

Alíquota ISS

item-doc-est.

preco-total[1]

aliquota-iss

74

70

Despesa

Vl ISS

item-doc-est.

despesas

valor-iss[1]

71

75

Descontoitem-doc-est.desconto[1]72hkm_vrecebVl Recebidoround((item-doc-est.preco-total[1] +

Narrativa Item

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

Árvore de páginas

Versões comparadas

Versão antiga 29

Nova versão Atual

Chave

Informações Gerais

Objetivo

Definição da Regra de Negócio

Protótipo de Tela

Diagrama de ação

Dicionário de Dados

Estrutura de Menu