Jump to

• Request
• Response
• Examples

Generate a Bill Unit Summary

post

/bcws/webresources/v1.0/billunits/bill-unit-summary

Create a summary of the bill units that match the specified IDs.

Request

Query Parameters

• id: string
  Account id

Supported Media Types

• application/xml
• application/json

Request Body - application/xml ()

Root Schema : schema

Type: array

Show Source

• Array of: object schema
  A bill unit.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/BillUnit"
    }
}

Nested Schema : schema

Type: object

A bill unit.

Show Source

• accountingCycleDom: integer (int32)
  The bill unit's accounting cycle day of month (DOM).
• accountingCycleEnd: string (date-time)
  The date and time the accounting cycle ends.
• accountingCycleStart: string (date-time)
  The date and time the accounting cycle starts.
• accountingCyclesUntilBillCycleEnds: integer (int32)
  The number of monthly accounting cycles remaining until the current billing cycle ends.
• accountingType: integer (int32)
  The bill unit's accounting type: open item (1) or balance forward (2).
• accountRef: object ResourceRef
• arBillUnitRef: object ResourceRef
• balanceGroups(required): array balanceGroups
• billForCurrentCycleRef: object ResourceRef
• billingCycleEnd: string (date-time)
  The date and time the billing cycle ends.
• billingCycleStart: string (date-time)
  The date and time the billing cycle starts
• billingFrequencyInMonths: integer (int32)
  The billing frequency in number of months. Can be one of the following:

  • 1: Monthly
  • 2: Bi-monthly
  • 3: Quarterly
  • 12: Yearly
• businessProfile(required): string
  The business profile associated with bill unit.
• collectionDate: string (date-time)
  The date collections is due.
• collectionDetailsRef: object ResourceRef
• correctiveInvoiceType: integer (int32)
  The type of invoice to create for corrective bills, such as an invoice correction letter or a replacement invoice.
• creationDate(required): string (date-time)
  The date and time the bill unit was created.
• currency: integer (int32)
  The bill unit's primary currency.
• currencySecondary: integer (int32)
  The bill unit's secondary currency.
• daysInBillCycle: integer (int32)
  The number of days in a billing cycle.
• daysRemainingInBillCycle: integer (int32)
  The number of days that remain in the current billing cycle.
• defaultBillUnit: boolean
  Whether this is the default bill unit (true) or not (false).
• exemptFromCollections: integer (int32)
  Whether the bill unit is exempt from collections or not.
• extension: object extension
  The extended attributes.
• id(required): string
  The ID.
• inCollections: boolean
  Whether the bill unit is in collections (true) or not (false).
• invoiceTemplate(required): string
  The name of the invoice template associated with the bill unit.
• lastActualBillDate: string (date-time)
  The date and time the last bill was created.
• lastActualBillRef: object ResourceRef
• lastBillFromBillingRef: object ResourceRef
• lastModified: string (date-time)
  The date and time the bill unit was last modified.
• name(required): string
  The bill unit's name.
• numSuppressedCycles: integer (int32)
  The number of consecutive billing cycles that the bill unit has been suppressed.
• parentAccountId(required): string
  The ID of this bill unit's parent account.
• parentAccountNumber(required): string
  The account number associated with the parent's bill unit.
• parentBillUnit: boolean
  Whether this is a parent bill unit (true) or not (false).
• parentBillUnitName(required): string
  The name of this bill unit's parent bill unit.
• parentCompanyName(required): string
  The parent bill unit's company name.
• parentFirstName(required): string
  The first name associated with the parent bill unit.
• parentLastName(required): string
  The last name associated with the parent bill unit.
• parentSalutation(required): string
  The parent bill unit's salutation, such as Mr. or Mx.
• paymentInstrumentName(required): string
  The name of the payment instrument.
• paymentInstrumentRef: object ResourceRef
• paymentMethod: object PaymentMethod
• paymentType: integer (int32)
  The payment type. Can be one of the following:

  • 10001:Invoice
  • 10003: Credit card
  • 10005: Direct debit
  • 10007: Subordinate
• rollUp: boolean
• scenarioRef: object ResourceRef
• segment: string
  The customer segment associated with the bill unit. A customer segment is a user-defined customer description that can be used to group accounts according to customer billing and payment practices.
• status: string
  The status of the bill unit: defunct (0), active (10100), inactive (10102), or closed (10103)
• suppressed: integer (int32)
  Whether the bill unit is suppressed or not.
• suppressionCyclesLeft: integer (int32)
  The number of consecutive billing cycles for which the bill is to be suppressed.
• totalChildAccounts: integer (int32)
  The total number of child accounts.
• wholesaleBilling(required): string
  The wholesale billing key.

{
    "required":[
        "balanceGroups",
        "businessProfile",
        "creationDate",
        "id",
        "invoiceTemplate",
        "name",
        "parentAccountId",
        "parentAccountNumber",
        "parentBillUnitName",
        "parentCompanyName",
        "parentFirstName",
        "parentLastName",
        "parentSalutation",
        "paymentInstrumentName",
        "wholesaleBilling"
    ],
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "name":{
            "type":"string",
            "description":"The bill unit's name."
        },
        "rollUp":{
            "type":"boolean"
        },
        "accountRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "accountingCycleDom":{
            "type":"integer",
            "description":"The bill unit's accounting cycle day of month (DOM).",
            "format":"int32"
        },
        "accountingType":{
            "type":"integer",
            "description":"The bill unit's accounting type: open item (<b>1</b>) or balance forward (<b>2</b>).",
            "format":"int32"
        },
        "balanceGroups":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/BalanceGroup"
            }
        },
        "paymentInstrumentRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "currency":{
            "type":"integer",
            "description":"The bill unit's primary currency.",
            "format":"int32"
        },
        "currencySecondary":{
            "type":"integer",
            "description":"The bill unit's secondary currency.",
            "format":"int32"
        },
        "status":{
            "type":"string",
            "description":"The status of the bill unit: defunct (<b>0</b>), active (<b>10100</b>), inactive (<b>10102</b>), or closed (<b>10103</b>)"
        },
        "arBillUnitRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "parentBillUnitName":{
            "type":"string",
            "description":"The name of this bill unit's parent bill unit."
        },
        "parentAccountId":{
            "type":"string",
            "description":"The ID of this bill unit's parent account."
        },
        "parentFirstName":{
            "type":"string",
            "description":"The first name associated with the parent bill unit."
        },
        "parentLastName":{
            "type":"string",
            "description":"The last name associated with the parent bill unit."
        },
        "parentCompanyName":{
            "type":"string",
            "description":"The parent bill unit's company name."
        },
        "parentSalutation":{
            "type":"string",
            "description":"The parent bill unit's salutation, such as Mr. or Mx."
        },
        "parentAccountNumber":{
            "type":"string",
            "description":"The account number associated with the parent's bill unit."
        },
        "invoiceTemplate":{
            "type":"string",
            "description":"The name of the invoice template associated with the bill unit."
        },
        "businessProfile":{
            "type":"string",
            "description":"The business profile associated with bill unit."
        },
        "wholesaleBilling":{
            "type":"string",
            "description":"The wholesale billing key."
        },
        "correctiveInvoiceType":{
            "type":"integer",
            "description":"The type of invoice to create for corrective bills, such as an invoice correction letter or a replacement invoice.",
            "format":"int32"
        },
        "lastModified":{
            "type":"string",
            "description":"The date and time the bill unit was last modified.",
            "format":"date-time"
        },
        "creationDate":{
            "type":"string",
            "description":"The date and time the bill unit was created.",
            "format":"date-time"
        },
        "accountingCyclesUntilBillCycleEnds":{
            "type":"integer",
            "description":"The number of monthly accounting cycles remaining until the current billing cycle ends.",
            "format":"int32"
        },
        "billForCurrentCycleRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "defaultBillUnit":{
            "type":"boolean",
            "description":"Whether this is the default bill unit (<b>true</b>) or not (<b>false</b>)."
        },
        "parentBillUnit":{
            "type":"boolean",
            "description":"Whether this is a parent bill unit (<b>true</b>) or not (<b>false</b>)."
        },
        "billingFrequencyInMonths":{
            "type":"integer",
            "description":"The billing frequency in number of months. Can be one of the following: <ul><li><b>1</b>: Monthly</li><li><b>2</b>: Bi-monthly</li><li><b>3</b>: Quarterly</li><li><b>12</b>: Yearly</li></ul>",
            "format":"int32"
        },
        "accountingCycleStart":{
            "type":"string",
            "description":"The date and time the accounting cycle starts.",
            "format":"date-time"
        },
        "accountingCycleEnd":{
            "type":"string",
            "description":"The date and time the accounting cycle ends.",
            "format":"date-time"
        },
        "lastActualBillRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "lastActualBillDate":{
            "type":"string",
            "description":"The date and time the last bill was created.",
            "format":"date-time"
        },
        "lastBillFromBillingRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "billingCycleStart":{
            "type":"string",
            "description":"The date and time the billing cycle starts",
            "format":"date-time"
        },
        "billingCycleEnd":{
            "type":"string",
            "description":"The date and time the billing cycle ends.",
            "format":"date-time"
        },
        "segment":{
            "type":"string",
            "description":"The customer segment associated with the bill unit. A customer segment is a user-defined customer description that can be used to group accounts according to customer billing and payment practices."
        },
        "daysInBillCycle":{
            "type":"integer",
            "description":"The number of days in a billing cycle.",
            "format":"int32"
        },
        "daysRemainingInBillCycle":{
            "type":"integer",
            "description":"The number of days that remain in the current billing cycle.",
            "format":"int32"
        },
        "exemptFromCollections":{
            "type":"integer",
            "description":"Whether the bill unit is exempt from collections or not.",
            "format":"int32"
        },
        "scenarioRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "numSuppressedCycles":{
            "type":"integer",
            "description":"The number of consecutive billing cycles that the bill unit has been suppressed.",
            "format":"int32"
        },
        "suppressed":{
            "type":"integer",
            "description":"Whether the bill unit is suppressed or not.",
            "format":"int32"
        },
        "suppressionCyclesLeft":{
            "type":"integer",
            "description":"The number of consecutive billing cycles for which the bill is to be suppressed.",
            "format":"int32"
        },
        "collectionDate":{
            "type":"string",
            "description":"The date collections is due.",
            "format":"date-time"
        },
        "paymentInstrumentName":{
            "type":"string",
            "description":"The name of the payment instrument."
        },
        "collectionDetailsRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "inCollections":{
            "type":"boolean",
            "description":"Whether the bill unit is in collections (<b>true</b>) or not (<b>false</b>)."
        },
        "paymentMethod":{
            "$ref":"#/components/schemas/PaymentMethod"
        },
        "paymentType":{
            "type":"integer",
            "description":"The payment type. Can be one of the following: <ul><li><b>10001</b>:Invoice</li><li><b>10003</b>: Credit card</li><li><b>10005</b>: Direct debit</li><li><b>10007</b>: Subordinate</li></ul>",
            "format":"int32"
        },
        "totalChildAccounts":{
            "type":"integer",
            "description":"The total number of child accounts.",
            "format":"int32"
        }
    },
    "description":"A bill unit.",
    "xml":{
        "name":"billUnit"
    }
}

