Difference between revisions of "API/Products/GetProductDetails"

From Emersion
Jump to: navigation, search
(new page created for GetProductDetails API function)
 
m (updated as per Emo Darwin request 9/6/2016)
Line 7: Line 7:
 
   <soapenv:Body>
 
   <soapenv:Body>
 
       <prod:GetProductDetailsRequest>
 
       <prod:GetProductDetailsRequest>
         <prod:Active>true</prod:Active>
+
         <prod:ProductStatus>Active</prod:ProductStatus>
 
         <!--Optional:-->
 
         <!--Optional:-->
 
         <prod:ProductID></prod:ProductID>
 
         <prod:ProductID></prod:ProductID>
Line 17: Line 17:
 
   <SOAP-ENV:Body>
 
   <SOAP-ENV:Body>
 
       <ns1:GetProductDetailsResponse>
 
       <ns1:GetProductDetailsResponse>
            <ns1:Product>
+
          <ns1:Product>
            <ns1:ID>1957964</ns1:ID>
+
<ns1:ID>1957963</ns1:ID>
            <ns1:Name>iPhone 5s Any Shock Case - Bendigo Bank Connect branded</ns1:Name>
+
<ns1:Name>Apple iPhone 6 16GB - Grey</ns1:Name>
            <ns1:Description>iPhone 5s Any Shock Case - Bendigo Bank Connect branded</ns1:Description>
+
<ns1:Description>Apple iPhone 6 16GB - Grey</ns1:Description>
            <ns1:CategoryID>16</ns1:CategoryID>
+
<ns1:CategoryID>16</ns1:CategoryID>
            <ns1:Category>Mobile Phone</ns1:Category>
+
<ns1:Category>Mobile Phone</ns1:Category>
            <ns1:Type>Physical Product</ns1:Type>
+
<ns1:Type>Physical Product</ns1:Type>
            <ns1:SKU>iphone5sshock</ns1:SKU>
+
<ns1:Manufacturer>Apple</ns1:Manufacturer>
            <ns1:Pricing>
+
<ns1:Colour>Gray</ns1:Colour>
              <ns1:BookID>100066</ns1:BookID>
+
<ns1:Supplier>Apple</ns1:Supplier>
              <ns1:BookName>Default Pricing Book</ns1:BookName>
+
<ns1:SKU>MG472X/A</ns1:SKU>
              <ns1:BookStartDate xsi:nil="true"/>
+
<ns1:Barcode>
              <ns1:BookEndDate xsi:nil="true"/>
+
<ns1:Type>UPC-E</ns1:Type>
              <ns1:Prices>
+
<ns1:Shortname>UPC-E</ns1:Shortname>
                  <ns1:Price>
+
<ns1:Value>888462062350</ns1:Value>
                    <ns1:QuantityBreakStart>1</ns1:QuantityBreakStart>
+
</ns1:Barcode>
                    <ns1:StartDate>2015-07-03 00:00:00</ns1:StartDate>
+
<ns1:Pricing>
                    <ns1:EndDate xsi:nil="true"/>
+
<ns1:BookID>100066</ns1:BookID>
                    <ns1:SellPrice>17.5</ns1:SellPrice>
+
<ns1:BookName>Default Pricing Book</ns1:BookName>
                    <ns1:SellTaxID>2</ns1:SellTaxID>
+
<ns1:BookStartDate xsi:nil="true"/>
                    <ns1:SellTaxName>Australian GST</ns1:SellTaxName>
+
<ns1:BookEndDate xsi:nil="true"/>
                    <ns1:CostPrice>17.5</ns1:CostPrice>
+
<ns1:Prices>
                    <ns1:CostTaxID>2</ns1:CostTaxID>
+
<ns1:Price>
                    <ns1:CostTaxName>Australian GST</ns1:CostTaxName>
+
<ns1:QuantityBreakStart>1</ns1:QuantityBreakStart>
                  </ns1:Price>
+
<ns1:StartDate>2015-07-03</ns1:StartDate>
              </ns1:Prices>
+
<ns1:EndDate>2015-09-18</ns1:EndDate>
            </ns1:Pricing>
+
<ns1:SellPrice>853.69</ns1:SellPrice>
        </ns1:Product>
+
<ns1:SellTaxID>2</ns1:SellTaxID>
 +
<ns1:SellTaxName>Australian GST</ns1:SellTaxName>
 +
<ns1:CostPrice>853.69</ns1:CostPrice>
 +
<ns1:CostTaxID>2</ns1:CostTaxID>
 +
<ns1:CostTaxName>Australian GST</ns1:CostTaxName>
 +
</ns1:Price>
 +
<ns1:Price>
 +
<ns1:QuantityBreakStart>1</ns1:QuantityBreakStart>
 +
<ns1:StartDate>2015-07-03</ns1:StartDate>
 +
<ns1:EndDate>2015-09-18</ns1:EndDate>
 +
<ns1:SellPrice>853.69</ns1:SellPrice>
 +
<ns1:SellTaxID>2</ns1:SellTaxID>
 +
<ns1:SellTaxName>Australian GST</ns1:SellTaxName>
 +
<ns1:CostPrice>853.69</ns1:CostPrice>
 +
