CLL F509 Ug PTB

Fazer download em pdf ou txt
Fazer download em pdf ou txt
Você está na página 1de 74

LAD Consulting Localizations

Brazilian Credit Bureau Integration


(CLL F509)

Manual do Usuário

RELEASE 12.0.6

Versão 5

DISCLAIMER:

CURRENTLY, ORACLE OFFERS CERTAIN RESALABLE ASSETS OR OTHER DEFINED SERVICE


DELIVERABLES (COLLECTIVELY REFERRED TO AS "SERVICE DELIVERABLES") UNDER A LIMITED
USE LICENSE. THE SERVICE DELIVERABLES CURRENTLY INCLUDE, BUT ARE NOT LIMITED TO,
ORACLE INTEGRATION HUB. YOU AGREE THAT :

(i) SERVICE DELIVERABLES ARE NOT ORACLE STANDARD SOFTWARE PROGRAMS,


(ii) TECHNICAL SUPPORT FOR SERVICE DELIVERABLES IS NOT AVAILABLE FROM OR UNDER, OR
PROVIDED BY OR THROUGH, ORACLE'S SUPPORT SERVICES ORGANIZATION OR YOUR ORACLE
PROGRAM LICENSE AGREEMENT,
(iii) YOUR RIGHT TO USE AND RECEIVE SUPPORT SERVICES FOR SERVICE DELIVERABLES IS
SOLELY AS DESCRIBED IN YOUR CONTRACT FOR SUCH SERVICE DELIVERABLES, AND
(iv) A SERVICE REQUEST REGARDING SERVICE DELIVERABLES, REGARDLESS OF HOW INITIATED
OR LOGGED, WILL BE ADDRESSED IN ACCORDANCE WITH THE TERMS OF YOUR CONTRACT FOR
SUCH SERVICE DELIVERABLES.
Controle do Documento

Registro de Alterações

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

Valéria de Souza Zana /


02-Mar-15 1 Criação do Documento - RELATO
Luiz Gustavo Fontes
14-May-15 Luiz Gustavo Fontes 2 Inclusão do processo de conciliação
21-May-15 Rafaela Rodrigues 3 Inclusão da funcionalidade PEFIN
07-jan-16 Rodrigo Naves 4 Inclusão de informações de CONFIE
17-Aug-16 Valéria de Souza Zana 5 Inclusão de detalhes sobre CONFIE – tela de parâmetros e
exemplo de chamada da API Pública de comunicação com a
SERASA

Revisores

Nome Função

Ketter Rogerio Localizations Manager


Valéria de Souza Zana Localizations Senior Application Engineer

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 2
Conteúdo

Controle do Documento ............................................................................................................. 2

Prefácio 5

O Manual ................................................................................................................................... 6
Como Usar este Manual ...................................................................................................... 6
Documentos Relacionados .................................................................................................. 7
Comentários/Sugestões ....................................................................................................... 7

CAPÍTULO 1 Introdução ................................................................................................................................ 8

Brazilian Credit Bureau Integration ........................................................................................... 9


Premissas ............................................................................................................................ 9
Conceito .............................................................................................................................. 9
RELATO .......................................................................................................................... 10
PEFIN ............................................................................................................................... 11
CONFIE ............................................................................................................................ 12

CAPÍTULO 2 Configuração .......................................................................................................................... 13

Opções de Perfil....................................................................................................................... 14

RELATO.................................................................................................................................. 15
Sequência de Implementação ............................................................................................ 15
Diretório Unix................................................................................................................... 15
Informações de Empresa ................................................................................................... 16
Associação de Origens do Lote por Unidade Operacional ............................................... 16
Extensão no Endereço da Conta do Cliente ...................................................................... 17
Extensão na Configuração do Tipo de Transação ............................................................. 19
Parâmetros Iniciais............................................................................................................ 21
PEFIN ...................................................................................................................................... 23
Sequência de Implementação ............................................................................................ 23
Diretório Unix................................................................................................................... 23
Informações de Empresa ................................................................................................... 24
Associação de Origens do Lote por Unidade Operacional ............................................... 24
Extensão no Endereço da Conta do Cliente ...................................................................... 26
Extensão na Configuração do Tipo de Transação ............................................................. 28
Parâmetros Iniciais............................................................................................................ 30
CONFIE ................................................................................................................................... 32
Sequência de Implementação ............................................................................................ 32
1. Acesso na camada de aplicação ao endpoint do serviço da SERASA .......................... 32
2. Informações de empresa ............................................................................................... 33

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 3
3. Parâmetros iniciais ........................................................................................................ 33
4. Business Event .............................................................................................................. 36
5. Public API .................................................................................................................... 37

CAPÍTULO 3 Processos ................................................................................................................................. 38

RELATO.................................................................................................................................. 39
Remessa - Títulos a receber com vencimento futuro ........................................................ 39
Remessa - Liquidação total de títulos ............................................................................... 39
Remessa - Liquidação parcial de títulos ........................................................................... 39
Remessa - Ajustes realizados em títulos a receber referentes a devoluções totais e
cancelamentos ................................................................................................................... 40
Remessa - Ajustes realizados em títulos a receber referentes a devoluções parciais ........ 40
Remessa - Ajustes realizados em títulos a receber referentes a descontos concedidos e
acréscimos ........................................................................................................................ 41
Remessa - Registro de informações sobre “Tempo de Relacionamento” com clientes..... 41
Remessa - Geração de arquivo de remessa através de tela específica ............................... 42
Remessa - Geração de arquivo de remessa através de solicitação concorrente ................. 45
Retorno ............................................................................................................................. 46
Consulta da Remessa ........................................................................................................ 48
Reprocessamento da Remessa .......................................................................................... 50
Processo de Conciliação ................................................................................................... 52
PEFIN ...................................................................................................................................... 54
Remessa ............................................................................................................................ 54
Remessa - Geração de arquivo através de tela específica ................................................. 55
Remessa - Geração de arquivo através de solicitação concorrente ................................... 59
Remessa de Ocorrências ................................................................................................... 60
Remessa de Ocorrências - Geração de arquivo através de tela específica ........................ 61
Remessa de Ocorrências - Geração de arquivo através de solicitação concorrente .......... 63
Retorno ............................................................................................................................. 65
Histórico de Ocorrências .................................................................................................. 66
Histórico de Ocorrências - Solicitação manual de exclusão de título no PEFIN .............. 68
CONFIE ................................................................................................................................... 71
Public API ........................................................................................................................ 71

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 4
Prefácio

Este manual inclui informações necessárias para implementação e utilização do CLL-F509


Brazilian Credit Bureau Integration no que diz respeito a solução para atender a integração com a
SERASA:

 RELATO: Relatório de Comportamento de Negócios – Versão Maio/2015

o RELATO Reciprocidade – Layout Simplificado de Remessas e Retornos Normais


SERASA Experian.

o Conciliação – Processo mensal de conciliação de titulos em aberto e liquidados


entre a empresa e a SERASA Experian.

 PEFIN: Pendências Financeiras – Versão Março/2014

o RK - CONVEM – Layout PEFIN.

 CONFIE: Confirmação e Monitoramento Fiscal Eletrônico

o Layout String Consulta (150 bytes) – Versão Março/2011

Os layouts contém informações detalhadas sobre:

 Visão geral e informações de referência.

 Funções específicas que você pode executar com o CLL-F509 Brazilian Credit Bureau
Integration.

 Como utilizar as telas.

 Programas do CLL-F509 Brazilian Credit Bureau Integration.

 Funções e características.

 O prefácio mostra como este manual é organizado e introduz outras fontes de informação que
podem ajudá-lo a usar o CLL-F509 Brazilian Credit Bureau Integration.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 5
O Manual
Este capítulo contém informações importantes referentes à estrutura do manual.

Como Usar este Manual

Você deverá usar o Manual do CLL-F509 Brazilian Credit Bureau Integration quando estiver
procurando informações específicas da localização para o Brasil referente as integrações entre
Oracle e SERASA. Encontrará informações detalhadas de cada tela, bem como de suas respectivas
áreas e campos. Algumas convenções foram utilizadas para fazer este manual fácil de ser lido e
entendido.

Descrições dos Campos


A descrição dos forms do CLL-F509 Brazilian Credit Bureau Integration inclui explicações de
cada campo do form. Abaixo é demonstrado o padrão adotado no manual para descrever a
funcionalidade do campo:

Fornecedor Obrigatório Pick,Edit

No exemplo acima, o nome do campo é Fornecedor, a característica é Obrigatória e o campo pode


ser acessado através de uma lista de valores (LOV).

Características dos Campos


Existem vários tipos de características, e são variados conforme a função do campo:

Requerido Necessário entrar com um valor para o campo, antes de


salvar suas alterações.

Opcional Pode ou não entrar com um valor para o campo.

Condicional, Requerido Dependendo de alguma circunstância, você deve entrar com


um valor para o campo, antes de navegar para o próximo ou
salvar suas alterações.

Exibir Somente Não permite alterações do valor do campo. O CLL-F509


Brazilian Credit Bureau Integration utiliza estes campos
para exibir informações.

Sugerido, Obrigatório O CLL-F509 Brazilian Credit Bureau Integration


automaticamente entra com um valor para o campo,
podendo ser alterado caso necessário.

Forma de Edição/Acesso
A forma de edição/acesso aos campos é:

Pick O campo será preenchido apenas por uma lista de valores


pertinentes ao campo.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 6
Edit O campo permite entrada de dados definida pelo usuário.

Campos Flexíveis (Descriptive Flexfield)


Algumas telas do CLL-F509 Brazilian Credit Bureau Integration exibem campos flexíveis (DF),
indicados por colchetes. São usados para registrar informações específicas, requeridas ao negócio
do cliente.

Documentos Relacionados

Informações técnicas do CLL-F509 Brazilian Credit Bureau Integration podem ser encontradas no
manual técnico disponível no metalink.

Para complementar as informações contidas neste documento, foram feitas indicações pontuais de
consultas a outros manuais disponíveis no metalink.

Comentários/Sugestões

LAD Add-on Localization desenvolveu este manual para o auxiliar na implantação e utilização do
produto e também valoriza seus comentários/sugestões para aprimoramento da documentação.
Seus comentários e sugestões devem ser enviados para análise pela abertura de Services Requests
no My Oracle Support para o produto LAD Add-on Localization. Caso sejam aprovados, serão
incluídos em versões futuras.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 7
CAPÍTULO

1 Introdução

E ste capítulo descreve as premissas e conceitos básicos para implementação e utilização das
funcionalidades disponíveis para troca de informações com a SERASA.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 8
Brazilian Credit Bureau Integration
LAD Consulting Localizations disponibilizou no Brasil uma solução com programas e telas, para
atender a requerimentos específicos e comuns nas integrações SERASA.

A solução, localizada para a área de Contas a Receber contempla:

 RELATO Reciprocidade – Layout Simplificado de Remessas/Retornos Normais e


Conciliação SERASA Experian de acordo com o Manual de Homologação de Maio/2015.

 RK - CONVEM – Layout PEFIN de Remessas, Remessas de Ocorrências e Retornos de


acordo com o Manual de Homologação de março/2014.

 WebService do Confie;

Toda configuração e procedimento de utilização serão detalhados neste manual para o


entendimento da solução a ser implementada no cliente.

Premissas

Este manual auxilia na implementação e utilização do CLL-F509 Brazilian Credit Bureau


Integration, não abordaremos as funcionalidades dos módulos Oracle Receivables e Oracle
Advanced Collections.

