There is a newer version of the API available. To link to the newest API documentation, click here - Version 20110301
  1. Product API

Product API

 

getSuppliers

Retrieves a list of suppliers that the merchant has access to.

getSuppliers Request Parameters

getSuppliers Response Parameters

 

 

getSuppliers Example

getSuppliers Request Example - XML

<?php
$URL = "https://sandbox.doba.com/api/5.0/xml_partner_api.php";
$strRequest = "
<dce>
	<request>
		
		<authentication>
			<username>username</username>
			<password>password</password>
		</authentication>
		
		<retailer_id>123456</retailer_id>

		<supplier_ids>
			<supplier_id>28</supplier_id>
			<supplier_id>1</supplier_id>
		</supplier_ids>

		<action>getSuppliers</action>
	</request>
</dce>
";
$connection = curl_init();
curl_setopt($connection, CURLOPT_URL, $URL );
curl_setopt($connection, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($connection, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($connection, CURLOPT_POST, 1);
curl_setopt($connection, CURLOPT_POSTFIELDS, $strRequest);
curl_setopt($connection, CURLOPT_RETURNTRANSFER, 1);
set_time_limit(108000);
$strResponse = curl_exec($connection);
if(curl_errno($connection)) {
	print "Curl error: " . curl_error($connection);
} else {
	$info = curl_getinfo($connection);
	print "HTTP Response Code = ".$info["http_code"]."\n";
}
curl_close($connection);

print "URL = $URL\n\n";
print "Method = getSuppliers\n\n";
print "Request:\n=====================================================\n\n";
print_r($strRequest);
print "\n\nResponse:\n=====================================================\n\n";
print_r($strResponse);
?>

getSuppliers Response Example - XML

<?xml version="1.0"?>
<dce>
  <response>
    <outcome>success</outcome>
    <suppliers>
      <supplier>
        <supplier_id>28</supplier_id>
        <supplier_name>Alder</supplier_name>
        <supplier_is_pro/>
        <supplier_group>basic</supplier_group>
        <categories>
          <category>
            <id>9821</id>
            <name>Home, garden &amp; living</name>
            <selected/>
            <count/>
          </category>
        </categories>
        <info>
          <days_to_receive_refund>15</days_to_receive_refund>
          <days_allowed_to_return>30</days_allowed_to_return>
          <meta_description/>
          <meta_keywords>cottage furniture</meta_keywords>
          <inventory_info>Usually 90% of products are in-stock at anytime</inventory_info>
          <avg_product_discount>65%</avg_product_discount>
          <shipping_carriers>FedEx</shipping_carriers>
          <policy>Every product comes with our 100% satisfaction guarantee. If, after initial inspection, product is damaged or defective in any way you may return in unused condition in original carton within 30 days for a full credit.

Note: All returns are for refund only. Replacement product must be ordered again as a new order with a new order number and will include freight and handling charges.</policy>
          <rma_instructions>1. A Return Merchandise Authorization number (RMA#) must be marked on the outside of the shipping box for product returns. This RMA# is valid for 30 days.
2. You must ensure that merchandise is returned to receive proper credit. This means that the item(s) should be returned by way of a reputable shipping carrier (the supplier has asked for all damaged items to be sent back via FedEx if possible as thats who they will be setting their claims up with), the shipment should be insured, and it should have a tracking confirmation or some method of delivery confirmation.
3. Freight on merchandise being returned is to be prepaid.
4. Ship the return to:
Returns
7900 INDUSTRIAL VILLAGE RD
GREENSBORO, NC 27409
5. Non-defective merchandise will be credited at original invoice price less freight and handling charges and restocking fees of 10%.
6. Merchandise must be returned in original manufacturer box, INSIDE an outer shipping box, with enclosed
documentation (including a copy of the invoice or packing slip) and all parts.</rma_instructions>
          <damage_policy/>
          <shortage_policy/>
          <special_conditions/>
          <description>&lt;b&gt;Supplier Type:&lt;/b&gt; manufacturer&lt;br&gt;&lt;br&gt;&lt;b&gt;Brand(s) carried by supplier include(s):&lt;/b&gt; Carolina Cottage&lt;br&gt;&lt;br&gt;Note: Brand list is not inclusive of all brands sold by supplier.</description>
          <id>28</id>
          <name>Alder</name>
          <drop_ship_fee>2.00</drop_ship_fee>
          <visibility_group>basic</visibility_group>
          <date_active>2006-04-17</date_active>
          <allows_custom_branding>0</allows_custom_branding>
          <allows_direct_relationships>0</allows_direct_relationships>
          <product_alerts/>
          <classification>Manufacturer</classification>
          <summary/>
          <alerts/>
          <avg_ship_time>0</avg_ship_time>
          <item_count>99</item_count>
          <fulfillment_percentage>50</fulfillment_percentage>
          <rma_percentage>0</rma_percentage>
          <avg_item_lifespan>229</avg_item_lifespan>
          <num_in_stock>78</num_in_stock>
          <num_out_of_stock/>
          <inventory_update_frequency>5.17</inventory_update_frequency>
          <avg_qty_in_stock>9</avg_qty_in_stock>
          <notes/>
          <ship_price_strategy_class>FedEx</ship_price_strategy_class>
        </info>
        <inventory_stats/>
        <is_active>1</is_active>
      </supplier>
      <supplier>
        <supplier_id>1</supplier_id>
        <supplier_name>Alpha</supplier_name>
        <supplier_is_pro/>
        <supplier_group>free</supplier_group>
        <categories>
          <category>
            <id>7913</id>
            <name>Apparel, shoes &amp; jewelry</name>
            <selected/>
            <count/>
          </category>
          <category>
            <id>8336</id>
            <name>Electronics &amp; computer</name>
            <selected/>
            <count/>
          </category>
          <category>
            <id>9343</id>
            <name>Games, movies &amp; music</name>
            <selected/>
            <count/>
          </category>
          <category>
            <id>9679</id>
            <name>Health &amp; beauty</name>
            <selected/>
            <count/>
          </category>
          <category>
            <id>9821</id>
            <name>Home, garden &amp; living</name>
            <selected/>
            <count/>
          </category>
          <category>
            <id>10216</id>
            <name>Outdoor &amp; sports</name>
            <selected/>
            <count/>
          </category>
        </categories>
        <info>
          <days_to_receive_refund>10</days_to_receive_refund>
          <days_allowed_to_return>90</days_allowed_to_return>
          <meta_description>Consumer electronics drop ship supplier Alpha is popular for its large selection of electronics like CD players, radios, digital cameras, speakers, karaoke machines, and more</meta_description>
          <meta_keywords>electronics drop shipper, electronics supplier, wholesale electronics accessories, wholesale consumer electronics, speakers, digital cameras, scanners, karaoke machines</meta_keywords>
          <inventory_info>Usually 90% of products are in-stock at anytime</inventory_info>
          <avg_product_discount>45%</avg_product_discount>
          <shipping_carriers>UPS</shipping_carriers>
          <policy>Return Policy

1.	A Return Merchandise Authorization (RMA) number must be obtained from Alpha prior to the return of any merchandise. Product returned without an RMA number will be returned to the customer at the customers expense.

2.	 RMA numbers are valid for a period of 30 days only.

3.	Defective returns are eligible for return only within 30 days from Alpha invoice date. After 30 days, all products must be referred to the manufacturer for authorized warranty repair. (Some manufacturers may have stricter return policies.) Eligible returns will be credited at purchase price or current selling, which ever is lower.  Original freight does not qualify for credit on defective returns however, replacement orders will be shipped out prepaid.   

4.	All returns must be shipped prepaid freight by the customer with the RMA number displayed on the outside of the box.

5.	Products must be returned complete with original parts and documentation along with the original manufacturers box/packaging. 

6.	Factory sealed product in re-sellable condition may be returned at Alphas discretion. Re-sellable products authorized for return will be credited at the current Alpha selling price less a 20% restocking fee.

7.	Returns not received complete (ie; missing parts, documentation, or manufacturer?s box/packing) will not be credited and will be sent back to the customer at their expense. 

8.	Returns will be credited at the price paid on invoice or current selling price, whichever is lower, less any re-stock fee. Items showing signs of misuse or consumer abuse will not be accepted for return credit. Credit will be processed 5 business days after receipt of merchandise at Alpha.

9.	Sale of closeout items are final. Only defective closeout items may be returned for credit as per normal Alpha policies.

10.	 Plasma TVs are not eligible for return to AlphaL

11.	All Samsung TV?s and Monitors, regardless of size, do not qualify for return and must be handled directly by the manufacturer by calling 1-800-SAM-SUNG.

12.	Most TV?s/Monitors 30? or larger and projection products that require in-field service /repairs must be coordinated through the manufacturer?s warranty procedures. These products are not eligible for return. Please contact the appropriate manufacturer for troubleshooting or repair service.

NOTE:  Non-defective merchandise will be credited at original invoice price less freight and handling charges and restocking fees of: 20%</policy>
          <rma_instructions>1. A Return Merchandise Authorization number (RMA#) must be marked on the outside of the shipping box for product returns. This RMA# is valid for 30 days.
2. You must ensure that merchandise is returned to receive proper credit. This means that the item(s) should be returned by way of a reputable shipping carrier, the shipment should be insured, and it should have a tracking confirmation or some method of delivery confirmation.
3. Freight on merchandise being returned is to be prepaid.
4. Ship the return to:
Returns Dept.
12510 Micro Dr.
 DOCK  R
 Mira Loma, CA 91752

5. Defective merchandise including original freight and handling fee will be credited upon receipt of merchandise
6. Non-defective merchandise will be credited at original invoice price less freight and handling charges and restocking fees of: 20% 
7. Merchandise must to be returned in original manufacturer box, INSIDE an outer shipping box, with enclosed
documentation and all parts. No returns or credit requests are accepted after 90 days of invoice/ship date. Where applicable, a fee up to 50% of the product price may be applied for missing parts, documentation, and manufacturer?????s box/packing.
8. Credit will be issued within 15 business days upon receipt of merchandise.
9. Plasma TVs are not eligible for return.</rma_instructions>
          <damage_policy/>
          <shortage_policy/>
          <special_conditions/>
          <description>&lt;b&gt;Supplier Type:&lt;/b&gt; distributor&lt;br&gt;&lt;br&gt;&lt;b&gt;Brand(s) carried by supplier include(s):&lt;/b&gt; Steren, Ultralast, Pyle, Cables Unlimited and Philips USA&lt;br&gt;&lt;br&gt;Note: Brand list is not inclusive of all brands sold by supplier.</description>
          <id>1</id>
          <name>Alpha</name>
          <drop_ship_fee>1.50</drop_ship_fee>
          <visibility_group>free</visibility_group>
          <date_active>2003-04-08</date_active>
          <allows_custom_branding>0</allows_custom_branding>
          <allows_direct_relationships>0</allows_direct_relationships>
          <product_alerts/>
          <classification>Distributor</classification>
          <summary/>
          <alerts/>
          <avg_ship_time>0</avg_ship_time>
          <item_count>20243</item_count>
          <fulfillment_percentage>90.54</fulfillment_percentage>
          <rma_percentage>4.05</rma_percentage>
          <avg_item_lifespan>163</avg_item_lifespan>
          <num_in_stock>14214</num_in_stock>
          <num_out_of_stock/>
          <inventory_update_frequency>1</inventory_update_frequency>
          <avg_qty_in_stock>96</avg_qty_in_stock>
          <notes>Plasma TVs are not eligible for return to Alpha. Most TV/Monitors 30"/projections products and Samsung TVs 14" or larger to not qualify under normal Alpha Return Policy. Contact Samsung @ 1-800-SAMSUNG for service. Most TVs/Monitors 30" or larger and projection products require in-field service repairs under manufacturers warranty. These products are not eligible for return. Please contact the appropriate manufacturer for troubleshooting repair service.</notes>
          <ship_price_strategy_class>FedEx</ship_price_strategy_class>
        </info>
        <inventory_stats/>
        <is_active>1</is_active>
      </supplier>
    </suppliers>
  </response>
</dce>

getSuppliers Request Example - SOAP

<?php
$URL = "https://sandbox.doba.com/soap/5.0/wsdl/ApiPartnerSearch.wsdl";
$client = new SoapClient($URL, array("trace" => 1));
$objAuth = new stdClass();
$objAuth->username = "username";
$objAuth->password = "password";
$objRequest = new stdClass();
$objRequest->authentication = $objAuth;
$objRequest->retailer_id="123";

$objRequest->supplier_ids=array("28", "1");

try { $Response = $client->getSuppliers($objRequest); }
catch ( SOAPFault $e ) {$Response = ("Error ".$e->faultcode.": ".$e->faultstring); }

print "URL = $URL\n\n";
print "Method = getSuppliers\n\n";
print "Request:\n=====================================================\n\n";
print_r($objRequest);
print "\n\nResponse:\n=====================================================\n\n";
print_r($Response);
?>

getSuppliers Response Example - SOAP

Array
(
    [0] => stdClass Object
        (
            [categories] => Array
                (
                    [0] => stdClass Object
                        (
                            [count] => 
                            [id] => 9821
                            [name] => Home, garden & living
                            [selected] => 
                        )

                )

            [info] => stdClass Object
                (
                    [alerts] => 
                    [allows_custom_branding] => 
                    [allows_direct_relationships] => 
                    [avg_item_lifespan] => 229
                    [avg_product_discount] => 65%
                    [avg_qty_in_stock] => 9
                    [avg_ship_time] => 0
                    [classification] => Manufacturer
                    [damage_policy] => 
                    [date_active] => 2006-04-17
                    [days_allowed_to_return] => 30
                    [days_to_receive_refund] => 15
                    [description] => <b>Supplier Type:</b> manufacturer<br><br><b>Brand(s) carried by supplier include(s):</b> Carolina Cottage<br><br>Note: Brand list is not inclusive of all brands sold by supplier.
                    [drop_ship_fee] => 2
                    [fulfillment_percentage] => 50
                    [id] => 28
                    [inventory_info] => Usually 90% of products are in-stock at anytime
                    [inventory_update_frequency] => 5.17
                    [item_count] => 99
                    [meta_description] => 
                    [meta_keywords] => cottage furniture
                    [name] => Alder
                    [notes] => 
                    [num_in_stock] => 78
                    [num_out_of_stock] => 
                    [policy] => Every product comes with our 100% satisfaction guarantee. If, after initial inspection, product is damaged or defective in any way you may return in unused condition in original carton within 30 days for a full credit.

Note: All returns are for refund only. Replacement product must be ordered again as a new order with a new order number and will include freight and handling charges.
                    [product_alerts] => 
                    [rma_instructions] => 1. A Return Merchandise Authorization number (RMA#) must be marked on the outside of the shipping box for product returns. This RMA# is valid for 30 days.
2. You must ensure that merchandise is returned to receive proper credit. This means that the item(s) should be returned by way of a reputable shipping carrier (the supplier has asked for all damaged items to be sent back via FedEx if possible as thats who they will be setting their claims up with), the shipment should be insured, and it should have a tracking confirmation or some method of delivery confirmation.
3. Freight on merchandise being returned is to be prepaid.
4. Ship the return to:
Returns
7900 INDUSTRIAL VILLAGE RD
GREENSBORO, NC 27409
5. Non-defective merchandise will be credited at original invoice price less freight and handling charges and restocking fees of 10%.
6. Merchandise must be returned in original manufacturer box, INSIDE an outer shipping box, with enclosed
documentation (including a copy of the invoice or packing slip) and all parts.
                    [rma_percentage] => 0
                    [ship_price_strategy_class] => FedEx
                    [shipping_carriers] => FedEx
                    [shortage_policy] => 
                    [special_conditions] => 
                    [summary] => 
                    [visibility_group] => basic
                )

            [is_active] => 1
            [supplier_group] => basic
            [supplier_id] => 28
            [supplier_is_pro] => 
            [supplier_name] => Alder
        )

    [1] => stdClass Object
        (
            [categories] => Array
                (
                    [0] => stdClass Object
                        (
                            [count] => 
                            [id] => 7913
                            [name] => Apparel, shoes & jewelry
                            [selected] => 
                        )

                    [1] => stdClass Object
                        (
                            [count] => 
                            [id] => 8336
                            [name] => Electronics & computer
                            [selected] => 
                        )

                    [2] => stdClass Object
                        (
                            [count] => 
                            [id] => 9343
                            [name] => Games, movies & music
                            [selected] => 
                        )

                    [3] => stdClass Object
                        (
                            [count] => 
                            [id] => 9679
                            [name] => Health & beauty
                            [selected] => 
                        )

                    [4] => stdClass Object
                        (
                            [count] => 
                            [id] => 9821
                            [name] => Home, garden & living
                            [selected] => 
                        )

                    [5] => stdClass Object
                        (
                            [count] => 
                            [id] => 10216
                            [name] => Outdoor & sports
                            [selected] => 
                        )

                )

            [info] => stdClass Object
                (
                    [alerts] => 
                    [allows_custom_branding] => 
                    [allows_direct_relationships] => 
                    [avg_item_lifespan] => 163
                    [avg_product_discount] => 45%
                    [avg_qty_in_stock] => 96
                    [avg_ship_time] => 0
                    [classification] => Distributor
                    [damage_policy] => 
                    [date_active] => 2003-04-08
                    [days_allowed_to_return] => 90
                    [days_to_receive_refund] => 10
                    [description] => <b>Supplier Type:</b> distributor<br><br><b>Brand(s) carried by supplier include(s):</b> Steren, Ultralast, Pyle, Cables Unlimited and Philips USA<br><br>Note: Brand list is not inclusive of all brands sold by supplier.
                    [drop_ship_fee] => 1.5
                    [fulfillment_percentage] => 90.54
                    [id] => 1
                    [inventory_info] => Usually 90% of products are in-stock at anytime
                    [inventory_update_frequency] => 1
                    [item_count] => 20243
                    [meta_description] => Consumer electronics drop ship supplier Alpha is popular for its large selection of electronics like CD players, radios, digital cameras, speakers, karaoke machines, and more
                    [meta_keywords] => electronics drop shipper, electronics supplier, wholesale electronics accessories, wholesale consumer electronics, speakers, digital cameras, scanners, karaoke machines
                    [name] => Alpha
                    [notes] => Plasma TVs are not eligible for return to Alpha. Most TV/Monitors 30"/projections products and Samsung TVs 14" or larger to not qualify under normal Alpha Return Policy. Contact Samsung @ 1-800-SAMSUNG for service. Most TVs/Monitors 30" or larger and projection products require in-field service repairs under manufacturers warranty. These products are not eligible for return. Please contact the appropriate manufacturer for troubleshooting repair service.
                    [num_in_stock] => 14214
                    [num_out_of_stock] => 
                    [policy] => Return Policy

1.	A Return Merchandise Authorization (RMA) number must be obtained from Alpha prior to the return of any merchandise. Product returned without an RMA number will be returned to the customer at the customers expense.

2.	 RMA numbers are valid for a period of 30 days only.

3.	Defective returns are eligible for return only within 30 days from Alpha invoice date. After 30 days, all products must be referred to the manufacturer for authorized warranty repair. (Some manufacturers may have stricter return policies.) Eligible returns will be credited at purchase price or current selling, which ever is lower.  Original freight does not qualify for credit on defective returns however, replacement orders will be shipped out prepaid.   

4.	All returns must be shipped prepaid freight by the customer with the RMA number displayed on the outside of the box.

5.	Products must be returned complete with original parts and documentation along with the original manufacturers box/packaging. 

6.	Factory sealed product in re-sellable condition may be returned at Alphas discretion. Re-sellable products authorized for return will be credited at the current Alpha selling price less a 20% restocking fee.

7.	Returns not received complete (ie; missing parts, documentation, or manufacturer?s box/packing) will not be credited and will be sent back to the customer at their expense. 

8.	Returns will be credited at the price paid on invoice or current selling price, whichever is lower, less any re-stock fee. Items showing signs of misuse or consumer abuse will not be accepted for return credit. Credit will be processed 5 business days after receipt of merchandise at Alpha.

9.	Sale of closeout items are final. Only defective closeout items may be returned for credit as per normal Alpha policies.

10.	 Plasma TVs are not eligible for return to AlphaL

11.	All Samsung TV?s and Monitors, regardless of size, do not qualify for return and must be handled directly by the manufacturer by calling 1-800-SAM-SUNG.

12.	Most TV?s/Monitors 30? or larger and projection products that require in-field service /repairs must be coordinated through the manufacturer?s warranty procedures. These products are not eligible for return. Please contact the appropriate manufacturer for troubleshooting or repair service.

NOTE:  Non-defective merchandise will be credited at original invoice price less freight and handling charges and restocking fees of: 20%
                    [product_alerts] => 
                    [rma_instructions] => 1. A Return Merchandise Authorization number (RMA#) must be marked on the outside of the shipping box for product returns. This RMA# is valid for 30 days.
2. You must ensure that merchandise is returned to receive proper credit. This means that the item(s) should be returned by way of a reputable shipping carrier, the shipment should be insured, and it should have a tracking confirmation or some method of delivery confirmation.
3. Freight on merchandise being returned is to be prepaid.
4. Ship the return to:
Returns Dept.
12510 Micro Dr.
 DOCK  R
 Mira Loma, CA 91752

5. Defective merchandise including original freight and handling fee will be credited upon receipt of merchandise
6. Non-defective merchandise will be credited at original invoice price less freight and handling charges and restocking fees of: 20% 
7. Merchandise must to be returned in original manufacturer box, INSIDE an outer shipping box, with enclosed
documentation and all parts. No returns or credit requests are accepted after 90 days of invoice/ship date. Where applicable, a fee up to 50% of the product price may be applied for missing parts, documentation, and manufacturer?????s box/packing.
8. Credit will be issued within 15 business days upon receipt of merchandise.
9. Plasma TVs are not eligible for return.
                    [rma_percentage] => 4.05
                    [ship_price_strategy_class] => FedEx
                    [shipping_carriers] => UPS
                    [shortage_policy] => 
                    [special_conditions] => 
                    [summary] => 
                    [visibility_group] => free
                )

            [is_active] => 1
            [supplier_group] => free
            [supplier_id] => 1
            [supplier_is_pro] => 
            [supplier_name] => Alpha
        )
)

 

 

getItemSearch

Searches and retrieves product information based on custom criteria.

The getItemSearch method can be used to build a replica of the Doba category tree. First, call the function with no parameters and the returned data will contain the top level category structure. From there you can specify the category_id on subsequent calls to obtain the sub-categories. A maximum of 50,000 items can be returned via getItemSearch.

Note: If no option arguments are provided, the response will not include product data. It will only include the filter information along with the top-level category structure.

getItemSearch Request Parameters

getItemSearch Response Parameters

 

 

getItemSearch Request Example - XML

<?php
$URL = "https://sandbox.doba.com/api/5.0/xml_partner_api.php";
$strRequest = "
<dce>
<request>
		
	<authentication>
		<username>username</username>
		<password>password</password>
	</authentication>
	
	<retailer_id>123456</retailer_id>

	<action>getItemSearch</action>

	<search_term>ipod</search_term>
	
	<display_count></display_count>
	<display_start></display_start>
	
	<filter>
		<facet>
			<name>f_cat</name>
			<ids>
				<id>10216</id>
			</ids>
		</facet>		
		<facet>
			<name>f_supplier_id</name>
			<ids>
				<id>1</id>
			</ids>
		</facet>
		<facet>
			<name>f_stock</name>
			<ids>
				<id>in-stock</id>
			</ids>
		</facet>
	</filter>
	
</request>
</dce>
";
$connection = curl_init();
curl_setopt($connection, CURLOPT_URL, $URL );
curl_setopt($connection, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($connection, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($connection, CURLOPT_POST, 1);
curl_setopt($connection, CURLOPT_POSTFIELDS, $strRequest);
curl_setopt($connection, CURLOPT_RETURNTRANSFER, 1);
set_time_limit(108000);
$strResponse = curl_exec($connection);
if(curl_errno($connection)) {
	print "Curl error: " . curl_error($connection);
} else {
	$info = curl_getinfo($connection);
	print "HTTP Response Code = ".$info["http_code"]."\n";
}
curl_close($connection);

print "URL = $URL\n\n";
print "Method = getItemSearch\n\n";
print "Request:\n=====================================================\n\n";
print_r($strRequest);
print "\n\nResponse:\n=====================================================\n\n";
print_r($strResponse);
?>

getItemSearch Response Example - XML

<?xml version="1.0"?>
<dce>
<response>
    <outcome>success</outcome>
    <saved_searches>
      <saved_search>
        <criteria>O:8:"stdClass":7:{s:13:"display_start";i:0;s:13:"display_count";i:20;s:11:"search_term";s:3:"wii";s:11:"sort_column";s:7:"default";s:14:"sort_direction";s:3:"asc";s:15:"rollup_products";i:1;s:12:"search_terms";a:1:{i:0;s:3:"wii";}}</criteria>
        <friendly_criteria>O:8:"stdClass":3:{s:6:"search";s:3:"wii";s:13:"grouped_items";s:3:"yes";s:4:"sort";s:11:"Default asc";}</friendly_criteria>
        <name>wii</name>
        <saved_search_id>68695</saved_search_id>
        <results_per_page>20</results_per_page>
        <view_option>gallery</view_option>
        <sort_order>2</sort_order>
        <date_created>2009-09-11 17:02:53</date_created>
      </saved_search>
      <saved_search>
        <criteria>O:8:"stdClass":8:{s:13:"display_start";i:0;s:13:"display_count";i:20;s:11:"search_term";s:6:"shirts";s:11:"sort_column";s:7:"default";s:14:"sort_direction";s:3:"asc";s:15:"rollup_products";i:1;s:12:"search_terms";a:1:{i:0;s:6:"shirts";}s:6:"filter";a:3:{i:0;O:8:"stdClass":2:{s:4:"name";s:7:"f_stock";s:3:"ids";a:1:{i:0;s:8:"in-stock";}}i:1;O:8:"stdClass":2:{s:4:"name";s:10:"f_hasImage";s:3:"ids";a:1:{i:0;i:1;}}i:2;O:8:"stdClass":2:{s:4:"name";s:13:"f_refurbished";s:3:"ids";a:2:{i:0;i:0;i:1;i:1;}}}}</criteria>
        <friendly_criteria>O:8:"stdClass":4:{s:6:"search";s:6:"shirts";s:13:"grouped_items";s:3:"yes";s:4:"sort";s:11:"Default asc";s:7:"include";s:11:"refurbished";}</friendly_criteria>
        <name>shirts</name>
        <saved_search_id>42170</saved_search_id>
        <results_per_page>20</results_per_page>
        <view_option>gallery</view_option>
        <sort_order>3</sort_order>
        <date_created>2009-01-06 14:45:03</date_created>
      </saved_search>
    </saved_searches>
    <search_term>red</search_term>
    <parent_categories/>
    <facets>
      <facet>
        <name>f_cat</name>
        <display_name>Categories</display_name>
        <values>
          <value>
            <displayValue>Apparel, shoes &amp; jewelry</displayValue>
            <id>7913</id>
            <count>113</count>
            <selected/>
          </value>
          <value>
            <displayValue>Automotive, tool &amp; industrial</displayValue>
            <id>8071</id>
            <count>28</count>
            <selected/>
          </value>
        </values>
      </facet>
      <facet>
        <name>f_supplier_id</name>
        <display_name>Suppliers</display_name>
        <values>
          <value>
            <displayValue>Churchill</displayValue>
            <id>93</id>
            <count>412</count>
            <selected/>
          </value>
          <value>
            <displayValue>Olympic</displayValue>
            <id>87</id>
            <count>71</count>
            <selected/>
          </value>
        </values>
      </facet>
      <facet>
        <name>f_brand</name>
        <display_name>Brands</display_name>
        <values>
          <value>
            <displayValue/>
            <id/>
            <count>94</count>
            <selected/>
          </value>
          <value>
            <displayValue>anvil</displayValue>
            <id>anvil</id>
            <count>74</count>
            <selected/>
          </value>
        </values>
      </facet>
      <facet>
        <name>f_stock</name>
        <display_name>Stock</display_name>
        <values>
          <value>
            <displayValue>f_stock</displayValue>
            <id/>
            <count>
              <in-stock>1096</in-stock>
              <discontinued/>
              <not-on-site/>
              <out-of-stock/>
            </count>
            <selected/>
          </value>
        </values>
      </facet>
      <facet>
        <name>f_hasImage</name>
        <display_name>Has Image</display_name>
        <values>
          <value>
            <displayValue>True</displayValue>
            <id/>
            <count>1096</count>
            <selected/>
          </value>
          <value>
            <displayValue>False</displayValue>
            <id/>
            <count/>
            <selected/>
          </value>
        </values>
      </facet>
      <facet>
        <name>f_refurbished</name>
        <display_name>Refurbished</display_name>
        <values>
          <value>
            <displayValue>False</displayValue>
            <id/>
            <count>1096</count>
            <selected/>
          </value>
          <value>
            <displayValue>True</displayValue>
            <id/>
            <count/>
            <selected/>
          </value>
        </values>
      </facet>
      <facet>
        <name>f_special</name>
        <display_name>Special</display_name>
        <values>
          <value>
            <displayValue>f_special</displayValue>
            <id/>
            <count>
              <value>1096</value>
            </count>
            <selected/>
          </value>
        </values>
      </facet>
      <facet>
        <name>f_weekly_deal</name>
        <display_name>Weekly Deal</display_name>
        <values>
          <value>
            <displayValue>f_weekly_deal</displayValue>
            <id/>
            <count>
              <value>1096</value>
            </count>
            <selected/>
          </value>
        </values>
      </facet>
      <facet>
        <name>f_supplier_deal</name>
        <display_name>Supplier Deal</display_name>
        <values>
          <value>
            <displayValue>f_supplier_deal</displayValue>
            <id/>
            <count>
              <value>1096</value>
              <value>2</value>
            </count>
            <selected/>
          </value>
        </values>
      </facet>
      <facet>
        <name>f_attribute_l0</name>
        <display_name>Brands</display_name>
        <values/>
      </facet>
    </facets>
    <total_search_results>1644</total_search_results>
    <display_start/>
    <display_count>1</display_count>
    <products>
      <product>
        <item_id>77741</item_id>
        <item_sku>AM2A016</item_sku>
        <supplier_name>Delta</supplier_name>
        <quantity_avail>25</quantity_avail>
        <in_warehouse>1</in_warehouse>
        <stats>
          <min_cost>3.44</min_cost>
          <max_cost>3.44</max_cost>
          <min_qty>25</min_qty>
          <max_qty>25</max_qty>
          <item_count>1</item_count>
          <item_count_in_warehouse>1</item_count_in_warehouse>
        </stats>
        <flags/>
        <product_id>58318</product_id>
        <title>Accessory Kit, Minimag </title>
        <price>3.44</price>
        <original_price/>
        <prepay_price>3.34</prepay_price>
        <msrp>6.58</msrp>
        <description>Accessory pack for the Mini Mag-Lite AA. Red, amber and clear lenses. Anti-roll device/lens holder, wrist lanyard and pocket clip.</description>
        <image_url>http://d1k0ppjronk6up.cloudfront.net/products/7/AM2A016.jpg</image_url>
        <image_height>250</image_height>
        <image_width>250</image_width>
        <thumb_url>http://d1k0ppjronk6up.cloudfront.net/products/7/AM2A016.jpg?maxX=120&amp;maxY=120</thumb_url>
        <thumb_width>140</thumb_width>
        <thumb_height>130</thumb_height>
        <in_stock>1</in_stock>
        <product_sku>AM2A016</product_sku>
        <brand>MagLite</brand>
        <product_group/>
      </product>
    </products>
    <exact_match>
      <product>
        <item_id>4445674</item_id>
        <item_sku>M045368-MED~10</item_sku>
        <supplier_name>Cheetah</supplier_name>
        <quantity_avail>10</quantity_avail>
        <in_warehouse/>
        <stats>
          <min_cost>47.03</min_cost>
          <max_cost>47.03</max_cost>
          <min_qty>0</min_qty>
          <max_qty>10</max_qty>
          <item_count>8</item_count>
          <item_count_in_warehouse>0</item_count_in_warehouse>
        </stats>
        <flags/>
        <product_id>4082298</product_id>
        <title>ADIDAS EQT B Ball</title>
        <price>47.03</price>
        <original_price/>
        <prepay_price>45.68</prepay_price>
        <msrp>120.00</msrp>
        <description>The EQT B-Ball from Adidas features a fully removable boot sock liner with extra sock provided. adiPRENE plus in the forefoot maximizes propulsion and energy return. Durable non-marking rubber outsole provides superior traction on the hardwood. Durable suede leather and synthetic upper offers comfort and padded ankle and footbed for great cushioning.</description>
        <image_url>http://d1k0ppjronk6up.cloudfront.net/products/572/M045368.jpg</image_url>
        <image_height>389</image_height>
        <image_width>450</image_width>
        <thumb_url>http://d1k0ppjronk6up.cloudfront.net/products/572/M045368.jpg?maxX=120&amp;maxY=120</thumb_url>
        <thumb_width>0</thumb_width>
        <thumb_height>0</thumb_height>
        <in_stock>1</in_stock>
        <product_sku>M045368-MED</product_sku>
        <brand>ADIDAS</brand>
        <product_group/>
      </product>
    </exact_match>
    <specials/>
    <top_sellers/>
    <suggestion/>
  </response>
</dce>

getItemSearch Request Example - SOAP

<?php
$URL = "https://sandbox.doba.com/soap/5.0/wsdl/ApiPartnerSearch.wsdl";
$client = new SoapClient($URL, array("trace" => 1));
$objAuth = new stdClass();
$objAuth->username = "username";
$objAuth->password = "password";
$objRequest = new stdClass();
$objRequest->authentication = $objAuth;
$objRequest->retailer_id="12345";
$objRequest->virtual_warehouse="0";
$objRequest->user_folder_id="";
$objRequest->search_term="hammer";
$objRequest->saved_search_id="";
$objRequest->sort_column="price";
$objRequest->sort_direction="asc";
$objRequest->updated_within_last_days="0";
$objRequest->price_range_max="10";
$objRequest->price_range_min="5";
$objRequest->hide_descendents="0";
$objRequest->rollup_products="0";
$objRequest->display_count="10";
$objRequest->display_start="0";
$f_stock = new stdClass();
$f_stock->name = "f_stock";
$f_stock->ids = array("in-stock");
$objRequest->filter[]=$f_stock;
$f_cat = new stdClass();
$f_cat->name = "f_cat";
$f_cat->ids = array();
$objRequest->filter[]=$f_cat;
$f_supplier_id = new stdClass();
$f_supplier_id->name = "f_supplier_id";
$f_supplier_id->ids = array();
$objRequest->filter[]=$f_supplier_id;
$f_brand = new stdClass();
$f_brand->name = "f_brand";
$f_brand->ids = array();
$objRequest->filter[]=$f_brand;
$f_hasImage = new stdClass();
$f_hasImage->name = "f_hasImage";
$f_hasImage->ids = array("1");
$objRequest->filter[]=$f_hasImage;
$f_refurbished = new stdClass();
$f_refurbished->name = "f_refurbished";
$f_refurbished->ids = array("1","0");
$objRequest->filter[]=$f_refurbished;

try { $Response = $client->getItemSearch($objRequest); }
catch ( SOAPFault $e ) {$Response = ("Error ".$e->faultcode.": ".$e->faultstring); }

print "URL = $URL\n\n";
print "Method = getItemSearch\n\n";
print "Request:\n=====================================================\n\n";
print_r($objRequest);
print "\n\nResponse:\n=====================================================\n\n";
print_r($Response);
?>

getItemSearch Response Example - SOAP

stdClass Object
(
    [display_count] => 10
    [display_start] => 0
    [exact_match] => Array
        (
            [0] => stdClass Object
                (
                    [brand] => Steren
                    [description] => 
  • Designed for joining 2 coaxial cables together [image_height] => 200 [image_url] => http://d1k0ppjronk6up.cloudfront.net/products/1/200-050.jpg [image_width] => 240 [in_stock] => 1 [in_warehouse] => [item_id] => 9891 [item_sku] => 200-050 [msrp] => 0.95 [prepay_price] => 0.1 [price] => 0.1 [product_group] => [product_id] => 9787 [product_sku] => 200-050 [quantity_avail] => 1880 [stats] => [supplier_name] => Alpha [thumb_height] => 0 [thumb_url] => http://d1k0ppjronk6up.cloudfront.net/products/1/200-050.jpg [thumb_width] => 0 [title] => F Coupler Female To Female - Nickel F Coupler Female To Female - Nickel ) ) [facets] => Array ( [0] => stdClass Object ( [display_name] => Categories [name] => f_cat [values] => Array ( [0] => stdClass Object ( [count] => 3 [displayValue] => Apparel, shoes & jewelry [id] => 7913 [selected] => ) [1] => stdClass Object ( [count] => 8 [displayValue] => Automotive, tool & industrial [id] => 8071 [selected] => ) [2] => stdClass Object ( [count] => 15 [displayValue] => Books [id] => 8281 [selected] => ) [3] => stdClass Object ( [count] => 1 [displayValue] => Electronics & computer [id] => 8336 [selected] => ) [4] => stdClass Object ( [count] => 9 [displayValue] => Games, movies & music [id] => 9343 [selected] => ) [5] => stdClass Object ( [count] => 9 [displayValue] => Health & beauty [id] => 9679 [selected] => ) [6] => stdClass Object ( [count] => 20 [displayValue] => Unknown [id] => 3 [selected] => ) ) ) [1] => stdClass Object ( [display_name] => Suppliers [name] => f_supplier_id [values] => Array ( [0] => stdClass Object ( [count] => 17 [displayValue] => Baker and Taylor [id] => 474 [selected] => ) [1] => stdClass Object ( [count] => 11 [displayValue] => ISN Tools [id] => 21 [selected] => ) [2] => stdClass Object ( [count] => 9 [displayValue] => MDF Instruments Direct, Inc. [id] => 124 [selected] => ) [3] => stdClass Object ( [count] => 8 [displayValue] => Super D [id] => 476 [selected] => ) ) ) [2] => stdClass Object ( [display_name] => Brands [name] => f_brand [values] => Array ( [0] => stdClass Object ( [count] => 9 [displayValue] => mdf instruments usa [id] => mdf instruments usa [selected] => ) [1] => stdClass Object ( [count] => 4 [displayValue] => grip-on-tools [id] => grip-on-tools [selected] => ) [3] => stdClass Object ( [count] => 3 [displayValue] => melissa & doug [id] => melissa & doug [selected] => ) ) ) [3] => stdClass Object ( [display_name] => Stock [name] => f_stock [values] => Array ( [0] => stdClass Object ( [count] => 65 [displayValue] => in-stock [id] => in-stock [selected] => 1 ) [1] => stdClass Object ( [count] => 0 [displayValue] => [id] => [selected] => ) [2] => stdClass Object ( [count] => 0 [displayValue] => discontinued [id] => discontinued [selected] => ) [3] => stdClass Object ( [count] => 0 [displayValue] => not-on-site [id] => not-on-site [selected] => ) [4] => stdClass Object ( [count] => 0 [displayValue] => out-of-stock [id] => out-of-stock [selected] => ) ) ) [4] => stdClass Object ( [display_name] => Has Image [name] => f_hasImage [values] => Array ( [0] => stdClass Object ( [count] => 65 [displayValue] => True [id] => 1 [selected] => 1 ) [1] => stdClass Object ( [count] => 0 [displayValue] => False [id] => 0 [selected] => ) ) ) [5] => stdClass Object ( [display_name] => Refurbished [name] => f_refurbished [values] => Array ( [0] => stdClass Object ( [count] => 65 [displayValue] => False [id] => 0 [selected] => 1 ) [1] => stdClass Object ( [count] => 0 [displayValue] => True [id] => 1 [selected] => 1 ) ) ) [6] => stdClass Object ( [display_name] => Brands [name] => f_attribute_l0 [values] => ) ) [parent_categories] => Array ( ) [products] => Array ( [0] => stdClass Object ( [brand] => Melissa & Doug [description] => Two screwdrivers, a hammer and a saw are four of the essential seven tools in this collection. This extra thick wooden puzzle includes seven easy-grasp, chunky tool shaped pieces, each with a full-color, matching picture underneath. Tool pieces can stand on edges for pretend play. Encourages eye-hand, fine motor and creative expression skills.<br>Age Rating: 2 yrs + [image_height] => 627 [image_url] => http://d1k0ppjronk6up.cloudfront.net/products/2006/3731.jpg [image_width] => 830 [in_stock] => 1 [in_warehouse] => [item_id] => 4738905 [item_sku] => 3731 [msrp] => 9.99 [prepay_price] => 4.99 [price] => 5.12 [product_group] => [product_id] => 4185409 [product_sku] => 3731 [quantity_avail] => 55 [stats] => stdClass Object ( [item_count] => 1 [item_count_in_warehouse] => 0 [max_cost] => 5.12 [max_qty] => 55 [min_cost] => 5.12 [min_qty] => 55 ) [supplier_name] => Melissa & Doug [thumb_height] => 0 [thumb_url] => http://d1k0ppjronk6up.cloudfront.net/products/2006/ [thumb_width] => 0 [title] => Tools Chunky Puzzles Tools Chunky Puzzles ) [1] => stdClass Object ( [brand] => Melissa & Doug [description] => Pound the eight colorful wooden pegs into the wooden bench, then flip it over to repeat the activity again and again! Four pairs of pegs for color matching and wooden hammer included.<br>Age Rating: 2 yrs + [image_height] => 785 [image_url] => http://d1k0ppjronk6up.cloudfront.net/products/2006/0496.jpg [image_width] => 900 [in_stock] => 1 [in_warehouse] => [item_id] => 4739191 [item_sku] => 496 [msrp] => 9.99 [prepay_price] => 4.99 [price] => 5.12 [product_group] => [product_id] => 4185695 [product_sku] => 496 [quantity_avail] => 55 [stats] => stdClass Object ( [item_count] => 1 [item_count_in_warehouse] => 0 [max_cost] => 5.12 [max_qty] => 55 [min_cost] => 5.12 [min_qty] => 55 ) [supplier_name] => Melissa & Doug [thumb_height] => 0 [thumb_url] => http://d1k0ppjronk6up.cloudfront.net/products/2006/ [thumb_width] => 0 [title] => Pound-a-Peg Pound-a-Peg ) [2] => stdClass Object ( [brand] => Firepower [description] => [image_height] => 200 [image_url] => http://d1k0ppjronk6up.cloudfront.net/products/21/FPW1423-0086.jpg [image_width] => 200 [in_stock] => 1 [in_warehouse] => [item_id] => 209396 [item_sku] => FPW1423-0086 [msrp] => 7.8 [prepay_price] => 4.99 [price] => 5.14 [product_group] => [product_id] => 148373 [product_sku] => FPW1423-0086 [quantity_avail] => 11 [stats] => stdClass Object ( [item_count] => 1 [item_count_in_warehouse] => 0 [max_cost] => 5.14 [max_qty] => 11 [min_cost] => 5.14 [min_qty] => 11 ) [supplier_name] => ISN Tools [thumb_height] => 0 [thumb_url] => http://d1k0ppjronk6up.cloudfront.net/products/21/FPW1423-0086.jpg [thumb_width] => 0 [title] => Chipping Hammer Cone and Chisel, Coil Handle Chipping Hammer Cone and Chisel, Coil Handle ) [3] => stdClass Object ( [brand] => [description] => <p>The perfect first tool box for any child! This wooden tool set includes a saw, 3 kinds of wrenches, pliers, 2 screwdrivers, 2 hammers, an awl, and two “L” squares. Let their imagination run wild with a very fist tool set. Although most parts have been rounded or smoothed out, children should always be supervised when playing with any kind of tool. Comes with toolbox to keep all 12 tools in and the box measures 10 x 12.25 x 1.375 inches.</p> [image_height] => 700 [image_url] => http://d1k0ppjronk6up.cloudfront.net/products/451/website_home_large_80-25391.jpg [image_width] => 700 [in_stock] => 1 [in_warehouse] => [item_id] => 4878771 [item_sku] => 80-25391 [msrp] => 24.99 [prepay_price] => 5 [price] => 5.15 [product_group] => [product_id] => 4223382 [product_sku] => 80-25391 [quantity_avail] => 1901 [stats] => stdClass Object ( [item_count] => 1 [item_count_in_warehouse] => 0 [max_cost] => 5.15 [max_qty] => 1901 [min_cost] => 5.15 [min_qty] => 1901 ) [supplier_name] => Trademark Global [thumb_height] => 0 [thumb_url] => http://d1k0ppjronk6up.cloudfront.net/products/451/ [thumb_width] => 0 [title] => Child’s First Tool Set – All Wood in Toolbox with Re-Mailer Child’s First Tool Set – All Wood in Toolbox with Re-Mailer ) ) [saved_searches] => Array ( [0] => stdClass Object ( [criteria] => O:8:"stdClass":8:{s:13:"display_start";i:0;s:13:"display_count";i:20;s:11:"search_term";s:4:"ipod";s:11:"sort_column";s:0:"";s:14:"sort_direction";s:0:"";s:15:"rollup_products";i:0;s:16:"hide_descendents";i:0;s:12:"search_terms";a:1:{i:0;s:4:"ipod";}} [date_created] => 2008-11-14 13:50:00 [friendly_criteria] => O:8:"stdClass":1:{s:6:"search";s:4:"ipod";} [name] => ipod [results_per_page] => 20 [saved_search_id] => 37300 [sort_order] => 1 [view_option] => gallery ) ) [search_term] => hammer [total_search_results] => 65 )
  •  

     

    getProductDetail

    Retreives detailed product information for the products, items, watchlists, or folder ids requested. Items located in subdirectories are not returned.

    Only retrieves data for one option at a time, preference given in this order: products - items - watchlists - folders.

    getProductDetail Request Parameters

    getProductDetail Response Parameters

     

     

    getProductDetail Example

    getProductDetail Request Example - XML

    <?php
    $URL = "https://sandbox.doba.com/api/5.0/xml_partner_api.php";
    $strRequest = "
    <?xml version="1.0"?>
    <dce>
      <request>
        <authentication>
          <username>username</username>
          <password>password</password>
        </authentication>
        <action>getProductDetail</action>
        <retailer_id>1223549</retailer_id>
        <page>1</page>
        <products>
          <product>129935</product>
          <product>137931</product>
          <product>385982</product>
        </products>
        <items/>
        <watchlists/>
        <folders/>
      </request>
    </dce>";
    $connection = curl_init();
    curl_setopt($connection, CURLOPT_URL, $URL );
    curl_setopt($connection, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($connection, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($connection, CURLOPT_POST, 1);
    curl_setopt($connection, CURLOPT_POSTFIELDS, $strRequest);
    curl_setopt($connection, CURLOPT_RETURNTRANSFER, 1);
    set_time_limit(108000);
    $strResponse = curl_exec($connection);
    if(curl_errno($connection)) {
    	print "Curl error: " . curl_error($connection);
    } else {
    	$info = curl_getinfo($connection);
    	print "HTTP Response Code = ".$info["http_code"]."\n";
    }
    curl_close($connection);
    
    print "URL = $URL\n\n";
    print "Method = getProductDetail\n\n";
    print "Request:\n=====================================================\n\n";
    print_r($strRequest);
    print "\n\nResponse:\n=====================================================\n\n";
    print_r($strResponse);
    ?>
    

    getProductDetail Response Example - XML

    <?xml version="1.0"?>
    <dce>
      <response>
        <outcome>success</outcome>
        <page>1</page>
        <products>
          <product>
            <product_id>33491</product_id>
            <status>discontinued</status>
            <title>Jerzees heavyweight tee 100% cotton tee</title>
            <description>5.6oz., 100% preshrunk cotton tee (birch is 99% cotton, light oxford is 90/10 cotton/poly).Ribbed collar.Coverseamed neck front.Double-needle stitched hemmed sleeves and bottom.Taped shoulder to shoulder.</description>
            <additional_details/>
            <product_sku>03204</product_sku>
            <brand>Jerzees Activewear</brand>
            <condition>new</condition>
            <freight/>
            <ship_width>0</ship_width>
            <ship_length>0</ship_length>
            <ship_height>0</ship_height>
            <ship_weight>0.63</ship_weight>
            <ship_cost>6.50</ship_cost>
            <items>
              <item>
                <item_id>540248</item_id>
                <supplier_id>5</supplier_id>
                <name>Color: BLACK SM</name>
                <item_sku>03204~00A3</item_sku>
                <map>0.00</map>
                <price>1.86</price>
                <prepay_price>1.81</prepay_price>
                <msrp>4.45</msrp>
                <qty_avail>0</qty_avail>
                <stock>discontinued</stock>
                <last_update>2009-01-19 08:43:50</last_update>
                <in_warehouse/>
                <custom_fields/>
              </item>
            </items>
            <images>
              <image>
                <url>http://d1k0ppjronk6up.cloudfront.net/products/5/363M.jpg</url>
                <thumb_url>http://d1k0ppjronk6up.cloudfront.net/products/5/363M.jpg?maxX=120&amp;amp;maxY=120</thumb_url>
                <image_height>250</image_height>
                <image_width>250</image_width>
                <default>1</default>
              </image>
            </images>
            <supplier_id>5</supplier_id>
            <supplier_name>Ruby</supplier_name>
            <supplier_processing>3-6 business days to ship out and receive tracking number.</supplier_processing>
            <supplier_alerts/>
            <upc/>
            <supplier_notes/>
            <supplier_drop_fee>0.00</supplier_drop_fee>
            <product_group>startup</product_group>
            <categories>
              <category>
                <id>33596</id>
                <name>Product Catalog</name>
                <selected/>
                <count/>
              </category>
              <category>
                <id>32330</id>
                <name>apparel and fashion</name>
                <selected/>
                <count/>
              </category>
              <category>
                <id>32778</id>
                <name>women's fitness apparel</name>
                <selected/>
                <count/>
              </category>
              <category>
                <id>32785</id>
                <name>active shirts</name>
                <selected/>
                <count/>
              </category>
              <category>
                <id>32792</id>
                <name>short sleeve shirts</name>
                <selected/>
                <count/>
              </category>
            </categories>
            <supplier>
              <id>5</id>
              <name>Ruby</name>
              <drop_ship_fee>0.00</drop_ship_fee>
              <visibility_group>startup</visibility_group>
              <date_active>2003-07-12</date_active>
              <allows_custom_branding>0</allows_custom_branding>
              <allows_direct_relationships>0</allows_direct_relationships>
              <product_alerts/>
              <classification/>
              <summary>Supplier Specification: DistributorPrimary Industry: Apparel and FashionServices and Products Offered: Americas largest wholesaler of imprint able apparel, and the largest distributor of sport shirts in the world. Their product selection includes recreation and casual clothing including: athletic, childrens, closeouts, fleece, head wear, ladies, t-shirts, short shirts, etc.Days to Ship Average:  0-3 Days:  65%4-7 Days:  35%8-10 Days:  0%over 10+ days:  0Overall Fulfillment %:  95%</summary>
              <alerts/>
              <avg_ship_time>1.23</avg_ship_time>
              <item_count>10787</item_count>
              <fulfillment_percentage>100</fulfillment_percentage>
              <rma_percentage>0</rma_percentage>
              <avg_item_lifespan>0</avg_item_lifespan>
              <num_in_stock>10161</num_in_stock>
              <num_out_of_stock/>
              <inventory_update_frequency>1.11</inventory_update_frequency>
              <avg_qty_in_stock>3607</avg_qty_in_stock>
              <notes/>
              <ship_price_strategy_class>Normal</ship_price_strategy_class>
            </supplier>
            <productStats/>
            <messages/>
          </product>
        </products>
      </response>
    </dce>

    getProductDetail Request Example - SOAP

    <?php
    $URL = "https://sandbox.doba.com/soap/5.0/wsdl/ApiPartnerSearch.wsdl";
    $client = new SoapClient($URL, array("trace" => 1));
    $objAuth = new stdClass();
    $objAuth->username = "username";
    $objAuth->password = "password";
    $objRequest = new stdClass();
    $objRequest->authentication = $objAuth;
    $objRequest->page=1;
    $objRequest->retailer_id="123456";
    $objRequest->products=Array( 1, 2, 3, 4, 5 );
    $objRequest->items=Array("114942");
    $objRequest->watchlists=Array();
    
    try { $Response = $client->getProductDetail($objRequest); }
    catch ( SOAPFault $e ) {$Response = ("Error ".$e->faultcode.": ".$e->faultstring); }
    
    print "URL = $URL\n\n";
    print "Method = getProductDetail\n\n";
    print "Request:\n=====================================================\n\n";
    print_r($objRequest);
    print "\n\nResponse:\n=====================================================\n\n";
    print_r($Response);
    ?>
    

    getProductDetail Response Example - SOAP

    stdClass Object
    (
        [page] => 1
        [products] => Array
            (
                [0] => stdClass Object
                (
                    [additional_details] => 
                    [brand] => MacAlly
                    [categories] => Array
                        (
                            [0] => stdClass Object
                                (
                                    [count] => 
                                    [id] => 33596
                                    [name] => Product Catalog
                                    [selected] => 
                                )
    
                            [1] => stdClass Object
                                (
                                    [count] => 
                                    [id] => 30480
                                    [name] => consumer electronics
                                    [selected] => 
                                )
    
                            [2] => stdClass Object
                                (
                                    [count] => 
                                    [id] => 120094
                                    [name] => ipod
                                    [selected] => 
                                )
    
                            [3] => stdClass Object
                                (
                                    [count] => 
                                    [id] => 128304
                                    [name] => ipod docks and speakers
                                    [selected] => 
                                )
    
                        )
    
                    [condition] => new
                    [description] => Tiny, portable, battery-operated stereo speakers.  Enjoy your iPod music without headsets or large wired external speakers.  On/Off switch to save battery life while not in use.  Works with iPod mini, iPod or any audio players with a 3.5mm jack.
                    [freight] => 
                    [images] => Array
                        (
                            [0] => stdClass Object
                                (
                                    [default] => 1
                                    [image_height] => 300
                                    [image_width] => 300
                                    [thumb_url] => http://d1k0ppjronk6up.cloudfront.net/products/4/PODWAVE.jpg?maxX=120&maxY=120
                                    [url] => http://d1k0ppjronk6up.cloudfront.net/products/4/PODWAVE.jpg
                                )
    
                        )
    
                    [items] => Array
                        (
                            [0] => stdClass Object
                                (
                                    [custom_fields] => Array
                                        (
                                        )
    
                                    [in_warehouse] => 
                                    [item_id] => 114942
                                    [item_sku] => PODWAVE
                                    [last_update] => 2009-02-10 13:05:11
                                    [map] => 0
                                    [msrp] => 19.99
                                    [name] => iPod Speakers IP-A111
                                    [prepay_price] => 13.29
                                    [price] => 13.68
                                    [qty_avail] => 21
                                    [stock] => in-stock
                                    [supplier_id] => 4
                                )
    
                        )
    
                    [messages] => 
                    [productStats] => 
                    [product_group] => free_member
                    [product_id] => 88028
                    [product_sku] => PODWAVE
                    [ship_cost] => 6.6
                    [ship_height] => 0
                    [ship_length] => 0
                    [ship_weight] => 0.2
                    [ship_width] => 0
                    [status] => available
                    [supplier] => stdClass Object
                        (
                            [alerts] => 
                            [allows_custom_branding] => 
                            [allows_direct_relationships] => 1
                            [avg_item_lifespan] => 15
                            [avg_qty_in_stock] => 139
                            [avg_ship_time] => 1.5
                            [classification] => Distributor
                            [date_active] => 2003-07-11
                            [drop_ship_fee] => 0
                            [fulfillment_percentage] => 90.31
                            [id] => 4
                            [inventory_update_frequency] => 1.07
                            [item_count] => 25823
                            [name] => Diamond
                            [notes] => This supplier does not ship to Hawaii or Alaska. For most home entertainment, video games, and opened software the supplier cannot accept the return, please check with customer service if you are having troubles with an RMA request for one of these.
                            [num_in_stock] => 17693
                            [num_out_of_stock] => 
                            [product_alerts] => 
                            [rma_percentage] => 2.42
                            [ship_price_strategy_class] => FedEx
                            [summary] => Supplier Specification: Distributor Primary Industry: Computer and LaptopServices and Products Offered: One of Americas oldest & largest computer, consumer electronics and small appliance distributors.  They offer a  great selection of products like computers, audio and video products, printers, hard drives, mp3 players, watches, projectors, organizers, digital security, and more.Days to Ship Average:  0-3 Days:  91%4-7 Days:  8%8-10 Days:  0%over 10+ days:  0Overall Fulfillment %:  98%
    
        *This supplier does not ship to HI & AK.*
                            [visibility_group] => free
                        )
    
                    [supplier_alerts] => 
                    [supplier_drop_fee] => 0.00
                    [supplier_id] => 4
                    [supplier_name] => Diamond
                    [supplier_notes] => This supplier does not ship to Hawaii or Alaska. For most home entertainment, video games, and opened software the supplier cannot accept the return, please check with customer service if you are having troubles with an RMA request for one of these.
                    [supplier_processing] => 2-5 business days to ship out and receive tracking number.
                    [title] => iPod Speakers IP-A111
                    [upc] => 701107486055
                )
    
            )
    
    )

     

     

    getProductInventory

    Retrieves current inventory information for the requested products.

    getProductInventory Request Parameters

    getProductInventory Response Parameters

     

     

    getProductInventory Example

    getProductInventory Request Example - XML

    <?php
    $URL = "https://sandbox.doba.com/api/5.0/xml_partner_api.php";
    $strRequest = "
    <dce>
    	<request>
    		
    <authentication>
    <username>username</username>
    <password>password</password>
    </authentication>
    <retailer_id>123456</retailer_id>
    
    
    		<action>getProductInventory</action>
    
    		<products>
    			<product>405</product>
    		</products>
    
    		<items>
    			<item>422</item>
    		</items>
    				
    		<watchlists>
    			<watchlist>123</watchlist>
    		</watchlists>
    		
    	</request>
    </dce>
    ";
    $connection = curl_init();
    curl_setopt($connection, CURLOPT_URL, $URL );
    curl_setopt($connection, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($connection, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($connection, CURLOPT_POST, 1);
    curl_setopt($connection, CURLOPT_POSTFIELDS, $strRequest);
    curl_setopt($connection, CURLOPT_RETURNTRANSFER, 1);
    set_time_limit(108000);
    $strResponse = curl_exec($connection);
    if(curl_errno($connection)) {
    	print "Curl error: " . curl_error($connection);
    } else {
    	$info = curl_getinfo($connection);
    	print "HTTP Response Code = ".$info["http_code"]."\n";
    }
    curl_close($connection);
    
    print "URL = $URL\n\n";
    print "Method = getProductInventory\n\n";
    print "Request:\n=====================================================\n\n";
    print_r($strRequest);
    print "\n\nResponse:\n=====================================================\n\n";
    print_r($strResponse);
    ?>
    

    getProductInventory Response Example - XML

    <?xml version="1.0"?>
    <dce>
      <response>
        <outcome>success</outcome>
        <items>
          <item>
            <item_id>405</item_id>
            <product_id>405</product_id>
            <stock>in-stock</stock>
            <qty_avail>1</qty_avail>
            <price>56.44</price>
            <prepay_price>56.44</prepay_price>
          </item>
          <item>
            <item_id>422</item_id>
            <product_id>422</product_id>
            <stock>discontinued</stock>
            <qty_avail>0</qty_avail>
            <price>15.93</price>
            <prepay_price>15.93</prepay_price>
          </item>
        </items>
      </response>
    </dce>
    

    getProductInventory Request Example - SOAP

    <?php
    $URL = "https://sandbox.doba.com/soap/5.0/wsdl/ApiPartnerSearch.wsdl";
    $client = new SoapClient($URL, array("trace" => 1));
    $objAuth = new stdClass();
    $objAuth->username = "username";
    $objAuth->password = "password";
    $objRequest = new stdClass();
    $objRequest->authentication = $objAuth;
    $objRequest->retailer_id="123456";
    $objRequest->products=Array();
    $objRequest->items=Array("880705","150073");
    $objRequest->watchlists=Array();
    
    try { $Response = $client->getProductInventory($objRequest); }
    catch ( SOAPFault $e ) {$Response = ("Error ".$e->faultcode.": ".$e->faultstring); }
    
    print "URL = $URL\n\n";
    print "Method = getProductInventory\n\n";
    print "Request:\n=====================================================\n\n";
    print_r($objRequest);
    print "\n\nResponse:\n=====================================================\n\n";
    print_r($Response);
    ?>
    

    getProductInventory Response Example - SOAP

    Array
    (
        [0] => stdClass Object
            (
                [item_id] => 150073
                [prepay_price] => 2.53
                [price] => 2.6
                [product_id] => 106044
                [qty_avail] => 0
                [stock] => discontinued
            )
    
        [1] => stdClass Object
            (
                [item_id] => 880705
                [prepay_price] => 101.5
                [price] => 104.5
                [product_id] => 591594
                [qty_avail] => 78
                [stock] => in-stock
            )
    
    )
    

     

     

    getWatchlists

    Retrieves a list of watch lists currently saved within a merchants account. Watch lists can be created and managed at http://www.doba.com

    If you don't have access to watch lists, but instead have access to Warehouse Folders, you should be using the getWarehouseFolders method.

    getWatchlists Request Parameters

    getWatchlists Response Parameters

     

     

    getWatchlists Example

    getWatchlists Request Example - XML

    <?php
    $URL = "https://sandbox.doba.com/api/5.0/xml_partner_api.php";
    $strRequest = "
    <dce>
    	<request>
    		
    <authentication>
    <username>username</username>
    <password>password</password>
    </authentication>
    <retailer_id>123456</retailer_id>
    
    
    		<action>getWatchlists</action>
    	</request>
    </dce>
    ";
    $connection = curl_init();
    curl_setopt($connection, CURLOPT_URL, $URL );
    curl_setopt($connection, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($connection, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($connection, CURLOPT_POST, 1);
    curl_setopt($connection, CURLOPT_POSTFIELDS, $strRequest);
    curl_setopt($connection, CURLOPT_RETURNTRANSFER, 1);
    set_time_limit(108000);
    $strResponse = curl_exec($connection);
    if(curl_errno($connection)) {
    	print "Curl error: " . curl_error($connection);
    } else {
    	$info = curl_getinfo($connection);
    	print "HTTP Response Code = ".$info["http_code"]."\n";
    }
    curl_close($connection);
    
    print "URL = $URL\n\n";
    print "Method = getWatchlists\n\n";
    print "Request:\n=====================================================\n\n";
    print_r($strRequest);
    print "\n\nResponse:\n=====================================================\n\n";
    print_r($strResponse);
    ?>
    

    getWatchlists Response Example - XML

    <?xml version="1.0"?>
    <dce>
      <response>
        <outcome>success</outcome>
        <watchlists>
          <watchlist>
            <watchlist_id>109587</watchlist_id>
            <retailer_id>1227885</retailer_id>
            <name>iPod Shuffle Dynamic</name>
            <default>1</default>
            <send_callback>1</send_callback>
            <item_count>143</item_count>
          </watchlist>
          <watchlist>
            <watchlist_id>177477</watchlist_id>
            <retailer_id>1227885</retailer_id>
            <name>2009-02-11 14:42:02</name>
            <default>0</default>
            <send_callback>0</send_callback>
            <item_count>2575</item_count>
            <type>dynamic</type>
          </watchlist>
        </watchlists>
      </response>
    </dce>
    

    getWatchlists Request Example - SOAP

    <?php
    $URL = "https://sandbox.doba.com/soap/5.0/wsdl/ApiPartnerSearch.wsdl";
    $client = new SoapClient($URL, array("trace" => 1));
    $objAuth = new stdClass();
    $objAuth->username = "username";
    $objAuth->password = "password";
    $objRequest = new stdClass();
    $objRequest->authentication = $objAuth;
    $objRequest->retailer_id="1223418";
    
    try { $Response = $client->getWatchlists($objRequest); }
    catch ( SOAPFault $e ) {$Response = ("Error ".$e->faultcode.": ".$e->faultstring); }
    
    print "URL = $URL\n\n";
    print "Method = getWatchlists\n\n";
    print "Request:\n=====================================================\n\n";
    print_r($objRequest);
    print "\n\nResponse:\n=====================================================\n\n";
    print_r($Response);
    ?>
    

    getWatchlists Response Example - SOAP

    Array
    (
        [0] => stdClass Object
            (
                [default] => 1
                [item_count] => 58
                [name] => ipod
                [retailer_id] => 1223418
                [send_callback] => 1
                [watchlist_id] => 94250
                [type] => dynamic
            )
    
        [1] => stdClass Object
            (
                [default] => 
                [item_count] => 99
                [name] => 2008-05-23 14:34:14
                [retailer_id] => 1223418
                [send_callback] => 1
                [watchlist_id] => 94251
                [type] => static
            )
    
        [2] => stdClass Object
            (
                [default] => 
                [item_count] => 2
                [name] => Golf
                [retailer_id] => 1223418
                [send_callback] => 1
                [watchlist_id] => 94252
                [type] => static
            )
    
    )
    

     

     

    getWatchlistProducts

    Retrieves basic product detail for the requested watch list. Only one watch list can be retrieved per request.

    getWatchlistProducts Request Parameters

    getWatchlistProducts Response Parameters

     

     

    getWatchlistProducts Example

    getWatchlistProducts Request Example - XML

    <?php
    $URL = "https://sandbox.doba.com/api/5.0/xml_partner_api.php";
    $strRequest = "
    <dce>
    	<request>
    		
    <authentication>
    <username>username</username>
    <password>password</password>
    </authentication>
    <retailer_id>123456</retailer_id>
    
    
    		<action>getWatchlistProducts</action>
    		<watchlist_id>123</watchlist_id>
    		<limit>10000</limit>
    		<offset>0</offset>
    		<changes_only>0</changes_only>
    	</request>
    </dce>
    ";
    $connection = curl_init();
    curl_setopt($connection, CURLOPT_URL, $URL );
    curl_setopt($connection, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($connection, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($connection, CURLOPT_POST, 1);
    curl_setopt($connection, CURLOPT_POSTFIELDS, $strRequest);
    curl_setopt($connection, CURLOPT_RETURNTRANSFER, 1);
    set_time_limit(108000);
    $strResponse = curl_exec($connection);
    if(curl_errno($connection)) {
    	print "Curl error: " . curl_error($connection);
    } else {
    	$info = curl_getinfo($connection);
    	print "HTTP Response Code = ".$info["http_code"]."\n";
    }
    curl_close($connection);
    
    print "URL = $URL\n\n";
    print "Method = getWatchlistProducts\n\n";
    print "Request:\n=====================================================\n\n";
    print_r($strRequest);
    print "\n\nResponse:\n=====================================================\n\n";
    print_r($strResponse);
    ?>
    

    getWatchlistProducts Response Example - XML

    <?xml version="1.0"?>
    <dce>
      <response>
        <outcome>success</outcome>
        <watchlist_id>83</watchlist_id>
        <result_total>3</result_total>
        <products>
          <product>
            <event/>
            <flags/>
            <item_id>605782</item_id>
            <stock>in-stock</stock>
            <qty_avail>13</qty_avail>
            <item_name>CORDLESS SPOTLIGHT</item_name>
            <product_id>368089</product_id>
            <price>8.02</price>
            <original_price/>
            <prepay_price>7.79</prepay_price>
            <custom_price/>
            <msrp>12.39</msrp>
            <last_update>2010-04-11 09:17:54</last_update>
          </product>
          <product>
            <event/>
            <flags/>
            <item_id>605845</item_id>
            <stock>in-stock</stock>
            <qty_avail>142</qty_avail>
            <item_name>38 VHF MARINE ANTENNA"</item_name>
            <product_id>368152</product_id>
            <price>13.89</price>
            <original_price/>
            <prepay_price>13.49</prepay_price>
            <custom_price/>
            <msrp>21.45</msrp>
            <last_update>2010-03-22 05:09:11</last_update>
          </product>
          <product>
            <event/>
            <flags/>
            <item_id>605846</item_id>
            <stock>in-stock</stock>
            <qty_avail>19</qty_avail>
            <item_name>5 FT VHF MARINE ANTENNA</item_name>
            <product_id>368153</product_id>
            <price>20.58</price>
            <original_price/>
            <prepay_price>19.98</prepay_price>
            <custom_price/>
            <msrp>31.77</msrp>
            <last_update>2010-03-22 06:50:08</last_update>
          </product>
        </products>
      </response>
    </dce>

    getWatchlistProducts Request Example - SOAP

    <?php
    $URL = "https://sandbox.doba.com/soap/5.0/wsdl/ApiPartnerSearch.wsdl";
    $client = new SoapClient($URL, array("trace" => 1));
    $objAuth = new stdClass();
    $objAuth->username = "username";
    $objAuth->password = "password";
    $objRequest = new stdClass();
    $objRequest->authentication = $objAuth;
    $objRequest->retailer_id="123456";
    $objRequest->offset="0";
    $objRequest->limit="10000";
    $objRequest->watchlist_id="654321";
    $objRequest->changes_only="0";
    
    try { $Response = $client->getWatchlistProducts($objRequest); }
    catch ( SOAPFault $e ) {$Response = ("Error ".$e->faultcode.": ".$e->faultstring); }
    
    print "URL = $URL\n\n";
    print "Method = getWatchlistProducts\n\n";
    print "Request:\n=====================================================\n\n";
    print_r($objRequest);
    print "\n\nResponse:\n=====================================================\n\n";
    print_r($Response);
    ?>
    

    getWatchlistProducts Response Example - SOAP

    stdClass Object
    (
        [products] => Array
            (
                [0] => stdClass Object
                    (
                        [event] => 
                        [price] => 19.28
                        [item_id] => 198047
                        [item_name] => PowerBlock/iPod AC Adapter
                        [last_update] => 2009-02-20 13:00:39
                        [msrp] => 29.99
                        [product_id] => 137931
                        [qty_avail] => 294
                        [stock] => in-stock
                    )
    
                [1] => stdClass Object
                    (
                        [event] => 
                        [price] => 86.26
                        [item_id] => 501219
                        [item_name] => Black Noise Isolating Earphones
                        [last_update] => 2009-02-11 09:45:17
                        [msrp] => 149.95
                        [product_id] => 299366
                        [qty_avail] => 17
                        [stock] => in-stock
                    )
    
                [2] => stdClass Object
                    (
                        [event] => 
                        [price] => 18.27
                        [item_id] => 206025
                        [item_name] => iPod Video 30GB Aluminum Case
                        [last_update] => 2009-02-11 09:45:16
                        [msrp] => 34.95
                        [product_id] => 145317
                        [qty_avail] => 0
                        [stock] => out-of-stock
                    )
    
            )
    
        [result_total] => 3
        [watchlist_id] => 125467
    )
    

     

     

    editWatchlist

    Adds or removes items from a specified watchlist.

    There can be only one API call per action, meaning that if a retailer wants to add and remove products from a watchlist, one API call should be issued for adding products and another API call should be issued for the removal.

    New watchlists can be created using this method. To create a new watchlist, simply include all of the item_id's you wish to add to the new watchlist, or the saved_search_id's, and provide a watchlist_name, but do not specify the watchlist_id or watchlist_ids. If watchlist_id or watchlist_ids is specified it will search the watchlists for the watchlist_id and attempt to update it. If none is provided, it will create a new watchlist.

    editWatchlist Request Parameters

    editWatchlist Response Parameters

     

     

    editWatchlist Request Example - XML

    <?php
    $URL = "https://sandbox.doba.com/api/5.0/xml_partner_api.php";
    $strRequest = "
    <dce>
    	<request>
    		
    <authentication>
    <username>password</username>
    <password>password</password>
    </authentication>
    <retailer_id>123456</retailer_id>
    
    
    		<action>editWatchlist</action>
    		
    		<watchlist_id>654</watchlist_id>
    		<item_ids>
    			<item>22043</item>
    		</item_ids>
    		
    	</request>
    </dce>
    ";
    $connection = curl_init();
    curl_setopt($connection, CURLOPT_URL, $URL );
    curl_setopt($connection, CURLOPT_SSL_VERIFYPEER, 0);
    curl_setopt($connection, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($connection, CURLOPT_POST, 1);
    curl_setopt($connection, CURLOPT_POSTFIELDS, $strRequest);
    curl_setopt($connection, CURLOPT_RETURNTRANSFER, 1);
    set_time_limit(108000);
    $strResponse = curl_exec($connection);
    if(curl_errno($connection)) {
    	print "Curl error: " . curl_error($connection);
    } else {
    	$info = curl_getinfo($connection);
    	print "HTTP Response Code = ".$info["http_code"]."\n";
    }
    curl_close($connection);
    
    print "URL = $URL\n\n";
    print "Method = editWatchlist\n\n";
    print "Request:\n=====================================================\n\n";
    print_r($strRequest);
    print "\n\nResponse:\n=====================================================\n\n";
    print_r($strResponse);
    ?>
    

    editWatchlist Response Example - XML

    <?xml version="1.0"?>
    <dce>
      <response>
        <outcome>success</outcome>
        <watchlist_id>12345</watchlist_id>
        <num_added>1</num_added>
        <num_removed/>
      </response>
    </dce>
    

    editWatchlist Request Example - SOAP

    <?php
    $URL = "https://sandbox.doba.com/soap/5.0/wsdl/ApiPartnerSearch.wsdl";
    $client = new SoapClient($URL, array("trace" => 1));
    $objAuth = new stdClass();
    $objAuth->username = "username";
    $objAuth->password = "password";
    $objRequest = new stdClass();
    $objRequest->authentication = $objAuth;
    $objRequest->retailer_id="1223418";
    $objRequest->item_ids=Array("22044");
    
    try { $Response = $client->editWatchlist($objRequest); }
    catch ( SOAPFault $e ) {$Response = ("Error ".$e->faultcode.": ".$e->faultstring); }
    
    print "URL = $URL\n\n";
    print "Method = editWatchlist\n\n";
    print "Request:\n=====================================================\n\n";
    print_r($objRequest);
    print "\n\nResponse:\n=====================================================\n\n";
    print_r($Response);
    ?>
    

    editWatchlist Response Example - SOAP

    stdClass Object
    (
        [num_added] => 1
        [num_removed] => 0
        [watchlist_id] => 12345
    )