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/20110301/xml_partner_api.php";
$strRequest = "
<dce>
  <request>
    <authentication>
      <username>username</username>
      <password>password</password>
    </authentication>
    <retailer_id>123456</retailer_id>
    <action>getSuppliers</action>
    <supplier_ids>
      <supplier_id>2646</supplier_id>
      <supplier_id>1535</supplier_id>
      <supplier_id>2693</supplier_id>
    </supplier_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 = 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>
        <id>1535</id>
        <name>Alexander</name>
        <is_pro/>
        <group>advanced</group>
        <categories/>
        <info>
          <alerts/>
          <allows_custom_branding>0</allows_custom_branding>
          <allows_direct_relationships>0</allows_direct_relationships>
          <avg_item_lifespan>0</avg_item_lifespan>
          <avg_processing_time>2-3</avg_processing_time>
          <avg_product_discount/>
          <avg_qty_in_stock>57</avg_qty_in_stock>
          <avg_ship_time>7.02</avg_ship_time>
          <classification/>
          <damage_policy/>
          <date_active>2008-07-01</date_active>
          <days_allowed_to_return>20</days_allowed_to_return>
          <days_to_receive_refund>15</days_to_receive_refund>
          <description/>
          <drop_ship_fee>4.00</drop_ship_fee>
          <fulfillment_percentage>100</fulfillment_percentage>
          <inventory_info/>
          <inventory_update_frequency>1.07</inventory_update_frequency>
          <item_count>723</item_count>
          <meta_description/>
          <meta_keywords/>
          <notes/>
          <num_in_stock>574</num_in_stock>
          <num_out_of_stock>0</num_out_of_stock>
          <product_alerts/>
          <return_policy>In most cases, you can return items within 20 days from the ship date.
To qualify, simply initiate the return within 20 days from the ship date and ensure that the item is in its original condition (including: packaging, manuals, warranties, accessories, security seals, etc., and shrink wrap where applicable). The supplier must receive your item back within 30 days of when it was originally shipped it to you. Please allow 14 days from the time we receive your item to process your return.
For your protection, we suggest all returns be sent back by a traceable carrier. The customer must pay all costs related to return shipping. After receiving and inspecting the returned merchandise, we will reimburse you for the purchase price of the item, less the original shipping fee and less a restocking fee of 15%. Generally, product exchange is not an option. For exchanges, simply place a duplicate order once the original is returned.
We cannot accept the return of certain items, including: swimming suits, undergarments, body jewelry, software, factory-sealed sports collectible sets, cigars, wines, and perishable products (food items, chocolates, plants &amp; flowers). Other select items, as noted on the product detail page.
RMA INSTRUCTIONS
&acirc;€&cent;	Through the order management tab, request a Return Merchandise Authorization Number (RMA). Do not ship items back prior to receiving an RMA number.
&acirc;€&cent;	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.
&acirc;€&cent;	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 number or some method of delivery confirmation.
&acirc;€&cent;	Freight on merchandise being returned is to be prepaid.
&acirc;€&cent;	Only ship returns to the return address provided in your RMA confirmation email.
&acirc;€&cent;	Note: Packages must have RMA number written visibly on shipping box with a brief description of the product defect inside. All items must be returned in the original packaging.</return_policy>
          <rma_instructions>In most cases, you can return items within 20 days from the ship date.
To qualify, simply initiate the return within 20 days from the ship date and ensure that the item is in its original condition (including: packaging, manuals, warranties, accessories, security seals, etc., and shrink wrap where applicable). The supplier must receive your item back within 30 days of when it was originally shipped it to you. Please allow 14 days from the time we receive your item to process your return.
For your protection, we suggest all returns be sent back by a traceable carrier. The customer must pay all costs related to return shipping. After receiving and inspecting the returned merchandise, we will reimburse you for the purchase price of the item, less the original shipping fee and less a restocking fee of 15%. Generally, product exchange is not an option. For exchanges, simply place a duplicate order once the original is returned.
We cannot accept the return of certain items, including: swimming suits, undergarments, body jewelry, software, factory-sealed sports collectible sets, cigars, wines, and perishable products (food items, chocolates, plants &amp; flowers). Other select items, as noted on the product detail page.
RMA INSTRUCTIONS
	Through the order management tab, request a Return Merchandise Authorization Number (RMA). Do not ship items back prior to receiving an RMA number.
	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.
	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 number or some method of delivery confirmation.
	Freight on merchandise being returned is to be prepaid.
	Only ship returns to the return address provided in your RMA confirmation email.
	Note: Packages must have RMA number written visibly on shipping box with a brief description of the product defect inside. All items must be returned in the original packaging.</rma_instructions>
          <rma_percentage>0</rma_percentage>
          <ship_price_strategy_class>FedEx</ship_price_strategy_class>
          <shipping_carriers>UPS</shipping_carriers>
          <shortage_policy/>
          <special_conditions/>
          <summary/>
          <visibility_group>advanced</visibility_group>
        </info>
        <inventory_stats/>
        <is_active>1</is_active>
      </supplier>
      <supplier>
        <id>2646</id>
        <name>Adrias</name>
        <is_pro/>
        <group>advanced</group>
        <categories/>
        <info>
          <alerts/>
          <allows_custom_branding>0</allows_custom_branding>
          <allows_direct_relationships>0</allows_direct_relationships>
          <avg_item_lifespan/>
          <avg_processing_time>0-0</avg_processing_time>
          <avg_product_discount/>
          <avg_qty_in_stock/>
          <avg_ship_time/>
          <classification/>
          <damage_policy/>
          <date_active>2009-07-22</date_active>
          <days_allowed_to_return>90</days_allowed_to_return>
          <days_to_receive_refund>15</days_to_receive_refund>
          <description/>
          <drop_ship_fee>0.00</drop_ship_fee>
          <fulfillment_percentage/>
          <inventory_info/>
          <inventory_update_frequency/>
          <item_count/>
          <meta_description/>
          <meta_keywords/>
          <notes/>
          <num_in_stock/>
          <num_out_of_stock/>
          <product_alerts/>
          <return_policy/>
          <rma_instructions/>
          <rma_percentage/>
          <ship_price_strategy_class>FedEx</ship_price_strategy_class>
          <shipping_carriers>UPS</shipping_carriers>
          <shortage_policy/>
          <special_conditions/>
          <summary/>
          <visibility_group>advanced</visibility_group>
        </info>
        <inventory_stats/>
        <is_active>1</is_active>
      </supplier>
      <supplier>
        <id>2693</id>
        <name>Inesite</name>
        <is_pro/>
        <group>advanced</group>
        <categories/>
        <info>
          <alerts/>
          <allows_custom_branding>0</allows_custom_branding>
          <allows_direct_relationships>0</allows_direct_relationships>
          <avg_item_lifespan/>
          <avg_processing_time>2-3</avg_processing_time>
          <avg_product_discount/>
          <avg_qty_in_stock>80</avg_qty_in_stock>
          <avg_ship_time/>
          <classification/>
          <damage_policy/>
          <date_active>2009-08-19</date_active>
          <days_allowed_to_return>15</days_allowed_to_return>
          <days_to_receive_refund>15</days_to_receive_refund>
          <description>Health and Sports Supplement Distributor</description>
          <drop_ship_fee>1.50</drop_ship_fee>
          <fulfillment_percentage/>
          <inventory_info/>
          <inventory_update_frequency/>
          <item_count/>
          <meta_description/>
          <meta_keywords/>
          <notes/>
          <num_in_stock/>
          <num_out_of_stock/>
          <product_alerts/>
          <return_policy>A 10% restocking fee plus freight will be charged on all approved RMAs.</return_policy>
          <rma_instructions/>
          <rma_percentage/>
          <ship_price_strategy_class>FedEx</ship_price_strategy_class>
          <shipping_carriers>UPS</shipping_carriers>
          <shortage_policy/>
          <special_conditions/>
          <summary/>
          <visibility_group>advanced</visibility_group>
        </info>
        <inventory_stats/>
        <is_active>1</is_active>
      </supplier>
    </suppliers>
  </response>
