- Created by chitra.b (Unlicensed) , last modified on Jun 08, 2020
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 7 Next »
Usage
Retrieves the account details from the Debitsuccess billing system based on the specified parameters.
Parameters
Name | Data Type | Length | Description | |
---|---|---|---|---|
User | ||||
| String | Required | Provided by Debitsuccess | |
| String | Required | Provided by Debitsuccess | |
RequestInitiator | String | 100 | Optional | Optional – allows requesting user to be logged |
AccountReferenceNo | String | 15 | Optional* | Debitsuccess account reference |
ExternalAccountReferenceNo | String | 50 | Optional* | External account reference |
* At least one of the following parameters must be supplied: AccountReferenceNo, ExternalAccountReferenceNo
Response
Name | Data Type | Description |
---|---|---|
DateCreated | DateTime | Date/time message was processed |
Id | String | Unique ID for the message |
ResponseNotes () | Collection of validation messages | |
· Code | String | |
· Note | String | |
· NoteType | Enum | Error, Warning, Info |
Status | Enum | Failed, Succeed, Unknown |
Accounts () | ||
· Term | int | Length of term |
· TermType | Enum | Months, Payments |
· AccountCode | String | Account code from contract |
· AccountNotes | String | Free form notes field. |
· AccountReferenceNo | String | Debitsuccess Reference number |
· ContractPrefix | String | Provided by Debitsuccess (allows customer accounts to be split into different organisational groups if required) |
· ExternalAccountReferenceNo | String | Your account identifier |
· NextBillingDate | DateTime? | Next date the account is due to be billed on |
· LastBillingDate | DateTime? | Last date the account was billed on |
· OverdueStatus | int | 0, 1, 2, 3 (0 = Not overdue, 3 = last stage before being send to debt collection or written off) |
· OverdueAmount | Decimal (10, 2) | |
· OverdueAmountWithoutFees | Decimal (10, 2) | Overdue amount without Debitsuccess establishment or penalty fees. |
· FixedTerm | Boolean | true – account will be closed at the end of the minimum term false – account will continue to bill after the minimum term |
· LastReversalReason | String | Reason for last payment failure |
· CancelReason | String | Reason account was closed |
· Suspended | Boolean | true – payments are suspended (the amount owing will NOT continue to accrue while payments are suspended) |
· SuspensionEndDate | DateTime | Date that suspension is due to end |
· PaymentsStopped | Boolean | true – payments have been stopped (the amount owing will continue to accrue while payments are stopped) |
· PaymentStopEndDate | DateTime | Date that the payment stop is due to end |
· CurrentInstalment | Decimal (10, 2) | Current instalment amount |
· CurrentFrequency | Enum | Current payment frequency |
· CatchUpAmount | Decimal (10, 2) | Catch-up amount |
· CatchUpEndDate | DateTime | End date for catch-up |
· PaymentInAdvanceAmount | Decimal (10, 2) | Payment in advance amount |
· PaymentInAdvanceEndDate | DateTime | End date for payment in advance |
· DateAccountStarted | DateTime | |
· DateAccountClosed | DateTime | |
· DateAccountLoaded | DateTime | |
· LastUpdatedDate | DateTime | Date that the customer account or a related record was last updated |
· MinTermTotalValue | Decimal (10, 2) | Amount to be collected for the account (in terms of recurring payments) before the account is past its minimum term |
· OutstandingBalance | Decimal (10, 2) | For an open account this returns the amount remaining for the account to pay |
· OutstandingBalanceWithoutFees | Decimal (10, 2) | Outstanding balance without Debitsuccess establishment or penalty fees |
· AccountTemplate | Guid | OMG contract template unique-identifier |
· ProjectedFinishDate | DateTime | Calculated estimated time for the account finish date. This field is being calculated overnight. |
· CurrentBalance | Decimal (10, 2) | This returns the difference between what should have been paid at the current date vs the amount already paid. A positive amount means that the customer account is overdue and a negative amount means the account is in credit. |
· CurrentBalanceWithoutFees | Decimal (10, 2) | Current balance excluding Debitsuccess fees. |
· DSFeeSchedules ()** | ||
o StartDate** | DateTime? | |
o Installment** | Decimal? (10, 2) | |
o PaymentFrequency** | Enum | OneOff |
o PaymentCode** | Enum | DebtCallFee EstablishmentFee MiscellaneousFee PenaltyFee Service TransferFee |
o Description** | String | |
o ScheduleId** | int | Unique identifier |
· OneOffSchedules () | ||
o StartDate | DateTime? | |
o Installment | Decimal? (10, 2) | |
o PaymentFrequency | Enum | OneOff |
o Description | String | Description |
o ScheduleId | int | Unique identifier |
· RecurringSchedules () | ||
o StartDate | DateTime? | |
o EndDate | DateTime? | |
o Installment | Decimal? (10, 2) | |
o PaymentFrequency | Enum | Weekly, Fortnightly, FourWeekly, Monthly, BiMonthly, Quarterly |
o Description | String | |
o ScheduleId | int | Unique identifier |
· SuspensionSchedules () | ||
o StartDate | DateTime? | |
o EndDate | DateTime? | |
o Installment | Decimal? (10, 2) | |
o PaymentFrequency | Enum | OneOff, Weekly, Fortnightly, FourWeekly, Monthly, BiMonthly, Quarterly |
o Description | String | |
o ScheduleId | int | Unique identifier |
· Customer | ||
o CustomerDetail | ||
§ DateOfBirth | DateTime? | |
§ Gender | Enum | Male, Female, Unknown |
§ FirstName | String | |
§ MiddleName | String | |
§ LastName | String | |
§ Title | String | |
o Contacts | ContactDetails | |
§ Phones () |
| |
· PhoneNumberType | Enum | Home, Mobile, Work, Emergency, Previous |
· CountryCode | Enum | NotSpecified, Aus, NZ, USA |
· StdCode | String | |
· Number | String | |
· Preferred | Boolean | |
· Name | String | |
§ Emails () |
| |
· EmailAddress | String | |
· Preferred | Boolean | |
§ Addresses () |
| |
· AddressType | Enum | Home, Business, Physical, Postal, Previous |
· Street | String | |
· Suburb | String | |
· City | String | |
· State | Enum | |
· Postcode | String | |
· Country | Enum | NotSpecified, Australia, NewZealand, UnitedStatesOfAmerica |
· Locality | String | |
· Preferred | Boolean | Whether address is preferred (true or false) |
· Paymethod | ||
o AccountNo | String | |
o ExpiryDate | DateTime | |
o AccountHolder | String | |
o AccountType | Enum | BankAccount, CreditCard |
o CreditCardType | Enum | None, AmericanExpress, Mastercard, Visa |
**These values will only be returned by a separate call GetCustomerAccountWithFeesByAccountID. The request and the rest of the response message are exactly the same as GetCustomerAccountByAccountID.
Error Messages
Type | Error Code | Error Message |
---|---|---|
Error | 12016 | Missing required reference number. Must provide either ExternalAccountReferenceNo or AccountReferenceNo or both. |
Error | 07 | Multiple accounts found with this criteria |
Error | 08 | There is no record found with this criteria |
Error | 10 | Account is not active |
Related Pages
Filter by label
There are no items with the selected labels at this time.
On this page:
- No labels
Add Comment