Oracle Retail Order Management System (CWSerenade) E ...

Oracle? Retail Order Management System (CWSerenade)

E-Commerce Guide Release 5.0 E95327-02

April 2018

Oracle? Retail Order Management System E-Commerce Guide, Release 5.0

E95327-02

Copyright ? 2018, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

ii

Contact Information

30500 Bruce Industrial Parkway Cleveland, OH 44139 USA Toll Free: 888.328.2826 Tel: 440.498.4414 Fax: 440.542.3043

1800 West Park Drive Westboro, MA 01581 Tel:508.655.7500 Fax:508.647.9495

7031 Columbia Gateway Drive Columbia, MD 21046-2289 Tel: 443.285.6000

Contents

E-Commerce Overview

Types of E-Commerce Transactions

E-Commerce Order Transaction ......................................................................... 15 E-Commerce Order Reject Transaction .............................................................. 17 E-Commerce Catalog Request Transaction ....................................................... 18 E-Commerce Order Status Transaction .............................................................. 19 E-Commerce Return Transaction ....................................................................... 20 E-Commerce Cancel Transaction ....................................................................... 21 E-Commerce Customer Transaction ................................................................... 22 E-Commerce Customer History Transaction ...................................................... 23 E-Commerce Inventory Inquiry Transaction ........................................................ 25 E-Commerce Inventory Download Transaction .................................................. 26

E-Commerce Messages

Generic Order Interface (Order API)

Order API Processing Overview ......................................................................... 30 Suppressing Deposits and Refunds ................................................................. 35 Batching Orders Through the Order API .......................................................... 36 Creating a Quote through the Order API .......................................................... 37 Processing a Return ......................................................................................... 38 Performing Credit Card Tokenization on Web Orders ..................................... 39 Performing Online Credit Card Authorization on Web Orders ......................... 40 Creating Authorization History for Orders Authorized on the Web ................... 40

Typical Order Interface Scenarios ....................................................................... 43 Sending a Separate Payment Message ........................................................... 44

Order API Setup Requirements .......................................................................... 47 Order API-Related System Control Values ......................................................... 50 Customer Creation, Matching and Update Logic in the Order API ..................... 54

Customer Sold To Selection, Creation and Update ......................................... 54 Creating or Selecting Shipping Addresses or Customers ................................ 58 Customer Bill To Selection and Creation ......................................................... 62 Individual Customer Creation and Selection .................................................... 63 Resolving the Item and SKU in the Order API .................................................... 65 User-Defined Fields in the CWOrderIn Message ................................................ 66 Selecting the Sales Rep ...................................................................................... 68 Discounted and Added Items in the CWOrderOut Response Message ............. 70 Discounting and Added Items in the CWOrderOut Response Summary ......... 71 Rejecting the Order (Order API) .......................................................................... 77

3/24/15

4

CWSerenade 5.0

Contents

Order Interface XML Message Formats

Inbound Order XML Message (CWORDERIN)

Inbound Order Message: Sample XMLs .......................................................... 172 Initial order message ...................................................................................... 172 Payment-only order message ........................................................................ 172 Sales transaction order message ................................................................... 172 Quote order message .................................................................................... 173 Customer return order message .................................................................... 173 CWOrderIn message with custom special handling ....................................... 174

Detailed Order XML Response (CWORDEROUT)

Detailed Order Response Message: Sample XML ........................................... 206

Order Acknowledgement XML Message (CWORDEROUT)

Order Acknowledgement Message: Sample XML ............................................ 209

Order Reject Request Message (CWORDERREJECT)

Order Reject Request Message: Sample .......................................................... 212 Order Reject Response Message: Samples ..................................................... 213

Order Creation Errors

Translating Special Characters ......................................................................... 224

E-Commerce Catalog Requests

Customer Creation/Update Logic in E-Commerce Catalog Requests .............. 226 Creating/Updating Sold To Customers in E-Commerce Catalog Requests ... 226 Creating/Updating Individuals in E-Commerce Catalog Requests ................. 227

E-Commerce Catalog Request Response ........................................................ 228 E-Commerce Catalog Request Message (CWCatRequest) ............................. 229

E-Commerce Catalog Request Message: Sample XML ................................ 236 E-Commerce Catalog Request Response Message (CWCatreqResponse) .... 238

E-Commerce Catalog Request Response Message: Sample XML ............... 239

E-Commerce Order Status Processing

Registered customer? .................................................................................... 240 Order status response includes response type? ............................................ 241 E-Commerce Order Status Message (CWOrderStatus) ................................... 242 E-Commerce Order Status Message: Sample XML ...................................... 244 E-Commerce Order Status Response Message (CWStatusResponse) ........... 245 E-Commerce Order Status Response Message: Sample XML ..................... 250

Creating Return Authorizations from the Web Storefront

E-Commerce Return Authorization Processing ............................................. 252 E-Commerce Return Request Message (CWReturn) ....................................... 256

E-Commerce Return Request Message: Sample XML .................................. 258 E-Commerce Return Response Message (CWReturnResponse) .................... 259

3/24/15

5

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download