LAD Consulting Localizations

CLL-F509 Brazilian Credit

Bureau Integration

Implementation Guide

RELEASE 12

April 2015

Version 3

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.
Document Control

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

01-Apr-15 Luiz Gustavo Fontes 1 Creation

07-Jan-16 Rodrigo Naves 2 Insert info about Proxy Setup for webservices connection for
CONFIE
17-Aug-16 Valéria Zana 3 Insert info about Business Event configuration and API for
CONFIE

Reviewers
Nome Função

Ketter Rogerio Localizations Manager

Valéria de Souza Zana Localizations Senior Application Engineer

LAD Consulting Localizations Implementation Guide Document Control ii

Brazilian Receivables SERASA Localization
Send us Your Comments
Oracle welcomes customers' comments and suggestions on the quality and usefulness of this document.
Your feedback is important, and helps us to best meet your needs as a user of our products. For example:
 Are the implementation steps correct and complete?
 Did you understand the context of the procedures?
 Did you find any errors in the information?
 Does the structure of the information help you with your tasks?
 Do you need different information or graphics? If so, where, and in what format?
 Are the examples correct? Do you need more examples?
If you find any errors or have any other suggestions for improvement, then please tell us your name, the
name of the company who has licensed our products, the title and part number of the documentation and
the chapter, section, and page number (if available).
Note: Before sending us your comments, you might like to check that you have the latest version of the
document and if any concerns are already addressed. To do this, access the new Applications Release
Online Documentation CD available on Oracle MetaLink and www.oracle.com. It contains the most
current Documentation Library plus all documents revised or released recently.
Send your comments to us using the electronic mail address: appsdoc_us@oracle.com
Please give your name, address, electronic mail address, and telephone number (optional).
If you need assistance with Oracle software, then please contact your support representative or Oracle
Support Services.
If you require training or instruction in using Oracle software, then please contact your Oracle local
office and inquire about our Oracle University offerings. A list of Oracle offices is available on our Web
site at www.oracle.com.

LAD Consulting Localizations Implementation Guide Send us Your Comments iii

Brazilian Receivables SERASA Localization
Preface

Intended Audience

Welcome to Release 12 of the CLL-F509 Brazilian Credit Bureau Integration Implementation Guide.
This guide assumes you have a working knowledge of the following:
 The principles and customary practices of your business area.
 Computer desktop application usage and terminology
If you have never used Oracle Applications, we suggest you attend one or more of the Oracle Applications
training classes available through Oracle University.

TTY Access to Oracle Support Services

Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United
States of America 24 hours a day, seven days a week. For TTY support, call 800.446.2398.

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good
usability, to the disabled community. To that end, our documentation includes features that make
information available to users of assistive technology. This documentation is available in HTML format,
and contains markup to facilitate access by the disabled community. Accessibility standards will
continue to evolve over time, and Oracle is actively engaged with other market-leading technology
vendors to address technical obstacles so that our documentation can be accessible to all of our
customers. For more information, visit the Oracle Accessibility Program Web site at
http://www.oracle.com/accessibility/ .

Accessibility of Code Examples in Documentation

Screen readers may not always correctly read the code examples in this document. The conventions for
writing code require that closing braces should appear on an otherwise empty line; however, some
screen readers may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not
own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these
Web sites.

LAD Consulting Localizations Implementation Guide Preface iv

Brazilian Receivables SERASA Localization
Structure

1. Overview
2. Planning Your Implementation
3. Configuring Oracle CLL-F509 Brazilian Credit Bureau Integration
a. Profile Options Setup
b. Add CLL Extension Function to Menus
c. Personalize Forms
d. Proxy Setup and Business Event about CONFIE (R12.1.3+ only)

Related Information Sources

This document is available through Metalink.

If this guide refers you to other Oracle Applications documentation, use only the Release 12 versions of
those guides.
For a full list of documentation resources for Oracle Applications Release 12, see Oracle Applications
Documentation Resources, Release 12, OracleMetaLink Document 394692.1.
Online Documentation
All Oracle Applications documentation is available online (HTML or PDF).
 PDF - PDF documentation is available for download from the Oracle Technology Network at
http://otn.oracle.com/documentation.
 Online Help - Online help patches (HTML) are available on Oracle MetaLink.
 Oracle MetaLink Knowledge Browser - The OracleMetaLink Knowledge Browser lets you
