CLL F509 Ug PTB
CLL F509 Ug PTB
CLL F509 Ug PTB
Manual do Usuário
RELEASE 12.0.6
Versão 5
DISCLAIMER:
Registro de Alterações
Revisores
Nome Função
Prefácio 5
O Manual ................................................................................................................................... 6
Como Usar este Manual ...................................................................................................... 6
Documentos Relacionados .................................................................................................. 7
Comentários/Sugestões ....................................................................................................... 7
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
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
Funções específicas que você pode executar com o 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.
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.
Forma de Edição/Acesso
A forma de edição/acesso aos campos é:
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.
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.
WebService do Confie;
Premissas
A seguir relacionamos informações sobre integrações SERASA e a forma pela qual descrevemos
os seus respectivos conteúdos.
Conceito
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º).
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.
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.
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.
PEFIN
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.
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
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.
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.
Detalhes sobre a tela de parâmetros iniciais e API estão descritos no decorrer desse documento.
2 Configuração
E ste capítulo detalha como configurar o CLL-F509 Brazilian Credit Bureau Integration para a
WebService do CONFIE, além de demonstrar como deve ser o acesso a API Pública que irá
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).
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:
1. Diretório Unix
2. Informações de empresa
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.
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.
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.
1) Selecionar o Cliente.
SERASA-RELATO Status
Informação preenchida automaticamente pelo sistema. Os possíveis estatus são:
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.
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”.
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.
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.
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.
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.
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:
Sequência de Implementação
Seguem abaixo os passos para configuração do CLL-F509 Brazilian Credit Bureau Integration –
PEFIN:
1. Diretório Unix
2. Informações de empresa
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.
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.
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.
Consulte também: Oracle Brazilian Fiscal Managment User’s Guide para obter
maiores informações sobre a configuração.
1) Selecionar o Cliente.
5) Salvar as alterações.
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”.
4) Salvar as alterações.
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.
Operating Unit
Nome da Unidade Operacional a ser parametrizada. Considera o setup por MOAC ou profile
da responsabilidade para exibir a lista de valores.
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.
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.
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.
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:
2. Informações de empresa
3. Parâmetros iniciais
4. Business Event
5. Public API
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:
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.
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.
Importante:
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.
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.
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.
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 API pública: CLL_F509_CONFIE_PUB é responsável por acionar o Business Event, que faz a
chamada no WebService da Serasa-Confie.
send_request:
Responsável por:
wait_for_response:
Responsável por:
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.
3 Processos
Neste capítulo são detalhados os processos do CLL-F509 Brazilian Credit Bureau Integration.
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.
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.
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.
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.).
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
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.
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.).
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
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).
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.
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.
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).
Caso não existam transações a serem selecionadas no período o lote de remessa não será
criado.
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.
Navegação: CLL: Brazilian Credit Bureau Integration Serasa Relato Remittance Regular
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.
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.
Neste processo a geração do lote e do arquivo de remessa ocorre numa única etapa.
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:
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.
Consulta da Remessa
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.
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”.
Reprocessamento da Remessa
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.
2) Os erros demonstrados na tela de erros (botão “View Errors”) devem ser corrigidos.
4) Uma nova solicitação concorrente é submetida para criação do novo lote de remessa
contendo somente as transações que tiveram erro.
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.).
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.
5) Posteriormente, este novo arquivo contendo as datas de liquidação deverá ser enviado
para a SERASA.
Remessa
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.
A Oracle disponibiliza essa solução, utilizando os registros armazenados na tabela
core do Receivables: AR_PAYMENT_SCHEDULES_ALL.
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.
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).
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.
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.
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.
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.
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.
Remessa de Ocorrências
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.
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.
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.
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.
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.
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.
3) Clique em OK e em Submit.
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:
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.
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.
2) Será apresentada uma tela contendo um resumo do título que já foram considerado em lotes
de remessa, conforme pesquisa solicitada.
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”
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.
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.
Essa seção tem como objetivo detalhar os parâmetros utilizados nos 2 procedimentos disponíveis
na 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.
Procedimento: SEND_REQUEST
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.
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'
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.