</dce>

getSuppliers Request Example - SOAP

<?php
$URL = "https://sandbox.doba.com/soap/20110301/wsdl/ApiPartnerSearch.wsdl";
$client = new SoapClient($URL, array("trace" => 1));

$objAuth = new stdClass();
$objAuth->username = "username";
$objAuth->password = "password";
$objRequest->authentication = $objAuth;
$objRequest->retailer_id = "123456";
$objRequest->supplier_ids=array("2646", "1535", "2693");

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
                (
                )

            [group] => advanced
            [id] => 1535
            [info] => stdClass Object
                (
                    [alerts] => 
                    [allows_custom_branding] => 
                    [allows_direct_relationships] => 
                    [avg_item_lifespan] => 0
                    [avg_processing_time] => 2-3
                    [avg_product_discount] => 
                    [avg_qty_in_stock] => 57
                    [avg_ship_time] => 7.02
                    [classification] => 
                    [damage_policy] => 
                    [date_active] => 2008-07-01
                    [days_allowed_to_return] => 20
                    [days_to_receive_refund] => 15
                    [description] => 
                    [drop_ship_fee] => 4
                    [fulfillment_percentage] => 100
                    [inventory_info] => 
                    [inventory_update_frequency] => 1.07
                    [item_count] => 723
                    [meta_description] => 
                    [meta_keywords] => 
                    [notes] => 
                    [num_in_stock] => 574
                    [num_out_of_stock] => 0
                    [product_alerts] => 
                    [return_policy] => In most cases, you can return items within 20 days from the ship date.
To qualify, simply initiate the return within 20 days from the ship date and ensure that the item is in its original condition (including: packaging, manuals, warranties, accessories, security seals, etc., and shrink wrap where applicable). The supplier must receive your item back within 30 days of when it was originally shipped it to you. Please allow 14 days from the time we receive your item to process your return.
For your protection, we suggest all returns be sent back by a traceable carrier. The customer must pay all costs related to return shipping. After receiving and inspecting the returned merchandise, we will reimburse you for the purchase price of the item, less the original shipping fee and less a restocking fee of 15%. Generally, product exchange is not an option. For exchanges, simply place a duplicate order once the original is returned.
We cannot accept the return of certain items, including: swimming suits, undergarments, body jewelry, software, factory-sealed sports collectible sets, cigars, wines, and perishable products (food items, chocolates, plants & flowers). Other select items, as noted on the product detail page.
RMA INSTRUCTIONS
•	Through the order management tab, request a Return Merchandise Authorization Number (RMA). Do not ship items back prior to receiving an RMA number.
•	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.
•	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 number or some method of delivery confirmation.
•	Freight on merchandise being returned is to be prepaid.
•	Only ship returns to the return address provided in your RMA confirmation email.
•	Note: Packages must have RMA number written visibly on shipping box with a brief description of the product defect inside. All items must be returned in the original packaging.
                    [rma_instructions] => In most cases, you can return items within 20 days from the ship date.
To qualify, simply initiate the return within 20 days from the ship date and ensure that the item is in its original condition (including: packaging, manuals, warranties, accessories, security seals, etc., and shrink wrap where applicable). The supplier must receive your item back within 30 days of when it was originally shipped it to you. Please allow 14 days from the time we receive your item to process your return.
For your protection, we suggest all returns be sent back by a traceable carrier. The customer must pay all costs related to return shipping. After receiving and inspecting the returned merchandise, we will reimburse you for the purchase price of the item, less the original shipping fee and less a restocking fee of 15%. Generally, product exchange is not an option. For exchanges, simply place a duplicate order once the original is returned.
We cannot accept the return of certain items, including: swimming suits, undergarments, body jewelry, software, factory-sealed sports collectible sets, cigars, wines, and perishable products (food items, chocolates, plants & flowers). Other select items, as noted on the product detail page.
RMA INSTRUCTIONS
	Through the order management tab, request a Return Merchandise Authorization Number (RMA). Do not ship items back prior to receiving an RMA number.
	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.
	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 number or some method of delivery confirmation.
	Freight on merchandise being returned is to be prepaid.
	Only ship returns to the return address provided in your RMA confirmation email.
	Note: Packages must have RMA number written visibly on shipping box with a brief description of the product defect inside. All items must be returned in the original packaging.
                    [rma_percentage] => 0
                    [ship_price_strategy_class] => FedEx
                    [shipping_carriers] => UPS
                    [shortage_policy] => 
                    [special_conditions] => 
                    [summary] => 
                    [visibility_group] => advanced
                )

            [is_active] => 1
            [is_pro] => 
            [name] => Alexander
        )

    [1] => stdClass Object
        (
            [categories] => Array
                (
                )

            [group] => advanced
            [id] => 2646
            [info] => stdClass Object
                (
                    [alerts] => 
                    [allows_custom_branding] => 
                    [allows_direct_relationships] => 
                    [avg_item_lifespan] => 
                    [avg_processing_time] => 0-0
                    [avg_product_discount] => 
                    [avg_qty_in_stock] => 0
                    [avg_ship_time] => 
                    [classification] => 
                    [damage_policy] => 
                    [date_active] => 2009-07-22
                    [days_allowed_to_return] => 90
                    [days_to_receive_refund] => 15
                    [description] => 
                    [drop_ship_fee] => 0
                    [fulfillment_percentage] => 
                    [inventory_info] => 
                    [inventory_update_frequency] => 
                    [item_count] => 
                    [meta_description] => 
                    [meta_keywords] => 
                    [notes] => 
                    [num_in_stock] => 
                    [num_out_of_stock] => 
                    [product_alerts] => 
                    [return_policy] => 
                    [rma_instructions] => 
                    [rma_percentage] => 
                    [ship_price_strategy_class] => FedEx
                    [shipping_carriers] => UPS
                    [shortage_policy] => 
                    [special_conditions] => 
                    [summary] => 
                    [visibility_group] => advanced
                )

            [is_active] => 1
            [is_pro] => 
            [name] => Adrias
        )

    [2] => stdClass Object
        (
            [categories] => Array
                (
                )

            [group] => advanced
            [id] => 2693
            [info] => stdClass Object
                (
                    [alerts] => 
                    [allows_custom_branding] => 
                    [allows_direct_relationships] => 
                    [avg_item_lifespan] => 
                    [avg_processing_time] => 2-3
                    [avg_product_discount] => 
                    [avg_qty_in_stock] => 80
                    [avg_ship_time] => 
                    [classification] => 
                    [damage_policy] => 
                    [date_active] => 2009-08-19
                    [days_allowed_to_return] => 15
                    [days_to_receive_refund] => 15
                    [description] => Health and Sports Supplement Distributor
                    [drop_ship_fee] => 1.5
                    [fulfillment_percentage] => 
                    [inventory_info] => 
                    [inventory_update_frequency] => 
                    [item_count] => 
                    [meta_description] => 
                    [meta_keywords] => 
                    [notes] => 
                    [num_in_stock] => 
                    [num_out_of_stock] => 
                    [product_alerts] => 
                    [return_policy] => A 10% restocking fee plus freight will be charged on all approved RMAs.
                    [rma_instructions] => 
                    [rma_percentage] => 
                    [ship_price_strategy_class] => FedEx
                    [shipping_carriers] => UPS
                    [shortage_policy] => 
                    [special_conditions] => 
                    [summary] => 
                    [visibility_group] => advanced
                )

            [is_active] => 1
            [is_pro] => 
            [name] => Inesite
        )

)

 

 