A seguir relacionamos informações sobre integrações SERASA e a forma pela qual descrevemos
os seus respectivos conteúdos.

Conceito

Foi adotada uma padronização na nomenclatura de alguns procedimentos/funcionalidades, para


facilitar a leitura e entendimento da solução localizada, conforme segue:

SERASA
A SERASA é uma empresa privada que possui um dos maiores bancos de dados do mundo e
dedica sua atividade à prestação de serviços de interesse geral. A instituição é reconhecida pelo
Código de Defesa do Consumidor como uma entidade de caráter público (Lei 8.078, artigo 43,
parágrafo 4º).

Em seus computadores são armazenados dados cadastrais de empresas e cidadãos e informações


negativas que indicam dívidas vencidas e não pagas e os registros de protesto de título, ações
judiciais, cheques sem fundos e outros registros provenientes de fontes públicas e oficiais. Os
dados de dívidas vencidas são enviados sob convênio com credores/fornecedores, indicando os
dados do devedor.
As informações da SERASA são fornecidas aos bancos, às lojas do comércio, às pequenas, médias
e grandes empresas, com o objetivo de dar apoio às decisões de crédito e, assim, tornar os
negócios mais baratos, rápidos e seguros.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 9
RELATO
Relatório de Comportamento em Negócios - É um relatório completo sobre as empresas
brasileiras, com dados cadastrais, de comportamento em negócios e a relação dessas instituições
com o mercado.

Permite uma análise ampla de pequenas e médias empresas, favorecendo a gestão de negócios, a
redução de fraudes e inadimplência, além de aumentar a rentabilidade na concessão de crédito.
Para consultar os dados, basta informar o CNPJ do cliente ou a razão social da empresa.

PEFIN
Pendências Financeiras - É uma lista com dados cadastrais dos clientes com seus respectivos
títulos vencidos.

A SERASA mantém um cadastro centralizado com informações de clientes inadimplentes das


empresas participantes com as informações atualizadas sobre o cadastro do seu cliente, pessoa
física ou jurídica, endereços para localização desse consumidor, fornecedor ou parceiro e telefones
de contato.

Além de disponibilizar dados para a localização do consumidor, viabiliza a comunicação com ele,
por meio da carta-comunicado e/ou boleto de cobrança, para facilitar e estimular a quitação da
dívida (Procedimentos não tratados pela funcionalidade descrita nesse Manual).

WebService
WebService é um padrão de comunicação usado para transferência de informações entre as
empresas e a SERASA (Confie).

Terminologia em Inglês
Termos no idioma Inglês foram aplicados em nomes de manuais, na navegação do produto e em
termos técnicos para facilitar o entendimento e localização dos dados ou registros.

RELATO
Detalhamento do processo de integração do RELATO:

CNPJ - Nos arquivos de remessa, no registro Header, consta o número do CNPJ da empresa, que é
obtido na configuração de Entitdade Legal do GL, utilizando as configuração de associação de
origem do lote e Unidade Operacional, definidos no CLL-F407 – Brazilian Fiscal Managment.

Nome da Empresa - Recuperado juntamente com o CNPJ, é utilizado para exibir na saída de
execução do processo concorrente dos processos de remessa e retorno.

Arquivos de remessa para o RELATO - Os programas disponíveis geram arquivos com


informações de títulos de clientes a vencer, recebimentos, devoluções e cancelamentos. Será
gerado um arquivo de remessa para cada grupo de estabelecimentos agrupados por CNPJ
configurados no CLL-F407 – Brazilian Fiscal Managment.

Arquivos de retorno do RELATO - Os programas disponíveis carregam arquivos enviados pela


SERASA resultantes do processamento dos arquivos de remessa.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 10
Arquivos de conciliação do RELATO - Os programas disponíveis carregam arquivos de
conciliação enviados mensalmente pela SERASA, verificam a liquidação ou não dos títulos em
aberto informados no arquivo e geram um novo arquivo informando a data de pagemento destes
títulos, caso estes tenham sido totalmente liquidados.

Acesso aos arquivos TXT - Para a leitura e gravação de arquivos, o CLL-F509 Brazilian Credit
Bureau Integration utiliza o utilitário UTL_FILE. Para termos sucesso no acesso aos arquivos
TXT que são gerados e processados é importante definir, juntamente com o DBA, os diretórios de
acesso aos mesmos para que ele possa cadastrá-los no arquivo init.ora, no parâmetro
UTL_FILE_DIR.

Geração de remessa para o RELATO – A geração de arquivos de remessa pode se dar através
da execução de programa concorrente específico para tal finalidade ou através de tela de remessa
criada para esta finalidade.

Importação do retorno do RELATO – Após cada processamento de um arquivo de remessa


realizado pela SERASA um arquivo de retorno é gerado contendo o resultado do processamento.
A importação deste arquivo para o EBS é realizada através de um programa concorrente criado
exclusivamente para esta funcionalidade.

PEFIN

Detalhamento do processo de integração do RELATO:

CNPJ - Nos arquivos de remessa, no registro Header, consta a raiz do número do CNPJ da
empresa (9 primeiras posições), que é obtido na configuração de Entitdade Legal do GL,
utilizando as configuração de associação de origem do lote e Unidade Operacional, definidos no
CLL-F407 – Brazilian Fiscal Managment.

Nome da Empresa - Recuperado juntamente com o CNPJ, é utilizado para exibir na saída de
execução do processo concorrente dos processos de remessa e retorno.

Arquivos de remessa para o PEFIN - Os programas disponíveis geram arquivos com


informações de títulos de clientes vencidos, considerando a quantidade de dias e valores, definidos
na tela de Parâmetros do PEFIN. Será gerado um arquivo de remessa para cada grupo de
estabelecimentos agrupados por CNPJ configurados no CLL-F407 – Brazilian Fiscal Managment.
O arquivo de remessa é identificado pela string “E” na linha de cabeçalho do arquivo. Nas linhas
de detalhes, a string “I” informa que o título está sendo incluído no PEFIN.

Arquivos de remessa de exclusão para o PEFIN - Os programas disponíveis geram arquivos


com informações de títulos de clientes, enviados anteriormente no processo de remessa e que
foram liquidados, sendo necessário a exclusão no PEFIN. Esse processo é denominado “Remessa
de Ocorrências” e é identificado pela string “E” na linha de cabeçalho do arquivo. Nas linhas de
detalhes, a string “E” informa que o título deve ser excluído do PEFIN.

Arquivos de retorno do PEFIN - Os programas disponíveis carregam arquivos enviados pela


SERASA resultantes do processamento dos arquivos de remessas. O arquivo de retorno é
identificado pela string “R” na linha de cabeçalho do arquivo. Quando o registro foi retornado com
erro, os códigos de erros com 3 posições, são enviados na linha de detalhes. Quando o retorno for
com sucesso, os espaços destinados aos códigos de erros estarão nulos.

Acesso aos arquivos TXT - Para a leitura e gravação de arquivos, o CLL-F509 Brazilian Credit
Bureau Integration utiliza o utilitário UTL_FILE. Para termos sucesso no acesso aos arquivos
TXT que são gerados e processados é importante definir, juntamente com o DBA, os diretórios de

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 11
acesso aos mesmos para que ele possa cadastrá-los no arquivo init.ora, no parâmetro
UTL_FILE_DIR.

Geração de remessa para o PEFIN – A geração de arquivos de remessa pode se dar através da
execução de programa concorrente específico para tal finalidade ou através de tela de remessa
criada para esta finalidade.

Geração de remessa de exclusão para o PEFIN – A geração de arquivos de remessa de


ocorrências se dá através da execução de programa concorrente específico para tal finalidade. Tem
como objetivo selecionar todos os títulos enviados anteriormente à SERASA que foram liquidados
pelo cliente. Também é possível fazer a inclusão manual da exclusão, utilizando a tela de Histórico
de Ocorrências.

Importação do retorno do PEFIN – Após cada processamento de um arquivo de remessa


realizado pela SERASA um arquivo de retorno é gerado contendo o resultado do processamento.
A importação deste arquivo para o EBS é realizada através de um programa concorrente criado
exclusivamente para esta funcionalidade.

CONFIE

Detalhamento do processo de integração do CONFIE:

A solução disponibiliza uma API Pública que, ao ser chamada, acionará o Business Event
responsável pela comunição com o WebService do CONFIE. Para que a comunição aconteça com
sucesso, faz-se necessário a liberação de acesso do endpoint do serviço da Serasa, na camada de
aplicação. Para mais detalhes, consulte a seção “CONFIE” no Implementation Guide.

A solução Oracle para atender o CONFIE, além da API Pública, também disponibiliza uma tela de
parâmetros iniciais e a configuração o Business Event para acessar o WebService. Esse Business
Event está configurado para acessar o ambiente de Homologação da Serasa-Confie. Ao aplicar o
patch em produção é necessário alterar manualmente a configuração do Business Event para
acessar o WebService do ambiente de produção do CONFIE.

Para mais detalhes sobre a configuração do WebService, consulte a seção “CONFIE” no


Implementation Guide.

Detalhes sobre a tela de parâmetros iniciais e API estão descritos no decorrer desse documento.

Algumas premissas sobre essa solução devem estar claras, sendo:

1) Para o parâmetro TIPORETORNO que é o tipo de retorno da consulta, a Serasa libera 2


opções:

a. 1 – Retorno do tipo XML;

b. 2 – Retorno no formato string;

Está no escopo somente a opção “1 – Retorno do tipo XML”.

2) O WebService possui vários endpoints, mas está no escopo somente o método:


“ConsultaConfieGeral”.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 12
CAPÍTULO

2 Configuração

E ste capítulo detalha como configurar o CLL-F509 Brazilian Credit Bureau Integration para a

geração de arquivos de remessa/retorno do RELATO e do PEFIN.

Também detalha as configurações necessárias na tela de parâmetros iniciais para acesso ao

WebService do CONFIE, além de demonstrar como deve ser o acesso a API Pública que irá

chamar o WebService de comunicação com Serasa-Confie.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 13
Opções de Perfil

Profile utilizada para identificar que no módulo CLL-F509 Brazilian Credit Bureau Integration
estarão habilitadas todas as extensões de Localizações no cadastro de Cliente e Tipo de Transação
do AR (Account Receivables).

Deverá estar setada no nível da Responsabilidade.

 CLL F509: Enable Extension for Brazilian Serasa Solution = Yes

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 14
RELATO
A seguir estão detalhadas as configurações necessárias para o funcionamento do RELATO.

Consulte o Implementation Guide para mais informações sobre como configurar as extensões
personalizadas no cadastro de Cliente e Tipo de Transação do AR (Account Receivables). Uma
vez configurada as extensões, estarão habilitados os campos referente ao RELATO e PEFIN, pois
ambos fazem parte da solução SERASA.

Sequência de Implementação

Seguem abaixo os passos para configuração do CLL-F509 Brazilian Credit Bureau Integration –
RELATO:

Passo Nome da Etapa

1. Diretório Unix

2. Informações de empresa

3. Associação de origens do lote por unidade operacional

4. Extensão no endereço da conta do cliente

5. Extensão na configuração do tipo de transação

6. Parâmetros iniciais

7. Opções de Perfil

Diretório Unix
Definir junto com a área de TI do cliente, o usuário e o diretório no UNIX para disponibilizar os
arquivos de remessa e retorno do RELATO.