browse the knowledge base, from a single product page, to find all documents for that product
area. Use the Knowledge Browser to search for release-specific information, such as FAQs,
recent patches, alerts, white papers, troubleshooting tips, and other archived documents.
 Oracle eBusiness Suite Electronic Technical Reference Manuals - Each Electronic Technical
Reference Manual (eTRM) contains database diagrams and a detailed description of database
tables, forms, reports, and programs for a specific Oracle Applications product. This information
helps you convert data from your existing applications and integrate Oracle Applications data with
non-Oracle applications, and write custom reports for Oracle Applications products. Oracle eTRM
is available on Oracle MetaLink.

Related Guides
You should have the following related books on hand. Depending on the requirements of your particular
installation, you may also need additional manuals or guides.
Oracle Applications Installation Guide: Using Rapid Install:
This book is intended for use by anyone who is responsible for installing or upgrading Oracle Applications.
It provides instructions for running Rapid Install either to carry out a fresh installation of Oracle
Applications Release 12, or as part of an upgrade from Release 11i to Release 12. The book also describes
the steps needed to install the technology stack components only, for the special situations where this is
applicable.
Oracle Applications System Administrator's Guide Documentation Set
This documentation set provides planning and reference information for the Oracle Applications System
Administrator. Oracle Applications System Administrator's Guide - Configuration contains information on
system configuration steps, including defining concurrent programs and managers, enabling Oracle
Applications Manager features, and setting up printers and online help. Oracle Applications System
Administrator's Guide - Maintenance provides information for frequent tasks such as monitoring your

LAD Consulting Localizations Implementation Guide Preface v

Brazilian Receivables SERASA Localization
 system with Oracle Applications Manager, managing concurrent managers and reports, using diagnostic
utilities, managing profile options, and using alerts. Oracle Applications System Administrator's Guide -
Security describes User Management, data security, function security, auditing, and security
configurations.
Oracle Applications Upgrade Guide: Release 11i to Release 12:
This guide provides information for DBAs and Applications Specialists who are responsible for upgrading
a Release 11i Oracle Applications system (techstack and products) to Release 12. In addition to information
about applying the upgrade driver, it outlines pre-upgrade steps and post-upgrade steps, and provides
descriptions of product-specific functional changes and suggestions for verifying the upgrade and reducing
downtime.
Oracle Applications Flexfields Guide
This guide provides flexfields planning, setup, and reference information for the Oracle Applications
implementation team, as well as for users responsible for the ongoing maintenance of Oracle Applications
product data. This guide also provides information on creating custom reports on flexfields data.
Oracle Cash Management User Guide:
This guide describes how to use Oracle Cash Management to clear your receipts, as well as reconcile bank
statements with your outstanding balances and transactions. This manual also explains how to effectively
manage and control your cash cycle. It provides comprehensive bank reconciliation and flexible cash
forecasting.
Oracle General Ledger Implementation Guide:
This guide provides information on how to implement Oracle General Ledger. Use this guide to understand
the implementation steps required for application use, including how to set up Accounting Flexfields,
Accounts, and Calendars.
Oracle General Ledger Reference Guide:
This guide provides detailed information about setting up General Ledger Profile Options and
Applications Desktop Integrator (ADI) Profile Options.
Oracle General Ledger User's Guide:
This guide provides information on how to use Oracle General Ledger. Use this guide to learn how to
create and maintain ledgers, ledger currencies, budgets, and journal entries. This guide also includes
information about running financial reports.
Oracle Payables User Guide:
This guide describes how to use Oracle Payables to create invoices and make payments. In addition, it
describes how to enter and manage suppliers, import invoices using the Payables open interface, manage
purchase order and receipt matching, apply holds to invoices, and validate invoices. It contains information
on managing expense reporting, procurement cards, and credit cards. This guide also explains the
accounting for Payables transactions.
Oracle Payables Implementation Guide:
This guide provides you with information on how to implement Oracle Payables. Use this guide to
understand the implementation steps required for how to set up suppliers, payments, accounting, and tax.
Oracle Payables Reference Guide:
This guide provides you with detailed information about the Oracle Payables open interfaces, such as
the Invoice open interface, which lets you import invoices. It also includes reference information on
purchase order matching and purging purchasing information.
Oracle Receivables User Guide:
This guide provides you with information on how to use Oracle Receivables. Use this guide to learn how
to create and maintain transactions and bills receivable, enter and apply receipts, enter customer
information, and manage revenue. This guide also includes information about accounting in Receivables.
Use the Standard Navigation Paths appendix to find out how to access each Receivables window.

