
Button Manager API Reference
BMSetInventory API Operation
34 June, 2009 Button Manager NVP API
BMSetInventory Request
The request specifies inventory values related to a hosted button as well as inventory values
that are specific to each menu item associated with the button.
BMSetInventory Request Fields
Item Tracking Details Fields
Field Description
METHOD (Required) BMSetInventory
HOSTEDBUTTONID (Required) The ID of the hosted button whose inventory you want to set.
TRACKINV (Required) Whether to track inventory levels associated with the button. It is
one of the following values:
z 0 - do not track inventory
z 1 - track inventory
TRACKPNL (Required) Whether to track the gross profit associated with inventory
changes. It is one of the following values:
z 0 - do not track the gross profit
z 1 - track the gross profit
NOTE: The gross profit is calculated as the price of the item less its cost,
multiplied by the change in the inventory level since the last call to
BMSetInventory.
OPTIONINDEX (Optional) Option index, which identifies the button. Option index 0 is the
menu that contains the price if one exists; otherwise, it is the first menu
without a price.
Character length and limitations: 1 single-byte alphanumeric character
SOLDOUTURL (Optional) The URL to which the buyer’s browser is redirected when the
inventory drops to 0
NOTE: Specifying a URL in this field also prevents a sale when the inventory
drops to 0; otherwise, sales can continue even when inventory is
unavailable.
Character length and limitations: 127 single-byte alphanumeric characters
ITEMNUMBER (Optional) The ID for an item associated with this button
ITEMQTY The quantity you want to specify for the item associated with this button.
Specify either the absolute quantity in this field or the change in quantity in the
quantity delta field
ITEMQTYDELTA The change in quantity you want to specify for the item associated with this
button. Specify either the change in quantity in this field or the absolute
quantity in the item quantity field
Commentaires sur ces manuels