Nested Schema : ResourceRef

Type: object

Show Source

• id(required): string
  The ID.
• uri: string
  The Uniform Resource Identifier (URI) associated with the resource.

{
    "required":[
        "id"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "uri":{
            "type":"string",
            "description":"The Uniform Resource Identifier (URI) associated with the resource."
        }
    }
}

Nested Schema : balanceGroups

Type: array

Show Source

• Array of: object BalanceGroup

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/BalanceGroup"
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : PaymentMethod

Type: object

Show Source

• creditCard: object CreditCardType
• directDebit: object DirectDebitType
• extension: object extension
  The extended attributes.
• invoice: object InvoiceType
• paymentType: integer (int32)
  The payment type. Can be one of the following:

  • 10001:Invoice
  • 10003: Credit card
  • 10005: Direct debit
  • 10007: Subordinate
• sepa: object SepaType

{
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "creditCard":{
            "$ref":"#/components/schemas/CreditCardType"
        },
        "directDebit":{
            "$ref":"#/components/schemas/DirectDebitType"
        },
        "invoice":{
            "$ref":"#/components/schemas/InvoiceType"
        },
        "sepa":{
            "$ref":"#/components/schemas/SepaType"
        },
        "paymentType":{
            "type":"integer",
            "description":"The payment type. Can be one of the following: <ul><li><b>10001</b>:Invoice</li><li><b>10003</b>: Credit card</li><li><b>10005</b>: Direct debit</li><li><b>10007</b>: Subordinate</li></ul>",
            "format":"int32"
        }
    }
}

Nested Schema : BalanceGroup

Type: object

Show Source

• balances: array balances
  The list of balances associated with the balance group.
• elem: integer (int32)
  The position of the entry in the array. For example, the first item in a list would have an elem value of 1.
• extension: object extension
  The extended attributes.
• id(required): string
  The ID.
• monitorType: string
  The monitoring group type. Allowed Values:

  • H_CE (Hierarchy Credit Exposure)
  • PR_CE (Payment Responsible Credit Exposure)
  • SUB_CE (Subscription Credit Exposure)
  • PR_RTCE (Payment Responsible Real-Time Credit Enforcement)
• name: string
  The name of the balance group.
• services: array services

{
    "required":[
        "id"
    ],
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "name":{
            "type":"string",
            "description":"The name of the balance group."
        },
        "services":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ServiceType"
            }
        },
        "monitorType":{
            "type":"string",
            "description":"The monitoring group type. Allowed Values: <ul><li><b>H_CE</b> (Hierarchy Credit Exposure)</li><li><b>PR_CE</b> (Payment Responsible Credit Exposure)</li><li><b>SUB_CE</b> (Subscription Credit Exposure)</li><li><b>PR_RTCE</b> (Payment Responsible Real-Time Credit Enforcement)</li></ul>"
        },
        "balances":{
            "type":"array",
            "description":"The list of balances associated with the balance group.",
            "items":{
                "$ref":"#/components/schemas/Balances"
            }
        },
        "elem":{
            "type":"integer",
            "description":"The position of the entry in the array. For example, the first item in a list would have an <b>elem</b> value of <b>1</b>.",
            "format":"int32",
            "xml":{
                "attribute":true
            }
        }
    }
}

Nested Schema : balances

Type: array

The list of balances associated with the balance group.

Show Source

• Array of: object Balances
  The list of balances associated with the balance group.

{
    "type":"array",
    "description":"The list of balances associated with the balance group.",
    "items":{
        "$ref":"#/components/schemas/Balances"
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : services

Type: array

Show Source

• Array of: object ServiceType

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/ServiceType"
    }
}

Nested Schema : Balances

Type: object

The list of balances associated with the balance group.

Show Source

• creditFloor: number
  The credit floor associated with the balance.
• creditLimit: number
  The credit limit associated with the balance.
• creditThresholds: integer (int32)
  The credit thresholds associated with the balance.
• creditThresholdsFixed: string
  The value at which to send a notification, such as 30 US dollars or 30 minutes.
• currentBalance(required): number
  The current balance.
• dynamicCreditFloor: boolean
  Whether to use a dynamic credit floor (true) or not (false). The default is false.
• expiredBeforeUsing: number
  The number of days until the balance expires.
• formattedCreditThresholds: string
  The balance percentage usage at which to notify the customer.
• loanThresholds: integer (int32)
  The percent-based threshold for offering a loan. If the customer's balance falls below this percent, they are notified and offered a loan.
• loanThresholdsFixed: string
  The fixed amount threshold for offering a loan. If the customer's balance falls below this amount, they are notified and offered a loan.
• modifyLimit: boolean
  Whether a credit limit is being modified by the request (true) or not (false).
• outstandingAmount(required): number
  An amount that the customer still owes, for loans or when they exceed their credit limit.
• overrideCreditLimit: integer (int32)
  Whether to override the credit limit. Allowed Values: 0 (Enforce Credit Limit) or 1 (Override credit limit).
• resourceId: integer (int32)
  The resource ID associated with the balance.
• subBalances: array subBalances
• tempCreditLimit: array tempCreditLimit

{
    "required":[
        "currentBalance",
        "outstandingAmount"
    ],
    "type":"object",
    "properties":{
        "modifyLimit":{
            "type":"boolean",
            "description":"Whether a credit limit is being modified by the request (<b>true</b>) or not (<b>false</b>)."
        },
        "currentBalance":{
            "type":"number",
            "description":"The current balance."
        },
        "dynamicCreditFloor":{
            "type":"boolean",
            "description":"Whether to use a dynamic credit floor (<b>true</b>) or not (<b>false</b>). The default is <b>false</b>."
        },
        "creditFloor":{
            "type":"number",
            "description":"The credit floor associated with the balance."
        },
        "creditLimit":{
            "type":"number",
            "description":"The credit limit associated with the balance."
        },
        "overrideCreditLimit":{
            "type":"integer",
            "description":"Whether to override the credit limit. Allowed Values: <b>0</b> (Enforce Credit Limit) or <b>1</b> (Override credit limit).",
            "format":"int32"
        },
        "creditThresholds":{
            "type":"integer",
            "description":"The credit thresholds associated with the balance.",
            "format":"int32"
        },
        "formattedCreditThresholds":{
            "type":"string",
            "description":"The balance percentage usage at which to notify the customer."
        },
        "creditThresholdsFixed":{
            "type":"string",
            "description":"The value at which to send a notification, such as 30 US dollars or 30 minutes."
        },
        "expiredBeforeUsing":{
            "type":"number",
            "description":"The number of days until the balance expires."
        },
        "subBalances":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/SubBalances"
            }
        },
        "outstandingAmount":{
            "type":"number",
            "description":"An amount that the customer still owes, for loans or when they exceed their credit limit."
        },
        "loanThresholds":{
            "type":"integer",
            "description":"The percent-based threshold for offering a loan. If the customer's balance falls below this percent, they are notified and offered a loan.",
            "format":"int32"
        },
        "loanThresholdsFixed":{
            "type":"string",
            "description":"The fixed amount threshold for offering a loan. If the customer's balance falls below this amount, they are notified and offered a loan."
        },
        "tempCreditLimit":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/TempCreditLimit"
            }
        },
        "resourceId":{
            "type":"integer",
            "description":"The resource ID associated with the balance.",
            "format":"int32",
            "xml":{
                "attribute":true
            }
        }
    },
    "description":"The list of balances associated with the balance group."
}

Nested Schema : subBalances

Type: array

Show Source

• Array of: object SubBalances

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/SubBalances"
    }
}

Nested Schema : tempCreditLimit

Type: array