É necessário definir ferramenta a ser utilizada para executar o FTP do Unix para seu
microcomputador e utilizar o software fornecido pela SERASA (EDI7 TCP SERASA Experian)
para transferir o arquivo de remessa e retirar o arquivo de retorno.


Importante definir, juntamente com o DBA, o diretório de acesso e cadastrá-lo na
tela de parâmetros iniciais do RELATO.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 15
Informações de Empresa
As informações provenientes da empresa agora ficam na tela de Entidade Legal do GL, onde é
definido o Nome da Empresa, Estabelecimentos e o Número do CNPJ que serão utilizados no
header do arquivo de remessa e retorno.

Navegação: Setup  Accounting Setups  Ledger Setup  Define  Accounting Setups

Associação de Origens do Lote por Unidade Operacional


Associar na tela de Parâmetros do CLL-F407 Brazilian Fiscal Managment, na aba “Receivables”,
as origens do lote com a Unidade Operacional.

Essa associação faz-se necessária para a geração dos arquivos de remessa do RELATO, que estão
no nível de empresa Filial.

A utilização dessa tela utiliza as regras de MOAC.

As funcionalidades da tela são:

1) Selecionar a Entidade Legal, utilizando a funcionalidade de pesquisa. Quando mais de um


registro for recuperado na pesquisa, deve-se navegar na tela, usando as setas de navegação (↑
ou ↓ ) no campo “Registration Number” da sessão “Legal Entity”.

2) A sessão “Establishment” exibe todos os Estabelecimentos pertencentes a Entitdade Legal


selecionada anteriormente. Selecionar o estabelecimento desejado e clicar no botão
“Associations”.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 16
Navegação: Brazilian Fiscal Management  Setup  Parameters

3) Na aba “Receivables” incluir as origens de lote que estarão associadas ao Estabelecimento


selecionado.

4) A associação deverá estar com o campo “Assigned” marcado para que seja considerada como
válida. Uma origem de lote somente poderá estar associada a um Estabelecimento.

5) Salvar as alterações.

Consulte também: Oracle Brazilian Fiscal Managment User’s Guide para obter
maiores informações sobre a configuração.

Extensão no Endereço da Conta do Cliente


Para que o cliente tenha suas informações compartilhadas com o RELATO-SERASA torna-se
necessário o preenchimento de alguns atributos existentes na extensão do endereço da conta do
cliente.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 17
Esta extensão é ativada somente após personalização da página “Customer Account”. Os detalhes
da personalização estão descritos no manual “CLL-F509 Brazilian Credit Bureau Integration –
Implementation Guide”.

1) Selecionar o Cliente.

Navegação: Receivables  Customers  Standard

2) Acionar o botão de Detalhes da Conta.

3) No endereço da conta do cliente clicar no botão de extensões.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 18
4) Preencher os campos “Site Shared in RELATO-SERASA” e “Customer Since”. O campo
“SERASA-RELATO Status” é preenchido automaticamente pelo sistema.

Site shared in RELATO-SERASA


Indica se as informações do cliente serão enviadas ou não para registro na SERASA.

SERASA-RELATO Status
Informação preenchida automaticamente pelo sistema. Os possíveis estatus são:

Em Branco O cliente ainda não foi selecionado para registro na SERASA


CONFIRMED O cliente está registrado na SERASA com sucesso
Dados para registro foram enviados à SERASA e um erro foi
ERROR
detectado no processamento
Dados para registro foram enviados à SERASA mas ainda não
REMITTED
houve retorno do processamento
O cliente está selecionado para registro na SERASA, o lote de
SELECTED remessa foi criado mas ainda não houve a geração e envio do
arquivo para registro

Customer Since
Data de início do relacionamento do cliente com a empresa. Essa informação é necessária
para preencher a sessão “Tempo de Relacionamento” no arquivo de remessa.

5) Salvar as alterações.

Extensão na Configuração do Tipo de Transação

Para que uma transação do Contas a Receber seja registrada no RELATO-SERASA, o tipo desta
transação deverá estar configurado para tal. Existe uma extensão no cadastro de tipos de transação
para definir quais tipos serão registrados.

Esta extensão é ativada somente após personalização do forms “Transaction Types”. Os detalhes
da personalização estão descritos no manual “CLL-F509 Brazilian Credit Bureau Integration –
Implementation Guide”.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 19
1) Selecionar o Tipo de Transação.

Navegação: Receivables  Setup  Transactions  Transaction Types

2) Selecionar o menu “Tools”  “Additional Information”.

3) Informar se o tipo de transação será utilizado para o RELATO-SERASA. Caso não seja
preenchido ou seja preenchido com valor “No”, as transações associadas ao tipo de transação
em questão não serão selecionadas para envio ao RELATO-SERASA.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 20
4) Salvar as alterações.

Parâmetros Iniciais
Nesta tela são definidas as configurações iniciais para o funcionamento do CLL-F509 Brazilian
Credit Bureau Integration. Sem essa configuração, não é possível executar os processos de
remessa/retorno.
1) Acessar a aba “Relato”da tela de parâmetros do RELATO-SERASA.

Navegação: CLL: Brazilian Credit Bureau Integration  Serasa  Parameters

2) Informar os seguintes parâmetros:

Operating Unit
Nome da Unidade Operacional a ser parametrizada.

Process Type
Periodicidade do processo de geração de informações para a SERASA, podendo ser :

A remessa será enviada diariamente considerando até três dias úteis após a
Diário
data "até" da última remessa processada
A remessa será enviada semanalmente considerando até 8 dias úteis após a
Semanal
data "até" da última remessa processada
Utilizado para processamento de arquivos de conciliação. Este tipo NÃO
Conciliation
deve ser utilizado na configuração dos Parâmetros Iniciais.

Em decorrência da Lei do Cadastro Positivo, a atualização das informações deve ocorrer a


cada sete dias, as periodicidades Mensal e Quinzenal não são mais tratadas pela SERASA.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 21
Remittance File Location
Caminho completo do diretório do Unix onde o arquivo de remessa será criado.

Return File Location


Caminho completo do diretório do Unix de onde o arquivo de retorno lido.

Years to Consider
Quantidade de anos a serem considerados na seleção das transações. Exemplo: Considerar
para envio ao RELATO-SERASA somente as transações criadas nos últimos 3 anos.

Start Date
Data de início da validade da parametrização.

End Date
Data de término da validade da parametrização.

3) Salvar as alterações.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 22
PEFIN
A seguir estão detalhadas as configurações necessárias para o funcionamento do PEFIN.

Consulte o Implementation Guide para mais informações sobre como configurar as extensões
personalizadas no cadastro de Cliente e Tipo de Transação do AR (Account Receivables).

Uma vez configurada as extensões, estarão habilitados os campos referente ao RELATO e PEFIN,
pois ambos fazem parte da solução SERASA.


IMPORTANTE:

A configuração no Oracle EBS e conferência dos títulos selecionados para envio à


Serasa, incluindo ou excluindo um título no PEFIN, é de responsabilidade da
Empresa. A Oracle somente disponibiliza o software para geração do lote e a
Serasa faz o processamento dos títulos enviados.

Sequência de Implementação

Seguem abaixo os passos para configuração do CLL-F509 Brazilian Credit Bureau Integration –
PEFIN:

Passo Nome da Etapa

1. Diretório Unix

2. Informações de empresa

3. Associação de origens do lote por unidade operacional

4. Extensão no endereço da conta do cliente

5. Extensão na configuração do tipo de transação

6. Parâmetros iniciais

7. Opções de Perfil

Diretório Unix

Definir junto com a área de TI do cliente, o usuário e o diretório no UNIX para disponibilizar os
arquivos de remessa e retorno do PEFIN.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 23
É necessário definir ferramenta a ser utilizada para executar o FTP do Unix para seu
microcomputador e utilizar o software fornecido pela SERASA (EDI7 TCP SERASA Experian)
para transferir o arquivo de remessa e retirar o arquivo de retorno.


Importante definir, juntamente com o DBA, o diretório de acesso e cadastrá-lo na
tela de parâmetros iniciais do PEFIN.

Informações de Empresa
As informações provenientes da empresa agora ficam na tela de Entidade Legal do GL, onde é
definido o Nome da Empresa, Estabelecimentos e o Número do CNPJ que serão utilizados no
header do arquivo de remessa e retorno.

Navegação: Setup  Accounting Setups  Ledger Setup  Define  Accounting Setups

Associação de Origens do Lote por Unidade Operacional


Associar na tela de Parâmetros do CLL-F407 Brazilian Fiscal Managment, na aba “Receivables”,
as origens do lote com a Unidade Operacional.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 24
Essa associação faz-se necessária para a geração dos arquivos de remessa do PEFIN, que estão no
nível de empresa Filial.

A utilização dessa tela utiliza as regras de MOAC.

As funcionalidades da tela são:

1) Selecionar a Entidade Legal, utilizando a funcionalidade de pesquisa. Quando mais de um


registro for recuperado na pesquisa, deve-se navegar na tela, usando as setas de navegação (↑
ou ↓ ) no campo “Registration Number” da sessão “Legal Entity”.

2) A sessão “Establishment” exibe todos os Estabelecimentos pertencentes a Entitdade Legal


selecionada anteriormente. Selecionar o estabelecimento desejado e clicar no botão
“Associations”.

Navegação: Brazilian Fiscal Management  Setup  Parameters

3) Na aba “Receivables” incluir as origens de lote que estarão associadas ao Estabelecimento


selecionado.

4) A associação deverá estar com o campo “Assigned” marcado para que seja considerada como
válida. Uma origem de lote somente poderá estar associada a um Estabelecimento.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 25
5) Salvar as alterações.

Consulte também: Oracle Brazilian Fiscal Managment User’s Guide para obter
maiores informações sobre a configuração.

Extensão no Endereço da Conta do Cliente


Para que o cliente tenha suas informações compartilhadas com o PEFIN-SERASA torna-se
necessário o preenchimento de alguns atributos existentes na extensão do endereço da conta do
cliente.
Quando não houver informação cadastrada no endereço da conta do cliente, serão considerados os
valores informados na tela de Parâmetros, para selecionar os títulos que serão enviados ao PEFIN.
Esta extensão é ativada somente após personalização da página “Customer Account”. Os detalhes
da personalização estão descritos no manual “CLL-F509 Brazilian Credit Bureau Integration –
Implementation Guide”.

1) Selecionar o Cliente.

Navegação: Receivables  Customers  Standard

2) Acionar o botão de Detalhes da Conta.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 26
3) No endereço da conta do cliente clicar no botão de extensões.

4) Preencher os campos “Site Shared in SERASA-PEFIN”, “Minimum Days Late”, “Minimum


Remaining Amount” e “Debit Memo shared in PEFIN”.

Site shared in SERASA-PEFIN


Indica se as informações do cliente serão enviadas ou não para registro na SERASA.

Minimum Days Late


Mínimo de dias de atraso que um título vencido do Cliente deve ser considerado na lista para
registro na SERASA.

Minimum Remaining Amount


Valor Mínimo do saldo de um título vencido do Cliente deve ser considerado na lista para
registro na SERASA.

Debit Memo shared in PEFIN


Indica se os títulos vencidos do tipo ‘Nota de Débito’do cliente serão enviadas ou não para
registro na SERASA.

5) Salvar as alterações.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 27
Extensão na Configuração do Tipo de Transação