searchCatalog

Searches and retrieves product information based on custom criteria.

The searchCatalog method can be used to build a replica of the Doba category structure. 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 searchCatalog.

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.

searchCatalog Request Parameters

searchCatalog Response Parameters

 

 

searchCatalog Example

searchCatalog Request Example - XML

<?php
$URL = "https://sandbox.doba.com/api/20110301/xml_partner_api.php";
$strRequest = "
<dce>
  <request>
    <authentication>
      <username>username</username>
      <password>password</password>
    </authentication>
    <retailer_id>123456</retailer_id>
    <action>searchCatalog</action>
    <search_term>ipod</search_term>
    <display_count>3</display_count>
    <display_start>9</display_start>
    <filter>
      <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 = searchCatalog\n\n";
print "Request:\n=====================================================\n\n";
print_r($strRequest);
print "\n\nResponse:\n=====================================================\n\n";
print_r($strResponse);
?>

searchCatalog Response Example - XML

<?xml version="1.0"?>
<dce>
  <response>
    <outcome>success</outcome>
    <saved_searches>
      <saved_search>
        <criteria>O:8:"stdClass":8:{s:13:"display_start";i:0;s:13:"display_count";i:24;s:6:"filter";a:4:{i:0;O:8:"stdClass":2:{s:4:"name";s:5:"f_cat";s:3:"ids";a:1:{i:0;s:4:"8336";}}i:1;O:8:"stdClass":2:{s:4:"name";s:7:"f_stock";s:3:"ids";a:1:{i:0;s:8:"in-stock";}}i:2;O:8:"stdClass":2:{s:4:"name";s:10:"f_hasImage";s:3:"ids";a:1:{i:0;i:1;}}i:3;O:8:"stdClass":2:{s:4:"name";s:13:"f_refurbished";s:3:"ids";a:2:{i:0;i:0;i:1;i:1;}}}s:11:"search_term";s:6:"laptop";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:"laptop";}}</criteria>
        <friendly_criteria>O:8:"stdClass":5:{s:6:"filter";a:1:{s:5:"f_cat";O:8:"stdClass":2:{s:4:"name";s:10:"Categories";s:5:"value";a:1:{i:0;s:22:"Electronics &amp; computer";}}}s:6:"search";s:6:"laptop";s:13:"grouped_items";s:3:"yes";s:4:"sort";s:11:"Default asc";s:7:"include";s:11:"refurbished";}</friendly_criteria>
        <name>Electronics &amp; computer, Refurbished items, Lap</name>
        <saved_search_id>13413</saved_search_id>
        <results_per_page>24</results_per_page>
        <view_option>gallery</view_option>
        <sort_order>1</sort_order>
        <date_created>2011-04-29 14:53:58</date_created>
      </saved_search>
    </saved_searches>
    <search_term>ipod</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>1</count>
            <selected/>
          </value>
          <value>
            <displayValue>Electronics &amp; computer</displayValue>
            <id>8336</id>
            <count>255</count>
            <selected/>
          </value>
          <value>
            <displayValue>Games, movies &amp; music</displayValue>
            <id>9343</id>
            <count>1</count>
            <selected/>
          </value>
          <value>
            <displayValue>Home, garden &amp; living</displayValue>
            <id>9821</id>
            <count>6</count>
            <selected/>
          </value>
          <value>
            <displayValue>Outdoor &amp; sports</displayValue>
            <id>10216</id>
            <count>3</count>
            <selected/>
          </value>
        </values>
      </facet>
      <facet>
        <name>f_supplier_id</name>
        <display_name>Suppliers</display_name>
        <values>
          <value>
            <displayValue>Diamond</displayValue>
            <id>4</id>
            <count>159</count>
            <selected/>
          </value>
          <value>
            <displayValue>Mansfield</displayValue>
            <id>109</id>
            <count>78</count>
            <selected/>
          </value>
          <value>
            <displayValue>Alpha</displayValue>
            <id>1</id>
            <count>29</count>
            <selected/>
          </value>
        </values>
      </facet>
      <facet>
        <name>f_brand</name>
        <display_name>Brands</display_name>
        <values>
          <value>
            <displayValue>Ihome</displayValue>
            <id>ihome</id>
            <count>14</count>
            <selected/>
          </value>
          <value>
            <displayValue>Belkin</displayValue>
            <id>belkin</id>
            <count>12</count>
            <selected/>
          </value>
          <value>
            <displayValue>Griffin Technology</displayValue>
            <id>griffin technology</id>
            <count>11</count>
            <selected/>
          </value>
          <value>
            <displayValue>Xo Vision</displayValue>
            <id>xo vision</id>
            <count>11</count>
            <selected/>
          </value>
          <value>
            <displayValue>Contour Design</displayValue>
            <id>contour design</id>
            <count>10</count>
            <selected/>
          </value>
          <value>
            <displayValue>Macally</displayValue>
            <id>macally</id>
            <count>10</count>
            <selected/>
          </value>
          <value>
            <displayValue>Sony Audio/video</displayValue>
            <id>sony audio/video</id>
            <count>9</count>
            <selected/>
          </value>
          <value>
            <displayValue>Iluv</displayValue>
            <id>iluv</id>
            <count>8</count>
            <selected/>
          </value>
          <value>
            <displayValue>Speakal</displayValue>
            <id>speakal</id>
            <count>8</count>
            <selected/>
          </value>
          <value>
            <displayValue>Coby Electronics</displayValue>
            <id>coby electronics</id>
            <count>7</count>
            <selected/>
          </value>
          <value>
            <displayValue>I.sound</displayValue>
            <id>i.sound</id>
            <count>6</count>
            <selected/>
          </value>
          <value>
            <displayValue>Iessentials</displayValue>
            <id>iessentials</id>
            <count>6</count>
            <selected/>
          </value>
          <value>
            <displayValue>Visual Land</displayValue>
            <id>visual land</id>
            <count>6</count>
            <selected/>
          </value>
          <value>
            <displayValue>Retrak / Emerge</displayValue>
            <id>retrak / emerge</id>
            <count>5</count>
            <selected/>
          </value>
          <value>
            <displayValue>Boss</displayValue>
            <id>boss</id>
            <count>4</count>
            <selected/>
          </value>
          <value>
            <displayValue>Griffin</displayValue>
            <id>griffin</id>
            <count>4</count>
            <selected/>
          </value>
          <value>
            <displayValue>Hercules</displayValue>
            <id>hercules</id>
            <count>4</count>
            <selected/>
          </value>
          <value>
            <displayValue>Marware</displayValue>
            <id>marware</id>
            <count>4</count>
            <selected/>
          </value>
          <value>
            <displayValue>Samsonic</displayValue>
            <id>samsonic</id>
            <count>4</count>
            <selected/>
          </value>
          <value>
            <displayValue>Sandisk</displayValue>
            <id>sandisk</id>
            <count>4</count>
            <selected/>
          </value>
        </values>
      </facet>
      <facet>
        <name>f_hasImage</name>
        <display_name>Has Image</display_name>
        <values>
          <value>
            <displayValue>True</displayValue>
            <id/>
            <count>266</count>
            <selected/>
          </value>
          <value>
            <displayValue>True</displayValue>
            <id/>
            <count/>
            <selected/>
          </value>
        </values>
      </facet>
      <facet>
        <name>f_refurbished</name>
        <display_name>Refurbished</display_name>
        <values>
          <value>
            <displayValue>True</displayValue>
            <id/>
            <count>266</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>
              <false>266</false>
            </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>
              <false>266</false>
              <true/>
            </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>
              <false>266</false>
              <true/>
            </count>
            <selected/>
          </value>
        </values>
      </facet>
      <facet>
        <name>f_attribute_l0</name>
        <display_name>Brands</display_name>
        <values/>
      </facet>
    </facets>
    <total_search_results>266</total_search_results>
    <has_next_page>1</has_next_page>
    <display_start>9</display_start>
    <display_count>3</display_count>
    <products>
      <product>
        <item_id>5595637</item_id>
        <item_sku>T48360</item_sku>
        <supplier_name>Alpha</supplier_name>
        <drop_ship_fee>1.50</drop_ship_fee>
        <quantity_avail>2</quantity_avail>
        <in_warehouse/>
        <last_update>2011-05-18 15:28:18</last_update>
        <stats>
          <item_count_in_specified_list>0</item_count_in_specified_list>
          <min_cost>13.11</min_cost>
          <max_cost>13.11</max_cost>
          <min_qty>2</min_qty>
          <max_qty>2</max_qty>
          <item_count>1</item_count>
          <item_count_in_warehouse>0</item_count_in_warehouse>
        </stats>
        <flags/>
        <product_id>4916747</product_id>
        <title>Black Fitted Koskin Case For iPod Black Fitted Koskin Case For iPod&amp;reg; 80GB classic</title>
        <price>13.11</price>
        <original_price/>
        <prepay_price>12.74</prepay_price>
        <msrp>29.95</msrp>
        <description>CASE LOGIC FITTED IPOD80GB CLASSIC BLK 80GB CLASSIC BLK&lt;BR&gt;&lt;BR&gt;&lt;li&gt;Flip open design allows total access to all ports and controls&lt;li&gt;Plastic screen protector and soft suede-like interior &lt;li&gt;Invisible magnetic closure for a sleek appearance&lt;li&gt;Internal dims: 2 7/16\" W x 4 1/8\" H x 13/32\" D  &lt;li&gt;Overall dims: 2 1/2\" W x 4 3/4\" H x 3/4\" D</description>
        <image_url>http://d1k0ppjronk6up.cloudfront.net/products/1/icc-1a_black.jpg</image_url>
        <image_height>600</image_height>
        <image_width>600</image_width>
        <thumb_url>http://d1k0ppjronk6up.cloudfront.net/products/1/icc-1a_black.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>T48360</product_sku>
        <brand>Case Logic</brand>
        <product_group>free_member</product_group>
      </product>
      <product>
        <item_id>297436</item_id>
        <item_sku>FMCUPB</item_sku>
        <supplier_name>Diamond</supplier_name>
        <drop_ship_fee>0.00</drop_ship_fee>
        <quantity_avail>51</quantity_avail>
        <in_warehouse/>
        <last_update>2010-03-22 04:33:45</last_update>
        <stats>
          <item_count_in_specified_list>0</item_count_in_specified_list>
          <min_cost>39.81</min_cost>
          <max_cost>39.81</max_cost>
          <min_qty>51</min_qty>
          <max_qty>51</max_qty>
          <item_count>1</item_count>
          <item_count_in_warehouse>0</item_count_in_warehouse>
        </stats>
        <flags/>
        <product_id>184438</product_id>
        <title>Black iPod Docking Station</title>
        <price>39.81</price>
        <original_price/>
        <prepay_price>38.67</prepay_price>
        <msrp>62.20</msrp>
        <description>Automobile Full Channel FM Transmitter, Cup Holder and Charger for iPod devices-Black &lt;br&gt;&lt;br&gt;&lt;b&gt;&lt;/b&gt;</description>
        <image_url>http://d1k0ppjronk6up.cloudfront.net/products/4/FMCUPB.jpg</image_url>
        <image_height>250</image_height>
        <image_width>250</image_width>
        <thumb_url>http://d1k0ppjronk6up.cloudfront.net/products/4/FMCUPB.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>FMCUPB</product_sku>
        <brand>MacAlly</brand>
        <product_group>free_member</product_group>
      </product>
      <product>
        <item_id>5568823</item_id>
        <item_sku>SISIRMC</item_sku>
        <supplier_name>Mansfield</supplier_name>
        <drop_ship_fee>2.00</drop_ship_fee>
        <quantity_avail>7</quantity_avail>
        <in_warehouse/>
        <last_update>2010-03-22 04:59:52</last_update>
        <stats>
          <item_count_in_specified_list>0</item_count_in_specified_list>
          <min_cost>22.46</min_cost>
          <max_cost>22.46</max_cost>
          <min_qty>7</min_qty>
          <max_qty>7</max_qty>
          <item_count>1</item_count>
          <item_count_in_warehouse>0</item_count_in_warehouse>
        </stats>
        <flags/>
        <product_id>4895525</product_id>
        <title>BLACK TAPSTICK CASE FOR</title>
        <price>22.46</price>
        <original_price/>
        <prepay_price>21.81</prepay_price>
        <msrp>34.17</msrp>
        <description>ADDS CONTROL &amp; PROTECTS IPOD SHUFFLE&amp;reg; 3G; CONTROLS PLAY\, PAUSE\, ADJUSTS VOLUME\, SKIPS TRACKS\, NAVIGATES PLAYLISTS &amp; ACTIVATES THE VOICEOVER FEATURE ON IPOD SHUFFLE&amp;reg; 3G ; FOR USE WITH ANY STANDARD HEADPHONES OR EARBUDS; INCLUDES 3-FT AUDIO CABLE FOR CONNECTING TO MOST STEREO SYSTEMS ; HIGH IMPACT POLYCARBONATE MATERIAL PROTECTS AGAINST KNOCKS &amp; NICKS ; BLACK&lt;br&gt;&lt;br&gt;</description>
        <image_url>http://d1k0ppjronk6up.cloudfront.net/products/109/600x600_SISIRMC.jpg</image_url>
        <image_height>600</image_height>
        <image_width>600</image_width>
        <thumb_url>http://d1k0ppjronk6up.cloudfront.net/products/109/600x600_SISIRMC.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>SISIRMC</product_sku>
        <brand>SCOSCHE</brand>
        <product_group>free_member</product_group>
      </product>
    </products>
    <exact_match/>
    <specials/>
    <top_sellers/>
    <suggestion/>
  </response>
