Difference between revisions of "API/Services/GetAccountDiscountSubscription"
From Emersion
(Created page with "'''Purpose ''' This Method will retrieve all account discount subscriptions for a given account based on status (optional). '''Inputs''' <soapenv:Header/> <soapenv:Bod...") |
|||
| Line 13: | Line 13: | ||
</ser:GetAccountDiscountSubscriptions> | </ser:GetAccountDiscountSubscriptions> | ||
</soapenv:Body> | </soapenv:Body> | ||
| + | |||
| + | '''Important notes:''' | ||
| + | |||
| + | 106. AccountID needs to be the ID of the Account in the Emersion system | ||
| + | |||
| + | 107. Status needs to be the ID of PkgSubscriptionStatus in the Emersion system, optional | ||
| + | |||
| + | '''Example Validation Error:''' | ||
| + | <SOAP-ENV:Body> | ||
| + | <SOAP-ENV:Fault> | ||
| + | <faultcode>SOAP-ENV:Client</faultcode> | ||
| + | <faultstring>Validation Error</faultstring> | ||
| + | <faultactor>http://emersion.com.au/Services</faultactor> | ||
| + | <detail>Could not find Account ID!</detail> | ||
| + | </SOAP-ENV:Fault> | ||
| + | </SOAP-ENV:Body> | ||
| + | |||
| + | |||
| + | '''Validation rules:''' | ||
| + | |||
| + | 108. Account exists | ||
| + | |||
| + | 109. Account has a parent which matches the caller. | ||
| + | |||
| + | 110. Status exists | ||
| + | |||
| + | '''Output''' | ||
| + | |||
| + | <SOAP-ENV:Body> | ||
| + | <ns1:GetAccountDiscountSubscriptionsResponse> | ||
| + | <!--1 to 999 repetitions:--> | ||
| + | <ns1:AccountDiscountSubscriptionItem> | ||
| + | <ns1:AccountDiscountSubscriptionID>100012</ns1:AccountDiscountSubscriptionID> | ||
| + | <ns1:StartDate>2013-10-15 14:08:05</ns1:StartDate> | ||
| + | <ns1:EndDate>2013-10-15 15:19:26</ns1:EndDate> | ||
| + | <ns1:AccountID>216754</ns1:AccountID> | ||
| + | <ns1:AccountDiscountPlanID>3</ns1:AccountDiscountPlanID> | ||
| + | <ns1:SubscriptionStatusID>6</ns1:SubscriptionStatusID> | ||
| + | </ns1:AccountDiscountSubscriptionItem> | ||
| + | </ns1:GetAccountDiscountSubscriptionsResponse> | ||
| + | </SOAP-ENV:Body> | ||
| + | |||
| + | |||
| + | '''Error String:''' | ||
| + | |||
| + | 111. Invalid or Missing Account ID | ||
| + | |||
| + | 112. Could not find Account ID! | ||
| + | |||
| + | 113. You do not have permission to modify this Account! | ||
| + | |||
| + | 114. Invalid Status ID! | ||
Latest revision as of 18:04, 10 September 2014
Purpose
This Method will retrieve all account discount subscriptions for a given account based on status (optional).
Inputs
<soapenv:Header/>
<soapenv:Body>
<ser:GetAccountDiscountSubscriptions>
<ser:AccountID>?</ser:AccountID>
<ser:Status>?</ser:Status>
</ser:GetAccountDiscountSubscriptions>
</soapenv:Body>
Important notes:
106. AccountID needs to be the ID of the Account in the Emersion system
107. Status needs to be the ID of PkgSubscriptionStatus in the Emersion system, optional
Example Validation Error:
<SOAP-ENV:Body>
<SOAP-ENV:Fault>
<faultcode>SOAP-ENV:Client</faultcode>
<faultstring>Validation Error</faultstring>
<faultactor>http://emersion.com.au/Services</faultactor>
<detail>Could not find Account ID!</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
Validation rules:
108. Account exists
109. Account has a parent which matches the caller.
110. Status exists
Output
<SOAP-ENV:Body>
<ns1:GetAccountDiscountSubscriptionsResponse>
<ns1:AccountDiscountSubscriptionItem>
<ns1:AccountDiscountSubscriptionID>100012</ns1:AccountDiscountSubscriptionID>
<ns1:StartDate>2013-10-15 14:08:05</ns1:StartDate>
<ns1:EndDate>2013-10-15 15:19:26</ns1:EndDate>
<ns1:AccountID>216754</ns1:AccountID>
<ns1:AccountDiscountPlanID>3</ns1:AccountDiscountPlanID>
<ns1:SubscriptionStatusID>6</ns1:SubscriptionStatusID>
</ns1:AccountDiscountSubscriptionItem>
</ns1:GetAccountDiscountSubscriptionsResponse>
</SOAP-ENV:Body>
Error String:
111. Invalid or Missing Account ID
112. Could not find Account ID!
113. You do not have permission to modify this Account!
114. Invalid Status ID!