Para que uma transação do Contas a Receber seja registrada no PEFIN-SERASA, o tipo desta
transação deverá estar configurado para tal. Existe uma extensão no cadastro de tipos de transação
para definir quais tipos serão registrados.
Nos detalhes do arquivo de remessa, é necessário informar o tipo da natureza da transação, de
acordo com uma lista de valores pré-definida pela SERASA. Portando, foi criado um campo nessa
extensão, que receberá essa lista de valores e, se estiver nula e o registro possuir a classe for
“Invoice”, será enviado NF (nota fiscal). Para as demais classes, será enviado DP (duplicata).

Esta extensão é ativada somente após personalização do forms “Transaction Types”. Os detalhes
da personalização estão descritos no manual “CLL-F509 Brazilian Credit Bureau Integration –
Implementation Guide”.

1) Selecionar o Tipo de Transação.

Navegação: Receivables  Setup  Transactions  Transaction Types

2) Selecionar o menu “Tools”  “Additional Information”.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 28
3) Preencher os campo “Report in SERASA – PEFIN?” e “Operation Type - PEFIN”.

Report in SERASA – PEFIN?


Indica se o Tipo de Transação será considerada para registro na SERASA. Caso não seja
preenchido ou seja preenchido com valor “No”, as transações associadas ao tipo de transação em
questão não serão selecionadas para envio ao PEFIN-SERASA.

Operation Type – PEFIN


Escolher a “Natureza de Operação” associada ao Tipo de Transação selecionado. Caso não
seja preenchido, será considerado que Tipos de Transação com a Classe ‘Invoice’ possuem a
Natureza de Operação igual ‘NF’(Nota Fiscal) e os demais Tipos de Transação possuem a
Natureza de Operação igual ‘DP’ (Duplicata).

4) Salvar as alterações.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 29
Parâmetros Iniciais

Nesta tela são definidas as configurações iniciais para o funcionamento do CLL-F509 Brazilian
Credit Bureau Integration. Sem essa configuração, não é possível executar os processos de
remessa/retorno.

Após salvar o registro, não é permitido alterar a informação. Deve-se preencher o “End Date” do
registro e inserir uma nova linha. Não é permitido ter a mesma Unidade Operacional ativa em mais
de um período.

1) Acessar a aba “Pefin”da tela de parâmetros do PEFIN-SERASA.

Navegação: CLL: Brazilian Credit Bureau Integration  Serasa  Parameters

2) Informar os seguintes parâmetros:

Operating Unit
Nome da Unidade Operacional a ser parametrizada. Considera o setup por MOAC ou profile
da responsabilidade para exibir a lista de valores.

Minimum Days Late


Mínimo de dias de atraso que um título vencido deve ser considerado na lista para registro na
SERASA. Esse mesmo campo existe na extensão de endereço da conta do cliente e se
sobresai sobre esse setup, quando informado.

Minimum Remaining Amount


Valor Mínimo do saldo de um título vencido à ser considerado na lista para registro na
SERASA. Esse mesmo campo existe na extensão de endereço da conta do cliente e se
sobresai sobre esse setup, quando informado.

Remittance File Location


Caminho completo do diretório do Unix onde o arquivo de remessa será criado. Deve ter
permissão para escrita de arquivo.

Return File Location


Caminho completo do diretório do Unix de onde o arquivo de retorno lido. Deve ter
permissão para leitura de arquivo.

Years to Consider
Quantidade de anos a serem considerados na seleção das transações. Exemplo: Considerar
para envio ao PEFIN-SERASA somente as transações criadas nos últimos 5 anos.

Batch Sequence
Número Sequencial do Arquivo de Remessa. É preenchido automaticamente pelo processo de
Remessa. É atualizado sempre que um novo lote de remessa é gerado. Exibe o número do
último lote de Remessa criado.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 30
Área Code
Código de Área do Telefone do Contato na empresa, responsável pela informações enviadas à
SERASA.

Telephone Number
Telefone do Contato na empresa, responsável pela informações enviadas à SERASA.

Telephone Extension
Ramal do Telefone do contato na empresa, responsável pela informações enviadas à
SERASA.

Company Contact Name


Nome do Contato na empresa, responsável pela informações enviadas à SERASA.

Generate Automatic Occurrence for Adjustments?


Informa se o processo de remessa de exclusões ao PEFIN-SERASA deverá selecionar títulos
que tiveram ajustes de valor. Por exemplo, Titulo enacaminhado à SERASA no valor de
1.000,00 sofre um ajuste de 990,00, deixando um saldo de 10,00. Se a opção estiver marcada,
será solicitado à SERASA a Exclusão desse título, caso contrário a exclusão somente será
considerada quando o saldo for 0 (zero). Quando o campo for nulo, considera-se que o título
será excluído somente quando o for saldo for 0 (zero).

Start Date
Data de início da validade da parametrização.

End Date
Data de término da validade da parametrização.

3) Salvar as alterações.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 31
CONFIE
A seguir estão detalhadas as configurações necessárias para o funcionamento do CONFIE.

Consulte o Implementation Guide para mais informações sobre como configurar o proxy para
acessar o WebService (se necessário) e as configurações do Business Event que irá acionar o
WebService da Serasa.

Sequência de Implementação

Seguem abaixo os passos para configuração do CLL-F509 Brazilian Credit Bureau Integration -
CONFIE:

Passo Nome da Etapa

1. Acesso na camada de aplicação ao endpoint do serviço da SERASA

2. Informações de empresa

3. Parâmetros iniciais

4. Business Event

5. Public API

1. Acesso na camada de aplicação ao endpoint do serviço da SERASA

Definir junto com a área de TI do cliente, os procedimentos necessários para disponbilizar acesso
ao endpoint do serviço da SERASA na camada de aplicação (EBS).


Importante:

1) Configurar as informações iniciais utilizadas na comunicação do


WebService do Confie na tela de parâmetros inciais;

2) Confirmar que a camada de aplicação tem acesso ao endpoint do


WebService – configuração de proxy

3) Verificar a configuração do Business Event, responsável por acessar o


WebService da Serasa (ambientes de Homologação / Produção).

Sem esses pré-requisitos, não é possível executar com sucesso a API Pública.

Mais detalhes técnicos sobre o acesso ao WebService da Serasa, consulte a seção “CONFIE” do
Implementation Guide.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 32
2. Informações de empresa

A configuração na tela de parâmetros iniciais do Confie é feita no nível de Unidade Operacional.

A mesma utiliza o conceito de acesso pela Profile “MO: Operating Unit” ou o setup por “MOAC”,
de acordo com o que estiver setado no ambiente do cliente.

Caso sua configuração for através da Profile, nenhuma configuração de associação se faz
necessária na tela de Parâmetros do módulo “CLL: Brazilian Fiscal Managment”.

Se sua configuração utilizar o setup por MOAC, é necessário configurar a tela de Parâmetros do
módulo “CLL: Brazilian Fiscal Managment”.

Consulte também: Oracle Brazilian Fiscal Managment User’s Guide para obter
maiores informações sobre a configuração.

3. Parâmetros iniciais

Nesta tela são definidas as configurações iniciais para o funcionamento do CLL-F509 Brazilian
Credit Bureau Integration. Sem essa configuração, não é possível iniciar a comunicação com o
WebService da Serasa-Confie.

É possível ter somente uma configuração ativa por Unidade Operacional.

A seguir estão detalhados os procedimentos para cadastro dos parâmetros do CONFIE:

1) Acessar a aba “Confie”da tela de parâmetros.

Navegação: CLL: Brazilian Credit Bureau Integration  Serasa  Parameters

2) Informar os seguintes parâmetros:

Operating Unit (required)


Nome da Unidade Operacional a ser parametrizada – disponível conforme setup da
Responsabilidade, podendo ser acessa pela profile “MO: Operating Unit” ou pelo setup
de MOAC.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 33
URL WebService (display only)
Preenchido automaticamente com o endpoint do WebService da Serasa-Confie,
configurado no Business Event.


Importante:

É enviado no patch o endpoint do WebService do ambiente de Homologação


da Serasa-Confie. Quando o patch for aplicado em ambiente de produção, faz-
se necessária a alteração do Business Event para acessar o ambiente de
Produção do WebService da Serasa-Confie. Para detalhes sobre a
configuração do Business Event, consulte o Implementation Guide

User (required)
Usuário da empresa, adquirido junto a SERASA, para acessar o WebService do
CONFIE.

Password (required)
Senha da empresa, adquirido junto a SERASA, para acessar o WebService do CONFIE.

Re-type Password (required)


Digitar novamente a senha da empresa para conferência, antes de ser salva. Essa senha é
criptografada antes de ser armazenada no banco de dados, garantindo assim, sigilo da
informação.

Request Type (required)


Tipos de consulta possíveis pela Serasa, ao consumir o WebService do CONFIE. As
possíveis opções são:

Tipo Descrição conforme Manual Serasa-Confie


1 - Somente sites (online) Busca somente nas fontes de dados (sites da
Receita, Sefaz / Sintegra)
2 - Somente Base Serasa-Experian Busca dados na base de dados da Serasa-Experian
3 - Online / Base Serasa-Experian Busca nas fontes de dados (sites da Receita, Sefaz
/ Sintegra) e caso não estejam disponíveis, busca
na base de dados Serasa-Experian
4 - Base Serasa-Experian / Online busca na base de dados Serasa-Experian e caso a
informação não exista ou esteja fora do prazo de
validade esperado, busca nas fontes de dados (sites
da Receita, Sefaz / Sintegra)
5 - Idêntica à opção 4 Porém caso a informação não exista na base
SERASA ou esteja fora do prazo de validade
esperado e a consulta aos sites retorne apenas
dados da Receita Federal, esses dados são exibidos
no relatório

Report Type (required)


Tipos de relatórios possíveis pela Serasa, ao consumir o WebService do CONFIE. As
possíveis opções são:

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 34
Tipo
1 - Relatório Completo (Com endereço)
2 - Relatório Sintético (Sem endereço)
3 - Relatório Completo (Com endereço) + Concentre
4 - Relatório Sintético (Sem endereço) + Concentre

Generate XML Additional? (required / display only)


Solicita o retorno da consulta com um bloco adicional, contendo o código HTML da
página do órgão consultado (para os casos de consultas ONLINE ao site).

Possui as opções Yes/No. Se informado “Yes”, traz o bloco HTML na consulta.

Observação: Esse bloco não estará disponível quando os dados da consulta forem
provenientes da base Serasa-Experian. Nesse caso, esse campo será somente consulta,
não podendo ser alterado.

Return Type (required)


Tipos de retorno possíveis pela Serasa, ao consumir o WebService do CONFIE. As
possíveis opções são:

Tipo
1 - Retorno do tipo XML
2 - Retorno no formato string

IMPORTANTE:
Somente a opção “1 - Retorno do tipo XML” está no escopo Oracle.

Time Out (required)


Tempo máximo para esperar por um retorno da consulta (em milisegundos). Conforme
definição da Serasa, o valor mínimo aceitável para esse parâmetro é de 20 segundos.

CNPJ - Days exceeded (opcional)


Define a quantidade máxima de dias de defasagem para aceitar a informação proveniente
da Base Serasa Experian quando o cliente consultado possuir um tipo de documento igual
a CNPJ (validação: valor mínimo de 1 dia)

CPF - Days exceeded (opcional)


Define a quantidade máxima de dias de defasagem para aceitar a informação proveniente
da Base Serasa Experian quando o cliente consultado possuir um tipo de documento igual
a CPF (validação: valor mínimo de 1 dia)

Start Date (required)


Data de início da validade da parametrização.

End Date (opcional)


Data de término da validade da parametrização.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 35
Notes:

1) Não é permitido ter mais de um registro no mesmo período de validade


