COMPLY - Nota 014587

Módulo: Integração - Extração dos dados

Funcionalidade: Execução da Extração

Data/Hora da Publicação: 22/06/2022 16:59:35

Data/Hora Última Alteração: 30/06/2022 09:31:36

Descrição da Nota: Processo de Extração: Liberação de nova funcionalidade 'Integrador XML' para realizar a extração de arquivos XML

Descrição

 

Evolução Processo de Extração:

Liberada nova funcionalidade  "Integrador XML" para realizar a extração de arquivos XML para tabelas indiretos do Comply.

Atende os modelos 55 - Nota Fiscal Eletrônica e 57 - Conhecimento de Transporte Eletrônico

 

 

Para utilização desta nova funcionalidade seguir as parametrizações indicadas abaixo.

 

1 - Necessário realizar a liberação do acesso para o usuário da seguinte forma:

Associar a Transação a Atividade do usuário que ficará responsável pela parametrização dos Cenários e Transformações para o processo de extração.

Sistema > Atividade > Atividade x Transação

Associação por Atividade

 

 

Em Atividade buscar o grupo que o usuário pertence

Em Aplicação marcar o produto PW. ETL

Selecionar a transação Integrador XML ETL e salvar através da opção "Aplicar alterações"

 

 

Associação por Transação

 

Em Aplicação marcar o produto PW. ETL

Em Transação marcar Integrador XML ETL

Selecionar a qual grupo o usuário que irá utilizar a nova funcionalidade pertence e salvar através da opção "Aplicar Alterações"

 

 

2 - Na tela de "Extrações de Dados" acessar a opção "Integrador XML | ETL" através do botão: "Integrador XML"

 

3 - Tela "Integrador XML ETL":

 

Aba Cenários, deve ser utilizada para o cadastramento dos cenários, neles devem ser definidos os parâmetros para a Leitura dos XML, como diretório de Origem, o modelo do documento que será carregado, se para o cenário as informações de Emitente e Destinatário da nota deve ser invertida e se deseja realizar inserção adicional de impostos PIS e COFINS, com suas parametrizações. Podem ser cadastrados mais de um cenário por modelo.

 

Exemplo: Nos XMLs de Conhecimento de Transporte eletrônico não existem  as tags de PIS e COFINS, para que sejam criadas as linhas destes impostos na tabela intermediária ITG_NF_IMPOSTO (se necessário), marcar as opções "Inserir PIS" e "Inserir COFINS" na aba Cenário referente ao Modelo 57 que será criado, bem como parametrizar as alíquotas e Situação Tributária destes impostos.

 

Na Aba "Transformação De x Para", podem ser cadastradas as transformações desejadas:

 

 

Nessa aba deve ser selecionado:

 

  • O Cenário,
  • A tabela destino
  • O Campo que deseja aplicar a transformação;
  • No grupo de informações "Origem" pode ser definida a condição para aplicar a transformação:

Caso nenhuma condição seja definida, a transformação sempre irá ocorrer, independentemente do valor identificado na origem, deve ser utilizada apenas uma condição por transformação.

  • No grupo de informações "Destino" deve ser definido:

O valor aplicado para a transformação.

Ou se será copiada a informação de outro campo.

Deve ser utilizada apenas uma destas opções por transformação.

Seguem as tabelas e os campos que tem o seu preenchimento realizado na extração através do programa extrator e os campos que não são preenchidos. Campos com asterisco ( * ) se não forem preenchidos podem fazer com que a nota fique parada no log de validação da Interface.

 

ITG_NF_CAPA

Campos sem preenchimento:

INF_NF_EMISSOR

INF_TP_NOTA *

INF_COD_MATRIZ *

INF_COD_FILIAL *

INF_MANDT *

INF_SUBSERIE

INF_COD_SIT_DOC

INF_NF_SRV *

INF_COD_STATUS *

 

INF_CENTRO_CUSTO

INF_MARCA_VOL

INF_NUM_VOL

INF_LIVRO_VOL

INF_COD_PRT_SRV

INF_DSC_PRT_SRV

INF_UF_PRT_SRV

INF_VLR_MATER

INF_NFTYPE

INF_CHV_CTE_REF

INF_TP_CTE

INF_CTO_CUST_TER

INF_SETOR

INF_SOLICITANTE

INF_COD_MATRIZ_O

INF_COD_FILIAL_O