LAD Consulting Localizations Implementation Guide Preface vi

Brazilian Receivables SERASA Localization
 Oracle Receivables Implementation Guide:
This guide provides you with information on how to implement Oracle Receivables. Use this guide
to understand the implementation steps required for application use, including how to set up
customers, transactions, receipts, accounting, tax, and collections. This guide also includes a
comprehensive list of profile options that you can set to customize application behavior.
Oracle Receivables Reference Guide:
This guide provides you with detailed information about all public application programming interfaces
(APIs) that you can use to extend Oracle Receivables functionality. This guide also describes the Oracle
Receivables open interfaces, such as AutoLockbox which lets you create and apply receipts and
AutoInvoice which you can use to import and validate transactions from other systems. Archiving and
purging Receivables data is also discussed in this guide.

Integration Repository

The Oracle Integration Repository is a compilation of information about the service endpoints exposed by
the Oracle E-Business Suite of applications. It provides a complete catalog of Oracle E-Business Suite's
business service interfaces. The tool lets users easily discover and deploy the appropriate business service
interface for integration with any system, application, or business partner.
The Oracle Integration Repository is shipped as part of the E-Business Suite. As your instance is patched,
the repository is automatically updated with content appropriate
for the precise revisions of interfaces in your environment.

Do Not Use Database Tools to Modify Oracle Applications Data

Oracle STRONGLY RECOMMENDS that you never use SQL*Plus, Oracle Data Browser, database
triggers, or any other tool to modify Oracle Applications data unless otherwise instructed.
Oracle provides powerful tools you can use to create, store, change, retrieve, and maintain information in
an Oracle database. But if you use Oracle tools such as SQL*Plus to modify Oracle Applications data,
you risk destroying the integrity of your data and you lose the ability to audit changes to your data.
Because Oracle Applications tables are interrelated, any change you make using an Oracle Applications
form can update many tables at once. But when you modify Oracle Applications data using anything other
than Oracle Applications, you may change a row in one table without making corresponding changes in
related tables. If your tables get out of synchronization with each other, you risk retrieving erroneous
information and you risk unpredictable results throughout Oracle Applications.
When you use Oracle Applications to modify your data, Oracle Applications automatically checks
that your changes are valid. Oracle Applications also keeps track of who changes information. If
you enter information into database tables using database tools, you may store invalid information.
You also lose the ability to track who has changed your information because SQL*Plus and other
database tools do not keep a record of changes.

LAD Consulting Localizations Implementation Guide Preface vii

Brazilian Receivables SERASA Localization
 Content

Document Control...................................................................................................................... ii

Send us Your Comments........................................................................................................... iii

Preface ...................................................................................................................................... iv
Intended Audience ............................................................................................................ iv
TTY Access to Oracle Support Services ......................................................................... iv
Documentation Accessibility .......................................................................................... iv
Accessibility of Code Examples in Documentation ...................................................... iv
Accessibility of Links to External Web Sites in Documentation ................................. iv
Structure ............................................................................................................................. v
Related Information Sources............................................................................................... v
Integration Repository .................................................................................................... vii
Do Not Use Database Tools to Modify Oracle Applications Data ................................ vii

CHAPTER 1 Overview ................................................................................................................................... 1

Introduction to Oracle CLL-F509 Brazilian Credit Bureau Integration ................................... 2

CHAPTER 2 Planning your Implementation ............................................................................................... 3

Planning Your Implementation .................................................................................................. 4

Shared Planning .................................................................................................................. 4
What Latin America Localizations do you plan to implement? .......................................... 4

CHAPTER 3 Configuring Oracle CLL-F509 Brazilian Credit Bureau Integration ................................. 5

Configuring Oracle CLL-F509 Brazilian Credit Bureau Integration ......................................... 6