para a Unidade Operacional.

2) A tela não permite que os dados sejam deletados. A opção está


desabilitada no menu

3) Salvar as alterações.

Após as alterações serem salvas com sucesso, os registros não podem ser alterados. Todos os
campos na tela são somente consulta, com excessão do campo “End Date” que deverá ser
preenchido quando for necessário alterar alguma informação cadastrada.
Os dados atuais devem ser encerrados e um novo registro deve ser criado, com as novas
informações e período de referência (Start Date/End Date).

4. Business Event
O endpoint do WebService da SERASA deve ser configurado no “Business Event”, utilizando a
responsabilidade “Workflow Administrator Web (New)”.


Importante:

A configuração inicial (apontando para o ambiente de homologação da Serasa-


Confie) será criada automaticamente pelo patch.

Esta funcionalidade está disponível na release 12.1.3 ou superior do EBS.

Para mais detalhes sobre a configuração do Business Event, inclusive a alteração


do Business Event para apontar para o endpoint do ambiente de produção da
Serasa-Confie, consulte o Implementation Guide.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 36
5. Public API

A API pública: CLL_F509_CONFIE_PUB é responsável por acionar o Business Event, que faz a
chamada no WebService da Serasa-Confie.

Ela possui 2 processos sendo:

 send_request:

Responsável por:

o Fazer as validações de todos os parâmetros de entrada e encontrando algum


problema, o erro é retornado no parâmetro de saída: p_return_message

o Preencher os parâmetros no payload de envio do serviço da SERASA

o Retornar informações de identificação da chamada do serviço como: data, event_key,


payload enviado e o status. Bem como popular a fila do Agent do Business Event
(queue_table)

 wait_for_response:

Responsável por:

o Consumir a fila do Agent do Business Event (queue_table), para o event_key


informado

o Retornar informações de retorno da consulta do serviço como: data, retorno do


payload e o status

o Deletar o evento retornado da fila do Agent do Business Event (queue_table)

Detalhes sobre cada parâmetro utilizado nos procedimentos da API, bem como um exemplo de
Bloco Anônimo em PL/SQL está diponível no próximo capítulo: “3 – Processos” desse
documento, na seção CONFIE.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 37
CAPÍTULO

3 Processos

Neste capítulo são detalhados os processos do CLL-F509 Brazilian Credit Bureau Integration.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 38
RELATO
A seguir estão detalhados os processos de Remessa, Retorno e Conciliação do RELATO.

Remessa - Títulos a receber com vencimento futuro

São os títulos criados no Contas a Receber desde a data do último processamento até o dia
anterior à data atual (data atual -1), que possuem vencimento futuro e cujo cliente tenha
relacionamento com o RELATO-SERASA.

Para cada título será criada 1 linha no arquivo de remessa contendo o CNPJ do cliente,
número do título, data de emissão, valor do título e data de vencimento.

Exemplo: Criação do título 1000-1 no valor de R$ 1.000,00 e vencimento em 10/04/2015.


CNPJ Título Data Valor Vencto Pagto
11.111.111/0001-11 1000-1 10/03/2015 1000 10/04/2015

Remessa - Liquidação total de títulos

São os títulos liquidados totalmente desde a data do último processamento até o dia anterior à
data atual (data atual -1) cujo cliente tenha relacionamento com o RELATO-SERASA.

Para cada título será criada 1 linha no arquivo de remessa contendo o CNPJ do cliente,
número do título, data de emissão, valor do pagamento, data de vencimento e data de
pagamento.

Exemplo: Liquidação do título 1000-1 no valor de R$ 1.000,00 em 09/04/2015.


CNPJ Título Data Valor Vencto Pagto
11.111.111/0001-11 1000-1 10/03/2015 1000 10/04/2015 09/04/2015

Remessa - Liquidação parcial de títulos

São os títulos liquidados parcialmente desde a data do último processamento até o dia anterior
à data atual (data atual -1) cujo cliente tenha relacionamento com o RELATO-SERASA.

Para cada título serão criadas 2 linha no arquivo de remessa:

Uma linha referente ao pagamento parcial contendo o CNPJ do cliente, número do título, data
de emissão, valor do pagamento parcial, data de vencimento e data de pagamento.

Também será uma segunda linha referente ao saldo em aberto do título contendo o CNPJ do
cliente, novo número do título, data de emissão, valor do saldo em aberto e data de
vencimento. O número do novo título será igual ao título que foi liquidado parcialmente
incrementado por uma letra no final (A, B, C, etc.).

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 39
Exemplo: Liquidação parcial do título 1000-1 no valor de R$ 100,00 em 15/03/2015,
restando um saldo a pagar de R$ 900,00.
CNPJ Título Data Valor Vencto Pagto
11.111.111/0001-11 1000-1 10/03/2015 100 10/04/2015 15/03/2015
11.111.111/0001-11 1000-1A 10/03/2015 900 10/04/2015

Em 30/03/2015 ocorreu uma nova liquidação parcial do mesmo título no valor de R$ 500,00
restando um saldo a pagar de R$ 400,00.
CNPJ Título Data Valor Vencto Pagto
11.111.111/0001-11 1000-1A 10/03/2015 500 10/04/2015 30/03/2015
11.111.111/0001-11 1000-1B 10/03/2015 400 10/04/2015

Remessa - Ajustes realizados em títulos a receber referentes a devoluções totais e cancelamentos

São as baixas de títulos referentes a devoluções totais e cancelamentos ocorridas desde a data
do último processamento até o dia anterior à data atual (data atual -1) cujo cliente tenha
relacionamento com o RELATO-SERASA.

Para cada título devolvido será criada 1 linha no arquivo de remessa informando a exclusão
do título. Esta linha contém o CNPJ do cliente, número do título, data de emissão e data de
vencimento. Ao invés do valor do título é enviada uma sequência de13 números noves
(9999999999999) indicando que trata-se de uma exclusão.

Exemplo: Cancelamento do título 1000-1.


CNPJ Título Data Valor Vencto Pagto
11.111.111/0001-11 1000-1 10/03/2015 9999999999999 10/04/2015

Remessa - Ajustes realizados em títulos a receber referentes a devoluções parciais

São as baixas de títulos referentes a devoluções parciais ocorridas desde a data do último
processamento até o dia anterior à data atual (data atual -1) cujo cliente tenha relacionamento
com o RELATO-SERASA.

Para cada título devolvido parcialmente serão criadas 2 linhas no arquivo de remessa:

Uma linha informando a exclusão do título original. Esta linha contém o CNPJ do cliente,
número do título, data de emissão e data de vencimento. Ao invés do valor do título é enviada
uma sequência de 13 números noves (9999999999999) indicando que trata-se de uma
exclusão.

Também será uma segunda linha referente ao novo saldo do título contendo o CNPJ do
cliente, novo número do título, data de emissão, valor do saldo em aberto e data de
vencimento. O número do novo título será igual ao título que foi liquidado parcialmente
acrescido de uma letra no final (A, B, C, etc.).

Exemplo: Devolução de R$300,00 sobre título 1000-1, restando um saldo a pagar de


R$700,00
CNPJ Título Data Valor Vencto Pagto
11.111.111/0001-11 1000-1 10/03/2015 9999999999999 10/04/2015
11.111.111/0001-11 1000-1A 10/03/2015 700 10/04/2015

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 40
Remessa - Ajustes realizados em títulos a receber referentes a descontos concedidos e acréscimos

São as alterações de saldos de títulos referentes a acréscimos ou descontos concedidos


ocorridos desde a data do último processamento até o dia anterior à data atual (data atual -1)
cujo cliente tenha relacionamento com o RELATO-SERASA.

Para cada título ajustado serão criadas 2 linhas no arquivo de remessa:

Uma linha informando a exclusão do título original. Esta linha contém o CNPJ do cliente,
número do título, data de emissão e data de vencimento. Ao invés do valor do título é enviada
uma sequência de13 números Noves (9) indicando que trata-se deuma exclusão.

Também será uma segunda linha referente ao novo saldo do título contendo o CNPJ do
cliente, novo número do título, data de emissão, valor do saldo em aberto e data de
vencimento. O número do novo título será igual ao título que foi liquidado parcialmente
acrescido de uma letra no final (A, B, C, etc.).

Exemplo: Desconto concedido de R$30,00 sobre título 1000-1, restando um saldo a pagar de
R$970,00
CNPJ Título Data Valor Vencto Pagto
11.111.111/0001-11 1000-1 10/03/2015 9999999999999 10/04/2015
11.111.111/0001-11 1000-1A 10/03/2015 970 10/04/2015

Remessa - Registro de informações sobre “Tempo de Relacionamento” com clientes

São registros referentes ao tempo de relacionamento da empresa com o cliente. Estes registros
são enviados uma única vez, quando o cliente é marcado para que seus títulos sejam enviados
para base de dados do RELATO-SERASA (ver Capítulo 2 – Configuração: RELATO -
Extensão no Endereço da Conta do Cliente).

É criada uma linha contendo o CNPJ do cliente e o tempo de relacionamento (Clientes


Desde).


Atenção: SERASA processa transações com valores até R$ 10.000.000,00. Caso
sua empresa possua lançamentos com valores superiores a este será necessário
contatar a SERASA e solicitar que o sistema seja parametrizado para permitir
valores acima desta quantia.

Na seleção das informações para envio ao RELATO-SERASA considera-se a periodicidade do


processo e quantidade de anos a considerar, definidos nos Parâmetros Iniciais (ver Capítulo 2 –
Configuração: RELATO – Parâmetros Iniciais).

Existem 2 formas de geração de um arquivo de remessa para o RELATO-SERASA:

 Através de uma tela específica onde o usuário controla o momento de gerar o lote e o
momento de gerar o arquivo de remessa.

 Através da execução de uma solicitação concorrente, onde usuário submete a solicitação e a


criação do lote e do arquivo de remessa ocorrem automaticamente.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 41
Independente da forma de geração do lote e arquivo de remessa, o processo irá sempre gerar lotes
e arquivos separados por estabelecimentos da Unidade Operacional selecionada. A distinção de
estabelecimentos se faz através da origem do lote da transação (ver Capítulo 2 – Configuração:
RELATO - Associação de Origens do Lote por Unidade Operacional).

Remessa - Geração de arquivo de remessa através de tela específica

Este processo é dividido em 2 etapas.

Na primeira etapa cria-se o lote de remessa, onde são selecionados todos os títulos a receber,
liquidações (parciais ou totais), devoluções e cancelamentos ocorridos desde a última data de
processamento até o dia anterior ao dia de processamento atual (data atual -1).

Também são selecionados os registros de relacionamento com novos clientes.

Caso não existam transações a serem selecionadas no período o lote de remessa não será
criado.

O lote de remessa e poderá ter os seguintes status:

NEW O lote foi gerado porém ao arquivo de remessa ainda não foi criado.

O lote foi gerado, o arquivo de remessa foi criado porém ainda não houve retorno
REMITTED
do processamento do arquivo pela SERASA.

O lote foi gerado, o arquivo de remessa foi criado e processado com sucesso pela
CONFIRMED SERASA. Este status só é atribuído ao lote após a importação do arquivo de
retorno enviado pela SERASA.

O lote foi gerado, o arquivo de remessa foi criado e processado pela SERASA,
porém existem transações que foram rejeitadas. O número de transações rejeitadas
PARTIALLY
é insuficiente para invalidar a remessa (menos que 20%). Este status só é atribuído
ao lote após a importação do arquivo de retorno enviado pela SERASA.