</dce>

searchCatalog Request Example - SOAP

<?php
$URL = "https://sandbox.doba.com/soap/20110301/wsdl/ApiPartnerSearch.wsdl";
$client = new SoapClient($URL, array("trace" => 1));

$objAuth = new stdClass();
$objAuth->username = "username";
$objAuth->password = "password";
$objRequest->authentication = $objAuth;
$objRequest->retailer_id = "123456";
$objRequest->search_term = "ipod";
$objRequest->display_count = "3";
$objRequest->display_start = "9";

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

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

searchCatalog Response Example - SOAP

stdClass Object
(
    [display_count] => 3
    [display_start] => 9
    [exact_match] => Array
        (
        )

    [facets] => Array
        (
            [0] => stdClass Object
                (
                    [display_name] => Categories
                    [name] => f_cat
                    [values] => Array
                        (
                            [0] => stdClass Object
                                (
                                    [count] => 1
                                    [displayValue] => Apparel, shoes & jewelry
                                    [id] => 7913
                                    [selected] => 
                                )

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

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

                            [3] => stdClass Object
                                (
                                    [count] => 6
                                    [displayValue] => Home, garden & living
                                    [id] => 9821
                                    [selected] => 
                                )

                            [4] => stdClass Object
                                (
                                    [count] => 3
                                    [displayValue] => Outdoor & sports
                                    [id] => 10216
                                    [selected] => 
                                )

                        )

                )

            [1] => stdClass Object
                (
                    [display_name] => Suppliers
                    [name] => f_supplier_id
                    [values] => Array
                        (
                            [0] => stdClass Object
                                (
                                    [count] => 159
                                    [displayValue] => Diamond
                                    [id] => 4
                                    [selected] => 
                                )

                            [1] => stdClass Object
                                (
                                    [count] => 78
                                    [displayValue] => Mansfield
                                    [id] => 109
                                    [selected] => 
                                )

                            [2] => stdClass Object
                                (
                                    [count] => 29
                                    [displayValue] => Alpha
                                    [id] => 1
                                    [selected] => 
                                )

                        )

                )

            [2] => stdClass Object
                (
                    [display_name] => Brands
                    [name] => f_brand
                    [values] => Array
                        (
                            [0] => stdClass Object
                                (
                                    [count] => 14
                                    [displayValue] => Ihome
                                    [id] => ihome
                                    [selected] => 
                                )

                            [1] => stdClass Object
                                (
                                    [count] => 12
                                    [displayValue] => Belkin
                                    [id] => belkin
                                    [selected] => 
                                )

                            [2] => stdClass Object
                                (
                                    [count] => 11
                                    [displayValue] => Griffin Technology
                                    [id] => griffin technology
                                    [selected] => 
                                )

                            [3] => stdClass Object
                                (
                                    [count] => 11
                                    [displayValue] => Xo Vision
                                    [id] => xo vision
                                    [selected] => 
                                )

                            [4] => stdClass Object
                                (
                                    [count] => 10
                                    [displayValue] => Contour Design
                                    [id] => contour design
                                    [selected] => 
                                )

                            [5] => stdClass Object
                                (
                                    [count] => 10
                                    [displayValue] => Macally
                                    [id] => macally
                                    [selected] => 
                                )

                            [6] => stdClass Object
                                (
                                    [count] => 9
                                    [displayValue] => Sony Audio/video
                                    [id] => sony audio/video
                                    [selected] => 
                                )

                            [7] => stdClass Object
                                (
                                    [count] => 8
                                    [displayValue] => Iluv
                                    [id] => iluv
                                    [selected] => 
                                )

                            [8] => stdClass Object
                                (
                                    [count] => 8
                                    [displayValue] => Speakal
                                    [id] => speakal
                                    [selected] => 
                                )

                            [9] => stdClass Object
                                (
                                    [count] => 7
                                    [displayValue] => Coby Electronics
                                    [id] => coby electronics
                                    [selected] => 
                                )

                            [10] => stdClass Object
                                (
                                    [count] => 6
                                    [displayValue] => I.sound
                                    [id] => i.sound
                                    [selected] => 
                                )

                            [11] => stdClass Object
                                (
                                    [count] => 6
                                    [displayValue] => Iessentials
                                    [id] => iessentials
                                    [selected] => 
                                )

                            [12] => stdClass Object
                                (
                                    [count] => 6
                                    [displayValue] => Visual Land
                                    [id] => visual land
                                    [selected] => 
                                )

                            [13] => stdClass Object
                                (
                                    [count] => 5
                                    [displayValue] => Retrak / Emerge
                                    [id] => retrak / emerge
                                    [selected] => 
                                )

                            [14] => stdClass Object
                                (
                                    [count] => 4
                                    [displayValue] => Boss
                                    [id] => boss
                                    [selected] => 
                                )

                            [15] => stdClass Object
                                (
                                    [count] => 4
                                    [displayValue] => Griffin
                                    [id] => griffin
                                    [selected] => 
                                )

                            [16] => stdClass Object
                                (
                                    [count] => 4
                                    [displayValue] => Hercules
                                    [id] => hercules
                                    [selected] => 
                                )

                            [17] => stdClass Object
                                (
                                    [count] => 4
                                    [displayValue] => Marware
                                    [id] => marware
                                    [selected] => 
                                )

                            [18] => stdClass Object
                                (
                                    [count] => 4
                                    [displayValue] => Samsonic
                                    [id] => samsonic
                                    [selected] => 
                                )

                            [19] => stdClass Object
                                (
                                    [count] => 4
                                    [displayValue] => Sandisk
                                    [id] => sandisk
                                    [selected] => 
                                )

                        )

                )

            [3] => stdClass Object
                (
                    [display_name] => Has Image
                    [name] => f_hasImage
                    [values] => Array
                        (
                            [0] => stdClass Object
                                (
                                    [count] => 266
                                    [displayValue] => True
                                    [id] => 
                                    [selected] => 
                                )

                            [1] => stdClass Object
                                (
                                    [count] => 0
                                    [displayValue] => True
                                    [id] => 
                                    [selected] => 
                                )

                        )

                )

            [4] => stdClass Object
                (
                    [display_name] => Refurbished
                    [name] => f_refurbished
                    [values] => Array
                        (
                            [0] => stdClass Object
                                (
                                    [count] => 266
                                    [displayValue] => True
                                    [id] => 
                                    [selected] => 
                                )

                            [1] => stdClass Object
                                (
                                    [count] => 0
                                    [displayValue] => True
                                    [id] => 
                                    [selected] => 
                                )

                        )

                )

            [5] => stdClass Object
                (
                    [display_name] => Special
                    [name] => f_special
                    [values] => Array
                        (
                            [0] => stdClass Object
                                (
                                    [count] => 1
                                    [displayValue] => f_special
                                    [id] => 
                                    [selected] => 
                                )

                        )

                )

            [6] => stdClass Object
                (
                    [display_name] => Weekly Deal
                    [name] => f_weekly_deal
                    [values] => Array
                        (
                            [0] => stdClass Object
                                (
                                    [count] => 1
                                    [displayValue] => f_weekly_deal
                                    [id] => 
                                    [selected] => 
                                )

                        )

                )

            [7] => stdClass Object
                (
                    [display_name] => Supplier Deal
                    [name] => f_supplier_deal
                    [values] => Array
                        (
                            [0] => stdClass Object
                                (
                                    [count] => 1
                                    [displayValue] => f_supplier_deal
                                    [id] => 
                                    [selected] => 
                                )

                        )

                )

            [8] => stdClass Object
                (
                    [display_name] => Brands
                    [name] => f_attribute_l0
                    [values] => 
                )

        )

    [has_next_page] => 1
    [parent_categories] => Array
        (
        )

    [products] => Array
        (
            [0] => stdClass Object
                (
                    [brand] => Case Logic
                    [description] => CASE LOGIC FITTED IPOD80GB CLASSIC BLK 80GB CLASSIC BLK<BR><BR><li>Flip open design allows total access to all ports and controls<li>Plastic screen protector and soft suede-like interior <li>Invisible magnetic closure for a sleek appearance<li>Internal dims: 2 7/16\" W x 4 1/8\" H x 13/32\" D  <li>Overall dims: 2 1/2\" W x 4 3/4\" H x 3/4\" D
                    [drop_ship_fee] => 1.5
                    [flags] => Array
                        (
                        )

                    [image_height] => 600
                    [image_url] => http://d1k0ppjronk6up.cloudfront.net/products/1/icc-1a_black.jpg
                    [image_width] => 600
                    [in_stock] => 1
                    [in_warehouse] => 
                    [item_id] => 5595637
                    [item_sku] => T48360
                    [last_update] => 2011-05-18 15:28:18
                    [msrp] => 29.95
                    [original_price] => 
                    [prepay_price] => 12.74
                    [price] => 13.11
                    [product_group] => free_member
                    [product_id] => 4916747
                    [product_sku] => T48360
                    [quantity_avail] => 2
                    [stats] => stdClass Object
                        (
                            [item_count] => 1
                            [item_count_in_specified_list] => 0
                            [item_count_in_warehouse] => 0
                            [max_cost] => 13.11
                            [max_qty] => 2
                            [min_cost] => 13.11
                            [min_qty] => 2
                        )

                    [supplier_name] => Alpha
                    [thumb_height] => 130
                    [thumb_url] => http://d1k0ppjronk6up.cloudfront.net/products/1/icc-1a_black.jpg?maxX=120&maxY=120
                    [thumb_width] => 140
                    [title] => Black Fitted Koskin Case For iPod Black Fitted Koskin Case For iPod&reg; 80GB classic
                )

            [1] => stdClass Object
                (
                    [brand] => MacAlly
                    [description] => Automobile Full Channel FM Transmitter, Cup Holder and Charger for iPod devices-Black <br><br><b></b>
                    [drop_ship_fee] => 0
                    [flags] => Array
                        (
                        )

                    [image_height] => 250
                    [image_url] => http://d1k0ppjronk6up.cloudfront.net/products/4/FMCUPB.jpg
                    [image_width] => 250
                    [in_stock] => 1
                    [in_warehouse] => 
                    [item_id] => 297436
                    [item_sku] => FMCUPB
                    [last_update] => 2010-03-22 04:33:45
                    [msrp] => 62.2
                    [original_price] => 
                    [prepay_price] => 38.67
                    [price] => 39.81
                    [product_group] => free_member
                    [product_id] => 184438
                    [product_sku] => FMCUPB
                    [quantity_avail] => 51
                    [stats] => stdClass Object
                        (
                            [item_count] => 1
                            [item_count_in_specified_list] => 0
                            [item_count_in_warehouse] => 0
                            [max_cost] => 39.81
                            [max_qty] => 51
                            [min_cost] => 39.81
                            [min_qty] => 51
                        )

                    [supplier_name] => Diamond
                    [thumb_height] => 0
                    [thumb_url] => http://d1k0ppjronk6up.cloudfront.net/products/4/FMCUPB.jpg?maxX=120&maxY=120
                    [thumb_width] => 0
                    [title] => Black iPod Docking Station
                )

            [2] => stdClass Object
                (
                    [brand] => SCOSCHE
                    [description] => ADDS CONTROL & PROTECTS IPOD SHUFFLE&reg; 3G; CONTROLS PLAY\, PAUSE\, ADJUSTS VOLUME\, SKIPS TRACKS\, NAVIGATES PLAYLISTS & ACTIVATES THE VOICEOVER FEATURE ON IPOD SHUFFLE&reg; 3G ; FOR USE WITH ANY STANDARD HEADPHONES OR EARBUDS; INCLUDES 3-FT AUDIO CABLE FOR CONNECTING TO MOST STEREO SYSTEMS ; HIGH IMPACT POLYCARBONATE MATERIAL PROTECTS AGAINST KNOCKS & NICKS ; BLACK<br><br>
                    [drop_ship_fee] => 2
                    [flags] => Array
                        (
                        )

                    [image_height] => 600
                    [image_url] => http://d1k0ppjronk6up.cloudfront.net/products/109/600x600_SISIRMC.jpg
                    [image_width] => 600
                    [in_stock] => 1
                    [in_warehouse] => 
                    [item_id] => 5568823
                    [item_sku] => SISIRMC
                    [last_update] => 2010-03-22 04:59:52
                    [msrp] => 34.17
                    [original_price] => 
                    [prepay_price] => 21.81
                    [price] => 22.46
                    [product_group] => free_member
                    [product_id] => 4895525
                    [product_sku] => SISIRMC
                    [quantity_avail] => 7
                    [stats] => stdClass Object
                        (
                            [item_count] => 1
                            [item_count_in_specified_list] => 0
                            [item_count_in_warehouse] => 0
                            [max_cost] => 22.46
                            [max_qty] => 7
                            [min_cost] => 22.46
                            [min_qty] => 7
                        )

                    [supplier_name] => Mansfield
                    [thumb_height] => 130
                    [thumb_url] => http://d1k0ppjronk6up.cloudfront.net/products/109/600x600_SISIRMC.jpg?maxX=120&maxY=120
                    [thumb_width] => 140
                    [title] => BLACK TAPSTICK CASE FOR
                )

        )

    [saved_searches] => Array
        (
            [0] => stdClass Object
                (
                    [criteria] => O:8:"stdClass":8:{s:13:"display_start";i:0;s:13:"display_count";i:24;s:6:"filter";a:4:{i:0;O:8:"stdClass":2:{s:4:"name";s:5:"f_cat";s:3:"ids";a:1:{i:0;s:4:"8336";}}i:1;O:8:"stdClass":2:{s:4:"name";s:7:"f_stock";s:3:"ids";a:1:{i:0;s:8:"in-stock";}}i:2;O:8:"stdClass":2:{s:4:"name";s:10:"f_hasImage";s:3:"ids";a:1:{i:0;i:1;}}i:3;O:8:"stdClass":2:{s:4:"name";s:13:"f_refurbished";s:3:"ids";a:2:{i:0;i:0;i:1;i:1;}}}s:11:"search_term";s:6:"laptop";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:"laptop";}}
                    [date_created] => 2011-04-29 14:53:58
                    [friendly_criteria] => O:8:"stdClass":5:{s:6:"filter";a:1:{s:5:"f_cat";O:8:"stdClass":2:{s:4:"name";s:10:"Categories";s:5:"value";a:1:{i:0;s:22:"Electronics & computer";}}}s:6:"search";s:6:"laptop";s:13:"grouped_items";s:3:"yes";s:4:"sort";s:11:"Default asc";s:7:"include";s:11:"refurbished";}
                    [name] => Electronics & computer, Refurbished items, Lap
                    [results_per_page] => 24
                    [saved_search_id] => 13413
                    [sort_order] => 1
                    [view_option] => gallery
                )

        )

    [search_term] => ipod
    [specials] => Array
        (
        )

    [suggestion] => 
    [top_sellers] => Array
        (
        )

    [total_search_results] => 266
)

 

 

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 - lists.