Show Source

• Array of: object TempCreditLimit

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/TempCreditLimit"
    }
}

Nested Schema : SubBalances

Type: object

Show Source

• currentBalance: number
  The current amount of the sub-balance.
• elementId: integer (int32)
  The ID of the element.
• expiredBeforeUsing: number
  The number of days until the sub-balance expires.
• extension: object extension
  The extended attributes.
• rolloverData: integer (int32)
  Details about a rollover subbalance.
• validFrom: string (date-time)
  The date and time the validity period starts.
• validTo: string (date-time)
  The date and time the validity period ends.

{
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "currentBalance":{
            "type":"number",
            "description":"The current amount of the sub-balance."
        },
        "validFrom":{
            "type":"string",
            "description":"The date and time the validity period starts.",
            "format":"date-time"
        },
        "validTo":{
            "type":"string",
            "description":"The date and time the validity period ends.",
            "format":"date-time"
        },
        "rolloverData":{
            "type":"integer",
            "description":"Details about a rollover subbalance.",
            "format":"int32"
        },
        "expiredBeforeUsing":{
            "type":"number",
            "description":"The number of days until the sub-balance expires."
        },
        "elementId":{
            "type":"integer",
            "description":"The ID of the element.",
            "format":"int32"
        }
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : TempCreditLimit

Type: object

Show Source

• extension: object extension
  The extended attributes.
• limit: number
  The temporary credit limit amount.
• resourceId: integer (int32)
  The resource ID associated with the temporary credit limit.
• validFrom(required): string (date-time)
  The date and time temporary credit limit's validity starts.
• validFromOffset: integer (int32)
  The offset for the temporary credit limit's validity period start.
• validFromUnit: integer (int32)
  The unit for the temporary credit limit's validity period start.
• validTo(required): string (date-time)
  The date and time temporary credit limit's validity ends.
• validToOffset: integer (int32)
  The offset for the temporary credit limit's validity period end.
• validToUnit: integer (int32)
  The unit for the temporary credit limit's validity period end.

{
    "required":[
        "validFrom",
        "validTo"
    ],
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "limit":{
            "type":"number",
            "description":"The temporary credit limit amount."
        },
        "resourceId":{
            "type":"integer",
            "description":"The resource ID associated with the temporary credit limit.",
            "format":"int32"
        },
        "validTo":{
            "type":"string",
            "description":"The date and time temporary credit limit's validity ends.",
            "format":"date-time"
        },
        "validFrom":{
            "type":"string",
            "description":"The date and time temporary credit limit's validity starts.",
            "format":"date-time"
        },
        "validToUnit":{
            "type":"integer",
            "description":"The unit for the temporary credit limit's validity period end.",
            "format":"int32"
        },
        "validToOffset":{
            "type":"integer",
            "description":"The offset for the temporary credit limit's validity period end.",
            "format":"int32"
        },
        "validFromUnit":{
            "type":"integer",
            "description":"The unit for the temporary credit limit's validity period start.",
            "format":"int32"
        },
        "validFromOffset":{
            "type":"integer",
            "description":"The offset for the temporary credit limit's validity period start.",
            "format":"int32"
        }
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : ServiceType

Type: object

Show Source

• accountRef: object ResourceRef
• aliasList: array aliasList
  The list of aliases associated with the service.
• balanceGroupRef: object ResourceRef
• balGrpIndex: integer (int32)
  The balance group index.
• creationDate: string (date-time)
  The date and time the service type was created.
• effectiveDate: string (date-time)
• extension: object extension
  The extended attributes.
• id: object ResourceRef
• lastModified: string (date-time)
  The date and time the service was last modified.
• lastStatusChange: string (date-time)
  The date and time of the last status change.
• lastStatusComment: string
  The comment associated with the last status change.
• lifeCycleState: integer (int32)
  The current life cycle state.
• login(required): string
  The login associated with the service.
• name: string
  The name of the service.
• nameinfoObj: object ResourceRef
• password(required): string
  The password associated with the service.
• passwordExpiration: string (date-time)
  The date and time the password expires.
• passwordStatus: integer (int32)
  The current status of the password.
• pendingDeferredActionsCount: integer (int32)
  The number of deferred actions that are pending for the service.
• serviceAccessLevel: string
  The service access level.
• status: integer (int32)
  The status.
• statusFlags: integer (int32)
  The status flags.
• subscriptionServiceRef: object ResourceRef
• svcExpLastNotiOffset: string
  The notification offset.
• svcExpLastNotiT: string (date-time)
  The last notification time.

{
    "required":[
        "login",
        "password"
    ],
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "pendingDeferredActionsCount":{
            "type":"integer",
            "description":"The number of deferred actions that are pending for the service.",
            "format":"int32"
        },
        "accountRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "aliasList":{
            "type":"array",
            "description":"The list of aliases associated with the service.",
            "items":{
                "$ref":"#/components/schemas/AliasList"
            }
        },
        "balanceGroupRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "creationDate":{
            "type":"string",
            "description":"The date and time the service type was created.",
            "format":"date-time"
        },
        "effectiveDate":{
            "type":"string",
            "format":"date-time"
        },
        "lastStatusComment":{
            "type":"string",
            "description":"The comment associated with the last status change."
        },
        "lastStatusChange":{
            "type":"string",
            "description":"The date and time of the last status change.",
            "format":"date-time"
        },
        "login":{
            "type":"string",
            "description":"The login associated with the service."
        },
        "lifeCycleState":{
            "type":"integer",
            "description":"The current life cycle state.",
            "format":"int32"
        },
        "lastModified":{
            "type":"string",
            "description":"The date and time the service was last modified.",
            "format":"date-time"
        },
        "name":{
            "type":"string",
            "description":"The name of the service."
        },
        "password":{
            "type":"string",
            "description":"The password associated with the service."
        },
        "passwordExpiration":{
            "type":"string",
            "description":"The date and time the password expires.",
            "format":"date-time"
        },
        "passwordStatus":{
            "type":"integer",
            "description":"The current status of the password.",
            "format":"int32"
        },
        "status":{
            "type":"integer",
            "description":"The status.",
            "format":"int32"
        },
        "statusFlags":{
            "type":"integer",
            "description":"The status flags.",
            "format":"int32"
        },
        "subscriptionServiceRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "serviceAccessLevel":{
            "type":"string",
            "description":"The service access level."
        },
        "balGrpIndex":{
            "type":"integer",
            "description":"The balance group index.",
            "format":"int32"
        },
        "nameinfoObj":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "svcExpLastNotiOffset":{
            "type":"string",
            "description":"The notification offset."
        },
        "svcExpLastNotiT":{
            "type":"string",
            "description":"The last notification time.",
            "format":"date-time"
        }
    }
}

Nested Schema : aliasList

Type: array

The list of aliases associated with the service.

Show Source

• Array of: object AliasList
  The list of aliases associated with the service.

{
    "type":"array",
    "description":"The list of aliases associated with the service.",
    "items":{
        "$ref":"#/components/schemas/AliasList"
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : AliasList

Type: object

The list of aliases associated with the service.

Show Source

• elem: integer (int32)
• name: string

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string"
        },
        "elem":{
            "type":"integer",
            "format":"int32",
            "xml":{
                "attribute":true
            }
        }
    },
    "description":"The list of aliases associated with the service."
}

Nested Schema : CreditCardType

Type: object

Show Source

• accountRef: object ResourceRef
• correctiveInvoiceType: integer (int32)
  The type of invoice to create, such as an invoice correction letter or a replacement invoice.
• details: object Details
  The offer details.
• extension: object extension
  The extended attributes.
• id: string
  The ID.
• name: string
  The payment instrument's name.
• paymentType: integer (int32)
  The payment type. Can be one of the following:

  • 10001:Invoice
  • 10003: Credit card
  • 10005: Direct debit
  • 10007: Subordinate

{
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "name":{
            "type":"string",
            "description":"The payment instrument's name."
        },
        "paymentType":{
            "type":"integer",
            "description":"The payment type. Can be one of the following: <ul><li><b>10001</b>:Invoice</li><li><b>10003</b>: Credit card</li><li><b>10005</b>: Direct debit</li><li><b>10007</b>: Subordinate</li></ul>",
            "format":"int32"
        },
        "accountRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "correctiveInvoiceType":{
            "type":"integer",
            "description":"The type of invoice to create, such as an invoice correction letter or a replacement invoice.",
            "format":"int32"
        },
        "details":{
            "$ref":"#/components/schemas/Details"
        }
    }
}

Nested Schema : DirectDebitType

Type: object

Show Source

• accountRef: object ResourceRef
• correctiveInvoiceType: integer (int32)
  The type of invoice to create, such as an invoice correction letter or a replacement invoice.
• details: object Details
  The offer details.
• extension: object extension
  The extended attributes.
• id: string
  The ID.
• name: string
  The payment instrument's name.
• paymentType: integer (int32)
  The payment type. Can be one of the following:

  • 10001:Invoice
  • 10003: Credit card
  • 10005: Direct debit
  • 10007: Subordinate

{
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "name":{
            "type":"string",
            "description":"The payment instrument's name."
        },
        "paymentType":{
            "type":"integer",
            "description":"The payment type. Can be one of the following: <ul><li><b>10001</b>:Invoice</li><li><b>10003</b>: Credit card</li><li><b>10005</b>: Direct debit</li><li><b>10007</b>: Subordinate</li></ul>",
            "format":"int32"
        },
        "accountRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "correctiveInvoiceType":{
            "type":"integer",
            "description":"The type of invoice to create, such as an invoice correction letter or a replacement invoice.",
            "format":"int32"
        },
        "details":{
            "$ref":"#/components/schemas/Details"
        }
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : InvoiceType

