API Docs / Schemas / ClientBillableServiceDto

ClientBillableServiceDto

Response DTO for client billable service information

Properties

Name Type Description
codestring

The unique code for this client service assignment

The unique code for this client service assignment

billableServiceCodeAndNameDto
billableServiceCategoryenum

Other CoreAccounting Tax Payroll CompanySecretarial Advisory SoftwareAndTraining

Other CoreAccounting Tax Payroll CompanySecretarial Advisory SoftwareAndTraining

recurringTaskCountinteger

The number of recurring tasks associated with the billable service

The number of recurring tasks associated with the billable service

billingFrequencyenum

OneOff Annual Quarterly Monthly

OneOff Annual Quarterly Monthly

pricenumber

The base price for this client's service (before any adjustment).
If OverridePricing = false: Loaded from BillableService based on BillingFrequency.
If OverridePricing = true: Custom base price set by user.
The final price after adjustment is in EffectivePrice.

The base price for this client's service (before any adjustment).
If OverridePricing = false: Loaded from BillableService based on BillingFrequency.
If OverridePricing = true: Custom base price set by user.
The final price after adjustment is in EffectivePrice.

overridePricingboolean

Indicates whether the pricing is overridden with a custom Price value
If true: Price is used as-is, ignoring BillableService pricing
If false: Price comes from BillableService, and the client-level adjustment is applied

Indicates whether the pricing is overridden with a custom Price value
If true: Price is used as-is, ignoring BillableService pricing
If false: Price comes from BillableService, and the client-level adjustment is applied

priceAdjustmentPercentagenumber

Snapshot of the percentage contribution from selected Percentage-mode pricing factors (positive or negative).

Snapshot of the percentage contribution from selected Percentage-mode pricing factors (positive or negative).

priceAdjustmentFixedAmountnumber

Snapshot of the absolute currency contribution from selected FixedAmount-mode pricing factors (positive or negative).

Snapshot of the absolute currency contribution from selected FixedAmount-mode pricing factors (positive or negative).

effectivePricenumber

Read-only. Effective price = Price + (Price * PriceAdjustmentPercentage / 100) + PriceAdjustmentFixedAmount.
Both contributions are always applied — they're snapshots from different pricing factors and can coexist.

Read-only. Effective price = Price + (Price * PriceAdjustmentPercentage / 100) + PriceAdjustmentFixedAmount.
Both contributions are always applied — they're snapshots from different pricing factors and can coexist.

startDatestring

The start date for this service

The start date for this service

endDatestring

The end date for this service (null means ongoing)

The end date for this service (null means ongoing)

statusenum

Active Inactive Paused Proposed

Active Inactive Paused Proposed

managedByUserCodeAndNameDto
pricingAnswersobject

The pricing factor answers that determined the final price
Key: Question, Value: Answer

The pricing factor answers that determined the final price
Key: Question, Value: Answer

pricingTierCodestring

The code of the selected custom pricing tier. Only present when the BillableService uses CustomTiers pricing mode.

The code of the selected custom pricing tier. Only present when the BillableService uses CustomTiers pricing mode.

stageClientBillableServiceStageDto
servicePackageCodeAndNameDto
servicePackageUsePackagePricingboolean

Whether the originating service package uses package-level pricing

Whether the originating service package uses package-level pricing

servicePackagePricenumber

The package-level price from the originating service package

The package-level price from the originating service package

servicePackageBillingFrequencyenum

OneOff Annual Quarterly Monthly

OneOff Annual Quarterly Monthly

autoInvoiceboolean

Whether this service automatically generates invoice line items

Whether this service automatically generates invoice line items

nextBillingDatestring

The next date a billable line item will be generated

The next date a billable line item will be generated

createdDatestring

When the service assignment was created

When the service assignment was created

updatedDatestring

When the service assignment was last updated

When the service assignment was last updated

JSON Example

{
  "code": "string",
  "billableService": {
    "code": "string",
    "name": "string"
  },
  "billableServiceCategory": "Other",
  "recurringTaskCount": 0,
  "billingFrequency": "OneOff"
}

Used By Operations

Contained in Schemas