+

MD.050 PROJETO FUNCIONAL DE

EXTENSÃO DO APLICATIVO

2018ULGZIDE/000082 2018_RELEASE OBRIGAÇÃO

SPED E APLICAÇÃO SYNCHRO

Autor: Marcos Yukio Akiama

Data de Criação: 10-JAN-2018
Última Atualização: 10-JAN-2018
Versão: 1.0

Aprovações: Nome do Responsável Assinatura Data

1. Funcional CCO Marcos Yukio Akiama

2. Coordenador CCO Edivandro Dias da Silva

3. Funcional TI Margarete Paulino Aguiar

4. Coordenador TI Marcelo Gelesov

5. Desenvolvimento ERP Claudio Monegatto

Controle de Documento

Gap Origem

Nome Função

Registro de alterações:

Data Autor Versão Referência da alteração

10/01/2018 Marcos Yukio Akiama 1.0 Criação do documento

Revisores

Nome Função

Distribuição

Copia Nome Local

No.

1
2
3
4

Nota para o Proprietário:

Se você receber uma cópia eletrônica deste documento e imprimi-la, por favor escreva
seu nome no respectivo campo na capa para controle de documento.
Se você receber uma cópia impressa deste documento, por favor escreva seu nome na
capa, para controle de documento.

Página ii de xx
Conteúdo

CONTROLE DE DOCUMENTO______________________________________________________________II
TÓPICOS______________________________________________________________________________4
Situação atual_______________________________________________________________________5
Necessidades Básicas do Negócio_______________________________________________________5
Principais Características_____________________________________________________________6
Funcionalidade 1 – Criação de tela para cadastro de código IBGE (estúdio)____________________6
Funcionalidade 2 – Criação de tabela para armazenamento de código IBGE x RI (estúdio)_________8
Funcionalidade 3 – Criação de concurrent para preenchimento de código IBGE RI (estúdio)_______9
Funcionalidade 4 – Criação de validação / retenção de RI sem código IBGE (CCO e estúdio)_____11
Funcionalidade 5 – Criação de personalização para preenchimento automático de códigos de
município (estúdio)________________________________________________________________13
Funcionalidade 6 – Alteração nas view CAIBR (estúdio)__________________________________14
Funcionalidade 7 – Inclusão / Validação de novos tipos de frete (CCO e Estúdio)_______________15
Procedimento do Usuário____________________________________________________________18
Premissas_________________________________________________________________________18
Plano de Testes_____________________________________________________________________18
Overview Técnico___________________________________________________________________19
Considerações____________________________________________________________________19
Pendências abertas__________________________________________________________________20
Pendências fechadas________________________________________________________________20

Página iii de xx
Tópicos

2018ULGZIDE/000082 2018_RELEASE OBRIGAÇÃO SPED E

APLICAÇÃO SYNCHRO – Consiste na adequação do módulo
Oracle Recebimento Integrado (RI) para que sejam inseridos os
códigos IBGE para cidades Origem e Destino no processo CT-e
de forma automática ou manual.

O GAP contém:
 Criação de tela para cadastro de código IBGE onde serão
cadastrados os códigos das cidades, segundo o IBGE, quando
houver entrada manual no RI;
 Criação de tabela para armazenamento de código IBGE x RI,
onde deverão ser armazenados os códigos das cidades
juntamente com o ID do RI;
 Criação de concurrent para preenchimento de código IBGE
para registros via Open Interface, para inserir automaticamente
os códigos de cidades, efetuando a busca de informações no
sistema Triangulus;
 Criação de validação / retenção de RI sem código IBGE para
que Recebimentos do processo CT-e sem os códigos de cidades
fiquem em retenção, independentemente do tipo de entrada
(automática ou manual);
 Criação de personalização para preenchimento automático de
códigos de município quando a entrada for manual;
 Alteração nas view CAIBR, para que essas informações sejam
disponibilizadas no sistema Synchro;
 Inclusão / Validação de novos tipos de frete, inserindo novos
códigos na lista de valores do tipo de frete e fazendo a tratativa
para que essas informações sejam disponibilizadas corretamente
no CTM-S.

Página 4 de 20
Situação atual
Atualmente as informações de código IBGE das cidades não são enviadas para o sistema
Synchro e SPED nos processos de frete (CT-e).

Necessidades Básicas do Negócio

A finalidade desse GAP é atender a uma nova obrigatoriedade fiscal (Ato COTEPE/ICMS
09/2008 - guia prático EDF-ICMS/IPI - versão 2.0.21), onde todas as Notas Fiscais referentes a
processos de frete recebidas nas filiais da Ultragaz e Bahiana, possuam os códigos IBGE das
cidades de origem e destino.
Essas informações são obrigatórias no SPED a partir de 01/02/2018.