Type: object

Show Source

• accountRef: object ResourceRef
• correctiveInvoiceType: integer (int32)
  The type of invoice to create, such as an invoice correction letter or a replacement invoice.
• details: object Details
  The offer details.
• extension: object extension
  The extended attributes.
• id: string
  The ID.
• name: string
  The payment instrument's name.
• paymentType: integer (int32)
  The payment type. Can be one of the following:

  • 10001:Invoice
  • 10003: Credit card
  • 10005: Direct debit
  • 10007: Subordinate

{
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "name":{
            "type":"string",
            "description":"The payment instrument's name."
        },
        "paymentType":{
            "type":"integer",
            "description":"The payment type. Can be one of the following: <ul><li><b>10001</b>:Invoice</li><li><b>10003</b>: Credit card</li><li><b>10005</b>: Direct debit</li><li><b>10007</b>: Subordinate</li></ul>",
            "format":"int32"
        },
        "accountRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "correctiveInvoiceType":{
            "type":"integer",
            "description":"The type of invoice to create, such as an invoice correction letter or a replacement invoice.",
            "format":"int32"
        },
        "details":{
            "$ref":"#/components/schemas/Details"
        }
    }
}

Nested Schema : SepaType

Type: object

Show Source

• accountRef: object ResourceRef
• correctiveInvoiceType: integer (int32)
  The type of invoice to create, such as an invoice correction letter or a replacement invoice.
• details: object Details
  The offer details.
• extension: object extension
  The extended attributes.
• id: string
  The ID.
• name: string
  The payment instrument's name.
• paymentType: integer (int32)
  The payment type. Can be one of the following:

  • 10001:Invoice
  • 10003: Credit card
  • 10005: Direct debit
  • 10007: Subordinate

{
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "name":{
            "type":"string",
            "description":"The payment instrument's name."
        },
        "paymentType":{
            "type":"integer",
            "description":"The payment type. Can be one of the following: <ul><li><b>10001</b>:Invoice</li><li><b>10003</b>: Credit card</li><li><b>10005</b>: Direct debit</li><li><b>10007</b>: Subordinate</li></ul>",
            "format":"int32"
        },
        "accountRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "correctiveInvoiceType":{
            "type":"integer",
            "description":"The type of invoice to create, such as an invoice correction letter or a replacement invoice.",
            "format":"int32"
        },
        "details":{
            "$ref":"#/components/schemas/Details"
        }
    }
}

Nested Schema : Details

Type: object

The offer details.

Show Source

• balanceImpactResource(required): string
  The resource that represents the balance impact of the offer.
• fixedAmount: number (float)
  The fixed amount of the offer.
• fixedPriceTag(required): string
  The fixed price tag of the offer.
• scaledAmount: number (float)
  The scaled amount of the offer.
• scaledPriceTag(required): string
  The scaled price tag of the offer.

{
    "required":[
        "balanceImpactResource",
        "fixedPriceTag",
        "scaledPriceTag"
    ],
    "type":"object",
    "properties":{
        "balanceImpactResource":{
            "type":"string",
            "description":"The resource that represents the balance impact of the offer."
        },
        "fixedAmount":{
            "type":"number",
            "description":"The fixed amount of the offer.",
            "format":"float"
        },
        "scaledAmount":{
            "type":"number",
            "description":"The scaled amount of the offer.",
            "format":"float"
        },
        "fixedPriceTag":{
            "type":"string",
            "description":"The fixed price tag of the offer."
        },
        "scaledPriceTag":{
            "type":"string",
            "description":"The scaled price tag of the offer."
        }
    },
    "description":"The offer details."
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : extension

Type: object

The extended attributes.

Request Body - application/json ()

Root Schema : schema

Type: array

Show Source

• Array of: object schema
  A bill unit.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/BillUnit"
    }
}

Nested Schema : schema

Type: object

A bill unit.

Show Source

• accountingCycleDom: integer (int32)
  The bill unit's accounting cycle day of month (DOM).
• accountingCycleEnd: string (date-time)
  The date and time the accounting cycle ends.
• accountingCycleStart: string (date-time)
  The date and time the accounting cycle starts.
• accountingCyclesUntilBillCycleEnds: integer (int32)
  The number of monthly accounting cycles remaining until the current billing cycle ends.
• accountingType: integer (int32)
  The bill unit's accounting type: open item (1) or balance forward (2).
• accountRef: object ResourceRef
• arBillUnitRef: object ResourceRef
• balanceGroups(required): array balanceGroups
• billForCurrentCycleRef: object ResourceRef
• billingCycleEnd: string (date-time)
  The date and time the billing cycle ends.
• billingCycleStart: string (date-time)
  The date and time the billing cycle starts
• billingFrequencyInMonths: integer (int32)
  The billing frequency in number of months. Can be one of the following:

  • 1: Monthly
  • 2: Bi-monthly
  • 3: Quarterly
  • 12: Yearly
• businessProfile(required): string
  The business profile associated with bill unit.
• collectionDate: string (date-time)
  The date collections is due.
• collectionDetailsRef: object ResourceRef
• correctiveInvoiceType: integer (int32)
  The type of invoice to create for corrective bills, such as an invoice correction letter or a replacement invoice.
• creationDate(required): string (date-time)
  The date and time the bill unit was created.
• currency: integer (int32)
  The bill unit's primary currency.
• currencySecondary: integer (int32)
  The bill unit's secondary currency.
• daysInBillCycle: integer (int32)
  The number of days in a billing cycle.
• daysRemainingInBillCycle: integer (int32)
  The number of days that remain in the current billing cycle.
• defaultBillUnit: boolean
  Whether this is the default bill unit (true) or not (false).
• exemptFromCollections: integer (int32)
  Whether the bill unit is exempt from collections or not.
• extension: object extension
  The extended attributes.
• id(required): string
  The ID.
• inCollections: boolean
  Whether the bill unit is in collections (true) or not (false).
• invoiceTemplate(required): string
  The name of the invoice template associated with the bill unit.
• lastActualBillDate: string (date-time)
  The date and time the last bill was created.
• lastActualBillRef: object ResourceRef
• lastBillFromBillingRef: object ResourceRef
• lastModified: string (date-time)
  The date and time the bill unit was last modified.
• name(required): string
  The bill unit's name.
• numSuppressedCycles: integer (int32)
  The number of consecutive billing cycles that the bill unit has been suppressed.
• parentAccountId(required): string
  The ID of this bill unit's parent account.
• parentAccountNumber(required): string
  The account number associated with the parent's bill unit.
• parentBillUnit: boolean
  Whether this is a parent bill unit (true) or not (false).
• parentBillUnitName(required): string
  The name of this bill unit's parent bill unit.
• parentCompanyName(required): string
  The parent bill unit's company name.
• parentFirstName(required): string
  The first name associated with the parent bill unit.
• parentLastName(required): string
  The last name associated with the parent bill unit.
• parentSalutation(required): string
  The parent bill unit's salutation, such as Mr. or Mx.
• paymentInstrumentName(required): string
  The name of the payment instrument.
• paymentInstrumentRef: object ResourceRef
• paymentMethod: object PaymentMethod
• paymentType: integer (int32)
  The payment type. Can be one of the following:

  • 10001:Invoice
  • 10003: Credit card
  • 10005: Direct debit
  • 10007: Subordinate
• rollUp: boolean
• scenarioRef: object ResourceRef
• segment: string
  The customer segment associated with the bill unit. A customer segment is a user-defined customer description that can be used to group accounts according to customer billing and payment practices.
• status: string
  The status of the bill unit: defunct (0), active (10100), inactive (10102), or closed (10103)
• suppressed: integer (int32)
  Whether the bill unit is suppressed or not.
• suppressionCyclesLeft: integer (int32)
  The number of consecutive billing cycles for which the bill is to be suppressed.
• totalChildAccounts: integer (int32)
  The total number of child accounts.
• wholesaleBilling(required): string
  The wholesale billing key.