O lote foi gerado, o arquivo de remessa foi criado e processado pela SERASA,
porém existem transações que foram rejeitas. O número de transações rejeitadas é
ERROR considerado alto (mais que 20%) e a remessa foi totalmente desprezada. Este
status só é atribuído ao lote após a importação do arquivo de retorno enviado pela
SERASA.

1) Acessar a tela de consulta e geração de lotes e clicar no botão “New”.

Navegação: CLL: Brazilian Credit Bureau Integration  Serasa  Relato  Remittance Regular

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 42
2) Será mostrada uma tela com informações sobre o lote a ser gerado.

3) Clicar no botão “Generate Batch” para criação do lote.

Lote e títulos criados com status”NEW”. Caso existam outros estabelecimentos atribuídos à
Unidade Operacional atual e estiverem devidamente configurados no módulo Brazilian Fiscal
Management será criado 1 lote para cada estabelecimento.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 43
Após a geração do lote é possível efetuar a reversão do mesmo através do botão “Revert
Batch”. Esta ação fará com que o status do lote e seus títulos seja alterado para
“REVERTED” e disponibilizará os títulos para serem selecionados na próxima geração de
lote. Caso existam outros lotes de outros estabelecimentos gerados no mesmo período
(Transaction Date From – Transaction Date To) estes também serão revertidos.

Para gerar o arquivo de remessa baseado no lote já gerado deve-se seguir os passos a seguir.
Este passos somente podem ser executados para lotes com status “NEW”. Após a geração do
arquivo o lote e seus títulos ficarão com status “REMITTED” e não será mais possível efetuar
a reversão do mesmo.

1) Clicar no botão “Generate File” para criação do lote.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 44
Neste momento o arquivo é gerado no diretório Unix contendo todos os títulos e respectivos
ajustes referentes ao período especificado e pode ser enviado à SERASA para processamento.

O status do lote e seus títulos são alterados para “REMITTED”.

Remessa - Geração de arquivo de remessa através de solicitação concorrente

Neste processo a geração do lote e do arquivo de remessa ocorre numa única etapa.

A solicitação concorrente “SERASA – RELATO – Remittance” é responsável por criar o lote


de remessa, observando os mesmos critérios de seleção da remessa por tela e em seguida criar
o arquivo de remessa.

1) Execute uma nova Solicitação: “SERASA – RELATO – Remittance”.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 45
Navegação: Requests  Run

2) Informe o nome da solicitação e os parâmetros “Operating Unit” e “Remittance File


Location”.

3) Aguarde o término da execução e consulte os arquivos de Saída e Log para verificar os


resultados.

Retorno

Após a criação do arquivo de remessa o mesmo deve ser encaminhado para a SERASA realizar o
processamento das informações contidas neste arquivo. A forma de envio irá variar conforme a
estrutura de transferência de arquivos definida pela empresa.

A SERASA irá recepcionar o arquivo de remessa, realizar o processamento das informações e irá
gerar um arquivo de retorno contendo o resultado deste processamento:

Indica que todos os dados enviados foram


REMESSA TOTAL PROCESSADA OK
aproveitados

REMESSA PARCIALMENTE PROCESSADA Indica que alguns registros foram


inconsistidos. Nesse caso, é necessário

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 46
verificar qual foi o erro, corrigi-lo e reenviar
os registros à SERASA Experian por meio do
arquivo de remessa normal

Indica que todo o arquivo foi inconsistido.


Nesse caso, será necessário verificar quais
TODA REMESSA DESPREZADA
foram os erros, corrigi-los e reenviar o arquivo
à SERASA Experian

Este arquivo de retorno deverá ser transferido para um diretório específico, definido nos
Parâmetros Iniciais (ver Capítulo 2 – Configuração: RELATO – Parâmetros Iniciais) e
posteriormente importado para atualização do Receivables.

A solicitação concorrente “SERASA - RELATO – Return” é responsável por ler o arquivo de


retorno e atualizar a o Receivables.

1) Execute uma nova Solicitação: “SERASA – RELATO – Return”.

Navegação: Requests  Run

2) Informe o nome da solicitação e os parâmetros “Operating Unit”, “Return File Location”


e “File Name”.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 47
3) Aguarde o término da execução e consulte os arquivos de Saída e Log para verificar os
resultados.

Consulta da Remessa

A seguir o passo a passo para consultar as Remessas do RELATO:

1) Acessar a tela de consulta e geração de lotes e clicar no botão “Find”.

Navegação: CLL: Brazilian Credit Bureau Integration  Serasa  Relato  Remittance Regular

Será apresentada uma tela contendo um resumo de todos os lotes de remessa gerados.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 48
2) Para verificar as transações de um lote de remessa deve-se posicionar o cursor sobre o
lote desejado e em seguida clicar no botão “View Details”.

Detalhes:

Para lotes com status “NEW” é possível efetuar a reversão do lote ou a realizar a criação do
arquivo de remessa através desta tela.

3) Quando após o processamento do arquivo de retorno o lote ficar com status “ERROR” ou
“PARTIALLY” significa que alguma inconsistência foi detectada. Para visualizar estas
inconsistências deve-se clicar no botão “View Errors”.

Erros referentes a transações do lote são mostrados na aba “Transaction Details”.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 49
Erros referentes a relacionamento com o cliente são mostrados na aba “Customer Details”

Reprocessamento da Remessa

Um lote com inconsistências poderá ser reprocessado.

1) Acessar a tela de consulta e geração de lotes e clicar no botão “Find” para localizar os lotes
de remessa que foram processados com erro.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 50
Navegação: CLL: Brazilian Credit Bureau Integration  Serasa  Relato  Remittance Regular

2) Os erros demonstrados na tela de erros (botão “View Errors”) devem ser corrigidos.

3) Para reprocessar estas inconsistências, criando um novo lote de remessa deve-se


selecionar o lote com erro e clicar no botão “Reprocess”.

4) Uma nova solicitação concorrente é submetida para criação do novo lote de remessa
contendo somente as transações que tiveram erro.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 51
Processo de Conciliação

A Conciliação do RELATO é um processo obrigatório que ocorre mensalmente, onde a


SERASA disponibiliza para empresa um arquivo contendo todos os títulos a receber enviados
pela empresa e que constam em seus registros com saldo em aberto.

Este arquivo deverá ser importado para o OEBS e atualizado com as datas de liquidação
destes títulos, caso a liquidação total tenha ocorrido. Entende-se por título totalmemente
liquidado, o título que possua saldo zero, independente do motivo que gerou sua baixa de
saldo (recebimento, devolução, cancelamento, etc.).

1) Execute uma nova Solicitação: “SERASA – RELATO – Conciliation”.

Navegação: Requests  Run

2) Informe o nome da solicitação e os parâmetros “Operating Unit”, “Return File Location”


e “File Name”.

3) Aguarde o término da execução da solicitação e consulte os arquivos de Saída e Log para


verificar os resultados.

O programa da solicitação concorrente fará a leitura do arquivo de conciliação enviado


pela SERASA e informado em seus parâmetros. Para cada título informado neste arquivo
será verificado no Receivables se o mesmo foi liquidado totalmente ou não.

Um novo lote com status “NEW” e tipo de processamento “C – Conciliation” será criado
com os títulos do arquivo de concilação original e as datas de liquidação dos mesmos,
caso isto tenha ocorrido.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 52
4) Um novo arquivo com layout semelhante ao arquivo lido deverá ser gerado a partir deste
novo lote através de botão “Generate File”. Este arquivo será criado no diretório Unix
informado no campo “Remittance File Location” da tela de Parâmetros Iniciais. Para
diferenciar o arquivo de conciliação do arquivo de remessa normal utlizou-se o prefixo
“CONC” no nome do arquivo de conciliação.

5) Posteriormente, este novo arquivo contendo as datas de liquidação deverá ser enviado
para a SERASA.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 53
PEFIN
A seguir estão detalhados os processos de Remessa, Remessa de Ocorrências e Retorno do PEFIN.

Remessa

O processo de remessa para o PEFIN-SERASA consiste na criação de arquivo texto contendo


informações sobre títulos a receber com vencimento em atraso.

Os títulos criados no Contas a Receber que possuem vencimento em atraso e cujo cliente e tipo de
transação estão selecionados para ser enviado ao PEFIN-SERASA.

Para cada título será criada 1 linha no arquivo de remessa contendo o código de operação, data de
vencimento, CNPJ do cliente, nome do cliente, endereço do cliente, valor do título e número do
título.

Para os arquivos de Remessa, considera-se o Código de Operação = “I”, informando a inclusão do


título no PEFIN.

Exemplo: Título 1110-1 no valor de R$ 100,00 e vencido em 10/01/2015.


Cód. Op. Vencimento CNPJ Cliente Endereço Valor Título
I 10/01/2015 11.111.111/0001-11 XYZ LTDA Rua Cidade UF CEP 100,00 1110-1


A Oracle disponibiliza essa solução, utilizando os registros armazenados na tabela
core do Receivables: AR_PAYMENT_SCHEDULES_ALL.

Caso a empresa utilize o modulo core: Oracle Advanced Collections, do Oracle


eBusiness Suite, responsável pela cobrança de clientes do contas a receber, ou
possuir alguma regra específica que deve ser considerada na seleção dos títulos, é
possível customizar a view: CLL_F509_STD_PEFIN_REMIT_V, incluindo novas
tabelas e cláusulas de seleção.

IMPORTANTE: Nenhum campo utilizado na exibição ou nas condições de


seleção disponibilizadas pela Oracle nessa view, devem ser alterados.

Existem 2 formas de geração de um arquivo de remessa para o PEFIN-SERASA:

 Através de uma tela específica onde o usuário controla o momento de gerar o lote e o
momento de gerar o arquivo de remessa.

 Através da execução de uma solicitação concorrente, onde usuário submete a solicitação e a


criação do lote e do arquivo de remessa ocorrem automaticamente.

Independente da forma de geração do lote e arquivo de remessa, o processo irá sempre gerar lotes
e arquivos separados por estabelecimentos da Unidade Operacional selecionada. A distinção de
estabelecimentos se faz através da origem do lote da transação (ver Capítulo 2 – Configuração:
PEFIN - Associação de Origens do Lote por Unidade Operacional).

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 54
Remessa - Geração de arquivo através de tela específica

Este processo é dividido em 2 etapas.

Na primeira etapa cria-se o lote de remessa, onde são selecionados todos os títulos a receber
em atraso conforme parâmetros selecionados.

Caso não existam transações a serem selecionadas no período o lote de remessa não será
criado.

O lote de remessa poderá ter os seguintes status:

CREATED O lote foi criado porém os títulos ainda não foram selecionados.

SELECTED O lote foi gerado porém o arquivo de remessa ainda não foi criado.

O lote foi gerado, o arquivo de remessa foi criado porém ainda não houve retorno
FORMATTED
do processamento do arquivo pela SERASA.

REVERTED O lote selecionado foi revertido.

O lote foi gerado, o arquivo de remessa foi criado e processado com sucesso pela
CONFIRMED SERASA. Este status só é atribuído ao lote após a importação do arquivo de
retorno enviado pela SERASA.

O lote foi gerado, o arquivo de remessa foi criado e processado pela SERASA,
PARTIALLY porém existem transações que foram rejeitadas. Este status só é atribuído ao lote
após a importação do arquivo de retorno enviado pela SERASA.

O lote foi gerado, o arquivo de remessa foi criado e processado pela SERASA,
ERROR porém todas as transações foram rejeitadas. Este status só é atribuído ao lote após
a importação do arquivo de retorno enviado pela SERASA.