<ns1:CostTaxID>2</ns1:CostTaxID>
 +
<ns1:CostTaxName>Australian GST</ns1:CostTaxName>
 +
</ns1:Price>
 +
<ns1:Price>
 +
<ns1:QuantityBreakStart>1</ns1:QuantityBreakStart>
 +
<ns1:StartDate>2015-09-18</ns1:StartDate>
 +
<ns1:EndDate xsi:nil="true"/>
 +
<ns1:SellPrice>981.8181818</ns1:SellPrice>
 +
<ns1:SellTaxID>2</ns1:SellTaxID>
 +
<ns1:SellTaxName>Australian GST</ns1:SellTaxName>
 +
<ns1:CostPrice>0</ns1:CostPrice>
 +
<ns1:CostTaxID>2</ns1:CostTaxID>
 +
<ns1:CostTaxName>Australian GST</ns1:CostTaxName>
 +
</ns1:Price>
 +
</ns1:Prices>
 +
</ns1:Pricing>
 +
</ns1:Product>
 
       </ns1:GetProductDetailsResponse>
 
       </ns1:GetProductDetailsResponse>
 
   </SOAP-ENV:Body>
 
   </SOAP-ENV:Body>

Revision as of 14:47, 9 June 2016

Purpose

Retrieve all available products all the object properties that need to be entered (along with whether they are mandatory or not). Hardware / products are stored within Emersion; data will be cached via CTA and retrieved daily.


Inputs

  <soapenv:Body>
     <prod:GetProductDetailsRequest>
        <prod:ProductStatus>Active</prod:ProductStatus>
        <prod:ProductID></prod:ProductID>
     </prod:GetProductDetailsRequest>
  </soapenv:Body>


Output

  <SOAP-ENV:Body>
     <ns1:GetProductDetailsResponse>
          <ns1:Product>

<ns1:ID>1957963</ns1:ID> <ns1:Name>Apple iPhone 6 16GB - Grey</ns1:Name> <ns1:Description>Apple iPhone 6 16GB - Grey</ns1:Description> <ns1:CategoryID>16</ns1:CategoryID> <ns1:Category>Mobile Phone</ns1:Category> <ns1:Type>Physical Product</ns1:Type> <ns1:Manufacturer>Apple</ns1:Manufacturer> <ns1:Colour>Gray</ns1:Colour> <ns1:Supplier>Apple</ns1:Supplier> <ns1:SKU>MG472X/A</ns1:SKU> <ns1:Barcode> <ns1:Type>UPC-E</ns1:Type> <ns1:Shortname>UPC-E</ns1:Shortname> <ns1:Value>888462062350</ns1:Value> </ns1:Barcode> <ns1:Pricing> <ns1:BookID>100066</ns1:BookID> <ns1:BookName>Default Pricing Book</ns1:BookName> <ns1:BookStartDate xsi:nil="true"/> <ns1:BookEndDate xsi:nil="true"/> <ns1:Prices> <ns1:Price> <ns1:QuantityBreakStart>1</ns1:QuantityBreakStart> <ns1:StartDate>2015-07-03</ns1:StartDate> <ns1:EndDate>2015-09-18</ns1:EndDate> <ns1:SellPrice>853.69</ns1:SellPrice> <ns1:SellTaxID>2</ns1:SellTaxID> <ns1:SellTaxName>Australian GST</ns1:SellTaxName> <ns1:CostPrice>853.69</ns1:CostPrice> <ns1:CostTaxID>2</ns1:CostTaxID> <ns1:CostTaxName>Australian GST</ns1:CostTaxName> </ns1:Price> <ns1:Price> <ns1:QuantityBreakStart>1</ns1:QuantityBreakStart> <ns1:StartDate>2015-07-03</ns1:StartDate> <ns1:EndDate>2015-09-18</ns1:EndDate> <ns1:SellPrice>853.69</ns1:SellPrice> <ns1:SellTaxID>2</ns1:SellTaxID> <ns1:SellTaxName>Australian GST</ns1:SellTaxName> <ns1:CostPrice>853.69</ns1:CostPrice> <ns1:CostTaxID>2</ns1:CostTaxID> <ns1:CostTaxName>Australian GST</ns1:CostTaxName> </ns1:Price> <ns1:Price> <ns1:QuantityBreakStart>1</ns1:QuantityBreakStart> <ns1:StartDate>2015-09-18</ns1:StartDate> <ns1:EndDate xsi:nil="true"/> <ns1:SellPrice>981.8181818</ns1:SellPrice> <ns1:SellTaxID>2</ns1:SellTaxID> <ns1:SellTaxName>Australian GST</ns1:SellTaxName> <ns1:CostPrice>0</ns1:CostPrice> <ns1:CostTaxID>2</ns1:CostTaxID> <ns1:CostTaxName>Australian GST</ns1:CostTaxName> </ns1:Price> </ns1:Prices> </ns1:Pricing> </ns1:Product>

     </ns1:GetProductDetailsResponse>
  </SOAP-ENV:Body>


Error String

  • "Invalid Product ID" - Product ID length less than 6 digits
  • "Undefined Product" - Product is not owned by Emersion, nor by service provider, or service type category does not exist and not own by parent account.