PUT api/customerrecurring/{id}

Updates a specific customer recurring record by CustomerRecurringID; only the following fields can be updated: Recurring Item Code, Description, Master Item Code, Bill Cycle, and Memo. To update all other fields, cancel and recreate the recur line.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

integer

Required

Body Parameters

CustomerRecurringUpdate
NameDescriptionTypeAdditional information
CustomerRecurringId

Sedona internal autonumber for the Customer Recurring record

integer

None.

ItemCode

Value from AR_Item table; list of valid options can be retrieved from GET: api/item

string

Required

String length: inclusive between 0 and 25

MasterItemCode

Item_Code from AR_Item table; the Recurring Revenue item that this item will be “rolled up” into. Items of like Master Item and cycle are grouped together in the application. Defaults to N/A if not set explicitly.

string

String length: inclusive between 0 and 25

MasterAccountCode

Master_Account_Code from AR_Master_Account table; used to set "Receivable to Master" flag; if set, should also pass Master's CustomerBillId

string

String length: inclusive between 0 and 25

BillCycle

M = Monthly, Q = Quarterly, S = Semi-annual, A = Annual

string

Required

String length: inclusive between 0 and 1

UserDescription

Description of the Recurring Charges; defaults to the Item Description if not set explicitly.

string

String length: inclusive between 0 and 50

InvoiceItemMemo

Memo field in the AR_Invoice_Item table

string

String length: inclusive between 0 and 2000

CustomerBillId

Optional - update the CustomerBillId this recurring record is pointing to; if MasterAccountCode is being set, this should be the CustomerBillId for the Master

integer

None.

Request Formats

application/json, text/json

Sample:
{
  "CustomerRecurringId": 1,
  "ItemCode": "sample string 2",
  "MasterItemCode": "sample string 3",
  "MasterAccountCode": "sample string 4",
  "BillCycle": "sample string 5",
  "UserDescription": "sample string 6",
  "InvoiceItemMemo": "sample string 7",
  "CustomerBillId": 8
}

application/xml, text/xml

Sample:
<CustomerRecurringUpdate xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SedonaServices.Models">
  <BillCycle>sample string 5</BillCycle>
  <CustomerBillId>8</CustomerBillId>
  <CustomerRecurringId>1</CustomerRecurringId>
  <InvoiceItemMemo>sample string 7</InvoiceItemMemo>
  <ItemCode>sample string 2</ItemCode>
  <MasterAccountCode>sample string 4</MasterAccountCode>
  <MasterItemCode>sample string 3</MasterItemCode>
  <UserDescription>sample string 6</UserDescription>
</CustomerRecurringUpdate>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'CustomerRecurringUpdate'.

Response Information

Resource Description

None.