getProductDetail Request Parameters

getProductDetail Response Parameters

 

 

getProductDetail Example

getProductDetail Request Example - XML

<?php
$URL = "https://sandbox.doba.com/api/20110301/xml_partner_api.php";
$strRequest = "
<dce>
  <request>
    <authentication>
      <username>username</username>
      <password>password</password>
    </authentication>
    <retailer_id>123456</retailer_id>
    <action>getProductDetail</action>
    <page>1</page>
    <limit>1000</limit>
    <ship_postal>84043</ship_postal>
    <products>
      <product>4924428</product>
    </products>
    <list_ids>
      <list_ids>1724</list_ids>
    </list_ids>
    <items>
      <item>5589431</item>
    </items>
  </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>failure</outcome>
    <error>
      <level>3</level>
      <code>510</code>
      <message>No products were found matching the request. </message>
    </error>
  </response>
</dce>

getProductDetail Request Example - SOAP

<?php
$URL = "https://sandbox.doba.com/soap/20110301/wsdl/ApiPartnerSearch.wsdl";
$client = new SoapClient($URL, array("trace" => 1));

$objAuth = new stdClass();
$objAuth->username = "username";
$objAuth->password = "password";
$objRequest->authentication = $objAuth;
$objRequest->retailer_id = "123456";
$objRequest->page = "1";
$objRequest->limit = "1000";
$objRequest->ship_postal = "84043";
$objRequest->products=array("4924428");
$objRequest->items=array("5589431");
$objRequest->list_ids=array("1724");

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

