Update Your Suppliers In Real Time With CCR XML. Introduction Bryan Eckle [email protected] President and Founder of Summit2Sea Consulting Specialization.

Update Your Suppliers In Real Time With CCR XML

Introduction

Bryan Eckle

[email protected] and Founder of Summit2Sea Consulting

Specialization in Oracle Federal Financials

http://www.sum2sea.com

Objective

• Learn how to include and improve CCR XML integration in your agency.

• Avoid pitfalls in the CCR XML Process

• Learn the steps to configure the CCR XML process (does not require any programming or technical expertise)

What is the CCR (Central Contractor Registration)?• All suppliers conducting business with the US Federal

Government must register with CCR

• The OMB (Office of Management and Budget) requires that CCR is used as the system of record for Federal supplier payment information. (Memorandum M-03-01)

• Oracle Federal Financials 11.5.10 and onward includes built in CCR integration

Options

• CCR Extract Files - this process is file based, an agency brings in an all inclusive monthly file and then has to process daily files with any supplier updates throughout the month

• The CCR XML Process - eliminates the need for the CCR extract files and allows for the real time on demand update of suppliers.

Benefits of CCR XML

• Tighten the integration between CCR and Oracle Federal Financials

• Functional configuration – no programming required

• Reduced IT support

• The file based process (CCR Extract) will be discontinued in the future.

• Reduced administration

CCR XML Diagram

CCR XML Configuration Steps (anyone can do it)• Obtain and place the BPN.gov certificate file

• Define the CCR XML specific profile options– CCR XML Certificate File

– CCR XML Server

– CCR XML Username and Password

– (Optional) Proxy Server

• Apply applicable patches

• Firewall confirguration

CCR XML Configuration Steps – BPN.gov certificate• I recommend obtaining the certificate file on

your own.• You can do this by visiting the SSL secured

site, https://www.bpn.gov• Refer to appendix A for detailed steps on

creating a certificate file.• Make sure the file is in a BASE64 format.

CCR XML Configuration Steps – Enter Profile Options• FV: CCR Certificate File

– The network or file system path with the .cer file containing the CCR server certificate, which is required to make an SSL connection to the CCR site.

– Check with your DBA, but the path is typically something like, uXX/../../comntop/admin/certs/wwwbpngov.cer

CCR XML Configuration Steps – Enter Profile Options• FV: CCR XML Server

– This value is the URL provided by Defense Logistics Information Services (DLIS) when an agency completes CCR XML registration. It is required to use CCR XML integration.

– As of the time of this presentation, the value was https://www.bpn.gov/CCRXML/xml.asmx/CCRXML

CCR XML Configuration Steps – Enter Profile Options• FV: CCR XML Username

– This value is provided by DLIS when an agency completes a CCR XML registration. This value is required to use CCR XML integration.

• FV: CCR XML Password– Provided at the time of registration

CCR XML Configuration Steps – Enter Profile Options• FV: Agency Proxy Server

– Optional– This would be up to your agency depending on the

security requirements.– The main purpose of a proxy server is to keep the

machines behind it anonymous for security purposes.

CCR XML Configuration Steps – Apply Patches on 11.5.10.2• Patch 6993686

– Gets the CCR XML process from version 2.0 to 2.05

• Patch 7372603– The patch gets the Oracle CCR XML version from

2.05 to 2.06. The CCR XML version 2.06 is the lowest version that CCR accepts at this time.

• Patch 7514093– Version 2.08 is the latest CCR XML version.

CCR XML Configuration Steps – Allow External Server Communication

• Network communication must be allowed between your server and the CCR (BPN.gov) server.

• Verify with your network team in order to ensure that there are not any firewall rules in place that would block connectivity.

Using the CCR XML Process - Example

• Receive a call that your agency wishes to do business with a new company, Summit2Sea Consulting.

• Their DUNS number is 14-234-9393

Using the CCR XML ProcessNavigate to the Search CCR Vendors page, enter the DUNS number and

click ‘Apply’

Using the CCR XML Process• Receive a warning message about a “Core Hours” request.

• Click Yes to run the CCR XML process immediately. If No, then it will be picked up in the next CCR XML concurrent request run.

• DLIS restricts the number of records CCR will return to 20 during peak hours and to 2,000 during off-peak hours. Off-peak hours for CCR are 0000 - 2400 EST during the weekend and 2300 - 0600 EST during the weekdays.

Using the CCR XML Process

Using the CCR XML Process

The concurrent program, CCR XML, automatically initiates and spawns the CCR Data Transfer

Using the CCR XML Process

View the request output of the CCR Data Transfer.

Using the CCR XML ProcessSearch for the DUNS number, click the Assignments button to create a new supplier / site in Oracle

Using the CCR XML ProcessSearch for the DUNS number, click the Assignments button to create a new supplier / site in Oracle

Using the CCR XML ProcessThe concurrent request, CCR Data Processing Program (CCR Data Processing), initiates to create the new

supplier in Oracle

Using the CCR XML Process

Verify the supplier and site creation in Oracle.

Using the CCR XML Process

Verify the supplier and site creation in Oracle

Using the CCR XML ProcessAlternatively, you can assign a DUNS number to an existing Oracle supplier by using the Existing Supplier

Site Assignments

Using the CCR XML ProcessSchedule the CCR XML Process in order to create / update any supplier changes periodically.

CCR XML Known Issues• The Organization Type field is not populated

for CCR suppliers. This is going to be included in the next RUP. In the meantime, have to manually update it or create a custom update based upon the FV_CCR_VENDORS table

• Foreign suppliers without TIN numbers fail validation and cannot be brought into Oracle.• Fixed in patch 7647109

Other Considerations• An expired supplier in CCR cannot be used

on a purchase order, release or invoice.• Unable to approve / validate POs and

Invoices where the CCR supplier is expired

Questions

Appendix A – Steps to obtain a certificate file1.  On your web brower (IE etc), bring up

https://www.bpn.gov

2.  Click on 'File>Properties' and click the 'Certficates' button

3.  Click on the 'Details' tab

4.  Click the 'Copy to File' button

Appendix A – Steps to obtain a certificate file cont’d5.  The 'Certificate Export Wizard' will appear,

click the 'Next' button.

6.  Choose the BASE-64 option and click 'Next'

7.  Give the file a name, we used wwwbpngov previously.

8.  FTP the file to the Apache server which will be making communication with the BPN.gov server

Appendix A – Steps to obtain a certificate file cont’d9.  Put the file in the

/XXX/app/applmgr/XXXXXX/comntop/admin/certs/ directory (note that this directory will vary based on your installation. Please check with your DBA or System Administrator)

10.  You are now ready to make an SSL connection to bpn.gov

Appendix B – XML Request Example, View CCR XML Log

Appendix B – XML Request Example

Appendix B – XML Request Example

Appendix B – XML Request Example

Appendix C – XML Response Example

Appendix C – XML Response Example

Appendix C – XML Response Example

Appendix C – XML Response Example

Appendix C – XML Response Example

Appendix C – XML Response Example

Appendix C – XML Response Example

Appendix C – XML Response Example

Appendix C – XML Response Example