{
    "required":[
        "balanceGroups",
        "businessProfile",
        "creationDate",
        "id",
        "invoiceTemplate",
        "name",
        "parentAccountId",
        "parentAccountNumber",
        "parentBillUnitName",
        "parentCompanyName",
        "parentFirstName",
        "parentLastName",
        "parentSalutation",
        "paymentInstrumentName",
        "wholesaleBilling"
    ],
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "name":{
            "type":"string",
            "description":"The bill unit's name."
        },
        "rollUp":{
            "type":"boolean"
        },
        "accountRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "accountingCycleDom":{
            "type":"integer",
            "description":"The bill unit's accounting cycle day of month (DOM).",
            "format":"int32"
        },
        "accountingType":{
            "type":"integer",
            "description":"The bill unit's accounting type: open item (<b>1</b>) or balance forward (<b>2</b>).",
            "format":"int32"
        },
        "balanceGroups":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/BalanceGroup"
            }
        },
        "paymentInstrumentRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "currency":{
            "type":"integer",
            "description":"The bill unit's primary currency.",
            "format":"int32"
        },
        "currencySecondary":{
            "type":"integer",
            "description":"The bill unit's secondary currency.",
            "format":"int32"
        },
        "status":{
            "type":"string",
            "description":"The status of the bill unit: defunct (<b>0</b>), active (<b>10100</b>), inactive (<b>10102</b>), or closed (<b>10103</b>)"
        },
        "arBillUnitRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "parentBillUnitName":{
            "type":"string",
            "description":"The name of this bill unit's parent bill unit."
        },
        "parentAccountId":{
            "type":"string",
            "description":"The ID of this bill unit's parent account."
        },
        "parentFirstName":{
            "type":"string",
            "description":"The first name associated with the parent bill unit."
        },
        "parentLastName":{
            "type":"string",
            "description":"The last name associated with the parent bill unit."
        },
        "parentCompanyName":{
            "type":"string",
            "description":"The parent bill unit's company name."
        },
        "parentSalutation":{
            "type":"string",
            "description":"The parent bill unit's salutation, such as Mr. or Mx."
        },
        "parentAccountNumber":{
            "type":"string",
            "description":"The account number associated with the parent's bill unit."
        },
        "invoiceTemplate":{
            "type":"string",
            "description":"The name of the invoice template associated with the bill unit."
        },
        "businessProfile":{
            "type":"string",
            "description":"The business profile associated with bill unit."
        },
        "wholesaleBilling":{
            "type":"string",
            "description":"The wholesale billing key."
        },
        "correctiveInvoiceType":{
            "type":"integer",
            "description":"The type of invoice to create for corrective bills, such as an invoice correction letter or a replacement invoice.",
            "format":"int32"
        },
        "lastModified":{
            "type":"string",
            "description":"The date and time the bill unit was last modified.",
            "format":"date-time"
        },
        "creationDate":{
            "type":"string",
            "description":"The date and time the bill unit was created.",
            "format":"date-time"
        },
        "accountingCyclesUntilBillCycleEnds":{
            "type":"integer",
            "description":"The number of monthly accounting cycles remaining until the current billing cycle ends.",
            "format":"int32"
        },
        "billForCurrentCycleRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "defaultBillUnit":{
            "type":"boolean",
            "description":"Whether this is the default bill unit (<b>true</b>) or not (<b>false</b>)."
        },
        "parentBillUnit":{
            "type":"boolean",
            "description":"Whether this is a parent bill unit (<b>true</b>) or not (<b>false</b>)."
        },
        "billingFrequencyInMonths":{
            "type":"integer",
            "description":"The billing frequency in number of months. Can be one of the following: <ul><li><b>1</b>: Monthly</li><li><b>2</b>: Bi-monthly</li><li><b>3</b>: Quarterly</li><li><b>12</b>: Yearly</li></ul>",
            "format":"int32"
        },
        "accountingCycleStart":{
            "type":"string",
            "description":"The date and time the accounting cycle starts.",
            "format":"date-time"
        },
        "accountingCycleEnd":{
            "type":"string",
            "description":"The date and time the accounting cycle ends.",
            "format":"date-time"
        },
        "lastActualBillRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "lastActualBillDate":{
            "type":"string",
            "description":"The date and time the last bill was created.",
            "format":"date-time"
        },
        "lastBillFromBillingRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "billingCycleStart":{
            "type":"string",
            "description":"The date and time the billing cycle starts",
            "format":"date-time"
        },
        "billingCycleEnd":{
            "type":"string",
            "description":"The date and time the billing cycle ends.",
            "format":"date-time"
        },
        "segment":{
            "type":"string",
            "description":"The customer segment associated with the bill unit. A customer segment is a user-defined customer description that can be used to group accounts according to customer billing and payment practices."
        },
        "daysInBillCycle":{
            "type":"integer",
            "description":"The number of days in a billing cycle.",
            "format":"int32"
        },
        "daysRemainingInBillCycle":{
            "type":"integer",
            "description":"The number of days that remain in the current billing cycle.",
            "format":"int32"
        },
        "exemptFromCollections":{
            "type":"integer",
            "description":"Whether the bill unit is exempt from collections or not.",
            "format":"int32"
        },
        "scenarioRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "numSuppressedCycles":{
            "type":"integer",
            "description":"The number of consecutive billing cycles that the bill unit has been suppressed.",
            "format":"int32"
        },
        "suppressed":{
            "type":"integer",
            "description":"Whether the bill unit is suppressed or not.",
            "format":"int32"
        },
        "suppressionCyclesLeft":{
            "type":"integer",
            "description":"The number of consecutive billing cycles for which the bill is to be suppressed.",
            "format":"int32"
        },
        "collectionDate":{
            "type":"string",
            "description":"The date collections is due.",
            "format":"date-time"
        },
        "paymentInstrumentName":{
            "type":"string",
            "description":"The name of the payment instrument."
        },
        "collectionDetailsRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "inCollections":{
            "type":"boolean",
            "description":"Whether the bill unit is in collections (<b>true</b>) or not (<b>false</b>)."
        },
        "paymentMethod":{
            "$ref":"#/components/schemas/PaymentMethod"
        },
        "paymentType":{
            "type":"integer",
            "description":"The payment type. Can be one of the following: <ul><li><b>10001</b>:Invoice</li><li><b>10003</b>: Credit card</li><li><b>10005</b>: Direct debit</li><li><b>10007</b>: Subordinate</li></ul>",
            "format":"int32"
        },
        "totalChildAccounts":{
            "type":"integer",
            "description":"The total number of child accounts.",
            "format":"int32"
        }
    },
    "description":"A bill unit.",
    "xml":{
        "name":"billUnit"
    }
}

Nested Schema : ResourceRef

Type: object

Show Source

• id(required): string
  The ID.
• uri: string
  The Uniform Resource Identifier (URI) associated with the resource.

{
    "required":[
        "id"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "uri":{
            "type":"string",
            "description":"The Uniform Resource Identifier (URI) associated with the resource."
        }
    }
}

Nested Schema : balanceGroups

Type: array

Show Source

• Array of: object BalanceGroup

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/BalanceGroup"
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : PaymentMethod

Type: object

Show Source

• creditCard: object CreditCardType
• directDebit: object DirectDebitType
• extension: object extension
  The extended attributes.
• invoice: object InvoiceType
• paymentType: integer (int32)
  The payment type. Can be one of the following:

  • 10001:Invoice
  • 10003: Credit card
  • 10005: Direct debit
  • 10007: Subordinate
• sepa: object SepaType

{
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "creditCard":{
            "$ref":"#/components/schemas/CreditCardType"
        },
        "directDebit":{
            "$ref":"#/components/schemas/DirectDebitType"
        },
        "invoice":{
            "$ref":"#/components/schemas/InvoiceType"
        },
        "sepa":{
            "$ref":"#/components/schemas/SepaType"
        },
        "paymentType":{
            "type":"integer",
            "description":"The payment type. Can be one of the following: <ul><li><b>10001</b>:Invoice</li><li><b>10003</b>: Credit card</li><li><b>10005</b>: Direct debit</li><li><b>10007</b>: Subordinate</li></ul>",
            "format":"int32"
        }
    }
}

Nested Schema : BalanceGroup

Type: object

Show Source

• balances: array balances
  The list of balances associated with the balance group.
• elem: integer (int32)
  The position of the entry in the array. For example, the first item in a list would have an elem value of 1.
• extension: object extension
  The extended attributes.
• id(required): string
  The ID.
• monitorType: string
  The monitoring group type. Allowed Values:

  • H_CE (Hierarchy Credit Exposure)
  • PR_CE (Payment Responsible Credit Exposure)
  • SUB_CE (Subscription Credit Exposure)
  • PR_RTCE (Payment Responsible Real-Time Credit Enforcement)
• name: string
  The name of the balance group.
• services: array services

{
    "required":[
        "id"
    ],
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "name":{
            "type":"string",
            "description":"The name of the balance group."
        },
        "services":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ServiceType"
            }
        },
        "monitorType":{
            "type":"string",
            "description":"The monitoring group type. Allowed Values: <ul><li><b>H_CE</b> (Hierarchy Credit Exposure)</li><li><b>PR_CE</b> (Payment Responsible Credit Exposure)</li><li><b>SUB_CE</b> (Subscription Credit Exposure)</li><li><b>PR_RTCE</b> (Payment Responsible Real-Time Credit Enforcement)</li></ul>"
        },
        "balances":{
            "type":"array",
            "description":"The list of balances associated with the balance group.",
            "items":{
                "$ref":"#/components/schemas/Balances"
            }
        },
        "elem":{
            "type":"integer",
            "description":"The position of the entry in the array. For example, the first item in a list would have an <b>elem</b> value of <b>1</b>.",
            "format":"int32",
            "xml":{
                "attribute":true
            }
        }
    }
}

Nested Schema : balances

Type: array

The list of balances associated with the balance group.

Show Source

• Array of: object Balances
  The list of balances associated with the balance group.

{
    "type":"array",
    "description":"The list of balances associated with the balance group.",
    "items":{
        "$ref":"#/components/schemas/Balances"
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : services

Type: array

Show Source

• Array of: object ServiceType

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/ServiceType"
    }
}

Nested Schema : Balances

Type: object

The list of balances associated with the balance group.

Show Source

• creditFloor: number
  The credit floor associated with the balance.
• creditLimit: number
  The credit limit associated with the balance.
• creditThresholds: integer (int32)
  The credit thresholds associated with the balance.
• creditThresholdsFixed: string
  The value at which to send a notification, such as 30 US dollars or 30 minutes.
• currentBalance(required): number
  The current balance.