Error! 510: No products were found matching the request. 

 

 

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/20110301/xml_partner_api.php";
$strRequest = "
<dce>
  <request>
    <authentication>
      <username>username</username>
      <password>password</password>
    </authentication>
    <retailer_id>123456</retailer_id>
    <action>getProductInventory</action>
    <page>1</page>
    <limit>1000</limit>
    <ship_postal>84043</ship_postal>
    <products>
      <product>4924428</product>
    </products>
    <list_ids/>
    <items>
      <item>5589431</item>
    </items>
  </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>failure</outcome>
    <error>
      <level>3</level>
      <code>510</code>
      <message>No products were found matching the request. </message>
    </error>
  </response>
</dce>

getProductInventory Request Example - SOAP

<?php
$URL = "https://sandbox.doba.com/soap/20110301/wsdl/ApiPartnerSearch.wsdl";
$client = new SoapClient($URL, array("trace" => 1));

$objAuth = new stdClass();
$objAuth->username = "username";
$objAuth->password = "password";
$objRequest->authentication = $objAuth;
$objRequest->retailer_id = "123456";
$objRequest->page = "1";
$objRequest->limit = "1000";
$objRequest->ship_postal = "84043";
$objRequest->products=array("4924428");
$objRequest->items=array("5589431");
$objRequest->list_ids=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

