OfferAdd command

This command adds a new offer, and its description and price. This command is called by the Product Management tools in the WebSphere Commerce Accelerator.

Command structure

http://host_name/path/
The fully qualified name of your WebSphere Commerce Server and the configuration path.

Diagram of the command structure: the command starts with the fully qualified name of your WebSphere Commerce Server and the configuration path, followed by the command name, OfferAdd  and the ? character. End the command with a list of parameters in the form of name value pairs. Separate each name value pair with the & character. For a detailed description of the parameters and their values, refer to the list entitled Parameter values.

Parameter values

offerId
(Required) The reference number of the offer. You must specify either offerId, or catentryId combined with identifier.
catentryId
(Required) The reference number of the catalog entry offered for sale. You must specify either catentryId combined with identifier, or offerId.
identifier
(Required) The external identifier of the offer including the catalog entry. You must specify either identifier combined with catentryId, or offerId.
field1
A customizable field.
field2
A customizable field.
flags
Indicates whether or not a shipping address is required.
maxQuantity
The maximum quantity that can be purchased in a single order under this offer.
minQuantity
The minimum quantity that can be purchased in a single order under this offer.
precedence
When more than one offer is effective at a particular time, the one with the highest precedence is used.
published
Indicates whether the offer is not published (0), published (1), or marked for deletion (2).
qtyunitId
The unit of measure for the minimum and maximum quantities.
desc
The description of the offer.
descLangId
The description of the language's reference number.
compareprice
Reserved for IBM internal use.
price
The price of the offer.
currency
The currency of the offer.
startDate
The start date of the offer. The format is YYYY:MM:DD:HH:MM:SS.
endDate
The end date of the offer. The format is YYYY:MM:DD:HH:MM:SS.
URL
The URL to be called when the command completes successfully.

Example

The following example creates an offer, with 10002 as the identifer, for catalog entry 10001. An offer description will also be created in the language -1 and an offerprice in 1.1 in currency CAD will be created and copied into the list price:

http://host_name/webapp/wcs/stores/servlet/OfferAdd?catentryId=10001
&identifier=10002&descLangId=-1&currency=CAD&price=1.1
&field1=hello&field2=a&flags=1&maxQuantity=10
&minQuantity=0&precedence=1&published=0&qtyunitId=C62
&&desc=offer description&comparePrice=11&URL=LogonForm

Behavior

Exception conditions

None.