Difference between revisions of "API/Services/GetServiceConfigurationRequirements"

From Emersion
Jump to: navigation, search
Line 7: Line 7:
 
   <soapenv:Header/>
 
   <soapenv:Header/>
 
   <soapenv:Body>
 
   <soapenv:Body>
       <ord:SetServiceConfiguration>
+
       <urn:GetServiceConfigurationRequirements>
         <ord:PresaleSQID>112233</ord:PresaleSQID>
+
         <urn:ServicePlanID>1234567</urn:ServicePlanID>
         <!--Optional:-->
+
         <urn:TransferType>CHURN</urn:TransferType>
        <ord:PropertyCollections>
+
       </urn:GetServiceConfigurationRequirements>
            <!--Zero or more repetitions:-->
 
            <com:Property>
 
              <com:PropertyTypeID>133</com:PropertyTypeID>
 
              <!--Optional:-->
 
              <com:PropertyValue>string_value</com:PropertyValue>
 
            </com:Property>
 
        </ord:PropertyCollections>
 
       </ord:SetServiceConfiguration>
 
 
   </soapenv:Body>
 
   </soapenv:Body>
  
Line 24: Line 16:
  
 
   <SOAP-ENV:Body>
 
   <SOAP-ENV:Body>
       <ns1:SetServiceConfigurationResponse>
+
       <ns2:GetServiceConfigurationRequirementsResponse>
         <ns1:Status>true</ns1:Status>
+
        <ns2:Property>
       </ns1:SetServiceConfigurationResponse>
+
            <ns1:Type ID="221">MOBILE_AUTH_DOB</ns1:Type>
 +
            <ns1:ValueType ID="1">DateOfBirth</ns1:ValueType>
 +
            <ns1:ValidationRules/>
 +
            <ns1:TypeOption/>
 +
            <ns1:IsMandatory>false</ns1:IsMandatory>
 +
         </ns2:Property>
 +
        <ns2:Property>
 +
            <ns1:Type ID="359">KEY_HIDE_YN</ns1:Type>
 +
            <ns1:ValueType ID="4">List</ns1:ValueType>
 +
            <ns1:ValidationRules/>
 +
            <ns1:TypeOption/>
 +
            <ns1:IsMandatory>true</ns1:IsMandatory>
 +
            <ns1:ValueLists>
 +
              <ns1:ValueList>
 +
                  <ns1:Value>Yes</ns1:Value>
 +
                  <ns1:Label>Yes</ns1:Label>
 +
              </ns1:ValueList>
 +
              <ns1:ValueList>
 +
                  <ns1:Value>No</ns1:Value>
 +
                  <ns1:Label>No</ns1:Label>
 +
              </ns1:ValueList>
 +
            </ns1:ValueLists>
 +
        </ns2:Property>
 +
       </ns2:GetServiceConfigurationRequirementsResponse>
 
   </SOAP-ENV:Body>
 
   </SOAP-ENV:Body>
 
 
'''Error String'''
 
'''Error String'''
  

Revision as of 15:34, 21 July 2016

Purpose

Retrieve all the object properties that need to be entered (along with whether they are mandatory or not).


Inputs

  <soapenv:Header/>
  <soapenv:Body>
     <urn:GetServiceConfigurationRequirements>
        <urn:ServicePlanID>1234567</urn:ServicePlanID>
        <urn:TransferType>CHURN</urn:TransferType>
     </urn:GetServiceConfigurationRequirements>
  </soapenv:Body>

Output

  <SOAP-ENV:Body>
     <ns2:GetServiceConfigurationRequirementsResponse>
        <ns2:Property>
           <ns1:Type ID="221">MOBILE_AUTH_DOB</ns1:Type>
           <ns1:ValueType ID="1">DateOfBirth</ns1:ValueType>
           <ns1:ValidationRules/>
           <ns1:TypeOption/>
           <ns1:IsMandatory>false</ns1:IsMandatory>
        </ns2:Property>
        <ns2:Property>
           <ns1:Type ID="359">KEY_HIDE_YN</ns1:Type>
           <ns1:ValueType ID="4">List</ns1:ValueType>
           <ns1:ValidationRules/>
           <ns1:TypeOption/>
           <ns1:IsMandatory>true</ns1:IsMandatory>
           <ns1:ValueLists>
              <ns1:ValueList>
                 <ns1:Value>Yes</ns1:Value>
                 <ns1:Label>Yes</ns1:Label>
              </ns1:ValueList>
              <ns1:ValueList>
                 <ns1:Value>No</ns1:Value>
                 <ns1:Label>No</ns1:Label>
              </ns1:ValueList>
           </ns1:ValueLists>
        </ns2:Property>
     </ns2:GetServiceConfigurationRequirementsResponse>
  </SOAP-ENV:Body>

Error String

  • "Missing Account Presale SQ ID" - Account Presale SQ ID is not supplied.
  • "Account Presale SQ does not exist" - Account Presale SQ ID supplied does not exist in system.
  • "Account does not exist" - Account ID supplied does not exist in system.
  • "Invalid Account ID" - Account ID supplied does not belong to the same parent group as the API caller.
  • "Missing Package Plan" - Package Plan must be selected before calling this function.
  • "Property(/ies) '[array dump]' required but missing in the Property Collection" - Required properties not supplied.
  • "Property(/ies) '[array dump]' is/are unknown to Service Configuration" - Unknown properties supplied.