Página 5 de 20
Principais Características

Funcionalidade 1 – Criação de tela para cadastro de código IBGE (estúdio)

 Uma nova tela (form) deve ser criada no Oracle RI, dentro da funcionalidade ZOOM do
cabeçalho da entrada de notas fiscais (form RECMNINV):

 Deve ser criada uma opção no ZOOM chamada Códigos de Município IBGE;
 Essa opção deve ficar disponivel apenas quando o campo :REC_INVOICES.
FISCAL_DOCUMENT_MODEL do form RECMNINV for do tipo CT%E%;
 Os campos de Estados e Cidades devem ser obrigatórios somente quando o
campo :REC_INVOICES. FISCAL_DOCUMENT_MODEL do form RECMNINV for do tipo
CT%E%;
 A tela também deve estar disponível e seus campos obrigatórios no form core RECMNIFR.
Porém esse form será habilitado somente quando o campo : REC_ENTRY_OPERATIONS.
FREIGHT_FLAG do form core RECINENT for igual à “F”;
 Essa nova tela deve exibir um aviso ao usuário para salvar os registros, caso o usuário

ainda não tenha salvo através do botão ;

Página 6 de 20
  Uma lista de valores para Estados deve ser criada. Utilizar a consulta abaixo para criação
da lista de valores:

SELECT LOCATION_SEGMENT_VALUE COD_ESTADO,

LOCATION_SEGMENT_DESCRIPTION ESTADO,
LOCATION_SEGMENT_ID ID_ESTADO
FROM APPS.AR_LOCATION_VALUES
WHERE LOCATION_SEGMENT_QUALIFIER = 'STATE'
AND ATTRIBUTE_CATEGORY IS NULL
ORDER BY 1, 2;
 Uma lista de valores para Cidades deve ser criada, porém somente as cidades do estado
selecionado (tópico acima) deverão ser retornados. Utilizar a consulta abaixo para criação
da lista de valores:

SELECT LOCATION_SEGMENT_VALUE CIDADE,

ATTRIBUTE11 COD_IBGE
FROM APPS.AR_LOCATION_VALUES
WHERE PARENT_SEGMENT_ID = :P_ID_ESTADO
ORDER BY 1;
 O layout proposto para a nova tela (form) foi sugerido em conjunto pela TI UG e CCO
Ultragaz:

Maquina Aplicação  ugbrmtzvlx030

Usuário/senha: applprod/W@lcome01

Página 7 de 20
Funcionalidade 2 – Criação de tabela para armazenamento de código IBGE x RI (estúdio)

 Para gravação dos códigos IBGE inseridos na tela (funcionalidade 1), será necessária a
criação de uma nova tabela customizada;
 Como sugestão, o nome da tabela pode ser CSTU_COD_IBGE_RI;
 Essa tabela deve conter os seguintes campos:
 INVOICE_ID – Tipo numérico, cujo valor deve ser recuperado do
campo :REC_INVOICES.INVOICE_ID do form RECMNINV ou do
campo :REC_INVOICES. INVOICE_ID do form RECMNIFR (quando a nova tela
for acessada por esse form);
 COD_IBGE_ORIGEM – Tipo numérico, cujo valor deve ser recuperado do campo
Cidade e bloco ORIGEM da nova tela;
 COD_IBGE_DESTINO – Tipo numérico, cujo valor deve ser recuperado do campo
Cidade e bloco ORIGEM da nova tela;

 Os campos são apenas uma sugestão, podendo o estúdio, criar da forma que considerar
mais apropriada (inclusive incluindo novas colunas).

Página 8 de 20
Funcionalidade 3 – Criação de concurrent para preenchimento de código IBGE RI (estúdio)

 Todos os registros enviados pelo sistema CTMS devem preencher automaticamente os

códigos IBGE da tabela CSTU_COD_IBGE_RI (funcionalidade 2), porém os códigos de
Estado e Cidade devem ser exibidos na tela de cadastro (funcionalidade 1);
 Para esse preenchimento, um novo concurrent com o nome “Preenchimento de Códigos
IBGE” deve ser criado e incluído como estágio 15 no conjunto de valores “Processa
Interface e Aprovação do RI para Gestão de Fretes”;
 Esse concurrent deverá buscar, via chave eletrônica, as informações de código de IBGE no
sistema Triangulus para RI’s com qualquer origem (REC_ENTRY_OPERATIONS.SOURCE)
CTMS;
 A chave eletrônica deve ser recuperada seguindo a lógica abaixo:
 Executar a consulta abaixo:

SELECT INVOICE_ID
FROM APPS.REC_FREIGHT_INVOICES
WHERE ELETRONIC_INVOICE_KEY = :P_CHAVE_ELETRONICA;

 Caso nenhum registro seja encontrado, executar a consulta abaixo:

SELECT INVOICE_ID
FROM APPS.REC_INVOICES
WHERE ELETRONIC_INVOICE_KEY = :P_CHAVE_ELETRONICA;

Página 9 de 20
 Utilizar as consultas abaixo para retorno das informações:
 Códigos IBGE de Origem:

SELECT INF.IDE_CMUNINI COD_ORGIEM_IBGE,

ARV.LOCATION_SEGMENT_VALUE CIDADE_ORIGEM,
ARV1.LOCATION_SEGMENT_VALUE ESTADO_ORIGEM
FROM NFE_SYS.ICTF01_INF INF,
APPS.AR_LOCATION_VALUES ARV,
APPS.AR_LOCATION_VALUES ARV1
WHERE INF.IDE_CMUNINI = ARV.ATTRIBUTE11
AND ARV.PARENT_SEGMENT_ID = ARV1.LOCATION_SEGMENT_ID
AND INF.INFCTE_ID = 'CTe'||:P_CHAVE_ELETRONICA;

 Códigos IBGE de Destino:

SELECT INF.IDE_CMUNFIM COD_DESTINO_IBGE,

ARV.LOCATION_SEGMENT_VALUE CIDADE_DESTINO,
ARV1.LOCATION_SEGMENT_VALUE ESTADO_DESTINO
FROM NFE_SYS.ICTF01_INF INF,
APPS.AR_LOCATION_VALUES ARV,
APPS.AR_LOCATION_VALUES ARV1
WHERE INF.IDE_CMUNFIM = ARV.ATTRIBUTE11
AND ARV.PARENT_SEGMENT_ID = ARV1.LOCATION_SEGMENT_ID
AND INF.INFCTE_ID = 'CTe'||:P_CHAVE_ELETRONICA;

 Caso qualquer uma das informações (COD_ORIGEM_IBGE ou COD_DESTINO_IBGE) não

sejam localizadas, os RI’s deverão ficar com status EM RETENÇÃO, detalhados no próximo
tópico deste documento;

Página 10 de 20
Funcionalidade 4 – Criação de validação / retenção de RI sem código IBGE (CCO e estúdio)

 Um novo código de retenção deve ser criado no RI pelo analista funcional do CCO –
Ultragaz. Esse código deve ser criado da seguinte forma:

 Novas validações devem ser criadas no momento da aprovação dos RI’s de forma
automática e manual. Caso qualquer uma das informações (COD_ORIGEM_IBGE ou
COD_DESTINO_IBGE) não sejam localizadas, os RI’s deverão ficar com status EM
RETENÇÃO (IN HOLD);
 Aprovações de forma automática ocorrem através do concurrent “Aprovação do RI
para Conhecimentos de Fretes (CSTU)”. Este concurrent faz parte do conjunto de
solicitações “Processa Interface e Aprovação do RI para Gestão de Fretes”;

 Aprovações manuais ocorrem através do botão do form

core RECINENT;
* DICA IMPORTANTE: existe uma package core chamada REC_CHECK_HOLDS_PKG
que faz todo o controle das retenções do RI, porém há algumas packages customizadas que
fazem tratativas e, ao final, utilizam a REC_CHECK_HOLDS_PKG. É necessário que o
estúdio avalie em qual das packages essas retenções deverão ser incluídas.

Página 11 de 20
  Exemplo para fazer a retenção do RI:

REC_CHECK_HOLDS_PKG.INCLUIR_ERRO_HOLD( P_OPERATION_ID ,
P_ORGANIZATION_ID ,
V_LOCATION_ID ,
'INV IBGE CODES' ,
V_INVOICE_ID ,
NULL);

 RI com status EM RETENÇÃO (IN HOLD) deverão permitir que o usuário, manualmente,
faça a inclusão dos códigos IBGE na tela de cadastro (funcionalidade 1);
 Somente RI’s com origem CTMS (REC_ENTRY_OPERATIONS.SOURCE) deverão ter o

botão do form core RECINENT desabilitado e seu status deve ser

alterado para INCOMPLETO (INCOMPLETE), ou seja, quando o usuário inserir os códigos
e fechar a tela de cadastro (funcionalidade 1), deve haver uma validação da origem desse
RI. Caso seja CTMS, o botão de aprovação deve ser desabilitado e o seguinte update deve
ser executado de forma automática:

UPDATE REC_ENTRY_OPERATIONS
SET STATUS = 'INCOMPLETE',
GL_DATE = TRUNC(SYSDATE),
RECEIVE_DATE = TRUNC(SYSDATE)
WHERE OPERATION_ID = :P_NUM_RI
AND ORGANIZATION_ID = :P_ID_FILIAL
AND SOURDE LIKE 'CTMS%'
AND STATUS <> 'COMPLETE';

Página 12 de 20
Funcionalidade 5 – Criação de personalização para preenchimento automático de códigos de
município (estúdio)

 Visando minimizar os erros cometidos ao dar entrada manual, será necessário a criação de
um processo em que os códigos IBGE são preenchidos automaticamente quando o usuário
salvar os registros conforme lógica abaixo:
 Verificar o campo :REC_ENTRY_OPERATIONS.FREIGHT_FLAG do form core
RECINENT;
o Caso seja “F”: Verificar o valor do campo :REC_FRE_IN.
FISCAL_DOCUMENT_MODEL do form RECMNIFR. O preenchimento
automático deve ter início ao salvar dados nesse form core;
o Caso seja “N”: Verificar o valor do campo :REC_INVOICES.
FISCAL_DOCUMENT_MODEL do form RECMNINV. O preenchimento
automático deve ter início ao salvar dados nesse form core;
 Somente RI’s com origem do tipo CT%E% devem ter o preenchimento automático;
 As regras de preenchimento seguem a mesma lógica do concurrent “Preenchimento de
Códigos IBGE” (funcionalidade 3);
 A chave eletrônica deve ser recuperada dos campos, conforme o form em que a nova tela
de cadastro será acessada. Segue abaixo:
 Acesso da tela de cadastro via form core RECMNINV:
o Bloco: REC_INVOICES.ELETRONIC_INVOICE_KEY
 Acesso da tela de cadastro via form core RECMNIFR:
o Bloco: REC_FRE_IN. ELETRONIC_INVOICE_KEY
 Utilizar as consultas abaixo para retorno das informações:
 Códigos IBGE de Origem:

SELECT INF.IDE_CMUNINI COD_ORGIEM_IBGE,

ARV.LOCATION_SEGMENT_VALUE CIDADE_ORIGEM,
ARV1.LOCATION_SEGMENT_VALUE ESTADO_ORIGEM
FROM NFE_SYS.ICTF01_INF INF,
APPS.AR_LOCATION_VALUES ARV,
APPS.AR_LOCATION_VALUES ARV1
WHERE INF.IDE_CMUNINI = ARV.ATTRIBUTE11
AND ARV.PARENT_SEGMENT_ID = ARV1.LOCATION_SEGMENT_ID
AND INF.INFCTE_ID = 'CTe'||:P_CHAVE_ELETRONICA;

Página 13 de 20
  Códigos IBGE de Destino:

SELECT INF.IDE_CMUNFIM COD_DESTINO_IBGE,

ARV.LOCATION_SEGMENT_VALUE CIDADE_DESTINO,
ARV1.LOCATION_SEGMENT_VALUE ESTADO_DESTINO
FROM NFE_SYS.ICTF01_INF INF,
APPS.AR_LOCATION_VALUES ARV,
APPS.AR_LOCATION_VALUES ARV1
WHERE INF.IDE_CMUNFIM = ARV.ATTRIBUTE11
AND ARV.PARENT_SEGMENT_ID = ARV1.LOCATION_SEGMENT_ID
AND INF.INFCTE_ID = 'CTe'||:P_CHAVE_ELETRONICA;

 Caso qualquer uma das informações (COD_ORIGEM_IBGE ou COD_DESTINO_IBGE) não

sejam localizadas, os RI’s deverão ficar com status EM RETENÇÃO (funcionalidade 4);

Funcionalidade 6 – Alteração nas view CAIBR (estúdio)

 Com a inclusão dos campos código IBGE, torna-se necessária a integração dessas
informações no sistema Synchro;
 Deve-se alterar a view core “CAIBR_REC_NFE_V”. É necessária a inclusão da tabela
CSTU_COD_IBGE_RI (funcionalidade 2). O join deve ser feito através da tabela
REC_INVOICES, pelo campo INVOICE_ID, porém deve-se utilizar um alter join (+), visto
que nem todos os registros da REC_INVOICES estarão na CSTU_COD_IBGE_RI. Abaixo
um exemplo de como o join entre as tabelas deve ser feito:

