updateInvoiceGrouping()

void updateInvoiceGrouping(string invoiceGroupingId, NewInvoiceGrouping updateInvoiceGroupingRequest)

This method updates an invoice grouping.

Parameters

invoiceGroupingId: Format: string; Purpose: Specifies the ID of the invoice grouping to update.
updateInvoiceGroupingRequest: Format: NewInvoiceGrouping XML; Purpose: Defines a NewInvoiceGrouping XML document that specifies the invoice grouping details that will be updated.

Example: A NewInvoiceGrouping XML document

This example shows a NewInvoiceGrouping XML document.

A NewInvoiceGrouping XML document contains the following optional elements:

<InvoiceGroupingOverrides>: (Optional) Overrides the description on the roll up transaction item and the charge types of which charges will be rolled up.
<ActiveFrom>: (Optional) The date from which charges will be rolled up.
<ActiveTo>: (Optional) The date up to which charges will be rolled up.

Note: If both <ActiveFrom> and <ActiveTo> fields are blank, charges for any date will be rolled up.

<NewInvoiceGrouping xmlns="http://xml.inomial.com/smile/2.xsd">
  <Account>2142424056</Account>
  <InvoiceGroupingConfiguration key="28b1a75d-b911-4ec3-a250-6740141ebce8">All charges</InvoiceGroupingConfiguration>
  <RollupToSubscription>2142422878</RollupToSubscription>
  <ActiveFrom>2015-03-24+10:00</ActiveFrom>
  <Subscriptions>
    <Subscription>2142424072</Subscription>
  </Subscriptions>
  <InvoiceGroupingOverrides>
    <RollupDescription>Rollup description {0,date} - {1,date}</RollupDescription>
    <ChargeTypes>
      <ChargeType key="9">Manually entered charge</ChargeType>
    </ChargeTypes> 
  </InvoiceGroupingOverrides> 
</NewInvoiceGrouping>

Results

This method does not return any output.

There are no messages defined by this method.

Faults

InvalidRequestException

This fault is returned when

the account is not provided
the invoice grouping configuration reference is not provided
the ActiveFrom date is not before the ActiveTo date
the invoice grouping configuration is currently inactive
the RollupToSubscription is not a subscription of the account
a Subscription entry is blank
a listed Subscription is not a subscription of the account
a listed Subscription has an existing invoice grouping active period overlapping the requested invoice grouping

NoSuchItemException

This fault is returned when

the invoice grouping for the ID does not exist
the account does not exist
the invoice grouping configuration reference does not exist
a charge type specified in InvoiceGroupingOverrides does not exist
the RollupToSubscription does not exist
a listed Subscription does not exist

Java client syntax

java -cp build/smilewsv2-client.jar [options]
 com.inomial.smile.client.v2.examples.UpdateInvoiceGrouping
 invoiceGroupingId filename

invoiceGroupingId: Purpose: Specifies the ID of the invoice grouping to update.
filename: Purpose: Defines the filename of the NewInvoiceGrouping XML document.

Note: For more information about the Java client and the options it accepts, see Java client syntax.