Módulo: Integração - Interfaces
Funcionalidade: Interfaces
Data/Hora da Publicação: 27/04/2022 11:23:49
Data/Hora Última Alteração: 10/06/2022 15:21:44
Descrição da Nota: Ajuste no teste de conexão de um novo sistema remoto PI/PO para o Fator de Conversão Unidade de Medida; Funcionalidade de Envio de e-mail no processo da Interface: Ajuste no valor default = N da opção de envio de e-mail; Interfaces: Fator de Conversão Unid. de Medida- Ajuste na mensagem 0340199 para o fator conversão e inclusão de transf. de Estabelecimento; Notas Fiscais Detalhadas Energia e Telecom - Ajuste na visualização do relatório Validações de Processo e melhoria de performance.
Sintoma
1 - Sistema Remoto de origem SAP PI_PO:
Ao parametrizar um novo sistema remoto para o Extrator de Fator de Conversão de Unidade de Medida, utilizando a opção de conector SAP PI, ocorria uma falha ao testarmos a conexão de Origem e Retorno, exemplo da exceção abaixo:
Erro ao acessar o webservice:
http://sapbw:50600/RESTAdapter/FatorConversao_200 - Protocolo: 'Rest' -
Erro: 'Não foi possível recuperar o nome da RFC para o endpoint: http://sapbw:50600/RESTAdapter/FatorConversao_200'
2 - Funcionalidade de Envio de E-mail ao final da Execução da Interface:
A funcionalidade de envio de E-mail ao final da execução dos processos de Interface é oriunda da Nota 014156, porém nesta nota mencionada, essa opção/parâmetro de envio de E-mail, saiu com o valor default marcado indevidamente como “S” (Sim - Enviar o e-mail), gerando assim a mensagem de erro no Log de Execução para os clientes que não utilizam esta funcionalidade e ou não a configuraram.
Na imagem, a seguir, é onde o parâmetro dessa funcionalidade encontrasse no Comply/ETL:
3 - Componente de Interface do Fator de Conversão de Unidade de Medida:
Ao realizar o processo de interface do Fator de Conversão de Unidade de Medida, os registros ficavam parados indevidamente no log, com a seguinte mensagem: "0340199 - Validação de Produto", isso porque o Produto estava cadastrado com uma vigência mais atual, exemplo: (23/09/22), sendo que a data de modificação da Conversão de unidade de medida na ITG é anterior exemplo: (23/07/22).
4 - Componente de Visualização do Log de Erros da Interface:
Ao finalizar o processo de interface e sendo necessário verificar os erros através da opção Validações de Processo, a tela não estava abrindo e ocorria o erro abaixo:
The multi-part identifier 'LOG.ILG_ID_REGISTRO' could not be bound
Solução
1 - Sistema Remoto de origem SAP PI_PO:
Ajustado o método que identifica os nomes das funções Z-Sonda ABAP no Produto Comply\ETL, no qual faltava implementar a função do Extrator de Fator de Conversão Unidade de Medida ("/PWSATI/Z_SATI_RFC_NAMESC_CONV") e por isto ao realizar o teste de conexão de Origem e Destino com o PO 7.5, o sistema remoto apresentava um erro.
2 - Funcionalidade de Envio de E-mail ao final da Execução da Interface:
Ajuste dessa entrega de envio de e-mail ao final da execução dos processos de Interface, foi passar o valor default para "N" (não enviar o e-mail), portanto após a aplicação o parâmetro ficará “N”, igualmente a imagem abaixo, e assim ficando uma configuração opcional aos clientes à ativação do envio o e-mail ou não.
Obs.: Lembrando que para realizar a parametrização de envio de e-mail, as instruções estão na Nota 014156.
3 - Componente de Interface do Fator de Conversão de Unidade de Medida:
Ajustada a regra na interface do Fator de Conversão de Unidade de Medida para que não seja checada a data de vigência pois se trata de um simples Cadastro de Conversões não precisando desta forma que o registro fique parado no log de erros.
4 - Componente de Visualização do Log de Erros da Interface:
Conforme citado no Sintoma, o erro era ao pedir a visualização do Log, foi ajustado/tratado o apelido do nome da tabela de Logs (ITG.LOG), sendo assim não ocorrerá mais a exceção na abertura da tela de Validações de Processo.
EVOLUÇÕES:
Esta nota possui a(s) seguinte(s) melhoria(s):
1 - Melhorias para Interface Notas Fiscais Detalhadas ENERGIA e TELECOM:
Melhorias realizadas para performance no reprocessamento de documentos/Notas Fiscais de Energia/TELECOM, nas quais melhoramos o processo de seleção e deleção das Notas Fiscais para também passarmos a utilizar os novos índices (indexes), conforme a liberação da Nota 014477, que é pré-requisito dessa nota. Portanto, foi feito melhoria na identificação dos documentos reprocessados (tratamos os campos Subsérie e Código de município) e na deleção dos documentos melhoramos a condição (o where) na criação do comando de limpeza, durante a etapa de reprocessados.
2 - Melhoria na Interface de Fator de Conversão de Unidade de Medida:
Implementação da funcionalidade de Transferência de Estabelecimento para a Interface de Fator de Conversão de Unidade de Medida.
A Transferência de Estabelecimento é uma funcionalidade utilizada ou não pelos clientes, caso queriam entender se é uma funcionalidade em uso, o menu é: Cadastros Básicos > Transferência de Estabelecimentos
Exemplo:
3 - Evolução para carga do campo Unidade de Medida de Inventário:
A Equipe de Cadastro Básico implementou o Campo (BUM_ID_INV) na Nota 014442, e que tem como objetivo armazenar a Unidade Básica do Material, sendo assim, as Extrações e Interfaces, que realizam os cadastros de Produtos e fazem o Controle de Vigências de Produtos, precisaram ser evoluídas, também.
As Interface envolvidas nesta nota e que tem o controle de vigência de produtos, são as seguintes: Cupom Fiscal (PDV), Movimentos de Estoque e Cadastros de Produto (Bloco K), Notas Fiscais de Indiretos e Serviços Tomados.
a) Alteração de Estrutura nas tabelas Intermediárias:
Bloco K – Industrialização (PO/RFC/TXT):
Movimentos de Estoque:
Tabela: ITG_MOV_ESTOQUE
Cadastro de Produto:
Tabela: ITG_PRODUTO_TRANSIT
Nota: Para clientes que tem a integração PI/PO 7.5 contratada, devem solicitar via chamado, os pacotes: Arquivo TPZ e Request do ABAP Proxy do Bloco K;
Cupom Fiscal - PDV (TXT):
Tabela: ITG_NF_ITEM_PDV
Serviço Tomado (PO/RFC/TXT):
Tabela: ITG_SERVICO_TOMADO_ITEM
b) Evoluções dos versionamentos de Extrações PO, RFC e TXT e/ou melhoria nos documentos de Layouts:
Versionamento:
Adicionado as informações referentes a Unidade de Medida de Inventário no Layout:
c) Evolução da Extração e Interface com a inclusão dos mapeamentos para preenchimento do campo Unidade de Medida de Inventário:
Bloco K - Industrialização:
PDV:
Indiretos:
Obs.: No Controle de Vigência da interface de indiretos, o campo INI_COD_UM_INV era utilizado para preenchimento do campo BUM_ID, com o ajuste a informação do campo INI_COD_UM_INV será usada no preenchimento do campo BUM_ID_INV no cadastro de produto, e a informação do campo INI_COD_UNI_MED será usada no preenchimento do campo BUM_ID no cadastro de produto e que tem como origem o campo IIT_COD_UNI_MED (no ITEM da Nota).
Serviço Tomado:
Obs.: Para extração origem RFC e PO, o campo IIT_COD_UNI_MED_INV (no ITEM do documento) será preenchido com o valor recebido no campo IIT_COD_UNI_MED.
Regras Gerais relacionadas a Unidade de Medida de Inventário:
a) O campo Unidade de Medida de Inventário é obrigatório assim como o campo de unidade de Medida para o cadastro de produtos pela interface e pelo controle de vigência;
b) Alteração da Unidade de Medida de Inventário (assim como preenchimento no cadastro, caso a informação não esteja preenchida), resulta em criação de nova vigência do produto.
4 - Processo de Controle de Vigência de Produtos e Parceiros
Melhoria realizada na funcionalidade de Controle de vigência de Produtos e Parceiros para quando ocorrer cenário, que contenha caractere especial tipo 'aspas simples', o processo não pare o cadastro, nas Interfaces que realizam a inclusão Produtos e Parceiros.
Incluso também a validação dos seguintes campos nos processos de Controle de Vigência e Parceiros:
Produto campos:
Parceiro campo:
Caso os campos não estejam preenchidos corretamente, os registros irão parar no Log de validações para ajustes.
4.00.00.0000
Produto:
Nota
Descrição
Ordem
Pacote - (Requisição)
Informações Complementares
1. É recomendado que sejam aplicados, primeiramente em ambiente de Homologação/Qualidade, os procedimentos: “Procedimentos e Pacotes de Atualização” e “Procedimento de Homologação” descritos nesta nota antes de aplicar no ambiente produtivo;
2. Analisar e aplicar os pré-requisitos que são premissas para esta atualização. Verificar as notas, que são pré-requisitos:
3. Com os pré-requisitos atualizados, aplicar o Pacote de Requisições nesta Nota:
01 - 709906 - ITG_DTA_INSERT_ITG_MAP_TRANSF_331807
02 - 709927 - ITG_DTA_INSERT_ITG_MAP_TRANSF_332285
03 - 709934 - ITG_DLL_MLH_PROC_INTERFACE_332162
04 - 709946 - ETL_DTA_INSERT_ETL_SCHEDULER_LOG_PARAM_332163
05 - 709989 - ETL_DTA_INSERT_ETL_SCHEDULER_LOG_PARAM_333320
06 - 709990 - ITG_DTA_INSERT_ITG_MAP_TRANSF_334002
07 - 710015 - ITG_DIC_ALTER_ITG_NF_ITEM_PDV_335025
08 - 710016 - ITG_DIC_ALTER_ITG_PRODUTO_TRANSIT_335025
09 - 710017 - ITG_DIC_ALTER_ITG_SERVICO_TOMADO_ITEM_335025
10 - 710018 - ITG_DIC_ALTER_ITG_MOV_ESTOQUE_335025
11 - 710014 - BSC_DTA_INSERT_BSC_MSG_VALIDACAO_334993
12 - 710020 - BSC_DLL_CTRL_VIG_PROD_UNID_MED_INV_331359
13 - 710011 - ITG_DLL_CTRL_VIG_PROD_UNID_MED_INV_331359
14 - 710024 - ETL_DLL_INCL_SRV_FATOR DE CONVERSAO_335186
15 - 710028 - ETL_DTA_INSERT_ETL_MAPPING_335261
16 - 710031 - ITG_DTA_INSERT_ITG_MAP_TRANSF_335270
17 - 710032 - ETL_DTA_INSERT_ETL_MAPPING_335284
18 - 710034 - ITG_DTA_INSERT_ITG_MAP_COL_335290
19 - 710038 - ITG_DLL_CORRIGE_LOG_ERROS_EXCEL_335473
20 - 710041 - ITG_DLL_CTRL_VIG_PROD_UNID_MED_INV_331359
21 - 710046 - ITG_DLL_COR_CALLSEERVICE_PROD_PARC_335714
22 - 710062 - ITG_DLL_MELHORIA_CTRL_PROD_PARC_335714
23 - 710047 - ITG_DTA_INSERT_ITG_MAP_TRANSF_335713
24 - 710067 - BSC_DLL_MELHORIA_CTRL_PROD_335714
25 - 710069 - ITG_DTA_INSERT_ITG_MAP_COL_336129
26 - 710070 - ITG_DTA_INSERT_ITG_MAP_TRANSF_336129
27 - 710087 - ETL_DTA_INSERT_ETL_MAPPING_336486
28 - 710088 - ITG_DTA_INSERT_ITG_MAP_TRANSF_336486
29 - 710166 - ETL_DTA_INSERT_ETL_MAPPING_337024
30 - 710079 - ETL_DTA_INSERT_ETL_MAPPING_323670
31 - 710150 - ETL_DTA_INSERT_ETL_MAPPING_320785
32 - 710035 - BSC_DLL_NF_PUB_REPROCESSAMENTO_335612
4. Parar o serviço do componente framework Sonda;
5. Iniciar o serviço do componente framework Sonda.