Oracle CLL-F509 Brazilian Credit Bureau Integration Implementation Checklist .......... 6
Step 1. Define CLL Extension Profile Options ............................................................... 6
Step 2. Add Extension Function to Menus.......................................................................... 6
Step 3. Personalize Forms................................................................................................... 8
Step 3.1. Oracle Receivables Personalizations – Transaction Type Form .......................... 8
Step 3.2. Oracle Receivables Personalizations – Customer Account Page ....................... 11
Step 4. Proxy Setup, Business Event and API about CONFIE ......................................... 14
Step 4.1. Proxy Setup for webservices connection for CONFIE ...................................... 14
Step 4.2. Business Event about CONFIE.......................................................................... 15
Step 4.2.1 Business Event – INVOKE Type .................................................................... 16
Step 4.2.2 Business Event – RESPONSE Type ................................................................ 22
Step 4.2.3 Business Event – Setup Testing ....................................................................... 26
Step 4.3. Public API ......................................................................................................... 27

LAD Consulting Localizations Implementation Guide Preface viii

Brazilian Receivables SERASA Localization
CHAPTER

1 Overview

LAD Consulting Localizations Implementation Guide 1

CLL-F509 Brazilian Credit Bureau Integration
Introduction to Oracle CLL-F509 Brazilian Credit Bureau Integration
Oracle CLL-F509 Brazilian Credit Bureau Integration is a product in the Oracle E-Business Suite of
Applications, which complements the core functionalities with additional features in order to avoid
several customizations at customer site.
This solution was built to offer the capability of send and receive files containing customer’s transaction
information for SERASA RELATO/PEFIN Report based on Brazilian requirements. Also allow get
customer’s information through CONFIE WebService.

LAD Consulting Localizations Implementation Guide 2

CLL-F509 Brazilian Credit Bureau Integration
CHAPTER

2 Planning your
Implementation

LAD Consulting Localizations Implementation Guide 3

CLL-F509 Brazilian Credit Bureau Integration
Planning Your Implementation

Shared Planning

Note: Before implementing Oracle CLL-F509 Brazilian Credit Bureau Integration, it is

advisable to answer the questions in this section to ensure that your implementation meets your
business needs

What Latin America Localizations do you plan to implement?

Latin America Consulting Localizations provides solutions for several countries. It is not
necessary to follow the steps from this manual if it is not planned to make use of the Brazilian
portion of the Latin America Consulting Localizations patch.

If you do not plan to implement Oracle Application for Brazil then it is not necessary to follow
this manual instructions.

LAD Consulting Localizations Implementation Guide 4

CLL-F509 Brazilian Credit Bureau Integration
CHAPTER

3 Configuring Oracle CLL-

F509 Brazilian Credit Bureau
Integration

LAD Consulting Localizations Implementation Guide 5

CLL-F509 Brazilian Credit Bureau Integration
Configuring Oracle CLL-F509 Brazilian Credit Bureau Integration

Oracle CLL-F509 Brazilian Credit Bureau Integration Implementation Checklist

The table below shows the Oracle Latin America Consulting Localizations implementation
checklist. All required setup steps in this checklist must be completed.

Oracle CLL-F509 Brazilian Credit Bureau Integration Implementation Checklist

Step Number Implementation Steps Required or Optional

1 Define CLL Extension Profile Options Required
2 Add Extension Function to Menus Required
3 Personalize Forms Required
4 Proxy Setup and Business Event about Required – R12.1.3+ only
CONFIE

Step 1. Define CLL Extension Profile Options

To have access to Brazilian Credit Bureau Integration Extensions it is necessary to enable some
profile options.
These profiles can be defined at several levels including at Operating Unit level.
Possible values are “Yes” or “No”. If no value is defined then it means “No”
Brazilian Credit Bureau Integration Profiles are:

CLL F509: Enable Extension This profile gives to the user the ability to
for Brazilian Serasa Solution use extension on AR Customer Standard
page and Transaction Types forms

Step 2. Add Extension Function to Menus

The Latin America Consulting Localization Extension Page is a new function that has to be added
to the Menus linked to the responsibility that will be used.
To add this feature please follow these steps for each AP, GL and AR Responsibilities that will be
used by Brazilian Users:
1) Go to Responsibility Definition Form and get the Menu Name attached to the responsibility
Path: System Administrator -> Security -> Responsibility -> Define

LAD Consulting Localizations Implementation Guide 6

CLL-F509 Brazilian Credit Bureau Integration
 2) Go to Enter Menu Form and search desired Menu
Path: System Administrator -> Application -> Menu

3) Include a new line with the Latin America Consulting Extension page
Function Name: CLL LXM: Localization Extensions Manager

LAD Consulting Localizations Implementation Guide 7

CLL-F509 Brazilian Credit Bureau Integration
Step 3. Personalize Forms