1) Acessar a tela de consulta e geração de lotes e criar um novo registro.


Os campos na sessão de cabeçalho: “Selection Criteria for Remittance Batches PEFIN” são
de preenchimento obrigatório, responsáveis por identificar o lote.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 55
Navegação: CLL: Brazilian Credit Bureau Integration  Serasa  Pefin  Pefin Remittance

2) Informe os parâmetros, se necessário.


Os campos da parte inferior da tela são de preenchimento opcional, sendo utilizados para
filtrar os títulos que se deseja incluir no lote que será criado. Se nenhum campo for
informado, serão selecionados todos os títulos de acordo com a parametrização do
sistema.
Na imagem abaixo, somente os títulos com vencimento entre 01-MAY-2015 e 31-MAY-
2015 serão selecionados.

3) Clicar no botão “Generate Batch” para criação do lote.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 56
4) Informe ‘Sim’ para continuar.

Lote e títulos criados com status”SELECTED”. Caso existam outros estabelecimentos


atribuídos à Unidade Operacional atual e estiverem devidamente configurados no módulo
Brazilian Fiscal Management será criado 1 lote para cada estabelecimento.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 57
Após a geração do lote é possível efetuar a reversão do mesmo através do botão “Revert
Batch”. Esta ação fará com que o status do lote e seus títulos seja alterado para
“REVERTED” e disponibilizará os títulos para serem selecionados na próxima geração de
lote.

Este passo somente pode ser executado para lotes com status “SELECTED”. Após a geração
do arquivo o lote e seus títulos ficarão com status “FORMATTED” e não será mais possível
efetuar a reversão do mesmo.

Para gerar o arquivo de remessa baseado no lote já selecionado, deve-se seguir os passos a
seguir.

É importante ressaltar que, antes de gerar o arquivo, é possível desmarcar as duplicatas


selecionadas com os parâmetros informados na tela anterior. Somente as duplicadas com o
flag “Selected” marcado serão incluídas no arquivo para envio à SERASA.

5) Clicar no botão “Format Batch” para criação do lote.

6) Informe ‘Sim’ para continuar.

Neste momento o arquivo é gerado no diretório Unix (configurado na tela de Parâmetros do


PEFIN), contendo todos os títulos selecionados na tela anterior e pode ser enviado à SERASA
para processamento, utilizando a ferramenta EDI7 da SERASA.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 58
Remessa - Geração de arquivo através de solicitação concorrente

Neste processo a geração do lote e do arquivo de remessa e remessa de ocorrências ocorre


numa única etapa.

A solicitação concorrente “SERASA – PEFIN – Remittance and Occurrence” é responsável


por criar o lote de remessa, observando os mesmos critérios de seleção da remessa por tela e
em seguida criar o arquivo de remessa.

Nesse processo, não é possível refinar o filtro dos títulos que serão enviados à SERASA e nem
consultar na tela antes de gerar o arquivo de remessa. O status do lote já será finalizado com
“FORMATTED” e o arquivo gerado no diretório Unix.

1) Execute uma nova Solicitação: “SERASA – PEFIN – Remittance and Occurrence”.

Navegação: Requests  Run

2) Informe o nome da solicitação e os parâmetros “Operating Unit”, “Remittance File


Location”, “Batch Name” e “Occurrence Batch Name”.

 O parâmetro: “Remittance File Location” é preenchido automaticamente com o


valor da tela de Parâmetros, no campo: “Remittance File Location” e não
permite alteração

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 59
3) Clique em OK e em Submit.

4) Aguarde o término da execução e consulte os arquivos de Saída e Log do Concurrent para


verificar os resultados.

Remessa de Ocorrências

O processo de remessa de ocorrências para o PEFIN-SERASA consiste na criação de arquivo texto


contendo informações sobre exclusões de títulos na SERASA, devido a liquidação da dívida

Os títulos em atraso, enviados na remessa e processados com sucesso pela SERASA, deverão ser
informados quando houver a liquidação do mesmo, através da remessa de ocorrências, com
indicação para exclusão do cadastro do PEFIN-SERASA.

Para cada título será criada 1 linha no arquivo de remessa contendo o código de operação, data de
vencimento, CNPJ do cliente, nome do cliente, endereço do cliente, valor do título e número do
título.

Para os arquivos de Remessa de Ocorrência, considera-se o Código de Operação = “E”,


informando a exclusão do título no PEFIN.

Exemplo: Título 1110-1 no valor de R$ 100,00 e vencido em 10/01/2015.


Cód. Op. Vencimento CNPJ Cliente Endereço Valor Título
E 10/01/2015 11.111.111/0001-11 XYZ LTDA Rua Cidade UF CEP 100,00 1110-1

Existem 2 formas de geração de um arquivo de remessa de ocorrências para o PEFIN-SERASA:

 Através de uma tela específica onde o usuário controla o momento de gerar o lote e o
momento de gerar o arquivo de remessa de ocorrências.

 Através da execução de uma solicitação concorrente, onde usuário submete a solicitação e a


criação do lote e do arquivo de remessa de ocorrências ocorrem automaticamente.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 60
Independente da forma de geração do lote e arquivo de remessa de ocorrências, o processo irá
sempre gerar lotes e arquivos separados por estabelecimentos da Unidade Operacional
selecionada. A distinção de estabelecimentos se faz através da origem do lote da transação (ver
Capítulo 2 – Configuração: PEFIN - Associação de Origens do Lote por Unidade Operacional).

Remessa de Ocorrências - Geração de arquivo através de tela específica

Este processo é dividido em 2 etapas.

Na primeira etapa cria-se o lote de remessa de ocorrências, onde são selecionados todos os
títulos a receber a serem excluídos na lista do PEFIN-SERASA conforme parâmetros
selecionados.

Caso não existam transações a serem selecionadas no período o lote de remessa não será
criado.

O lote de remessa poderá ter os seguintes status:

SELECTED O lote foi gerado porém ao arquivo de remessa ainda não foi criado.

O lote foi gerado, o arquivo de remessa foi criado porém ainda não houve retorno
FORMATTED
do processamento do arquivo pela SERASA.

REVERTED O lote selecionado foi revertido.

O lote foi gerado, o arquivo de remessa foi criado e processado com sucesso pela
CONFIRMED SERASA. Este status só é atribuído ao lote após a importação do arquivo de
retorno enviado pela SERASA.

O lote foi gerado, o arquivo de remessa foi criado e processado pela SERASA,
PARTIALLY porém existem transações que foram rejeitadas. Este status só é atribuído ao lote
após a importação do arquivo de retorno enviado pela SERASA.

O lote foi gerado, o arquivo de remessa foi criado e processado pela SERASA,
ERROR porém todas as transações foram rejeitadas. Este status só é atribuído ao lote após
a importação do arquivo de retorno enviado pela SERASA.

1) Acessar a tela de consulta e geração de lotes e criar um novo registro.


Os campos na sessão de cabeçalho: “Selection of Occurrence Remittance - PEFIN” são de
preenchimento obrigatório, responsáveis por identificar o lote.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 61
Navegação: CLL: Brazilian Credit Bureau Integration  Serasa  Pefin  Pefin Occurrence
Remittance

2) Informe os parâmetros, se necessário.


Os campos da parte inferior da tela são de preenchimento opcional, sendo utilizados para
filtrar os títulos que se deseja incluir no lote que será criado. Se nenhum campo for
informado, serão selecionados todos os títulos de acordo com a parametrização do
sistema.
Na imagem abaixo, somente os títulos com vencimento entre 01-MAY-2015 e 31-MAY-
2015 serão selecionados.

Após a criação do lote é possível efetuar a reversão do mesmo através do botão “Revert
Batch”. Esta ação fará com que o status do lote seja alterado para “REVERTED”.

Este passo somente pode ser executado para lotes com status “SELECTED”. Após a
geração do arquivo o lote e seus títulos ficarão com status “FORMATTED” e não será
mais possível efetuar a reversão do mesmo.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 62
3) Clicar no botão “Format Batch” para criação do lote.

Lote e títulos criados com status”FORMATTED”. Caso existam outros estabelecimentos


atribuídos à Unidade Operacional atual e estiverem devidamente configurados no módulo
Brazilian Fiscal Management será criado 1 lote para cada estabelecimento.

Neste momento o arquivo é gerado no diretório Unix (configurado na tela de Parâmetros do


PEFIN), contendo todos os títulos e pode ser enviado à SERASA para processamento,
utilizando a ferramenta EDI7 da SERASA.

Remessa de Ocorrências - Geração de arquivo através de solicitação concorrente

Neste processo a geração do lote e do arquivo de remessa e remessa de ocorrências ocorre


numa única etapa.

A solicitação concorrente “SERASA – PEFIN – Remittance and Occurrence” é responsável


por criar o lote de remessa de ocorrências, observando os mesmos critérios de seleção da
remessa de ocorrências por tela e em seguida cria o arquivo de remessa de ocorrências.

1) Execute uma nova Solicitação: “SERASA – PEFIN – Remittance and Occurrence”.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 63
Navegação: Requests  Run

2) Informe o nome da solicitação e os parâmetros “Operating Unit” e “Remittance File


Location”, “Batch Name” e “Occurrence Batch Name”.

 O parâmetro: “Remittance File Location” é preenchido automaticamente com o


valor da tela de Parâmetros, no campo: “Remittance File Location” e não
permite alteração

3) Clique em OK e em Submit.

4) Aguarde o término da execução e consulte os arquivos de Saída e Log do Concurrent para


verificar os resultados.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 64
Retorno

Após a criação do arquivo de remessa e remessa de ocorrências o mesmo deve ser encaminhado
para a SERASA realizar o processamento das informações contidas neste arquivo. A forma de
envio irá variar conforme a estrutura de transferência de arquivos definida pela empresa.

A SERASA irá recepcionar o arquivo de remessa, realizar o processamento das informações e irá
gerar um arquivo de retorno contendo o resultado deste processamento:

Indica que todos os dados enviados foram


REMESSA TOTAL PROCESSADA OK
aproveitados

Indica que alguns registros foram


inconsistidos. Nesse caso, é necessário
REMESSA PARCIALMENTE PROCESSADA verificar qual foi o erro, corrigi-lo e reenviar
os registros à SERASA Experian por meio do
arquivo de remessa normal

Indica que todo o arquivo foi inconsistido.


Nesse caso, será necessário verificar quais
TODA REMESSA DESPREZADA
foram os erros, corrigi-los e reenviar o arquivo
à SERASA Experian

Este arquivo de retorno deverá ser transferido para um diretório específico, definido nos
Parâmetros Iniciais (ver Capítulo 2 – Configuração: PEFIN – Parâmetros Iniciais) e
posteriormente importado para atualização do Brazilian Credit Bureau Integration.

A solicitação concorrente “SERASA - PEFIN – Return” é responsável por ler o arquivo de retorno
e atualizar o Brazilian Credit Bureau Integration.

1) Execute uma nova Solicitação: “SERASA – PEFIN – Return”.

Navegação: Requests  Run

2) Informe o nome da solicitação e os parâmetros “Operating Unit”, “Return File Location”


e “File Name”.

 O parâmetro: “Return File Location” é preenchido automaticamente com o valor


da tela de Parâmetros, no campo: “Return File Location” e não permite alteração

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 65
3) Clique em OK e em Submit.

4) Aguarde o término da execução e consulte os arquivos de Saída e Log do Concurrent para


