Module: Complex Product API
Resource: product_custom_option_value
Method:
- product_custom_option_value.add (SOAP V1)
- catalogProductCustomOptionValueAdd (SOAP V2)
Allows you to add a new custom option value to a custom option. Note that the custom option value can be added only to the option with the Select Input Type.
Arguments:
Type | Name | Description |
string | sessionId | Session ID |
string | optionId | Option ID |
array | data | Array of catalogProductCustomOptionValueAdd |
string | store | Store view ID or code (optional) |
Return:
Type | Description |
boolean | True if the custom option value is added |
The catalogProductCustomOptionValueAdd content is as follows:
Type | Name | Description |
string | title | Custom option value title |
string | price | Custom option value price |
string | price_type | Type of the custom option value price. Can have one of the following values: “fixed” or “percent” |
string | sku | Custom option value row SKU |
string | sort_order | Custom option value sort order |
Faults:
Fault Code | Fault Message |
101 | Option value with requested id does not exist. |
102 | Error while adding an option value. Details are in the error message. |
104 | Invalid option type. |
Examples
Request Example SOAP V1
$proxy = new SoapClient('http://magentohost/api/soap/?wsdl');
$sessionId = $proxy->login('apiUser', 'apiKey');
$productOptionId = 1;// Existing product option ID
// Add custom option value
$customOptionValue = array(
"title" => "Some value text 1",
"price" => 10.00,
"price_type" => "fixed",
"sku" => "custom_text_option_sku",
"sort_order" => 0
);
$resultCustomOptionValueAdd = $proxy->call(
$sessionId,
"product_custom_option_value.add",
array(
$productOptionId,
array($customOptionValue)
)
);
Request Example SOAP V2
$proxy = new SoapClient('http://magentohost/api/v2_soap/?wsdl');
$sessionId = $proxy->login('apiUser', 'apiKey');
$result = $proxy->catalogProductCustomOptionValueAdd($sessionId, '10', array(array(
'title' => 'value',
'price' => '99.99',
'price_type' => 'fixed',
'sku' => 'sku',
'sort_order' => '1'
)));
var_dump($result);
Request Example SOAP V2 (WS-I Compliance Mode)
$proxy = new SoapClient('http://magentohost/api/v2_soap/?wsdl');
$sessionId = $proxy->login((object)array('username' => 'apiUser', 'apiKey' => 'apiKey'));
$result = $proxy->catalogProductCustomOptionValueAdd((object)array('sessionId' => $sessionId->result, 'optionId' => '10', 'data' => array(array(
'title' => 'value',
'price' => '99.99',
'price_type' => 'fixed',
'sku' => 'sku',
'sort_order' => '1'
))));
var_dump($result->result);