Each Latin America Localization Extension has to be defined as a personalization in the original Form
(or page) in R12. Personalization is a new feature and it is the best place to add extension functionality.
It is not possible currently to deliver this personalization as a patch since the customers personalizations
would be erased and replaced by localized personalizations. At this moment this has to be done
manually.
It is possible to carry all personalizations from one environment to another without the need of
reentering them manually. Please, look for Metalink notes regarding “Import/Export Personalizations”.

NOTE: After the configuration the Latin America Extension page will be avaliable as:
Forms: In the Form menu go to “Tools -> CLL Extension”
Java page: A new button will appear in the upper right corner with the name “CLL Additional Info”
for the Quick and for the Update page

Step 3.1. Oracle Receivables Personalizations – Transaction Type Form

Please follow the instructions below for personalizing this form:

1. Open the Transaction Types form;
Path: Receivables -> Setup -> Transactions -> Transaction Types
2. On Help menu, click Diagnostics, Custom Code, and then Personalize;
3. After opening Form Personalizations screen, set this form for sequence 10 (Active Tools
Options) in according to screen below:
a. Condition Tab

LAD Consulting Localizations Implementation Guide 8

CLL-F509 Brazilian Credit Bureau Integration
 Trigger Event: WHEN-NEW-FORM-INSTANCE
Processing Mode: Not in Enter-Query Mode

b. Actions Tab

You can use Copy /Paste to avoid errors.

Seq: 10
Type: Menu
Language: All
Enabled: yes

Menu Entry: SPECIAL1: Additional Information

Menu Label: Additional Information
Enabled in Block (s): RA_CUST_TRX_TYPES

4. Set the sequence 20 (Go to SERASA Transaction Type Extension) in the same form:

a. Condition Tab

LAD Consulting Localizations Implementation Guide 9

CLL-F509 Brazilian Credit Bureau Integration
 Trigger Event: SPECIAL1
Condition: :SYSTEM.CURRENT_BLOCK='RA_CUST_TRX_TYPES'
Processing Mode: Not in Enter-Query Mode

b. Actions Tab

You can use Copy /Paste to avoid errors.

Seq: 10
Type: Builtin
Language: All
Enabled: yes

Builtin Type: Launch a Function

Function Code: CLL_LXM_PG
Function Name: CLL LXM: Localization Extensions Manager
Parameters:
'pExtendedTable=RA_CUST_TRX_TYPES_ALL&pConnectString=CUST_TRX_TYPE_ID=
'||${item.RA_CUST_TRX_TYPES.CUST_TRX_TYPE_ID.value}||',ORG_ID='||${ite
m.RA_CUST_TRX_TYPES.ORG_ID.value}

5. Click in “Apply Now” button, save your job and close the form.

LAD Consulting Localizations Implementation Guide 10

CLL-F509 Brazilian Credit Bureau Integration
 6. In Transaction Types forms, find or create a new setup.
7. The option “Addition Information” will be enabled in Tools menu

8. The fields about SERASA Extension will be exhibited

For more details about this fields, please verify User Guide Documentation.

Step 3.2. Oracle Receivables Personalizations – Customer Account Page

Please follow the instructions below for personalizing this page:

1. Open the Enter Customer page;
Path: Receivables -> Customers -> Standard
2. Find a Customer.
3. Choose an account and press “Details” button.

4. Press the “Personalize Page” in the page upper right corner.

LAD Consulting Localizations Implementation Guide 11

CLL-F509 Brazilian Credit Bureau Integration
 NOTE: If you do not see a “Personalize Page” option then it is necessary to setup two profile
options as follows:
 FND: Personalization Region Link Enabled = “Y”
 Personalize Self-Service Defn = “Y”

5. Look for “Advanced Table: Account Sites” and press the “Create Item” button

6. After opening Personalization page, define following information:

Level: Site
Item Style: Column
ID: CLL_ADDITIONAL_INFO

7. Go back to the Personalization Page and look for “CLL_ADDITIONAL_INFO” and press the

LAD Consulting Localizations Implementation Guide 12

CLL-F509 Brazilian Credit Bureau Integration
 “Create Item” button

8. After opening Personalization page, define following information

