OfferAdd URL

This URL adds a new offer, and its description and price.

 

URL structure

http:// host_name/path/

The fully qualified name of your WebSphere Commerce Server and the configuration path.

 

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

• OfferId is required when an offer already exists, but the user want to create a new language-dependent description or new offer price for that offer.

• When OfferAdd is called, the list price will also be created of the same currency and price of the offer price.

Exception conditions

None.

Related concepts

Catalog subsystem

Related reference

OfferDelete URL
OfferUpdate URL
Catalog subsystem URLs