API Docs / Schemas / CreateClientBillableServiceRequest

CreateClientBillableServiceRequest

Request DTO for creating a new client billable service assignment

Properties

Name Type Description
billableServiceCode*string

The code of the billable service to assign to this client

The code of the billable service to assign to this client

billingFrequency*enum

OneOff Annual Quarterly Monthly

OneOff Annual Quarterly Monthly

pricenumber

The price for this client's service
Required when OverridePricing = true (custom price)
Ignored when OverridePricing = false (price comes from BillableService)

The price for this client's service
Required when OverridePricing = true (custom price)
Ignored when OverridePricing = false (price comes from BillableService)

overridePricingboolean

Indicates whether to use a custom Price value instead of BillableService pricing
If true: Must provide Price value
If false: Price is loaded from BillableService, and PriceAdjustmentPercentage is applied

Indicates whether to use a custom Price value instead of BillableService pricing
If true: Must provide Price value
If false: Price is loaded from BillableService, and PriceAdjustmentPercentage is applied

priceAdjustmentPercentagenumber

The percentage adjustment to apply to the base price from BillableService (can be positive or negative)
Only used when OverridePricing = false. Defaults to 0 (no adjustment)
Use -10 for 10% discount, 15 for 15% markup

The percentage adjustment to apply to the base price from BillableService (can be positive or negative)
Only used when OverridePricing = false. Defaults to 0 (no adjustment)
Use -10 for 10% discount, 15 for 15% markup

startDate*string

The start date for this service

The start date for this service

endDatestring

The end date for this service (optional - null means ongoing)

The end date for this service (optional - null means ongoing)

status*enum

Active Inactive Paused Proposed

Active Inactive Paused Proposed

managedByUserCodestring

The code of the user managing this service

The code of the user managing this service

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

JSON Example

{
  "billableServiceCode": "string",
  "billingFrequency": "OneOff",
  "price": 0.01,
  "overridePricing": false,
  "priceAdjustmentPercentage": 0,
  "startDate": "2024-01-01T00:00:00Z",
  "status": "Active"
}

Used By Operations