• dynamicCreditFloor: boolean
  Whether to use a dynamic credit floor (true) or not (false). The default is false.
• expiredBeforeUsing: number
  The number of days until the balance expires.
• formattedCreditThresholds: string
  The balance percentage usage at which to notify the customer.
• loanThresholds: integer (int32)
  The percent-based threshold for offering a loan. If the customer's balance falls below this percent, they are notified and offered a loan.
• loanThresholdsFixed: string
  The fixed amount threshold for offering a loan. If the customer's balance falls below this amount, they are notified and offered a loan.
• modifyLimit: boolean
  Whether a credit limit is being modified by the request (true) or not (false).
• outstandingAmount(required): number
  An amount that the customer still owes, for loans or when they exceed their credit limit.
• overrideCreditLimit: integer (int32)
  Whether to override the credit limit. Allowed Values: 0 (Enforce Credit Limit) or 1 (Override credit limit).
• resourceId: integer (int32)
  The resource ID associated with the balance.
• subBalances: array subBalances
• tempCreditLimit: array tempCreditLimit

{
    "required":[
        "currentBalance",
        "outstandingAmount"
    ],
    "type":"object",
    "properties":{
        "modifyLimit":{
            "type":"boolean",
            "description":"Whether a credit limit is being modified by the request (<b>true</b>) or not (<b>false</b>)."
        },
        "currentBalance":{
            "type":"number",
            "description":"The current balance."
        },
        "dynamicCreditFloor":{
            "type":"boolean",
            "description":"Whether to use a dynamic credit floor (<b>true</b>) or not (<b>false</b>). The default is <b>false</b>."
        },
        "creditFloor":{
            "type":"number",
            "description":"The credit floor associated with the balance."
        },
        "creditLimit":{
            "type":"number",
            "description":"The credit limit associated with the balance."
        },
        "overrideCreditLimit":{
            "type":"integer",
            "description":"Whether to override the credit limit. Allowed Values: <b>0</b> (Enforce Credit Limit) or <b>1</b> (Override credit limit).",
            "format":"int32"
        },
        "creditThresholds":{
            "type":"integer",
            "description":"The credit thresholds associated with the balance.",
            "format":"int32"
        },
        "formattedCreditThresholds":{
            "type":"string",
            "description":"The balance percentage usage at which to notify the customer."
        },
        "creditThresholdsFixed":{
            "type":"string",
            "description":"The value at which to send a notification, such as 30 US dollars or 30 minutes."
        },
        "expiredBeforeUsing":{
            "type":"number",
            "description":"The number of days until the balance expires."
        },
        "subBalances":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/SubBalances"
            }
        },
        "outstandingAmount":{
            "type":"number",
            "description":"An amount that the customer still owes, for loans or when they exceed their credit limit."
        },
        "loanThresholds":{
            "type":"integer",
            "description":"The percent-based threshold for offering a loan. If the customer's balance falls below this percent, they are notified and offered a loan.",
            "format":"int32"
        },
        "loanThresholdsFixed":{
            "type":"string",
            "description":"The fixed amount threshold for offering a loan. If the customer's balance falls below this amount, they are notified and offered a loan."
        },
        "tempCreditLimit":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/TempCreditLimit"
            }
        },
        "resourceId":{
            "type":"integer",
            "description":"The resource ID associated with the balance.",
            "format":"int32",
            "xml":{
                "attribute":true
            }
        }
    },
    "description":"The list of balances associated with the balance group."
}

Nested Schema : subBalances

Type: array

Show Source

• Array of: object SubBalances

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/SubBalances"
    }
}

Nested Schema : tempCreditLimit

Type: array

Show Source

• Array of: object TempCreditLimit

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/TempCreditLimit"
    }
}

Nested Schema : SubBalances

Type: object

Show Source

• currentBalance: number
  The current amount of the sub-balance.
• elementId: integer (int32)
  The ID of the element.
• expiredBeforeUsing: number
  The number of days until the sub-balance expires.
• extension: object extension
  The extended attributes.
• rolloverData: integer (int32)
  Details about a rollover subbalance.
• validFrom: string (date-time)
  The date and time the validity period starts.
• validTo: string (date-time)
  The date and time the validity period ends.

{
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "currentBalance":{
            "type":"number",
            "description":"The current amount of the sub-balance."
        },
        "validFrom":{
            "type":"string",
            "description":"The date and time the validity period starts.",
            "format":"date-time"
        },
        "validTo":{
            "type":"string",
            "description":"The date and time the validity period ends.",
            "format":"date-time"
        },
        "rolloverData":{
            "type":"integer",
            "description":"Details about a rollover subbalance.",
            "format":"int32"
        },
        "expiredBeforeUsing":{
            "type":"number",
            "description":"The number of days until the sub-balance expires."
        },
        "elementId":{
            "type":"integer",
            "description":"The ID of the element.",
            "format":"int32"
        }
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : TempCreditLimit

Type: object

Show Source

• extension: object extension
  The extended attributes.
• limit: number
  The temporary credit limit amount.
• resourceId: integer (int32)
  The resource ID associated with the temporary credit limit.
• validFrom(required): string (date-time)
  The date and time temporary credit limit's validity starts.
• validFromOffset: integer (int32)
  The offset for the temporary credit limit's validity period start.
• validFromUnit: integer (int32)
  The unit for the temporary credit limit's validity period start.
• validTo(required): string (date-time)
  The date and time temporary credit limit's validity ends.
• validToOffset: integer (int32)
  The offset for the temporary credit limit's validity period end.
• validToUnit: integer (int32)
  The unit for the temporary credit limit's validity period end.

{
    "required":[
        "validFrom",
        "validTo"
    ],
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "limit":{
            "type":"number",
            "description":"The temporary credit limit amount."
        },
        "resourceId":{
            "type":"integer",
            "description":"The resource ID associated with the temporary credit limit.",
            "format":"int32"
        },
        "validTo":{
            "type":"string",
            "description":"The date and time temporary credit limit's validity ends.",
            "format":"date-time"
        },
        "validFrom":{
            "type":"string",
            "description":"The date and time temporary credit limit's validity starts.",
            "format":"date-time"
        },
        "validToUnit":{
            "type":"integer",
            "description":"The unit for the temporary credit limit's validity period end.",
            "format":"int32"
        },
        "validToOffset":{
            "type":"integer",
            "description":"The offset for the temporary credit limit's validity period end.",
            "format":"int32"
        },
        "validFromUnit":{
            "type":"integer",
            "description":"The unit for the temporary credit limit's validity period start.",
            "format":"int32"
        },
        "validFromOffset":{
            "type":"integer",
            "description":"The offset for the temporary credit limit's validity period start.",
            "format":"int32"
        }
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : ServiceType

Type: object

Show Source

• accountRef: object ResourceRef
• aliasList: array aliasList
  The list of aliases associated with the service.
• balanceGroupRef: object ResourceRef
• balGrpIndex: integer (int32)
  The balance group index.
• creationDate: string (date-time)
  The date and time the service type was created.
• effectiveDate: string (date-time)
• extension: object extension
  The extended attributes.
• id: object ResourceRef
• lastModified: string (date-time)
  The date and time the service was last modified.
• lastStatusChange: string (date-time)
  The date and time of the last status change.
• lastStatusComment: string
  The comment associated with the last status change.
• lifeCycleState: integer (int32)
  The current life cycle state.
• login(required): string
  The login associated with the service.
• name: string
  The name of the service.
• nameinfoObj: object ResourceRef
• password(required): string
  The password associated with the service.
• passwordExpiration: string (date-time)
  The date and time the password expires.
• passwordStatus: integer (int32)
  The current status of the password.
• pendingDeferredActionsCount: integer (int32)
  The number of deferred actions that are pending for the service.
• serviceAccessLevel: string
  The service access level.
• status: integer (int32)
  The status.
• statusFlags: integer (int32)
  The status flags.
• subscriptionServiceRef: object ResourceRef
• svcExpLastNotiOffset: string
  The notification offset.
• svcExpLastNotiT: string (date-time)
  The last notification time.

{
    "required":[
        "login",
        "password"
    ],
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "pendingDeferredActionsCount":{
            "type":"integer",
            "description":"The number of deferred actions that are pending for the service.",
            "format":"int32"
        },
        "accountRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "aliasList":{
            "type":"array",
            "description":"The list of aliases associated with the service.",
            "items":{
                "$ref":"#/components/schemas/AliasList"
            }
        },
        "balanceGroupRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "creationDate":{
            "type":"string",
            "description":"The date and time the service type was created.",
            "format":"date-time"
        },
        "effectiveDate":{
            "type":"string",
            "format":"date-time"
        },
        "lastStatusComment":{
            "type":"string",
            "description":"The comment associated with the last status change."
        },
        "lastStatusChange":{
            "type":"string",
            "description":"The date and time of the last status change.",
            "format":"date-time"
        },
        "login":{
            "type":"string",
            "description":"The login associated with the service."
        },
        "lifeCycleState":{
            "type":"integer",
            "description":"The current life cycle state.",
            "format":"int32"
        },
        "lastModified":{
            "type":"string",
            "description":"The date and time the service was last modified.",
            "format":"date-time"
        },
        "name":{
            "type":"string",
            "description":"The name of the service."
        },
        "password":{
            "type":"string",
            "description":"The password associated with the service."
        },
        "passwordExpiration":{
            "type":"string",
            "description":"The date and time the password expires.",
            "format":"date-time"
        },
        "passwordStatus":{
            "type":"integer",
            "description":"The current status of the password.",
            "format":"int32"
        },
        "status":{
            "type":"integer",
            "description":"The status.",
            "format":"int32"
        },
        "statusFlags":{
            "type":"integer",
            "description":"The status flags.",
            "format":"int32"
        },
        "subscriptionServiceRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "serviceAccessLevel":{
            "type":"string",
            "description":"The service access level."
        },
        "balGrpIndex":{
            "type":"integer",
            "description":"The balance group index.",
            "format":"int32"
        },
        "nameinfoObj":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "svcExpLastNotiOffset":{
            "type":"string",
            "description":"The notification offset."
        },
        "svcExpLastNotiT":{
            "type":"string",
            "description":"The last notification time.",
            "format":"date-time"
        }
    }
}