Level: Site
Item Style: Image
ID: CLL_F509_HZ_CUST_ACC_SITES_EXT
Admin Personalization: true
Data Type: VARCHAR2
Disable Server Side Validation: false
Destination URI:
OA.jsp?page=/oracle/apps/cll/lxm/webui/ExtensionUsagesPG&pExtendedPage
=/oracle/apps/ar/cusstd/acctoview/webui/AcctOviewPG&retainAM=Y&pExtend
edTable=HZ_CUST_ACCT_SITES_ALL&pConnectString=CUST_ACCT_SITE_ID={@Cust
AcctSiteId}
Image URI: /OA_MEDIA/updateicon_enabled.gif
Initial Sort Sequence: none
No Wrap: false

LAD Consulting Localizations Implementation Guide 13

CLL-F509 Brazilian Credit Bureau Integration
 Prompt: CLL Additional Info
Rendered: true
Scope: .
Sort Allowed: no
User Personalization: false
View Instance: HzPuiAcctSitesTableVO
Warn About Changes: true

9. Press: “Apply” Button.

10. Close Window and Open Account Sites page again.
11. The option “CLL Additional Info” (pencil icon) will appears

12. The fields about SERASA Extension will be exhibited

For more details about this fields, please verify User Guide Documentation.

Step 4. Proxy Setup, Business Event and API about CONFIE

This solution is avaiable in R12.1.3+ only.
If your environment has a Proxy Setup, please verify Step 4.1.
The Business Event for consume WebService Serasa-Confie is created by patch, this settings has
the SERASA-Homologation environment as default. For details about this configuration, please
verify the Step 4.2.
For verify possible errors in Public API, verify Step 4.3.

Step 4.1. Proxy Setup for webservices connection for CONFIE

If the servers use proxy configuration, you must follow some steps to allow web service connections.

LAD Consulting Localizations Implementation Guide 14

CLL-F509 Brazilian Credit Bureau Integration
 Please check out the instructions below for proxy setup:

1. Find the following files:

/vol02/oracle/<instance>/inst/apps/<instance>_<host>/ora/10.1.3/j2ee/forms/config/oc4j.properties
/vol02/oracle/<instance>/inst/apps/<instance>_<host>/ora/10.1.3/j2ee/oafm/config/oc4j.properties
/vol02/oracle/<instance>/inst/apps/<instance>_<host>/ora/10.1.3/j2ee/forms-
c4ws/config/oc4j.properties
/vol02/oracle/<instance>/inst/apps/<instance>_<host>/ora/10.1.3/j2ee/oacore/config/oc4j.properties

2. Modify the parameters:

#
# Proxy Configuration for OC4J
#
http.proxyHost=<proxy host>
http.proxyPort=<proxy port>
http.nonProxyHosts=<proxy host name> – Ex: *.br.oracle.com

3. Add the parameters:

#
# Proxy Configuration for OC4J
#
https.proxyHost=<proxy host>
https.proxyPort=<proxy port>

Step 4.2. Business Event about CONFIE


Important:

1) For password encrypt for access in WebService Serasa-Confie, is

utilized commands in DBMS package. For this it’s necessary access in
“dbms.crypto” package to user “APPS”
2) Your firewall MUST be access in Serasa-Confie Webservice

The patch will be created two Business Event:

 Invoke Type: Responsible for do initial validations and call the WebService Serasa-
Confie

 Reponse Type: Responsible for put the return of WebService in table:

CLL_F509_SERASA_QTAB

LAD Consulting Localizations Implementation Guide 15

CLL-F509 Brazilian Credit Bureau Integration
 Step 4.2.1 Business Event – INVOKE Type

1) In “Workflow Administrator Web (New)” responsibility, access the Business Event setup:

Navigator: Administrador Workflow Business Event

1.1) Put the string “%.cll.se.%” in “Name” field and click on button “Go”.

Must be showing two Business Event:

- oracle.apps.cll.se.serasa.confieGeral.invoke

- oracle.apps.cll.se.serasa.confieGeral.response

1.2) In Business Event: oracle.apps.cll.se.serasa.confieGeral.invoke, click on link “Update”

LAD Consulting Localizations Implementation Guide 16

CLL-F509 Brazilian Credit Bureau Integration
 
Important:

If this option not appears in your environment, it’s necessary update in Workflow
table, as below:
UPDATE wf_resources
SET text='*'
WHERE name='WF_ADMIN_ROLE';

COMMIT;

Please, close your browser and try again, following steps above

1.3) After to click on link “Update”, a similar screen below, must be shown.

Name oracle.apps.cll.se.serasa.confieGeral.invoke