INF_UF_CONSUMO

INF_VL_ABAT

INF_LANCTO_CONTB

INF_COD_VERIFICA_NFE

INF_VL_DED_ALIM

INF_VL_DED_TRANS

INF_VL_MAT_EQUIP

INF_VL_RET_SUB

INF_TP_OBRA

INF_MUNICIP_NEGOCIACAO

INF_FINALIDADE_EMISSAO

INF_TP_DOC_IN

INF_ESPECIE

 

 

Campos preenchidos com valores Default:

INF_SIST_ORIGEM = "INTEGRADOR_XML"

INF_DT_LANCTO = INF_DT_EMISSAO

INF_DT_MOV = INF_DT_EMISSAO

INF_DT_PREST_SERV = INF_DT_EMISSAO

INF_DOC_NUM= INF_NUM_NF+ INF_DT_EMISSAO (Dia + mês)

Modelo 57

INF_ESPECIE = "CTe";

INF_TP_DOC_IN = "CTE";

INF_TP_FRETE = "CIF";

Modelo 55

INF_TP_DOC_IN = "NF"

INF_ESPECIE = "NF"

 

ITG_NF_CP_PARCEIRO

Campos sem preenchimento:

IPR_INSC_MUN

IPR_COD_NIT

IPR_COD_INSS

IPR_INSC_SUFRA

IPR_CTA_CONTAB

IPR_COD_IE_ST

IPR_RELAC_FNT_PAG

IPR_NIF

IPR_COD_GRUPO

IPR_IND_SIMP_NAC

IPR_COD_PAIS (transportadora) *

Campo preenchido com valor Default:

IPR_MANDT = INF_MANDT

 

ITG_NF_OBS

Campo sem preenchimento:

IOS_OBS_LVR

 

Campos preenchidos com valores Default:

IOS_CODIGO = "999"

IOS_COMPLEMENTO= "INTEGRADOR_XML"

IOS_TIPO = "1"

IOS_MANDT = INF_MANDT

 

ITG_NF_CP_IMPORT

Campo sem preenchimento:

IPT_IMP_SIMPLIF

 

Campo preenchido com valor Default:

IPT_MANDT = INF_MANDT

 

ITG_NF_REFER

Campos sem preenchimento:

INI_SEQ_IT_PRI

INI_SEQ_IT_REF

 

Campo preenchido com valor Default:

INF_DOC_NUM_PRI = INF_DOC_NUM

 

ITG_NF_CP_FATURA

Campo preenchido com valor Default:

IPT_MANDT = INF_MANDT

Só insere se INF_TP_NOTA = "E"

 

ITG_NF_DUPLICATA

Campo preenchido com valor Default:

IFD_MANDT = INF_MANDT

Só insere se INF_TP_NOTA == "E"

 

ITG_NF_ITEM

Campos sem preenchimento:

 INI_CFOP_DIG

INI_MOV_FIS_MERC

INI_PRD_INC_ZF

INI_TP_PROD

INI_DSC_PRD_CPL

INI_CATEGORIA

INI_NCM_EXT

INI_QTD_BC_COFINS

INI_QTD_BC_PIS

INI_QUALIFICADOR

INI_TP_OPER_VDA

INI_VLR_ALIQ_COF

INI_VLR_ALIQ_PIS

INI_CTA_CTB

INI_NUM_EMPENHO

INI_COD_PROD_ANT

INI_COD_SRV_L116

INI_COD_IVA

INI_TP_RECEITA

INI_CENTRO_CUSTO

INI_CAP_RECEP

INI_CFPS

INI_IND_ESTATISTICO

INI_VL_ABAT

INI_TP_REPASSE

INI_CPRB

INI_COD_SERV_INTERNO

INI_COD_BENEF

INI_SEQ_EX

INI_COD_GRP_PROD *

 

INI_COD_ORG_PROD

 

Campo preenchido valor Default:

INI_MANDT = INF_MANDT

 

ITG_NF_IMPOSTO

Campos sem preenchimento:

IIP_MANDT

IIP_COD_CONT_SOC_APUR

IIP_COD_TP_CREDITO

IIP_COD_BASE_CALC_CREDITO

IIP_QTDE_ALIQ

IIP_QTDE_BC

IIP_COD_TRIBUTACAO

IIP_IND_SOMA_TOT_NF

 

Campo preenchido valor Default:

