Home >	Contents >	Index >
Template Tag TOC  |   Alpha TOC  |   Tag Family TOC  |   Purpose TOC  |   Annotated TOC  |   Index

CART.ADDITEM

Adds an order item to the shopping cart.

Syntax

<CART.ADDITEM 
      NAME="cartname" 
      STOREID="storeid" 
      [TYPE="products"] 
      ID="assetid" 
      QUANTITY="unitspurchased" 
      PRICE="totalprice"
      [LIST="orderitems" 
      MERGE="true|false" 
      INSERTBEFORE="rowid"
      VARNAME="rowid"]/> 

Parameters

NAME (required)

Input parameter. Name of the cart object.

STOREID (required)

Input parameter. Positive integer, not more than eight digits, that identifies the store to Sites. This number is assigned by your Transact administrator.

TYPE (optional)

Input parameter. Type of item to add. The default is Products.

ID (required)

Input and output parameter. As input, asset id of the order item that is added to the cart on output.

QUANTITY (required)

Input parameter. Number of units of this item that the buyer is purchasing. If items are sold in packages, then Quantity should represent the number of packages, not the total number of items in those packages.

PRICE (required)

Input parameter. Total price of this product, specified as an integer or a number with two decimal places. PRICE cannot be negative, PRICE cannot hold a currency character such as a dollar sign ($), and PRICE cannot hold a comma (,) as used in many European countries. For example, 42.99 is an acceptable value of PRICE, but $42.99 and 42,999 are not.

For both tangible goods and digital goods, set PRICE to be the total price of the item. If QUANTITY is greater than 1, then PRICE is the total price, not the price of an individual unit. For example, if you sell a gift set of three shirts for $60, you set QUANTITY to 3 and PRICE to $60. You do not set Price to $20, the price of each individual shirt.

For digital subscriptions, set PRICE to be the price of each installment payment. For example, if a subscription costs $100, payable in four equal installments, you set PRICE to 25.

LIST (optional)

Input parameter. List of order item parameters for the item.

MERGE (optional)

Input parameter. Boolean: whether to attempt to merge quantity, price with (possibly) existing item with the input ID (asset id).

INSERTBEFORE (optional)

Input parameter. Row identifier of the item before which to insert this item if no merge occurs (the default is to insert at end).

VARNAME (optional)

Input parameter. Row identifier for the item. This is always set by additem (not by the caller) and uniquely identifies the line item in the cart.

Description

See "Order Item Parameters," for individual item parameter names and values.

		Home >	Contents >	Index >
	Oracle XML Tag Reference Copyright (c) 2013, 2016, Oracle and/or its affiliates. All rights reserved.