Oracle Exchange Punchout

1y ago
11 Views
2 Downloads
892.55 KB
126 Pages
Last View : 18d ago
Last Download : 3m ago
Upload by : Kaydence Vann
Transcription

Oracle Exchange Punchout Guide Release 6.2 September 2001 Part No. A92190-01

Exchange, Release 6.2 Part No. A92190-01 Copyright 2001, Oracle Corporation. All rights reserved. Primary Author: Richard Sears, Vic Mitchell Contributing Authors: Warren Perkinson, Sanjay Bhasin, Sam Andrus. The Programs (which include both the software and documentation) contain proprietary information of Oracle Corporation; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs is prohibited. The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. Oracle Corporation does not warrant that this document is error free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Oracle Corporation. If the Programs are delivered to the U.S. Government or anyone licensing or using the programs on behalf of the U.S. Government, the following notice is applicable: Restricted Rights Notice Programs delivered subject to the DOD FAR Supplement are "commercial computer software" and use, duplication, and disclosure of the Programs, including documentation, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement. Otherwise, Programs delivered subject to the Federal Acquisition Regulations are "restricted computer software" and use, duplication, and disclosure of the Programs shall be subject to the restrictions in FAR 52.227-19, Commercial Computer Software - Restricted Rights (June, 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065. The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and Oracle Corporation disclaims liability for any damages caused by such use of the Programs. Oracle is a registered trademark, and Enabling the Information Age, and Oracle Exchange, are trademarks or registered trademarks of Oracle Corporation. Other names may be trademarks of their respective owners.

Contents Send Us Your Comments . vii Preface. ix Intended Audience . ix Structure. ix Related Documents. x 1 Using Oracle Exchange Punchouts Overview of Oracle Exchange Punchouts . Benefits Comparison of Punchout Models . References . Software Requirements. 1-1 1-6 1-6 1-6 2 Defining an Oracle Exchange Punchout Introduction . Functional Overview. Steps to Perform on Exchange. Step 1: Register your company on Exchange . Step 2: Create code mappings. Steps to Perform at Your Web Site. Step 1: Install an XML Parser . Step 2: Create .dtd files for use with your XML Parser. Step 3: Create a URL to accept incoming punchout documents . Step 4: Create the XML processing code . 2-1 2-2 2-4 2-4 2-4 2-6 2-7 2-7 2-8 2-9 iii

Steps to Configure Your Punchout Definition. Step 1: Configure Punchout Definition . Step 2: Test Punchout Definition . Step 3: Define Your Search Keywords . Step 4: Control Punchout Availability . Oracle Exchange Punchout Setup Checklist. 3 Defining an Oracle iProcurement Punchout Model 2: Punch out from Oracle iProcurement to Oracle Exchange: XML . Model 3: Punch out from Oracle iProcurement to Supplier via Oracle Exchange: XML Model 4: Punch out from Oracle iProcurement to Supplier via Oracle Exchange: cXML Model 5: Punch out from Oracle iProcurement directly to Supplier: XML . Installation / Implementation Steps. Oracle Exchange Setup Steps . Oracle iProcurement Setup Steps . Oracle eCommerce Gateway Setup Steps . A 3-7 3-16 3-25 3-31 3-34 3-36 3-42 A-1 A-2 A-2 A-2 A-4 Oracle iProcurement Punchout DTDs Common DTD file for all Request / Response DTDs (pomxmlrr.dtd) . OEXLoginRequest.dtd . LoginResponse.dtd . OrderLinesDataElements.dtd. LinkRequest.dtd. LinkResponse.dtd . SupplierSyncUpResponse.dtd . iv 3-1 Oracle Exchange Punchout DTDs XML Punchout Request (pomlognr.dtd) . XML Punchout Response (pomlogns.dtd) . Shopping Cart DTD (pom carts.dtd). POMXMLRR.DTD . SHOPPINGCART.DTD . B 2-27 2-27 2-28 2-28 2-29 2-31 B-1 B-3 B-5 B-5 B-9 B-9 B-9

SupplierLoginRequest.dtd. PunchOutSetupRequest.dtd. PunchOutSetupResponse.dtd. PunchOutOrderMessage.dtd. C B-10 B-11 B-11 B-11 Sample Oracle iProcurement XML Documents OEXLoginRequest . C-1 OEXLoginRequest (with optional extended data) . C-3 LoginResponse . C-5 OrderLinesDataElements. C-5 LinkRequest. C-8 LinkResponse . C-8 SupplierSyncUpResponse . C-8 SupplierLoginRequest. C-9 PunchOutSetupRequest (cXML). C-11 PunchOutSetupResponse (cXML). C-12 PunchOutOrderMessage (cXML) . C-12 Index v

vi

Send Us Your Comments Oracle Exchange Punchout Guide, Release 6.2 Part No. A92190-01 Oracle Corporation welcomes your comments and suggestions on the quality and usefulness of this document. Your input is an important part of the information used for revision. Did you find any errors? Is the information clearly presented? Do you need more information? If so, where? Are the examples correct? Do you need more examples? What features did you like most? If you find any errors or have any other suggestions for improvement, please indicate the document title and part number, and the chapter, section, and page number (if available). You can send comments to us in the following ways: Electronic mail: richard.sears@us.oracle.com FAX: (650) 506-7816 Attn: Oracle Exchange Postal service: Oracle Corporation Oracle Exchange Documentation 300 Oracle Parkway, 3OP16 Redwood Shores, CA 94065 USA If you would like a reply, please give your name, address, telephone number, and (optionally) electronic mail address. If you have problems with the software, please contact your local Oracle Support Services. vii

viii

Preface This manual describes how to use the punchout capability of Oracle Exchange to provide Exchange members and iProcurement users punchout access to supplier-hosted catalogs. Intended Audience This manual is intended for suppliers who wish to set up punchout access to their local catalogs and iProcurement managers who wish to enable and control punchout capability from an iProcurement instance. Structure This manual describes the following: Chapter 1 Using Oracle Exchange Punchouts This chapter explains punchout technology and describes the different punchout models and the benefits of each. Chapter 2 Defining an Oracle Exchange Punchout This chapter describes the Oracle Exchange to supplier punchout model and explains the process a supplier uses to implement this type of punchout. Chapter 3 Defining an Oracle iProcurement Punchout This chapter explains the different punchout models supported by Oracle iProcurement and how to implement each. ix

Appendix A Oracle Exchange Punchout DTDs This appendix contains examples of the DTDs used when executing Oracle Native XML punchout transactions from Oracle Exchange. Appendix B Oracle iProcurement Punchout DTDs This appendix contains examples of the DTDs used when implementing an XML punchout from Oracle iProcurement. Appendix C Sample Oracle iProcurement XML Documents This appendix conatins example XML documents used during a punchout from Oracle iProcurement (sample XML documents used for native XML punchout from Oracle Exchange are contained in Chapter 2). Related Documents For additional information on installing and implementing Oracle Exchange and Oracle iProcurement, see the following manuals: x Oracle iProcurement for Release 11i Installation Guide Oracle iProcurement for Release 11i Implementation Guide Oracle Exchange Installation Guide

1 Using Oracle Exchange Punchouts While procurement systems and online exchanges typically offer the ability to store information about their suppliers’ items or services locally, the task of defining and maintaining these local catalogs is both time consuming and, in the case of some products that are continually changing, extremely difficult. Additionally, some items and services are not well suited to this hosted catalog model (for example books, where the catalog changes frequently). Yet Exchange suppliers and procurement system content providers know that their users still want the ability to purchase such items. The problem is how to allow access to all the items but without the high cost overhead of having to maintain catalogs locally. The solution is punchout technology. Topics covered in this chapter include: Overview of Oracle Exchange Punchouts Punchout models Benefits comparison of the punchout models References Software requirements Overview of Oracle Exchange Punchouts Punchout enables buyers to connect to the supplier’s catalog and search for items directly on the supplier’s site. When an item or items are identified, the item information is returned to the buyer’s system to be added to any additional items being purchased. Punchout benefits both the supplier and the buyer by allowing suppliers to maintain and host their own catalog information, while buyers can search for items from within their own ERP system, procurement software, or online exchange purchasing operation. Using Oracle Exchange Punchouts 1-1

Additionally, a supplier can utilize the large customer base existing within an Oracle Exchange to increase the exposure that their products receive while reducing the configuration effort required on the part of the supplier. A supplier can define a punchout on an Oracle Exchange once and all Exchange members and Oracle iProcurement users on that exchange can use this punchout definition to access that supplier directly. Using the punchout capability provides the following: Exchange members have access to a broader range of potential products and services not just products whose information is stored locally on the exchange. Self service requisitioners within a buying organization are able to search on both the exchange and supplier sites for products which meet their requirements while Purchasing Managers can control contract leakage be ensuring that only items from approved suppliers are purchased. Suppliers can utilize the large customer base existing within an Oracle Exchange to increase the exposure for their products while reducing their configuration and maintenance effort. A supplier can define a punchout once and all members accessing this exchange can use this punchout definition to access the suppliers’ catalogs. Punchout Benefits Products which are configurable or include highly variable or dynamic pricing are difficule to maintain within a static, hosted catalog environment. These types of items are particularly well suited to a punchout as this allows the supplier to control the configuration and pricing. Catalogs which are continually changing are costly and time-consuming to maintain in a hosted environment. These types of catalogs are more accurately maintained by the supplier to ensure that the latest catalog content and pricing are available. Obtaining information directly from a supplier using a punchout ensures that the product information is accurate and up-to-date, which eliminates downstream inefficiencies due to incorrect product or pricing information . The burden of maintaining the hosted catalog is removed from the buying organization, which reduces both catalog maintenance and data storage costs. Products which previously had been difficult to maintain within a locally hosted catalog can now be purchased from within the buyer’s ERP system, procurement software, or directly from the exchange. Punchout does not suit every product or supplier however. By allowing the supplier to host catalog information locally, the buyer or buying organization must work closely with the supplier to control the content and pricing of products. 1-2 Oracle Exchange Punchout Guide

Table 1-1 Supplier Hosted versus Locally Hosted Catalogs Supplier Hosted Catalogs Locally Hosted Catalogs Best suited for products requiring a high degree of configuration (such as computer hardware), specialized services, or products with fluctuating prices. Best suited for commodity-type items (such as office supplies), products with pre-negotiated or stable prices, MRO items, or products built to a predetermined specification (such as mass produced mechanical parts). Supplier closely manages the content presented to buyers. Supplier avoids managing a complex web site and web content. Punchout Models Oracle Exchange supports various punchout models allowing both suppliers and buyers to provide and obtain goods and services most efficiently. Model 1: Oracle Exchange punchout to Supplier-hosted catalogs. Using Oracle Exchange Punchouts 1-3

Model 2: Punchout from Oracle iProcurement to Oracle Exchange in XML format Model 3: Punchout from Oracle iProcurement to a Supplier-hosted catalog via Oracle Exchange using XML format 1-4 Oracle Exchange Punchout Guide

Model 4: Punchout from Oracle iProcurement to a Supplier-hosted catalog via Oracle Exchange using cXML format Model 5: Punchout from Oracle iProcurement directly to a Supplier-hosted catalog using XML Using Oracle Exchange Punchouts 1-5

Benefits Comparison of Punchout Models Model Buyer Benefits Supplier Benefits Comments 1 Oracle Exchange punchout to supplier-hosted catalogs Buyer members automatically have access to centralized collection of punchouts simply by registering with Exchange. Suppliers define punchouts once to Exchange and are then visible to potentially all Exchange members. Suppliers can control access to their punchouts. Purchasing Managers and Company Admins can control buyer access. 2 iProcurement punchout to Oracle Exchange hosted catalogs iProcurement requisitioners have access to all supplier catalogs defined on Exchange. As soon as a supplier defines a catalog to Exchange, iProcurement users have access to it. Catalogs are also available to registered Exchange users. 3/4 iProcurement punchout to supplier hosted catalogs via Oracle Exchange iProcurement users have Suppliers only have to define their Punchout can be access to centralized punchouts on the Exchange once. via Oracle native collection of punchouts. An individual configuration within XML or cXML each iProcurement instance is not required. 5 iProcurement punchout directly to supplier hosted catalogs eContent managers can control their users’ access to punchouts from within iProcurement. Supplier can control access by determining who obtains the punchout information. Any punchout changes must be communicated to all buyer organizations. References Oracle iProcurement for Release 11i Installation Guide Oracle iProcurement for Release 11i Implementation Guide Oracle Exchange Implementation and Setup Guide Software Requirements Oracle Exchange 6.1, Patchset C or above Oracle iProcurement Release 11i, Patchset J or above 1-6 Oracle Exchange Punchout Guide Available using XML format only.

2 Defining an Oracle Exchange Punchout This chapter explains how to implement a punchout from Oracle Exchange to a supplier. Topics in this chapter include: Introduction to Oracle Exchange punchout Functional overview of Oracle Exchange punchouts Steps to perform on Oracle Exchange Steps to perform on your web site Steps to configure your punchout definition Oracle Exchange punchout setup checklist Introduction Suppliers using Oracle Exchange typically choose to host their catalogs of goods and services physically on Exchange. This relieves them of many of the catalog management tasks. If you wish, however, to still host your own web catalog and yet allow that catalog to be accessible to customers browsing Exchange, you can set up a punchout from the Exchange to your supplier-hosted catalogs. While buyers are browsing the Exchange, they enter keywords to search for particular products and services. The Exchange search engine will present a list of items which match the keywords entered by the buyer. If items from your supplier-hosted web catalogs match the search criteria, the buyer is presented with a link from the Exchange catalog to navigate to your supplier-hosted catalog. When the buyer completes selecting items to purchase, your supplier-hosted site returns the shopping cart contents to the Exchange to complete the buyer’s transaction. Defining an Oracle Exchange Punchout 2-1

Introduction Oracle Exchange uses XML transactions to pass information between Exchange and your supplier-hosted site. Exchange supports both XML and cXML protocols for exchanging information. Functional Overview Exchange Supplier Website ➊ XML ➋ Exchange Catalog Search XML HTTPS Portal ➌ ➍ Exchange Return URL XML ➎ Supplier Web Store Exchange Checkout Firewall 2-2 Oracle Exchange Punchout Guide

Introduction 1. When the keywords you defined when you defined your punchout on the Exchange meet the search criteria of a buyer shopping on Exchange, a link to your site is displayed. 2. When the buyer clicks the link to your site, the Exchange will post an XML or cXML document to the URL address that you specified for your web catalog. This document will include among other things, a connection password, the buyer’s Exchange username, the buyer’s company name, and a return URL For examples of this document in both XML and cXML, see “Process the incoming Punchout Request/PunchOutSetupRequest transaction” later in this chapter. 3. Your site must be able to process this XML or cXML document, validate that the password is correct, create an HTTP session to handle the request, and respond with a document specifying a destination URL and session information. The session information is important for two reasons. If required, it will allow you to provide buyer-specific information such as unique or pre-selected configurations, buyer-specific pricing or products, or buyer-specific advertising or links. It will allow your site to recognize buyers as having linked to your site from Exchange, and to return the buyers back to the Exchange along with the contents of their shopping carts once they have completed selecting their items. For examples of this document in both XML and cXML, see “Provide an appropriate Punchout Request Response/PunchOutSetupResponse transaction” later in this chapter. 4. The Exchange will redirect the buyer’s browser to the URL passed to it from the your site to allow the buyer to continue to shop on your web catalog. 5. When the buyer finishes shopping and is ready to return to the Exchange, your site must post an XML or cXML document containing all the selected items in the shopping cart back to the URL the Exchange passed in the initial call to your site. For examples of this document in both XML and cXML see, “Return the XML Shopping Cart/PunchOutOrderMessage information” later in this chapter. Defining an Oracle Exchange Punchout 2-3

Steps to Perform on Exchange 6. Once the buyer has returned to the Exchange, additional purchases can be made, or the buyer can proceed to checkout. Steps to Perform on Exchange Step 1: Register your company on Exchange To enable buyers on Exchange to access your site, you must exist as a registered company on the Exchange (if you are already registered with Exchange, no additional or special type of registration is necessary). To register with Exchange: 1. Navigate to the URL of the Exchange with which you wish to participate. 2. From the Marketplace home page, click the “Sign me up!” link. 3. On the Exchange Registration page, click the appropriate radio button selection, and then click Proceed to Registeration. 4. Use the online help pages available by clicking the Help icon at the top of the page to guide you through the remainder of the registration process. Step 2: Create code mappings If you plan to integrate the Exchange with your ERP system and web catalog, it is necessary to map the codes which are used within Exchange to the codes that are used for items in your catalog. This allows Exchange to recognize codes that are passed to it by your site when users have finished selecting the items they wish to purchase.You need to create mappings for currency codes and unit of measurement codes. Note that Currency Code and Unit of Measurement are only two of the codes which can be mapped. Mapping values you specify are also used for other inbound and outbound XML documents passed between Exchange and your company. You must be signed on to Exchange as a Company Administrator to define these mappings. Map currency codes 2-4 1. Sign on to Exchange using a signon with Company Admin authority. If you just registered your company in the previous step, the signon you used will have Company Admin authority 2. From the Marketplace homepage, click the “Company Admin” link, then click the “Application Setup” tab. The Application Setup page appears. Oracle Exchange Punchout Guide

Steps to Perform on Exchange 3. Click the “Data Mapping” link. The Data Mapping page appears. 4. Click the Currency Code radio button and then click the “Edit Mapping” button. The Edit Mapping (Currency Code) page appears. 5. Display the currency code you wish to map by entering the code in the “Currency Code Search” datafield and clicking the “Go” button, or by clicking the letter link that corresponds to the first letter of the code. The resulting display shows all currency codes that matched your search criteria. Description Exchange Value Text description of the currency code The value used internally by Exchange to represent this currency My Company to Exchange Value Exchange to My Company The value you will pass to Exchange The value Exchange will forward to you if sending a transaction from the Exchange (not used for Punchout) If your company does not use the code shown in the second column, enter the code you use in the third column. For example, your company may use US as the code for US dollars while Exchange uses USD for US dollars. In this case, you would enter US in the third column’s datafield to define the correct mapping. After you have specified all your code mappings, click the “Apply Changes” button. Map unit of measurement codes In addition to mapping your currency codes, you must also map the unit of measurement codes. You must map all unit of measurement codes that will be passed between your company and Exchange. The process to map unit of measurement codes is similar to that of mapping currency codes. 1. Sign on to Exchange using a signon with Company Admin authority. 2. From the Marketplace homepage, click the “Company Admin” link. Click the “Application Setup” tab. The Application Setup page appears. 3. Click the “Data Mapping” link. The Data Mapping page appears. 4. Click the Unit of Measurement radio button and click the “Edit Mapping” button. The Edit Mapping (Unit of Measurement) page appears. Defining an Oracle Exchange Punchout 2-5

Steps to Perform at Your Web Site 5. If you do not see the unit of measurement code you wish to map, enter the code in the “Unit of Measurement Search” datafield and click the “Go” button, or click the letter link that corresponds to the first letter of the code. The resulting display shows all unit of measurement codes that match your search criteria. Description Exchange Value Text description of the unit of measurement code The value used internally by Exchange to represent that unit of measurement My Company to Exchange Value Exchange to My Company The value you will pass to Exchange The value Exchange will forward to you if sending a transaction from the Exchange (not used for Punchout) If your company does not use the code shown in the second column, enter the code you use in the third column. For example, your company may use CSE as the cod

This appendix conatins example XML documents used during a punchout from Oracle iProcurement (sample XML documents used for native XML punchout from Oracle . not well suited to this hosted catalog model (for example books, where the catalog changes frequently). Yet Exchange suppliers and procurement system content providers know that

Related Documents:

access to punchout and transparent punchout catalogs. Appendix A expands on the overview of each punchout and transparent punchout model by describing how the process works at a more detailed level. Appendix B displays the DTD used by punchout and transparent punchout, descriptions of

Punchout Catalog Implementation & Functionality Requirements Suppliers awarded contracts that specify punchout catalogs will be required to provide two Punchout websites. The first is used for development integration testing and the second is used for production purposes. Both sites must have the standard Punchout functionality capabilities as .

What is a PunchOut Catalogue? PunchOut catalogues are interactive catalogues stored on your website that use cXML to enable two-way communication of electronic commerce details. For PunchOut catalogues, procurement applications display a hyperlink instead of product or pricing details. When users click this hyperlink, their web browser displays

Oracle e-Commerce Gateway, Oracle Business Intelligence System, Oracle Financial Analyzer, Oracle Reports, Oracle Strategic Enterprise Management, Oracle Financials, Oracle Internet Procurement, Oracle Supply Chain, Oracle Call Center, Oracle e-Commerce, Oracle Integration Products & Technologies, Oracle Marketing, Oracle Service,

Oracle is a registered trademark and Designer/2000, Developer/2000, Oracle7, Oracle8, Oracle Application Object Library, Oracle Applications, Oracle Alert, Oracle Financials, Oracle Workflow, SQL*Forms, SQL*Plus, SQL*Report, Oracle Data Browser, Oracle Forms, Oracle General Ledger, Oracle Human Resources, Oracle Manufacturing, Oracle Reports,

7 Messaging Server Oracle Oracle Communications suite Oracle 8 Mail Server Oracle Oracle Communications suite Oracle 9 IDAM Oracle Oracle Access Management Suite Plus / Oracle Identity Manager Connectors Pack / Oracle Identity Governance Suite Oracle 10 Business Intelligence

Advanced Replication Option, Database Server, Enabling the Information Age, Oracle Call Interface, Oracle EDI Gateway, Oracle Enterprise Manager, Oracle Expert, Oracle Expert Option, Oracle Forms, Oracle Parallel Server [or, Oracle7 Parallel Server], Oracle Procedural Gateway, Oracle Replication Services, Oracle Reports, Oracle

J’ai commencé à apprendre la guitare. Ma copine a choisi d’étudier le théâtre l’année prochaine. J’ai oublié d’acheter un cadeau d‘anniversaire pour ma sœur. Use of comparative and superlative of adjectives and adverbs such as: Je trouve l’espagnol plus facile que le français. Ma meilleure copine est plus petite que moi. La physique est la matière la plus difficile .