Nested Schema : aliasList

Type: array

The list of aliases associated with the service.

Show Source

• Array of: object AliasList
  The list of aliases associated with the service.

{
    "type":"array",
    "description":"The list of aliases associated with the service.",
    "items":{
        "$ref":"#/components/schemas/AliasList"
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : AliasList

Type: object

The list of aliases associated with the service.

Show Source

• elem: integer (int32)
• name: string

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string"
        },
        "elem":{
            "type":"integer",
            "format":"int32",
            "xml":{
                "attribute":true
            }
        }
    },
    "description":"The list of aliases associated with the service."
}

Nested Schema : CreditCardType

Type: object

Show Source

• accountRef: object ResourceRef
• correctiveInvoiceType: integer (int32)
  The type of invoice to create, such as an invoice correction letter or a replacement invoice.
• details: object Details
  The offer details.
• extension: object extension
  The extended attributes.
• id: string
  The ID.
• name: string
  The payment instrument's name.
• paymentType: integer (int32)
  The payment type. Can be one of the following:

  • 10001:Invoice
  • 10003: Credit card
  • 10005: Direct debit
  • 10007: Subordinate

{
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "name":{
            "type":"string",
            "description":"The payment instrument's name."
        },
        "paymentType":{
            "type":"integer",
            "description":"The payment type. Can be one of the following: <ul><li><b>10001</b>:Invoice</li><li><b>10003</b>: Credit card</li><li><b>10005</b>: Direct debit</li><li><b>10007</b>: Subordinate</li></ul>",
            "format":"int32"
        },
        "accountRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "correctiveInvoiceType":{
            "type":"integer",
            "description":"The type of invoice to create, such as an invoice correction letter or a replacement invoice.",
            "format":"int32"
        },
        "details":{
            "$ref":"#/components/schemas/Details"
        }
    }
}

Nested Schema : DirectDebitType

Type: object

Show Source

• accountRef: object ResourceRef
• correctiveInvoiceType: integer (int32)
  The type of invoice to create, such as an invoice correction letter or a replacement invoice.
• details: object Details
  The offer details.
• extension: object extension
  The extended attributes.
• id: string
  The ID.
• name: string
  The payment instrument's name.
• paymentType: integer (int32)
  The payment type. Can be one of the following:

  • 10001:Invoice
  • 10003: Credit card
  • 10005: Direct debit
  • 10007: Subordinate

{
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "name":{
            "type":"string",
            "description":"The payment instrument's name."
        },
        "paymentType":{
            "type":"integer",
            "description":"The payment type. Can be one of the following: <ul><li><b>10001</b>:Invoice</li><li><b>10003</b>: Credit card</li><li><b>10005</b>: Direct debit</li><li><b>10007</b>: Subordinate</li></ul>",
            "format":"int32"
        },
        "accountRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "correctiveInvoiceType":{
            "type":"integer",
            "description":"The type of invoice to create, such as an invoice correction letter or a replacement invoice.",
            "format":"int32"
        },
        "details":{
            "$ref":"#/components/schemas/Details"
        }
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : InvoiceType

Type: object

Show Source

• accountRef: object ResourceRef
• correctiveInvoiceType: integer (int32)
  The type of invoice to create, such as an invoice correction letter or a replacement invoice.
• details: object Details
  The offer details.
• extension: object extension
  The extended attributes.
• id: string
  The ID.
• name: string
  The payment instrument's name.
• paymentType: integer (int32)
  The payment type. Can be one of the following:

  • 10001:Invoice
  • 10003: Credit card
  • 10005: Direct debit
  • 10007: Subordinate

{
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "name":{
            "type":"string",
            "description":"The payment instrument's name."
        },
        "paymentType":{
            "type":"integer",
            "description":"The payment type. Can be one of the following: <ul><li><b>10001</b>:Invoice</li><li><b>10003</b>: Credit card</li><li><b>10005</b>: Direct debit</li><li><b>10007</b>: Subordinate</li></ul>",
            "format":"int32"
        },
        "accountRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "correctiveInvoiceType":{
            "type":"integer",
            "description":"The type of invoice to create, such as an invoice correction letter or a replacement invoice.",
            "format":"int32"
        },
        "details":{
            "$ref":"#/components/schemas/Details"
        }
    }
}

Nested Schema : SepaType

Type: object

Show Source

• accountRef: object ResourceRef
• correctiveInvoiceType: integer (int32)
  The type of invoice to create, such as an invoice correction letter or a replacement invoice.
• details: object Details
  The offer details.
• extension: object extension
  The extended attributes.
• id: string
  The ID.
• name: string
  The payment instrument's name.
• paymentType: integer (int32)
  The payment type. Can be one of the following:

  • 10001:Invoice
  • 10003: Credit card
  • 10005: Direct debit
  • 10007: Subordinate

{
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "name":{
            "type":"string",
            "description":"The payment instrument's name."
        },
        "paymentType":{
            "type":"integer",
            "description":"The payment type. Can be one of the following: <ul><li><b>10001</b>:Invoice</li><li><b>10003</b>: Credit card</li><li><b>10005</b>: Direct debit</li><li><b>10007</b>: Subordinate</li></ul>",
            "format":"int32"
        },
        "accountRef":{
            "$ref":"#/components/schemas/ResourceRef"
        },
        "correctiveInvoiceType":{
            "type":"integer",
            "description":"The type of invoice to create, such as an invoice correction letter or a replacement invoice.",
            "format":"int32"
        },
        "details":{
            "$ref":"#/components/schemas/Details"
        }
    }
}

Nested Schema : Details

Type: object

The offer details.

Show Source

• balanceImpactResource(required): string
  The resource that represents the balance impact of the offer.
• fixedAmount: number (float)
  The fixed amount of the offer.
• fixedPriceTag(required): string
  The fixed price tag of the offer.
• scaledAmount: number (float)
  The scaled amount of the offer.
• scaledPriceTag(required): string
  The scaled price tag of the offer.

{
    "required":[
        "balanceImpactResource",
        "fixedPriceTag",
        "scaledPriceTag"
    ],
    "type":"object",
    "properties":{
        "balanceImpactResource":{
            "type":"string",
            "description":"The resource that represents the balance impact of the offer."
        },
        "fixedAmount":{
            "type":"number",
            "description":"The fixed amount of the offer.",
            "format":"float"
        },
        "scaledAmount":{
            "type":"number",
            "description":"The scaled amount of the offer.",
            "format":"float"
        },
        "fixedPriceTag":{
            "type":"string",
            "description":"The fixed price tag of the offer."
        },
        "scaledPriceTag":{
            "type":"string",
            "description":"The scaled price tag of the offer."
        }
    },
    "description":"The offer details."
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : extension

Type: object

The extended attributes.

Back to Top

Response

Supported Media Types

• application/xml
• application/json

200 Response

The bill unit summary information was returned successfully.

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: object accountSummary

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/AccountSummary"
    }
}

Nested Schema : accountSummary

Type: object

Show Source

• billInProgressDue(required): number
  The in progress amount due for the bill unit.
• disputed(required): number
  The amount for the bill unit that is in dispute.
• dueNow(required): number
  The amount that is due now.
• extension: object extension
  The extended attributes.
• id: object ResourceRef
• numBills(required): integer
  The number of bills associated with the bill unit.
• paymentTypeId(required): string
  The ID for the bill unit's payment type.
• pendingDue(required): number
  The amount for the bill unit that is in pending state.
• pendingDueDate(required): string (date-time)
  The date and time the pending amount is due.
• unallocatedAdjustments(required): number
  The adjustment amount that is still unallocated.
• unallocatedPayments(required): number
  The payment amount that is still unallocated.

{
    "required":[
        "billInProgressDue",
        "disputed",
        "dueNow",
        "numBills",
        "paymentTypeId",
        "pendingDue",
        "pendingDueDate",
        "unallocatedAdjustments",
        "unallocatedPayments"
    ],
    "type":"object",
    "properties":{
        "extension":{
            "type":"object",
            "description":"The extended attributes."
        },
        "pendingDue":{
            "type":"number",
            "description":"The amount for the bill unit that is in pending state."
        },
        "pendingDueDate":{
            "type":"string",
            "description":"The date and time the pending amount is due.",
            "format":"date-time"
        },
        "unallocatedPayments":{
            "type":"number",
            "description":"The payment amount that is still unallocated."
        },
        "unallocatedAdjustments":{
            "type":"number",
            "description":"The adjustment amount that is still unallocated."
        },
        "billInProgressDue":{
            "type":"number",
            "description":"The in progress amount due for the bill unit."
        },
        "dueNow":{
            "type":"number",
            "description":"The amount that is due now."
        },
        "numBills":{
            "type":"integer",
            "description":"The number of bills associated with the bill unit."
        },
        "disputed":{
            "type":"number",
            "description":"The amount for the bill unit that is in dispute."
        },
        "paymentTypeId":{
            "type":"string",
            "description":"The ID for the bill unit's payment type."
        },
        "id":{
            "$ref":"#/components/schemas/ResourceRef"
        }
    },
    "xml":{
        "name":"accountSummary"
    }
}

