r12 – punchout using iprocurement

4/13/2015 R12 – Punchout using iProcurement | Oracle Apps Store

https://oracleappsstore.wordpress.com/2012/06/04/r12-punchout-using-iprocurement/ 1/21

Oracle Apps Store

R12 – Punchout using iProcurement

JUNE 4, 2012 17 COMMENTS(HTTPS://ORACLEAPPSSTORE.WORDPRESS.COM/2012/06/04/R12PUNCHOUTUSINGIPROCUREMENT/#COMMENTS)

Punchout through iProcurement

Punchout enables buyers to click a link that goes to a supplier’s catalog, search for items on the supplier’ssite, and return those items directly to the buyer’s shopping cart. If punching out from Oracle Exchange,buyers add the supplier’s items to their shopping cart on Oracle Exchange. If punching out from OracleiProcurement, requesters add the external items to their shopping cart in Oracle iProcurement.

Punchout offers seven models:

Model 1: Punchout from Oracle iProcurement to Oracle Exchange (XML)Model 2a: Punchout from Oracle iProcurement Directly to SupplierHosted Catalog (XML) Model 2b: Punchout from Oracle iProcurement Directly to SupplierHosted Catalog (cXML)Model 3a: Punchout from Oracle Exchange to SupplierHosted Catalog (XML)Model 3b: Punchout from Oracle Exchange to SupplierHosted Catalog (cXML)Model 4: Punchout from Oracle iProcurement to SupplierHosted Catalog via Oracle Exchange (XML)Model 5: Punchout from Oracle iProcurement to SupplierHosted Catalog via Oracle Exchange (cXML)

In the example below, we will see how to implement Model 2a…

https://oracleappsstore.wordpress.com/



(https://oracleappsstore.files.wordpress.com/2012/04/11.png)

In the illustration above:

1. The requester logs on to Oracle iProcurement.

2. From Oracle iProcurement, the requester clicks a punchout link to the supplier site.

3. The supplier authenticates the requester and returns a response.

4. Oracle iProcurement redirects the requester’s browser to the supplier site for shopping.

5. When the requester finishes shopping, the supplier site returns the shopping cart items to OracleiProcurement via the requester’s browser.

6. The requester completes the checkout process, and Oracle iProcurement processes the order.

Punchout Setup

Buyer Setup

(https://oracleappsstore.files.wordpress.com/2012/04/2a3.png)

https://oracleappsstore.files.wordpress.com/2012/04/2a3.png

https://oracleappsstore.files.wordpress.com/2012/04/11.png



(https://oracleappsstore.files.wordpress.com/2012/04/2b3.png)

1. Prerequisites

If the supplier’s site is secure, verify your access to secure sites.

a. Verify Access to Secure Sites

Certification Authorities List Accessing a secure site involves making sure the site is on the accessingapplication’s certification authorities list

For Models 2a and 2b: Punchout from Oracle iProcurement Directly to SupplierHosted Catalog (XML orcXML), the supplier’s certification authority needs to be on the cabundle.crt file in Oracle iProcurement

b. How To Add The Certificate To The Apache Certificate File For Punchout Suppliers UsingHTTPS?

When a Punchout is attempted to a supplier, using https, in order to create a Secure connection between theOracle EBusiness Suite Middle Tier Server and the Punchout Destination, the certificate must be present inthe certificate file that is used by the EBusiness Suite Middle Tier – Apache Web Server.

1. Locate the punchout url that is being used in the Catalog definition in iProcurement.

***Initially catalog should be defined for url adress entrance.

iProcurement Catalog Administrator Responsibility > eContent Manager > Manage Content > Catalogs >Create

(https://oracleappsstore.files.wordpress.com/2012/04/3a1.png)

https://oracleappsstore.files.wordpress.com/2012/04/2b3.png

https://oracleappsstore.files.wordpress.com/2012/04/3a1.png



Select Punchout Catalog, then press Continue.

(https://oracleappsstore.files.wordpress.com/2012/04/3b.png)

Define the type of external catalog by selecting a Source; Supplier and Access Method; Directpunchout (Oracle native XML), then press Continue.

Enter catalog information using the fields below and press Submit when you are finished.

*Indicates required field.

(https://oracleappsstore.files.wordpress.com/2012/04/3c2.png)

(https://oracleappsstore.files.wordpress.com/2012/04/3d.png)

Supplier URL address is entered at punchout URL tab as you can see above. This is done in theiProcurement Catalog Administration in release 11.5.10. (above)

https://oracleappsstore.files.wordpress.com/2012/04/3d.png

https://oracleappsstore.files.wordpress.com/2012/04/3c2.png

https://oracleappsstore.files.wordpress.com/2012/04/3b.png



(https://oracleappsstore.files.wordpress.com/2012/04/3e1.png)

For release 12, it is in the Content Zones Section of iProcurement Catalog Administration. (See above)

2. Next, utilize the web browser to connect to the https url that was used in the Punchout.

Example URL is https://testexchange.oracle.com (https://testexchange.oracle.com/) , but your url should beplaced here.

(https://oracleappsstore.files.wordpress.com/2012/04/4a.png)

In this example, Firefox browser is being used, which has a plugin installed called certviewer.This Firefox plugin (https://addons.mozilla.org/enUS/firefox/search?q=cert+viewer&cat=all) allows forviewing and saving a SSL certificate.

https://testexchange.oracle.com/

https://oracleappsstore.files.wordpress.com/2012/04/4a.png

https://oracleappsstore.files.wordpress.com/2012/04/3e1.png

https://addons.mozilla.org/en-US/firefox/search?q=cert+viewer&cat=all



Double click the lock (Lower Right Hand Corner – Pictured Above) to view the certificate.– Now choose the View Button – and the screen below will appear


From this screen, choose Export – which then brings up a ‘Save’ screen (See below)

(https://oracleappsstore.files.wordpress.com/2012/04/4c.png)

https://oracleappsstore.files.wordpress.com/2012/04/4c.png




Choose the Format – X509 Certificate with chain (PEM) – as seen above. Save it to the local PC

3. Now, it is necessary to confirm what certificate is being used by iProcurement.This is done by logging into the application as System Administrator – and moving to Profile/System – toquery on the Profile – POR : CA Certificate File Name



Take note of the file location – this is the actual location on the middle tier Apache iAS server.

4. Upon confirming the location of the certificate, proceed to use a telnet program to access the middle tier –where the certificate resides.






Move to the directory where the certificate is located on the iAS middle tier server – and use vi or other texteditor to open and add the contents from the certificate saved on the local PC – into the certificate that is onthe middle tier server – which was referenced in the profile. It is best to back up the certificate file prior tomaking any changes – seen above. Highlight and copy the complete contents from the saved certificate file.




Adding the certificate just after the ## comment signs in the current certificate file is recommended. Cut andpaste the complete contents from the Local PC text file into the certificate file on the server.

(https://oracleappsstore.files.wordpress.com/2012/04/5d.png)Save the newly modified certificate changes on the middle tier server.

5. Restart the Apache iAS web server, and confirm that now connectivity is possible as the Apache iAS isnow able to properly authenticate to the Supplier using https.

NOTE: It has been found that with release 12.X – a complete recycle of the middle tier may be required,and not just the Apache iAS

(https://oracleappsstore.files.wordpress.com/2012/04/5e.png)

Retest and confirm that the Handshake is now properly taking place.

Note: If you use proxy authorization, you will get an time out error. For this reason proxy authorizationshould be bypassed for only Punchout connection.

2. Set Profile Options in Oracle iProcurement

POR: Proxy Server Name

https://oracleappsstore.files.wordpress.com/2012/04/5e.png




Enter the proxy server (Web server) name if your Oracle iProcurement implementation has a proxy setup.The proxy server name is typically the same as the proxy server that is set up in people’s browsers in yourcompany—for example wwwproxy.company.com.

POR: Proxy Server Port

Enter the proxy server port on which the proxy server listens, if your Oracle iProcurement implementationhas a proxy setup. The port is typically the same as the port that is set up in people’s browsers in yourcompany—for example, 80.


3. Define Supplier Punchout in Oracle Procurement

We have already mentioned this step at prerequisite part.

After the supplier has set up punchout access to its Web store, use this step to create a punchout link inOracle iProcurement to the supplier’s site.

Note: The setup in this step applies to all operating units.

To create a punchout link directly to the supplier’s site:

1. Log on to Oracle iProcurement using the Catalog Administration responsibility.

2. Click the “eContent Manager” link.

3. In the navigation bar at the left, click the “Manage Catalogs” link.

4. On the Manage Catalogs page, click Create.

5. On the Create Catalog page, select “Punchout catalog” and click Continue.

6. On the Create External Catalog page –

Select a Source of Supplier.Select an Access Method of Direct Punchout (Oracle native XML) if you are setting up a Punchout to asupplier using XML




4.Add Catalog to Store

Any catalog you create must be assigned to a store to be searchable. Once your punchout catalog is readyfor use, assign it to a store.

To add catalog to a store (required) and sequence it (optional):

1. Log on to Oracle iProcurement using the Catalog Administration responsibility.

2. Click the “eContent Manager” link.

3. In the navigation bar on the left, click the “Manage Stores” link.

4. On the Manage Stores page, do either of the following:

Click a store’s Edit icon to add the catalog to an alreadycreated store.Click Create to create your own store and add the catalog to it.

Follow the guidance online and in the Help icon if you need more help creating and editing stores.

5. Once you have selected the catalogs you want to include in the store, click Continue.

iProcurement Catalog Administrator Responsibility > eContent Manager > Manage Content > Stores >Create Store

(https://oracleappsstore.files.wordpress.com/2012/04/6b1.png)

After entering store name and description you should add catalog to store and click submit button.

5. Set Up Data Mapping in Oracle eCommerce Gateway

Use Oracle eCommerce Gateway to map the following values that the supplier sends to values you use inOracle iProcurement:

SupplierSupplier siteUnit of measure (UOM)

https://oracleappsstore.files.wordpress.com/2012/04/6b1.png



Category

Punchout and transparent punchout do not use currency mapping in Oracle eCommerce Gateway, butrecognize only the International Standards Organization (ISO) currency codes.

Supplier and Supplier Site Mapping

Example Mapping of XXX Supplier Catalog

Supplier site id information is entered EDI Location tab and catbuy side should be informed to entervalue14915 and leave blank supplier name and site information in the XML file for XXX Supplier Catalog.





(https://oracleappsstore.files.wordpress.com/2012/04/6d.png)

Unit Of Measure (UOM) Mapping

eCommerce Gateway Responsibility > Setup > Code Conversion > Define Code Conversion Values

(https://oracleappsstore.files.wordpress.com/2012/04/6e.png)

(https://oracleappsstore.files.wordpress.com/2012/04/6f.png)

https://oracleappsstore.files.wordpress.com/2012/04/6e.png


https://oracleappsstore.files.wordpress.com/2012/04/6f.png



(https://oracleappsstore.files.wordpress.com/2012/04/6g.png)

(https://oracleappsstore.files.wordpress.com/2012/04/6h.png)

(https://oracleappsstore.files.wordpress.com/2012/04/6i.png)

You can see UOM comparison details between Catbuy and Oracle at below file.

https://oracleappsstore.files.wordpress.com/2012/04/6h.png

https://oracleappsstore.files.wordpress.com/2012/04/6i.png

https://oracleappsstore.files.wordpress.com/2012/04/6g.png



(https://oracleappsstore.files.wordpress.com/2012/04/6m.png)

Category Mapping

eCommerce Gateway Responsibility > Setup > Code Conversion > Define Code Conversion Values

(https://oracleappsstore.files.wordpress.com/2012/04/6j.png)

https://oracleappsstore.files.wordpress.com/2012/04/6m.png

https://oracleappsstore.files.wordpress.com/2012/04/6j.png



Catbuy is sent generic code 99999999 for all catalog item’s category code. Category code(MISC.MISC.MISC.MISC.STANDARD) mapping has been done with generic code 99999999 as you cansee below.

<category>

<categoryCode categoryCodeIdentifier=””>

</category>

(https://oracleappsstore.files.wordpress.com/2012/04/6k.png)

Some useful Noteid’s from Metalink to Resolve Common Issues

Although every setup is done, there are chances of getting connection problem error. If you come acrossany connection issues, please refer to the below Metalink notes to resolve them.

1. 399856.1: NullPoint Exception After Clicking On The Punchout Link2. 356128.1: How to Run the Punchout TEST Delivered With Oracle Applications?3. 344339.1: Punchout Fails With Error Code: 201 Unable To Reach Supplier Site4. 274816.1: Punchout Getting 201 Error – Unable To Connect To Supplier

POR : CA Certificate File Name

FILED UNDER PROCUREMENT TAGGED WITH PUNCHOUT

About AsokanI have around 10 years of Working Experience in the Industry. Have done various roles like Developer,Lead, Architect etc.

17 Responses to R12 – Punchout using iProcurement

https://oracleappsstore.wordpress.com/category/procurement/

https://oracleappsstore.files.wordpress.com/2012/04/6k.png

https://oracleappsstore.wordpress.com/tag/punch-out/



sonwabile nomnganga says:July 5, 2012 at 7:07 AMHi Asokan,

I am trying to implement the same kind of solution for the company i work for. would you mind if iwere to contact you for help. you have explained the exact slution i’d like to implement.

regardsonwabile

ReplyAsokan says:July 5, 2012 at 9:34 AMSure… Let me know what kind of help you requrie.

Thanks,Asokan

ReplyAndy says:July 27, 2012 at 4:49 AMIs there a comparable model for 11.5.10?

ReplyAsokan says:July 27, 2012 at 7:43 AMThe article posted is an inclusion of both 11.5.10 version & R12. The original implementation of thispunchout was in 11i and has very few changes in R12, for which there are new screenshots fromR12. Comparatively, there are very minimal changes in 11i’s iProc & R12’s version.

ReplyMoe says:July 31, 2012 at 11:01 AMThis is an excellent blog on creating a Punchout in iProc. Really appreciate the effort you put in toeducate other users like me.

ReplyJags Jawalekar says:August 1, 2012 at 10:21 PMExcellent post. You have done a great job in sdharing your knowledge.

ReplyPrashant Rao says:October 3, 2012 at 2:01 PM

https://oracleappsstore.wordpress.com/2012/06/04/r12-punchout-using-iprocurement/?replytocom=83#respond










Hi Ashokan – The blog is a very well written one. I have one question though, we are trying to extendthe current PunchOutOrderMessage cXML that comes from the supplier site to include some extrinsicelements on the line level. What we’ve done is to use the cXml dtd (version 1.1.007) and then generate asample PunchOutOrderMessage xml file which includes these extrinisic elements and we have sent thesame to the supplier for them to code and send us the xml in this format. However, we are not sure,where and how these extrinisic elements will be stored in Oracle and whether Oracle would store themat all on the requisition.

Do you have any insight regarding this ?

Thanks and Regards,Prashant

ReplyriuryK says:October 24, 2012 at 2:58 AMSame problem thank Prashant here. We are trying to send the supplier some catalogspecific extrinsics,but we do not know where to configure that. Any idea? Thank you.

ReplySiva Valluripalli says:March 28, 2013 at 10:50 PMFrom Oracle:

Is It Possible To Add Further Extrinsic Elements In The cXML Punchout Documents? [ID 458362.1].

Applies to:Oracle iProcurement – Version: 11.5.9 to 12.0.0 – Release: 11.5 to 12Information in this document applies to any platform.Goal

When using Punchout from iProcurement via Oracle Exchange to Supplier Site (cXML) is it possible tochange (or add) additional Extrinsic attributes?

For example:From: JSMITHTo: JSMITHSolutionFurther Extrinsic Attributes (including UniqueName) are included in cXML version 1.2.014; however,Oracle Punchout supports only version 1.1.007 at this time. As such, Enhancement Request Bug4724251 has been opened for these additional attributes to be added to punchout functionality in a futurerelease.

ReplyGopinath says:July 29, 2013 at 5:49 AM


http://gravatar.com/riuryk





HiThere is a mismatch between the UOM mentioned in Supplier site and the UOM that gets created inRequisition.The UOM mentioned in iProc site is ‘Reams’ but in Requisitions it turns to be ‘case’.Please help us to figure out where the problem isThanks,Gopi

ReplyAsokan says:July 29, 2013 at 9:55 AMGopi – Can you make sure if you followed the points under 5. Set Up Data Mapping in Oracle eCommerce Gateway ?

Thanks,Asokan

ReplyAjay says:August 19, 2013 at 1:25 AMHi Asokan,

We are working on Punchout implementation and a supplier is created for Punchout. Now we haveselected one supplier in iProcurement Catalog admin with US site. This supplier has sites in UK andFrance also. But the punchout is only working for US site but not the other 2 sites. If I have to make itwork for UK site, I have to go to Catalog admin and chage the site to UK and then it will work. Is theresome profile option in which we can enable all the sites for Punchout requisition ?

Thanks and regards,Ajay

ReplyWilliam Mok says:September 11, 2013 at 10:15 PMAsokan Thangaraju,

Thanks. This is very good information. I have additional questions regarding supplier hosted catalog,punch out, and linking the selected item to purchase to Oracle ERP Item Master? Is there anysynchronization between Oracle Item Master with the Supplier hosted catalog? If so, how?

The scenario is if the buyer selected an item to be purchased from the Supplier Hosted Catalog viapunch out, bring the information back to Oracle iProcurement and generate an PO with PO line. Howcan the item selected on the PO line be link to a item master?

Appreciate any feedback in advance.

Thanks,







William

ReplyHarsha Vardhan says:October 13, 2013 at 7:36 PMYou need to map the commodity codes in the supplier catalog to the category codes in your systemusing Oracle ecommerce gateway.

ReplyWilliam Wright says:October 17, 2013 at 11:15 AMAsokan,

As others have said, this is great information. Thank you. I’m having trouble completing the Supplierand Supplier Site mapping step in R12, I think because of the changes between 11i and R12 (we areusing Transparent Punchout in case it matters). Could you point me to the right steps to map theSupplier and Supplier Site for Transparent punchout in R12? Thank you.

William

ReplyPatroclus says:September 18, 2014 at 2:45 AMThis is a great, informative article. I do have a question though and I hope you could help. We areimplementing Model 2a and I have the document “Punchout and Transparent Punchout Guide for OracleiProcurement and Oracle Exchange, Release 11i, Part No. A9219003, April 2003″ as reference, eventhough we are using iProcurement R12.

Are the XML specifications and DTD the same for R11 and R12? thanks!

ReplyBrijesh says:January 6, 2015 at 5:40 PMgood and helpful article.

Reply

Create a free website or blog at WordPress.com.

The Enterprise Theme.

Follow

Follow “Oracle Apps Store”


https://wordpress.com/?ref=footer_website



javascript:void(0)


https://wordpress.com/themes/enterprise/




Build a website with WordPress.com

https://wordpress.com/?ref=lof