Error! 510: No products were found matching the request. 

 

 

getListsSummary

Retrieves a summary of inventory lists currently saved within a merchants account. Inventory lists can be created and managed at http://www.doba.com

getListsSummary Request Parameters

getListsSummary Response Parameters

 

 

getListsSummary Example

getListsSummary Request Example - XML

<?php
$URL = "https://sandbox.doba.com/api/20110301/xml_partner_api.php";
$strRequest = "
<dce>
  <request>
    <authentication>
      <username>username</username>
      <password>password</password>
    </authentication>
    <retailer_id>123456</retailer_id>
    <action>getListsSummary</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 = getListsSummary\n\n";
print "Request:\n=====================================================\n\n";
print_r($strRequest);
print "\n\nResponse:\n=====================================================\n\n";
print_r($strResponse);
?>

getListsSummary Response Example - XML

<?xml version="1.0"?>
<dce>
  <response>
    <outcome>success</outcome>
    <list>
      <item_count>16</item_count>
      <default>0</default>
      <send_callback>0</send_callback>
      <name>Boating</name>
      <id>14913</id>
    </list>
    <list>
      <item_count>273</item_count>
      <default>0</default>
      <send_callback>0</send_callback>
      <name>Tools</name>
      <id>14914</id>
    </list>
  </response>