SELECT *
FROM APPS.REC_INVOICES RI,
CSTU.CSTU_COD_IBGE_RI CCI
WHERE RI.INVOICE_ID = CCI.INVOICE_ID (+);

 Após a inclusão da tabela CSTU_COD_IBGE_RI na view CAIBR_REC_NFE_V, deve-se

incluir as colunas COD_IBGE_ORIGEM e COD_IBGE_DESTINO para exibição;
 É necessária uma alteração no processo de carga Oracle EBS x Synchro. A carga é realizada
pela procedure “EXPBR_SYN_FIS_DOF_E_PRC” que tem sua chamada no processo
“EXPBR_SYN_FIS_EXE_CARGA_PRC”;

 Nesta procedure (EXPBR_SYN_FIS_DOF_E_PRC), os campos COD_IBGE_ORIGEM e

COD_IBGE_DESTINO devem ser inseridos na tabela CAI.EXPBR_SYN_FIS_DOF_TAB,
conforme abaixo:

Página 14 de 20
 Tabelas
CSTU.CSTU_COD_IBGE_RI CAI.EXPBR_SYN_FIS_DOF_TAB
Coluna COD_IBGE_ORIGEM MUN_COD_ORIGEM
s COD_IBGE_DESTINO MUN_COD_DESTINO

Funcionalidade 7 – Inclusão / Validação de novos tipos de frete (CCO e Estúdio)

 Para o funcionamento correto de todo este projeto, existe a necessidade da criação de novos
códigos de Transporte. O analista funcional do CCO Ultragaz deve fazer a criação da
seguinte forma:

 Devem ser incluídos os códigos abaixo:

 3 - Transporte Próprio por conta do Remetente – CIF CP

Página 15 de 20
 Descrição: Transporte Próprio por conta do Remetente

 4 - Transporte Próprio por conta do Destinatário – FOB CP

Descrição: Transporte Próprio por conta do Destinatário

 Deve ser criada uma tratativa, onde os códigos 3 e 4 criados acima, tenham as mesmas
funcionalidades dos códigos 0 e 1 já existentes, conforme correspondência abaixo:

Página 16 de 20
 Correspondent
Código Criado
e
3 0
4 1

 O form core RECINENT possui alguns flexfields que são dependentes dos códigos antigos
e que precisam manter essa mesma lógica de dependência com os novos códigos criados.
Segue abaixo o print da tela e, no campo “Responsável pelo Pagamento”, está o código que
será o início de todas as validações posteriores:

 Também é necessária uma alteração na trigger customizada

“CSTU_REC_CARGA_INTFC_CTMS_R_BU”, incluindo os códigos criados (3 e 4) e
respeitando a correspondência acima definida;
 Verificar também o processo “EXPBR_SYN_FIS_DOF_E_PRC”, pois existem validações de
código de transporte e os novos códigos criados (3 e 4) devem ser inseridos e receber a
devida tratativa.

Procedimento do Usuário
O usuário deve fazer o recebimento de Notas Fiscais de frete ou Notas Fiscais com frete
agregado.

Página 17 de 20
 Porém o preenchimento do código IBGE e migração para o Synchro deve ocorrer
automaticamente para os recebimentos importados via Open Interface, exceto os casos em que,
devido à falta do código IBGE, os recebimentos possuam o status “EM RETENÇÃO”.

Premissas
N/A

Análise de Impacto
Com a implantação do projeto, todos os requisitos do Ato COTEPE/ICMS 09/2008 - guia
prático EDF-ICMS/IPI - versão 2.0.21 serão atendidos.

Plano de Testes
Descrito no PET.

Página 18 de 20
Overview Técnico

Considerações
Se alguma tabela, função ou objeto do Oracle e-Business Suite mudar em
versões futuras, componentes desta customização podem requerer
alterações para funcionarem corretamente. Avaliar o impacto de tais
alterações na solução customizada é uma atividade de
responsabilidade da Ultragaz, embora serviços do CCO ou serviços de
consultoria adicionais possam ser contratados para auxiliar a avaliação,
antes de atualizações e/ou correções, caso se façam necessárias.
Importante: O Overview Técnico visa facilitar e agilizar o
desenvolvimento da solução e a elaboração do MD-70 -
Especificação técnica. Sendo assim, não é necessário que
a Ultragaz realize validação desse tópico, incluso no
documento.

Todas as consultas / atualizações necessárias foram descritos nos tópicos de funcionalidade

deste documento.

Página 19 de 20
Pendências abertas e fechadas para este documento.

Pendências abertas

ID Pendência Solução Responsabilidade Data Meta Data de

Impacto

Pendências fechadas

ID Pendência Solução Responsabilidade Data Meta Data de

Impacto

Página 20 de 20