IIP_MANDT = INF_MANDT

 

Importante:

 

  • A criação de Cenário é obrigatória para uso do Integrador de XML
  • A criação de Transformações De x Para é opcional, o cliente pode fazer o saneamento das informações diretamente no banco, por rotinas ou processos internos, antes de processar os dados para as tabelas definitivas pelo processo de interface.

 

   A tela de Transformação De x Para

 

   Contém as opções de Criar, Incluir, Editar,  Salvar  e Excluir uma Transformação conforme a necessidade do usuário.

 

4 - Na Tela de Sistemas remotos devem ser criado(s) o Sistema(s) Remoto(s) e associados a Extração "Integrador XML | XML"

 

Importante:

 

  • O Diretório definido no Cenário, na Tela "Integrador XML | ETL" é a fonte oficial de onde os XML serão lidos.
  • Pode ser criado apenas um Sistema e nele processado todos os cenários criados anteriormente porem recomendamos que seja definido um sistema para cada Cenário criado, para facilitar a identificação de que Cenário está associado a cada tarefa, e também permitir que mais de um Cenário, seja executado simultaneamente.

 

5 - Na tela de "Extrações de Dados", criar as execuções ou agendamentos para a execução do Integrador de XML, para a carga dos dados. Para criar a tarefa deve ser selecionado o Cenário dos documentos a serem carregados:

 

  • Obs.: Caso o cenário cadastrado não esteja disponível na lista,  e ele seja um novo Cenário, basta abrir novamente a tela de "Extrações de Dados" e a lista será carregada com todos os cenários cadastrados.

 

 

 

Evolução na opção de "DOWNLOAD / UPLOAD" que atendia apenas arquivos TXT e   atenderá também os arquivos XML

 

Versões Tratadas

4.00.00.0000


Pré-Requisitos

Produto:

Nota

Descrição

Componente de Interface Notas Fiscais Indiretos: Ajuste campo TP_REPASSE; Configuração das Interfaces > Edição em Lote: Ajustado o código do programa para evitar erro; Melhoria no Sistema Remoto de origem SAP PI_PO: Criação campo para não validar certificados; Evolução na Extração e Interface para empresas do ramo OIL: Criação campo IIO_POSSUI_GLP mais mapeamento e nova versão nos Indiretos; Processo de Controle de Vigência de Produtos e Parceiros: Criação de novos parâmetros.


Pacotes de Atualizaçã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:

 

  • Componentes ETL/Comply: Nota 014566

 

 

3. Com os pré-requisitos atualizados, aplicar o Pacote de Requisições nesta Nota:

 

 

01 - 710283 - ETL_DIC_CREATE_TABLE_ETL_XML_CENARIO_339171

02 - 710284 - ETL_APL_CREATE_BO_ETL_XML_CENARIO_339171

03 - 710285 - ETL_DIC_CREATE_TABLE_ETL_XML_CONVERSAO_339171

04 - 710257 - ETL_APL_CRT_BO_TRA_INTEGRADOR_XML_ETL_338516

05 - 710253 - ETL_DLL_INTEGRADOR_XML_336141

06 - 710333 - ETL_DTA_INSERT_ETL_MAPPING_340347

07 - 710351 - ETL_DLL_INTEGRADOR_XML_336141

08 - 710367 - ETL_DLL_INTEGRADOR_XML_CONT_336141

09 - 710426 - ETL_DLL_INTEGRADOR_XML_FUNC_336141

10 - 710449 - ETL_DLL_AJUSTES_INTEGRADOR_XML_338252

11 - 710507 - ETL_DLL_AJT_INTEGRADOR_XML_CTR_338252

12 - 710526 - ETL_DLL_INTEGRADOR_XML_MOD55_PARC_TR_338252

13 - 710549 - ETL_DLL_INTEGRADOR_XML_AJUSTE_CAL_IMP_338252

14 - 710599 - ETL_DLL_INTREGRADOR_XML_AJUSTES_341813

15 - 710688 - ETL_DLL_INTREGRADOR_XML_AJUSTES_342733

16 - 710727 - ETL_DLL_INT_XML_LOG_DEL_PAINEL_342733

17 - 710741 - ETL_DTA_INSERT_ETL_MAPPING_343850

 

4. Parar o serviço do componente framework Sonda;

5. Iniciar o serviço do componente framework Sonda.