</dce>

getListsSummary Request Example - SOAP

<?php
$URL = "https://sandbox.doba.com/soap/20110301/wsdl/ApiPartnerSearch.wsdl";
$client = new SoapClient($URL, array("trace" => 1));

$objAuth = new stdClass();
$objAuth->username = "username";
$objAuth->password = "password";
$objRequest->authentication = $objAuth;
$objRequest->retailer_id = "123456";

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

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

getListsSummary Response Example - SOAP

Array
(
    [0] => stdClass Object
        (
            [default] => 
            [id] => 14913
            [item_count] => 16
            [name] => Boating
            [send_callback] => 
        )

    [1] => stdClass Object
        (
            [default] => 
            [id] => 14914
            [item_count] => 273
            [name] => Tools
            [send_callback] => 
        )

)

 

 

getListItems

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

getListItems Request Parameters

getListItems Response Parameters

 

 

getListItems Example

getListItems Request Example - XML

<?php
$URL = "https://sandbox.doba.com/api/20110301/xml_partner_api.php";
$strRequest = "
<dce>
  <request>
    <authentication>
      <username>username</username>
      <password>password</password>
    </authentication>
    <retailer_id>123456</retailer_id>
    <action>getListItems</action>
    <list_id>1724</list_id>
    <page>1</page>
    <limit>3</limit>
    <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 = getListItems\n\n";
print "Request:\n=====================================================\n\n";
print_r($strRequest);
print "\n\nResponse:\n=====================================================\n\n";
print_r($strResponse);
?>

getListItems Response Example - XML

<?xml version="1.0"?>
<dce>
  <response>
    <outcome>failure</outcome>
    <error>
      <level>3</level>
      <code>510</code>
      <message>No products were found matching the request. </message>
    </error>
  </response>
</dce>

getListItems Request Example - SOAP

<?php
$URL = "https://sandbox.doba.com/soap/20110301/wsdl/ApiPartnerSearch.wsdl";
$client = new SoapClient($URL, array("trace" => 1));

$objAuth = new stdClass();
$objAuth->username = "username";
$objAuth->password = "password";
$objRequest->authentication = $objAuth;
$objRequest->retailer_id = "123456";
$objRequest->list_id = "1724";
$objRequest->page = "1";
$objRequest->limit = "3";
$objRequest->changes_only = "0";

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

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

getListItems Response Example - SOAP

Error! 510: No products were found matching the request. 

 

 

editList

Adds or removes items from a specified inventory list.

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

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

editList Request Parameters

editList Response Parameters

 

 

editList Example

editList Request Example - XML

<?php
$URL = "https://sandbox.doba.com/api/20110301/xml_partner_api.php";
$strRequest = "
<dce>
  <request>
    <authentication>
      <username>username</username>
      <password>password</password>
    </authentication>
    <retailer_id>123456</retailer_id>
    <action>editList</action>
    <list_id>1724</list_id>
    <item_ids>
      <item_id>5589431</item_id>
    </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 = editList\n\n";
print "Request:\n=====================================================\n\n";
print_r($strRequest);
print "\n\nResponse:\n=====================================================\n\n";
print_r($strResponse);
?>

editList Response Example - XML

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

editList Request Example - SOAP

<?php
$URL = "https://sandbox.doba.com/soap/20110301/wsdl/ApiPartnerSearch.wsdl";
$client = new SoapClient($URL, array("trace" => 1));

$objAuth = new stdClass();
$objAuth->username = "username";
$objAuth->password = "password";
$objRequest->authentication = $objAuth;
$objRequest->retailer_id = "123456";
$objRequest->list_id = "17533";
$objRequest->item_ids_to_remove=array(
    "4309901",
    "4400449"
    );
try { $Response = $client->editList($objRequest); }
catch ( SOAPFault $e ) {$Response = ("Error ".$e->faultcode.": ".$e->faultstring); }

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

editList Response Example - SOAP

stdClass Object
(
    [list_id] => 17533
    [num_added] => 0
    [num_removed] => 2
)