Nested Schema : extension

Type: object

The extended attributes.

Nested Schema : ResourceRef

Type: object

Show Source

• id(required): string
  The ID.
• uri: string
  The Uniform Resource Identifier (URI) associated with the resource.

{
    "required":[
        "id"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"The ID."
        },
        "uri":{
            "type":"string",
            "description":"The Uniform Resource Identifier (URI) associated with the resource."
        }
    }
}

500 Response

An internal server error occurred.

Back to Top

Examples

This example shows how to generate a bill unit summary by submitting a POST request on the REST resource using cURL. For more information about cURL, see "Use cURL".

cURL Command

curl -X POST 'http://hostname:port/bcws/webresources/v1.0/billunits/bill-unit-summary' -H 'content-type: application/json' -d @billUnitSummary.json

where:

• hostname is the URL for the Billing Care REST server.
• port is the port for the Billing Care REST server.
• version is the version of the API you're using, such as v1.0.
• billUnitSummary.json is the JSON file that provides information about the bill units.

Example of Request Body

This example shows the contents of the billUnitSummary.json file sent as the request body.

[
    {
        "extension": null,
        "id": "0.0.0.1+-billinfo+78769",
        "name": "Bill Unit(1)",
        "accountRef": {
            "id": "0.0.0.1+-account+81329",
            "uri": null
        },
        "accountingCycleDom": 11,
        "accountingType": 2,
        "balanceGroups": [
            {
                "extension": null,
                "id": "0.0.0.1+-balance_group+77937",
                "name": null,
                "services": [],
                "balances": [
                    {
                        "currentBalance": -1301.52,
                        "creditFloor": null,
                        "creditLimit": null,
                        "creditThresholds": 0,
                        "formattedCreditThresholds": null,
                        "creditThresholdsFixed": "",
                        "expiredBeforeUsing": null,
                        "subBalances": [],
                        "resourceId": 840
                    },
                    {
                        "currentBalance": 2000,
                        "creditFloor": null,
                        "creditLimit": 0,
                        "creditThresholds": 0,
                        "formattedCreditThresholds": null,
                        "creditThresholdsFixed": "",
                        "expiredBeforeUsing": null,
                        "subBalances": [],
                        "resourceId": 1000095
                    }
                ],
                "elem": null
            }
            ],
            "paymentInstrumentRef": {
              "id": "0.0.0.1+-payinfo-invoice+84306",
              "uri": null
            },
            "currency": 840,
            "currencySecondary": 0,
            "status": null,
            "arBillUnitRef": {
              "id": "0.0.0.1+-billinfo+78769",
              "uri": null
            },
            "parentBillUnitName": "Bill Unit(1)",
            "parentAccountId": null,
            "parentFirstName": null,
            "parentLastName": null,
            "parentCompanyName": null,
            "parentSalutation": null,
            "parentAccountNumber": null,
            "invoiceTemplate": null,
            "businessProfile": "0.0.0.0++0",
            "wholesaleBilling": null,
            "correctiveInvoiceType": null,
            "lastModified": 1611840097000,
            "creationDate": null,
            "accountingCyclesUntilBillCycleEnds": null,
            "billForCurrentCycleRef": {
              "id": "0.0.0.1+-bill+209369",
              "uri": null
            },
            "defaultBillUnit": true,
            "parentBillUnit": false,
            "billingFrequencyInMonths": 1,
            "accountingCycleStart": null,
            "accountingCycleEnd": null,
            "lastActualBillRef": null,
            "lastActualBillDate": null,
            "lastBillFromBillingRef": null,
            "billingCycleStart": 1607673600000,
            "billingCycleEnd": 1610352000000,
            "segment": "-18",
            "daysInBillCycle": 31,
            "daysRemainingInBillCycle": 0,
            "exemptFromCollections": null,
            "scenarioRef": null,
            "numSuppressedCycles": null,
            "suppressed": null,
            "suppressionCyclesLeft": null,
            "collectionDate": null,
            "paymentInstrumentName": "10001 123",
            "collectionDetailsRef": null,
            "inCollections": false,
            "paymentMethod": null,
            "paymentType": 10001,
            "totalChildAccounts": null
          },
          {
            "extension": null,
            "id": "0.0.0.1+-billinfo+79498",
            "name": "bu2",
            "accountRef": {
              "id": "0.0.0.1+-account+81329",
              "uri": null
            },
            "accountingCycleDom": 1,
            "accountingType": 1,
            "balanceGroups": [
              {
                "extension": null,
                "id": "0.0.0.1+-balance_group+79242",
                "name": null,
                "services": [],
                "balances": [
                  {
                    "currentBalance": -20,
                    "creditFloor": null,
                    "creditLimit": null,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 840
                  }
                ],
                "elem": null
              },
              {
                "extension": null,
                "id": "0.0.0.1+-balance_group+199289",
                "name": null,
                "services": [],
                "balances": [
                  {
                    "currentBalance": 4530.5,
                    "creditFloor": null,
                    "creditLimit": null,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 840
                  },
                  {
                    "currentBalance": 2,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000004
                  },
                  {
                    "currentBalance": 1,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000007
                  },
                  {
                    "currentBalance": 1,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000010
                  },
                  {
                    "currentBalance": 2,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000012
                  },
                  {
                    "currentBalance": 1,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000018
                  },
                  {
                    "currentBalance": 1,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000020
                  },
                  {
                    "currentBalance": 1,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000023
                  },
                  {
                    "currentBalance": 1,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000024
                  },
                  {
                    "currentBalance": 211,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000025
                  },
                  {
                    "currentBalance": 1,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000026
                  },
                  {
                    "currentBalance": 1,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000027
                  },
                  {
                    "currentBalance": 1,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000093
                  },
                  {
                    "currentBalance": 1222,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000095
                  },
                  {
                    "currentBalance": 1,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000098
                  },
                  {
                    "currentBalance": 1,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000099
                  },
                  {
                    "currentBalance": 1,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000100
                  },
                  {
                    "currentBalance": 1,
                    "creditFloor": null,
                    "creditLimit": 0,
                    "creditThresholds": 0,
                    "formattedCreditThresholds": null,
                    "creditThresholdsFixed": "",
                    "expiredBeforeUsing": null,
                    "subBalances": [],
                    "resourceId": 1000102
                  }
                ],
                "elem": null
              }
            ],
            "paymentInstrumentRef": {
              "id": "0.0.0.1+-payinfo-invoice+84306",
              "uri": null
            },
            "currency": 840,
            "currencySecondary": 0,
            "status": null,
            "arBillUnitRef": {
              "id": "0.0.0.1+-billinfo+79498",
              "uri": null
            },
            "parentBillUnitName": "bu2",
            "parentAccountId": null,
            "parentFirstName": null,
            "parentLastName": null,
            "parentCompanyName": null,
            "parentSalutation": null,
            "parentAccountNumber": null,
            "invoiceTemplate": null,
            "businessProfile": "0.0.0.0++0",
            "wholesaleBilling": null,
            "correctiveInvoiceType": null,
            "lastModified": 1609852907000,
            "creationDate": null,
            "accountingCyclesUntilBillCycleEnds": null,
            "billForCurrentCycleRef": {
              "id": "0.0.0.1+-bill+203289",
            "uri": null
        },
        "defaultBillUnit": false,
        "parentBillUnit": false,
        "billingFrequencyInMonths": 1,
        "accountingCycleStart": null,
        "accountingCycleEnd": null,
        "lastActualBillRef": null,
        "lastActualBillDate": null,
        "lastBillFromBillingRef": null,
        "billingCycleStart": 1606809600000,
        "billingCycleEnd": 1609488000000,
        "segment": "-28",
        "daysInBillCycle": 31,
        "daysRemainingInBillCycle": -28,
        "exemptFromCollections": null,
        "scenarioRef": null,
        "numSuppressedCycles": null,
        "suppressed": null,
        "suppressionCyclesLeft": null,
        "collectionDate": null,
        "paymentInstrumentName": "10001 123",
        "collectionDetailsRef": null,
        "inCollections": false,
        "paymentMethod": null,
        "paymentType": 10001,
        "totalChildAccounts": null
    }
]

Example of Response Body

This shows an example of the contents of the response body in JSON format.

[
    {
        "extension": null,
        "pendingDue": -33.50,
        "pendingDueDate": 1612944000000,
        "unallocatedPayments": -286.95,
        "unallocatedAdjustments": -1020.5,
        "billInProgressDue": 0,
        "dueNow": 21.95,
        "numBills": 9,
        "disputed": 0,
        "paymentTypeId": null
    },
    {
        "extension": null,
        "pendingDue": 4530.5,
        "pendingDueDate": 1614758400000,
        "unallocatedPayments": -20,
        "unallocatedAdjustments": null,
        "billInProgressDue": 0,
        "dueNow": 2287.5,
        "numBills": 9,
        "disputed": 0,
        "paymentTypeId": null
    }
]

Back to Top