Skip to content

Tariff and Discount Detail Records

This page is a reference for the detail records that sit inside tariffs and discount plans. You normally manage these through their parent tariff or plan, but the field tables are here for when you need them.

A tariff rate is one line within a call tariff. Each rate sets the price for a particular type of call, such as UK mobiles, international destinations, or premium numbers. A single tariff usually holds dozens or hundreds of rates. Manage them on the tariff’s Tariff rates section.

This section identifies the specific rate within the tariff structure, including which tariff and call type this rate applies to.

FieldDescription
TariffThe tariff that this rate belongs to
Start DateFirst call date this rate applies from. Leave blank for no start limit.
End DateLast call date this rate applies to. Leave blank for no end limit.

Define the technical characteristics of this rate, including charge type configuration and discount plan settings.

FieldDescription
Charge TypeHow rates are calculated and applied for this specific rate
Discount PlanDiscount plan to apply to this rate

Set the primary cost structure for this rate, including per-minute charges, connection costs, and minimum/maximum cost limits.

FieldDescription
CostStandard rate applied for this call type and time period
Connection CostConnection charge applied to each call of this type
Rate SummaryHuman-readable description of how this rate is calculated and rounded
Minimum CostMinimum charge for any call of this type
Maximum CostMaximum charge for any single call of this type

Configure additional charges that are applied to calls, including access charges and surcharges for mobile origination, payphone origination, and call recording.

FieldDescription
Access ChargeAdditional access charge applied to calls of this type
Access Charge (Connection)Access charge connection component
Access Charge RoundingHow access charges are rounded for this rate
Mobile Origination SurchargeAdditional charge for mobile-originated calls of this type
Mobile Origination Surcharge (Connection)Mobile origination surcharge connection component
Mobile Origination Surcharge RoundingHow mobile origination surcharges are rounded for this rate
Payphone Origination SurchargeAdditional charge for payphone-originated calls of this type
Payphone Origination Surcharge (Connection)Payphone origination surcharge connection component
Payphone Origination Surcharge RoundingHow payphone origination surcharges are rounded for this rate
Call Recording SurchargeAdditional charge for call recording services
Call Recording Surcharge (Connection)Call recording surcharge connection component
Call Recording Surcharge RoundingHow call recording surcharges are rounded for this rate

Set up initial charging periods and costs that apply at the start of calls before standard charging begins.

FieldDescription
Initial CostCost applied during the initial period of a call
Initial DurationDuration of the initial charging period
Connection Cost After Initial DurationConnection cost applied after the initial duration

Configure how call durations, data usage, events, and costs are rounded for billing purposes.

FieldDescription
Minimum Chargeable DurationShortest duration that will be charged for
Round Duration Up To NextRound call duration up to the nearest number of seconds
Round Bytes Up To NextRound data usage up to the nearest number of bytes
Round Events Up To NextRound event count up to the nearest number
Round Cost Up To NextRound call cost up to the nearest number of pence
Round Cost After Surcharge Up To NextRound final cost after surcharges are applied

A fixed fee rate is one line within a fixed fee tariff, such as line rental at £18 or broadband at a set monthly price. Each rate is one chargeable item, so you build a service package from several rates. Manage them on the tariff’s rates section.

This section contains basic information about the fixed fee tariff rate, including an optional description.

FieldDescription
DescriptionOptional description for this fixed fee rate
Start DateFirst transaction start date this fixed fee rate applies from. Leave blank for no start limit.
End DateLast transaction start date this fixed fee rate applies to. Leave blank for no end limit.

This section defines which number types, feature types, transaction types, and carriers this fixed fee rate applies to.

FieldDescription
Number TypesThe number types this fixed fee rate applies to
Service TypesThe service types this fixed fee rate applies to
Feature TypesThe feature types this fixed fee rate applies to
Transaction TypesThe transaction types this fixed fee rate applies to
CarriersThe carriers this fixed fee rate applies to

This section contains the cost configuration for the fixed fee rate, including the charge type, value, period, and commission settings.

FieldDescription
Charge TypeThe type of charge calculation for this fixed fee rate
CostThe cost value for this fixed fee rate (amount or percentage depending on charge type)
Charge PeriodThe billing period for this fixed fee rate
Commission ProfileThe commission profile to use for transactions using this fixed fee rate
Transaction CodeOptional transaction code for transactions using this fixed fee rate

This section configures discount plan integration and allowance pool settings for this fixed fee rate.

FieldDescription
Allowance Pool NameName of the allowance pool which should be filled
Discount Plan 1 MultiplierMultiplier for discount plan 1
Discount Plan 1First discount plan that applies to this fixed fee rate
Discount Plan 2 MultiplierMultiplier for discount plan 2
Discount Plan 2Second discount plan that applies to this fixed fee rate
Discount Plan 3 MultiplierMultiplier for discount plan 3
Discount Plan 3Third discount plan that applies to this fixed fee rate
Discount Plan 4 MultiplierMultiplier for discount plan 4
Discount Plan 4Fourth discount plan that applies to this fixed fee rate
FieldDescription
Last ModifiedTimestamp of the most recent modification to this fixed fee tariff rate
CreatedTimestamp when this fixed fee tariff rate was created

A discount plan allowance is a bucket of inclusive minutes, data, or credit a customer receives from a discount plan, for example 500 free UK minutes a month. Allowances can be shared across all numbers on an account or allocated to specific ones. The platform creates and tracks these per customer per period.

Date range and pool configuration for the allowance

FieldDescription
Start DateDate when this discount plan allowance becomes active
End DateDate when this discount plan allowance expires
Allowance Pool NameNamed pool identifier for grouping related allowances

Discount plan and allowance amounts configuration

FieldDescription
Discount PlanThe discount plan this allowance is associated with
Free MinutesNumber of free minutes included in this allowance
Discounted Data (Bytes)Number of bytes of data included in this allowance
Discounted EventsNumber of events included in this allowance
Free CallsNumber of free calls included in this allowance
Cash DiscountCash discount amount included in this allowance
Nominal ValueNominal value of this allowance for accounting purposes

Current usage statistics and consumption tracking

FieldDescription
Used MinutesNumber of minutes consumed from this allowance
Used CallsNumber of calls consumed from this allowance
Used DiscountCash discount amount consumed from this allowance
Used A Leg DiscountA-leg discount amount consumed from this allowance
Allowance ConsumedTimestamp when this allowance was fully consumed

Audit trail and system tracking information

FieldDescription
Last ModifiedTimestamp when this discount plan allowance was most recently modified
CreatedTimestamp when this discount plan allowance was created

An allowance usage record is the running tally of how much of an allowance a customer has used in a billing period. It stops customers exceeding their inclusive amounts and supplies the used and remaining figures shown on bills.

References to the invoice and discount plan allowance this usage record tracks

FieldDescription
Invoice IDThe invoice this allowance usage applies to
Discount Plan Allowance IDThe discount plan allowance being tracked

Detailed breakdown of allowance consumption across different usage types

FieldDescription
Used MinutesNumber of minutes consumed from the allowance
Used BytesNumber of bytes consumed from the allowance
Used EventsNumber of events consumed from the allowance
Used CallsNumber of calls consumed from the allowance
Used DiscountMonetary value of discount consumed from the allowance
Used A Leg DiscountMonetary value of A leg discount consumed from the allowance

Audit trail and system tracking information

FieldDescription
Last ModifiedTimestamp of the most recent modification to this allowance usage record
CreatedTimestamp when this allowance usage record was created

Need precise control over rates, bundles and inclusive allowances? see how SAFE Billing Platform prices every call and charge