verificar os resultados.

Histórico de Ocorrências

Essa tela tem como objetivo exibir o histórico da duplicada em todos os lotes gerados, enviados
e/ou processados pelo PEFIN-SERASA.

Permite a inserção manual de uma ocorrência, somente quando última Ocorrência da duplicata
possuir status igual a 'REMITTED', 'CONFIRMED', 'ERROR' ou 'REVERTED_OC', clicando no
botão “Ocurrences”, estando com a duplicada selecionada na tela de Histórico.

Ao ser gerado o concurrent responsável pela geração do arquivo de Remessa de Ocorrências, essa
inclusão manual da ocorrência será enviada à SERASA, informando que o título pode ser excluído
do PEFIN, pois já houve a liquidação do mesmo.

A seguir estão detalhados os procedimentos para utilização da tela de Histórico de Ocorrências:

1) Ao acessar a tela de histórico de ocorrências, acione o comando F11+CTRL F11 para


localização de títulos.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 66
Navegação: CLL: Brazilian Credit Bureau Integration  Serasa  Pefin  Pefin Occurrence History

2) Será apresentada uma tela contendo um resumo do título que já foram considerado em lotes
de remessa, conforme pesquisa solicitada.

Quando o último processamento do título encontrar-se na SERASA, ou seja o retorno do título


foi processado com sucesso, o campo “Confirme Serasa/Pefin” terá valor “Yes”

4) Para verificar as ocorrências de um título, deve-se posicionar o cursor sobre o título


desejado e em seguida clicar no botão “Occurrences”.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 67
As ocorrências do título selecionado serão exibidos na tela abaixo:

5) Quando após o processamento do arquivo de retorno o lote ficar com status “ERROR” ou
“PARTIALLY” significa que alguma inconsistência foi detectada. O código do erro com
sua descrição aparecerá nessa tela nos campos “Return Info” e “Return Description”

Histórico de Ocorrências - Solicitação manual de exclusão de título no PEFIN

Após selecionado o título e acionado o botão “Occurrences”, conforme descrito no item


anterior, é possível fazer uma solicitação Manual de exlusão do título, desde que a última
Ocorrência status igual a 'REMITTED', 'CONFIRMED', 'ERROR' ou 'REVERTED_OC'.

Quando o status da última ocorrência do título for diferente dos status relacionados
anteriormente, a opção “New” está desabilitada no menu, impossibilitando a criação manual
da ocorrência de exclusão do título.

1) Acessar a tela de histórico de ocorrências e localizar o título a ser excluído do PEFIN-


SERASA.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 68
Navegação: CLL: Brazilian Credit Bureau Integration  Serasa  Pefin  Pefin Occurrence History

2) Acionar o Botão “Occurrences”

3) Acionar no menu a opção “New” e inserir a linha de exclusão, informando


obrigatoriamente o motivo pelo qual o título está sendo excluído.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 69
4) Salve o registro.

Ao gerar um novo lote de remessa de ocorrências, esse título em questão será selecionado na
lista de ocrrências à ser enviado ao PEFIN-SERASA.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 70
CONFIE
A seguir estão detalhados os processos de consulta ao WebService do CONFIE.

Essa seção tem como objetivo detalhar os parâmetros utilizados nos 2 procedimentos disponíveis
na API.

Conterá também um exemplo em PL/SQL de um bloco anônimo com a chamada da API.

Public API
A API tem como objetivo validar os parâmetros de entrada do WebService, fazer a chamada do
serviço, através do Business Event e devolver o retorno do WebService em um parâmetro de
saída.

Temos na API 2 procedimentos:


1) SEND_REQUEST: responsável pelas validações iniciais e chamada do serviço
2) WAIT_FOR_RESPONSE: responsável por devolver o retorno do WebService.

A seguir, a definição dos parâmetros de cada procedimentos da API Pública:


CLL_F509_CONFIE_PUB

Procedimento: SEND_REQUEST

Esse procedimento possui os parâmetros:

Parameter Name IN/OUT Type Comments


p_confie_id IN NUMBER Informar o próximo valor na sequence:
CLL_F509_CONFIE_S
p_document_number IN VARCHAR2 Informar o número do CNPJ, CPF ou
Inscrição Estadual do cliente que será
consultado
p_state IN VARCHAR2 Informar a UF do endereço do cliente que
será consultado. Enviar somente quando o
tipo do documento for Inscrição Estadual.
Para os tipos de documento CNPJ ou CPF
deve estar nulo
p_username IN VARCHAR2 Usuário da empresa com permissão para
acessar o WebService do CONFIE. Deve
buscar o valor cadastrado no campo
“Username” da tela de Parâmetros (aba
Confie)
p_password IN VARCHAR2 Senha do usuário da empresa com permissão
para acessar o WebService do CONFIE. Deve
buscar o valor cadastrado no campo
“Password” da tela de Parâmetros (aba
Confie)
p_request_type IN NUMBER Informar somente os números que identificam
o tipo de consulta. Números válidos de 1 a 5,
cadastrados na lookup:
CLL_F509_CONFIE_REQUEST_TYPES.
Deve buscar o valor cadastrado no campo

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 71
“Request Type” da tela de Parâmetros (aba
Confie)
p_report_type IN NUMBER Informar somente os números que identificam
o tipo de relatório. Números válidos de 1 a 4,
cadastrados na lookup:
CLL_F509_CONFIE_REPORT_TYPES.
Deve buscar o valor cadastrado no campo
“Report Type” da tela de Parâmetros (aba
Confie)
p_return_type IN NUMBER Informar somente os números que identificam
o tipo de retorno. Número válido: 1,
cadastrados na lookup:
CLL_F509_CONFIE_REPORT_TYPES.
(tipo de retorno 2 – formato string, fora do
escopo). Deve buscar o valor cadastrado no
campo “Return Type” da tela de Parâmetros
(aba Confie)
p_document_type IN VARCHAR2 Informar o código que identifica o tipo de
documento que será consultado. Valores
válidos: “1”, “2” e “I” cadastrados na lookup:
CLL_F509_CONFIE_DOCUMENT_TYPES.
p_timeout IN NUMBER Informar o valor em segundos, para esperar o
retorno do serviço. Valor mínimo de 20
segundos. Deve buscar o valor cadastrado no
campo “Timeout” da tela de Parâmetros (aba
Confie)
p_day_exceeded IN NUMBER Informar o valor máximo de dias para nova
consulta do cliente no CONFIE. Valor
mínimo de 1 dia. Deve validar se o tipo de
documento do cliente consultado é CNPJ ou
CPF e buscar o valor cadastrado nos campos
da tela de Parâmetros (aba Confie), sendo:
CNPJ: campo: “CNPJ - Days exceeded”
CPF: campo: “CPF - Days exceeded”
p_html_generate IN VARCHAR2 Infomar se deseja receber o retorno também
em um bloco adicional, contendo o código
HTML. Disponível somente para consultas do
tipo “online”. Deve buscar o valor cadastrado
no campo “Generate XML Additional?” da
tela de Parâmetros (aba Confie)
p_event_key OUT VARCHAR2 Retorna o valor gerado para o “event_key”
que identifica a consulta realizada na fila do
Agent do Business Event (queue_table)
p_begin_date OUT DATE Retorna a data de chamada no serviço
p_input_payload OUT CLOB Retorna o payload de envio consultado na
SERASA
p_status_call OUT VARCHAR2 Retorna o status “REQUEST”, identificando
que foi feita a consulta no serviço e está
aguardando o retorno
p_return_message OUT VARCHAR2 Retorna possíveis erros de validações dos
parâmetros iniciais ou alguma mensagem de
erro inesperado.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 72
Procedimento: WAIT_FOR_RESPONSE

Esse procedimento possui os parâmetros:

Parameter Name IN/OUT Type Comments


p_event_key IN VARCHAR2 Informar o valor do “event_key” que
identifica a consulta realizada na fila do Agent
do Business Event (queue_table), gerado no
procedimento: SEND_REQUEST
p_timeout IN NUMBER Informar o valor em segundos, para esperar o
retorno do serviço. Poderá ser o mesmo valor
informado no parâmetro do procedimento:
SEND_REQUEST. Valor mínimo de 20
segundos. Será adicionado 10 segundos no
valor informado.
p_end_date OUT DATE Retorna a data da consulta do serviço
p_output_payload OUT CLOB Retorna o payload de retorno do Confie
p_status_call OUT VARCHAR2 Retorna o status “RESPONSE”, identificando
que foi feita a consulta e o retorno no serviço
do Confie

Bloco Anônimo – PL/SQL

A seguir temos um exemplo de Bloco Anônimo em PL/SQL de como pode ser feita a
chamada da API.

Vale ressaltar que, nesse exemplo, os valores informados não foram selecionados na tela
de parâmetros do CONFIE, pois tem como objetivo somente exemplificar a chamada do
WebService através da API.


Importante:

Esse código deve ser alterado de acordo com a necessidade do cliente, sendo de
suma importância que os valores informados nos parâmetros da API sejam
recuperados da tela de parâmetros do CONFIE.

Exemplo do Bloco Anônimo, chamando os 2 procedimentos da API:

set serveroutput on
DECLARE
l_event_key VARCHAR2(50);
l_begin_date DATE;
l_input_payload CLOB;
l_status_call VARCHAR2(50);
l_return_message VARCHAR2(4000);
--
l_end_date DATE;
l_output_payload CLOB;
l_status_call_out VARCHAR2(50);
BEGIN
-- Send Request
cll_f509_confie_pub.send_request (p_confie_id => CLL_F509_CONFIE_S.NEXTVAL
,p_document_number => '00000125000111'
,p_state => NULL --'DF'

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 73
,p_username => 'username'
,p_password => 'password'
,p_request_type => 2
,p_report_type => 3
,p_return_type => 1
,p_document_type => '1'
,p_timeout => 20000
,p_day_exceeded => 060
,p_html_generate => 'N' --'S'
-- out
,p_event_key => l_event_key
,p_begin_date => l_begin_date
,p_input_payload => l_input_payload
,p_status_call => l_status_call
,p_return_message => l_return_message
);
dbms_output.put_line('l_event_key = '||l_event_key);
dbms_output.put_line('l_begin_date = '||l_begin_date);
dbms_output.put_line('l_input_payload = '||l_input_payload);
dbms_output.put_line('l_status_call = '||l_status_call);
dbms_output.put_line('l_return_message = '||l_return_message);
--
COMMIT;
--
--
-- Waiting For Response
--
IF l_event_key IS NOT NULL THEN
cll_f509_confie_pub.wait_for_response (p_event_key => l_event_key
,p_timeout => 20000 -- p_timeout
-- out
,p_end_date => l_end_date
,p_output_payload => l_output_payload
,p_status_call => l_status_call_out
);
dbms_output.put_line('l_end_date = '||l_end_date);
dbms_output.put_line('l_output_payload = '||l_output_payload);
dbms_output.put_line('l_status_call = '||l_status_call_out);
--
COMMIT;
--
END IF;
END;

Após execução da API, o retorno exibido no output deve ser parecido com esse:

Se nenhum retorno for exibido no output, após um tempo de espera, é possível que há
algum problema em suas configurações e é necessário acionar a equipe técnica (DBA)
para ajudar na solução do problema. Um exemplo de erro que pode ocorrer, é o ambiente
estar sem permissão para acessar o endpoint do serviço da Serasa-Confie.

LAD Localizations Manual do Usuário


Brazilian Credit Bureau Integration 74

Você também pode gostar