Display Name oracle.apps.cll.se.serasa.confieGeral.invoke

Description oracle.apps.cll.se.serasa.confieGeral.invoke

Status Enabled

Generate Function

Java Generate Function

Owner Name LAD Consulting Localizations

Owner Tag CLL

Customization Level Limit

1.4) Click on “Cancel” button. The first screen will be showed:

LAD Consulting Localizations Implementation Guide 17

CLL-F509 Brazilian Credit Bureau Integration
 1.5) In Business Event: oracle.apps.cll.se.serasa.confieGeral.invoke, click on link
“Subscription”.

The screen below is exhibited, click on link “Update”

1.6) The fields will filled with values:

LAD Consulting Localizations Implementation Guide 18

CLL-F509 Brazilian Credit Bureau Integration
 System CLL12TT7.US.ORACLE.COM (Confirm with your DBA)

Souce Local

Event Filter oracle.apps.cll.se.serasa.confieGeral.invoke

Source Agent

Phase 10

Status Enable

Rule Data Message

Action Type Invoke Web Service

On Error Stop and Rollback

1.7) Click on “Next” button. In this screen is informed the WebService endpoint. The patch
put the Homologation link. After tests, it’s necessary modify manually this information for
Production link:

In conformity with “Manual de Especificação Técnica de Integração com o Confie v5.6”, the
information valid is:
https://gw-homologa.serasa.com.br/SolucaoSintegra/SS20ws.asmx?wsdl
Homologation
https://sitenet05.serasa.com.br/SolucaoSintegra/SS20ws.asmx?wsdl
Production

LAD Consulting Localizations Implementation Guide 19

CLL-F509 Brazilian Credit Bureau Integration
 
Important:

If your environment doesn’t have permission to access Serasa-Confie WebService,

after waiting a few minutes, the error below will be showed:

1.8) Click on “Next” button. The screen will be appears:

1.9) Only click on “Next” button. The screen will be showed:

1.10) The option already appears selected. Only click on “Next” button again. The another
screen will be showed:

LAD Consulting Localizations Implementation Guide 20

CLL-F509 Brazilian Credit Bureau Integration
 1.11) “ConsultaConfieGeral” option must be selected only. Click on “Next” button and the
screen will be showed:

oracle.apps.fnd.wf.bes.WebServiceInvokerSubscription
Java Rule Function

Subscription Parameters

Name Value

WFBES_CALLBACK_EVENT oracle.apps.cll.se.serasa.confieGeral.response

WFBES_CALLBACK_AGENT CLL_F509_SERASA_QAGENT

Owner Name CLL

Owner Tag CLL

Customization Level User

Description oracle.apps.cll.se.serasa.confieGeral.invoke

LAD Consulting Localizations Implementation Guide 21

CLL-F509 Brazilian Credit Bureau Integration
 1.12) If without any modification was necessary, click on “Cancel” button. Otherwise,
clicking on “Apply ” button. The message must be shown:

Step 4.2.2 Business Event – RESPONSE Type

1) In “Workflow Administrator Web (New)” responsibility, access the Business Event setup:

Navigator: Administrador Workflow Business Event

1.1) Put the string “%.cll.se.%” in “Name” field and click on button “Go”.

Must be showing two Business Event:

- oracle.apps.cll.se.serasa.confieGeral.invoke

- oracle.apps.cll.se.serasa.confieGeral.response

LAD Consulting Localizations Implementation Guide 22

CLL-F509 Brazilian Credit Bureau Integration
 1.2) In Business Event: oracle.apps.cll.se.serasa.confieGeral.response, click on link “Update”


Important:

If this option not appears in your environment, it’s necessary update in Workflow
table, as below:
UPDATE wf_resources
SET text='*'
WHERE name='WF_ADMIN_ROLE';

COMMIT;

Please, close your browser and try again, following steps above

1.3) After to click on link “Update”, a similar screen below, must be shown.

Name oracle.apps.cll.se.serasa.confieGeral.response

Display Name oracle.apps.cll.se.serasa.confieGeral.response

Description oracle.apps.cll.se.serasa.confieGeral.response

Status Enabled

Generate Function

Java Generate Function

Owner Name LAD Consulting Localizations

Owner Tag CLL

Customization Level Limit

1.4) Click on “Cancel” button. The first screen will be showed:

LAD Consulting Localizations Implementation Guide 23

