Go to full article


Overview

The purpose of this call is to set a pre-billing date against a preactive service subscription. The pre-billing date is the one, on which, the pre-billing process will automatically kick-off for the preactive service and access fee will be taken against it.

WSDL

https://api.emersion.com.au/Services.wsdl

Operation name

SetPreBillingDateOnPreactiveServiceSubscription



Business Rules

  • Service subscription must be preactive
  • Service subscription must be owned by caller account
  • Service subscription must be at the bottom tier (i.e. at the end user account level)
  • Pre-billing date must be in the future
  • Pre-billing should not have been already processed against the service




SOAP Example


Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:emersion:api">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:SetPreBillingDateOnPreactiveServiceSubscription>
         <urn:ServiceSubscriptionID>100805</urn:ServiceSubscriptionID>
         <urn:PreBillingStartDate>2021-10-31</urn:PreBillingStartDate>
      </urn:SetPreBillingDateOnPreactiveServiceSubscription>
   </soapenv:Body>
</soapenv:Envelope>

Response:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:emersion:api">
   <SOAP-ENV:Body>
      <ns1:SetPreBillingDateOnPreactiveServiceSubscriptionResponse/>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>


Field Descriptions

All field names are case sensitive. Check enumerated values in the descriptions to confirm capitalisation and spacing. See field types for additional information..

NameDescriptionRequired?Field Type

Character

limit

Values
ServiceSubscriptionID
ID of the service subscription, for which, the pre-billing date is being setYesInteger

e.g. 100000

PreBillingStartDate
The date that needs to be set as the pre-billing dateYesDate
e.g. 2021-08-31



Error Handling


Error MessageDescription
Service Subscription ID must be provided

Service Subscription ID must be integer

Service Subscription ID not found
When the ID is not found in Emersion database
Service Subscription is not Preactive

Service Subscription is not the bottom level
subscription against the associated service

Service Subscription is not owned by the 
caller account

Pre-Billing Start Date must be provided

Invalid Pre-Billing Start Date provided

When date format is incorrect. Should be

YYYY-MM-DD

Pre-Billing Start Date must be in the future
Pre-Billing has already been processed against the service subscription