updateSimpleRecurringCharges()

void updateSimpleRecurringCharges(string usn, NewSimpleRecurringCharges recurringCharges)

This method is used for updating recurring charges of a specified account or subscription.

Parameters

usn
Format: string
Purpose: Specifies the account or subscription USN.
recurringCharges
Format: NewSimpleRecurringCharges XML
Purpose: Defines a NewSimpleRecurringCharges XML document that specifies the values of the recurring charges to be updated.

Example: A NewSimpleRecurringCharges XMl document

This example shows a NewSimpleRecurringCharges XML document to update recurring charge ID ‘515’ with new values for display rate and frequency type.

<NewSimpleRecurringCharges xmlns="http://xml.inomial.com/smile/2.xsd">  
  <SimpleRecurringCharge>
    <RecurringCharge id="515">
      <Frequency type="Days">30</Frequency>
    </RecurringCharge>
    <DisplayRate>$150/hr</DisplayRate>  
  </SimpleRecurringCharge>
</NewSimpleRecurringCharges>     

Results

No results returned for this update method.

Faults

RecurringChargeException
This fault is returned when one of the following situations occur:
  • A requested recurring charge belongs to another account or subscription, but not to the specified USN
  • Unrecognised pro-rata action is provided
  • Unrecognised frequency type is provided
  • Unrecognised charging mode is provided
NoSuchItemException

This fault is returned when the specified USN does not match an account or subscription.

InvalidRequestException

This fault is returned when a requested recurring charge has already been cancelled and cannot be updated.

Java client syntax

java -cp build/smilewsv2-client.jar [options]
 com.inomial.smile.client.v2.examples.UpdateSimpleRecurringCharges usn
 filename
usn
Purpose: Specifies the account or subscription USN.
filename
Purpose: Defines the filename of the NewSimpleRecurringCharges XML document.
Note: For more information about the Java client and the options it accepts, see Java client syntax.