CLL-F509 Brazilian Credit Bureau Integration
 1.5) In Business Event: oracle.apps.cll.se.serasa.confieGeral.response, click on link
“Subscription”.

The screen below is exhibited, click on link “Update”

1.6) The fields will filled with values:

LAD Consulting Localizations Implementation Guide 24

CLL-F509 Brazilian Credit Bureau Integration
 System CLL12TT7.US.ORACLE.COM (Confirm with your DBA)

Souce Local

Event Filter oracle.apps.cll.se.serasa.confieGeral.response

Source Agent

Phase 10

Status Enable

Rule Data Message

Action Type Send To Agent

On Error Stop and Rollback

1.7) Click in “Next” button. A new screen is open with the filled values:

Out Agent CLL_F509_SERASA_QAGENT@CLL12TT7.US.ORACLE.COM

To Agent

Priority Normal

Additional Options

Owner Name CLL

Owner Tag CLL

Customization Level User

Description oracle.apps.cll.se.serasa.confieGeral.response

LAD Consulting Localizations Implementation Guide 25

CLL-F509 Brazilian Credit Bureau Integration
 1.8) If without any modification was necessary, click on “Cancel” button. Otherwise, clicking
on “Apply ” button. The message must be shown:

Step 4.2.3 Business Event – Setup Testing

For testing in Business Event setup, it’s necessary verify the follow steps:

1) Find the “oracle.apps.cll.se.serasa.confieGeral.invoke” Business Event and click on “Test”

Button:

2) Put an aleatory number in “Event Key” field (in this example was informed 10) and paste the
content below in “XML Content” field:

<?xml version="1.0"?>
<ConsultaConfieGeral xmlns="http://tempuri.org/SolucaoSintegra/SS20WS">
<XML>
&lt;CONFIE&gt;&lt;CONSULTA DOCUMENTO="00000125000111" UF="" LOGIN="68410265" SENHA="10203040"
TIPOCONSULTA="2" TIPORELATORIO="3" TIPORETORNO="1" TIPODOCUMENTO="1" TIMEOUT="100" DIAS="060" HTML="N"&gt;
&lt;/CONSULTA&gt;
&lt;MONITORE PERIODOMONIT="" EMAILMONIT="" REFERENCIAMONIT=""&gt;&lt;/MONITORE&gt;
&lt;/CONFIE&gt;
</XML>
</ConsultaConfieGeral>

LAD Consulting Localizations Implementation Guide 26

CLL-F509 Brazilian Credit Bureau Integration
 3) When “Raise in Java” button is pressed, the “Response Content” field, in section “Event
Response” must be filled, as below:

 If the return not appears, a problem is occurring and need to be analysis. Look for
this Step 4 again.

Step 4.3. Public API

This topic showed how verify the possible errors that can occurs in the Public API's call. The
selects below must be executed:
select * from wf_notifications
where trunc(begin_date) = trunc(sysdate);

Verify SUBJECT column content. Must have information as this:

Local Event ERROR : oracle.apps.cll.se.serasa.confieGeral.invoke / CLL_F509:22

LAD Consulting Localizations Implementation Guide 27

CLL-F509 Brazilian Credit Bureau Integration
 The next select needs the content in NOTIFICATION_ID colunm, recovered in select above:
select wna.notification_id, wna.text_value
from wf_notification_attributes wna
where wna.name = 'ERROR_MESSAGE'
and wna.notification_id in (3045426);

The errors is appears in TEXT_VALUE column, for example:

(oracle.apps.fnd.wf.bes.BusinessEventException: Exception occured in invoking a

serviceoracle.j2ee.ws.wsdl.LocalizedWSDLException: WSDLException:
faultCode=PARSER_ERROR: Failed to read wsdl file at: "https://gw-
homologa.serasa.com.br/SolucaoSintegra/SS20ws.asmx?wsdl", caused by:
java.net.NoRouteToHostException. : java.net.NoRouteToHostException: No route to host)

To confirm if the QUEUE_TABLE was populated, execute this select:

select * from cll_f509_serasa_qtab tab
where 1=1
and enq_time >= trunc(sysdate)
and tab.user_data.event_name =
'oracle.apps.cll.se.serasa.confieGeral.response';

 This table is populated only if API call is finished with successfully.

LAD Consulting Localizations Implementation Guide 28

CLL-F509 Brazilian Credit Bureau Integration