CD-ROM Creation / Autorun AEE 211. CD-ROM Types Audio.wav Data.* (.doc,.pdf,.pm5,.wav, etc.)
CD-ROM Technical Guide (Telephony) File 3
Transcript of CD-ROM Technical Guide (Telephony) File 3
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 1 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright αααα 1999
BT OneBillPlus
CD-ROM Technical Guide
(Telephony)
File 3
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 2 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Table of Contents
1. Welcome .................................................................................................................................................................................................................. 3
2. Introduction............................................................................................................................................................................................................. 3
3. What is delivered? ................................................................................................................................................................................................... 3
4. How is it delivered? ................................................................................................................................................................................................. 3
5. Technical Prerequisites........................................................................................................................................................................................... 4
6. Technical Data ........................................................................................................................................................................................................ 4
7. Contact Point for Queries ....................................................................................................................................................................................... 4
8. Notes ........................................................................................................................................................................................................................ 5
9. Onebillplus File 3 file format ................................................................................................................................................................................. 7
10. Register of Amendments………………………………………………………………………………………………………………………..29
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 3 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
1. Welcome
Welcome to BT OneBillPlus.
OneBillPlus is a service, which consolidates individual telephony services, (known as source or local invoices), UK-wide from BT’s billing systems. Once a billing
frequency is agreed with you a single bill is produced which combines source invoice billing data raised at that date.
However, this guide is all about the billing record data generated from our systems, covering your billing usage and available for you to use as management information. BT
has developed the facility to provide the relevant OneBillPlus source invoice data on Read-Only Compact Disk (CD).
We provide a CDROM disk copy of the guide and you are welcome to copy this on to your hard disk for your own private use, provided you do not modify the guide in any way
2. Introduction
This guide provides a definition of the format of OneBillPlus data, sent via CD-ROM. BT OneBillPlus customers who have elected to receive their bill data via CD-ROM in
addition to Paper invoices should use it.
The OneBillPlus service has been enhanced to provide files on CD-ROM for you to input to your own systems enabling the analysis of your BT charges and usage.
This document has been produced for technical personnel to assist in utilising the information held on the data files. It gives an overview of the contents of each file, the
format in which the file is copied to the CD-ROM, and a detailed file layout with a technical description of each field and record on the file.
3. What is Delivered?
The OneBillPlus service produces various data files, which may be interrogated by your own software to provide a detailed analysis of the BT telephony services you use and
the costs of those services.
The data is held in a Comma Delimited Format. This information can be read into most PC spreadsheet and database packages but if your files hold a high volume of data we
recommend that you import them using an industry standard database package.
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 4 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
4. How is it delivered?
The data files are supplied on CD-ROM.
5. Technical Prerequisites
To use the CD-ROM you must have an IBM compatible Personal Computer that has the ability to read Compact Disk.
6. Technical Data
The files written to CD-ROM will have the following parameters: -
Example -
File name XXXXF3YY.ZZ
FORMAT Fixed field comma delimited.
Where: XXXX is the last four digits of your OneBillPlus account number.
YY is the last two digits of the invoice number.
ZZ is the identifier relating to the location of the BT office responsible for the OneBillPlus account.
The file will be versioned as follows:
OneBillPlus Telephony details – R009.01
The version number has two parts, a major number (either Mnnn or Rnnn) and a minor number (nn).
The Minor number is incremented when there is no change to the data structure; i.e. typically operational fixes like a field should be spaces and not nulls, wrong decimal
point etc.
The Major number is incremented when there are data structure changes, i.e. new fields appended to an existing record, new record types introduced, etc.
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 5 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
7. Contact Point for Queries
Any queries regarding the use of the CD-ROM product, e.g., non-receipt, corruption of data, general usage queries, should be directed to your BT contact number detailed on
your paper invoice.
8. Notes
The following notes will be of use when interpreting the data held on the disk: -
8.1 The file is of comma separated format. i.e.:
• Fields are of fixed length.
• Fields are delimited by a comma.
• Trailing empty field delimiters, ( e.g. commas ), will be suppressed, i.e. the last character of the last field to contain data will be the last character in the record.
• The file, when written to the CDROM, will be ASCII encoded, records terminated by CR/LF (PC DOS format).
• Fields, which are numeric monetary values, are in pounds and pence to either 2 or 3 decimal places e.g.££££££££.ppp
• All currency fields will have a leading sign.
• Where a currency field is less than 1.00, there will be a leading ‘0’ before the decimal place. (i.e. 0.12 NOT .12).
• The size of each field given in the record description is exclusive of commas and text delimiters and indicates the MAXIMUM size.
• All date fields have the format yyyy/mm/dd.
Note: Decimal places are explicitly present in all numerical fields. For example + 00000012.34. All monetary fields are preceded with a ‘+’ or ‘-’ sign.
8.2 The dataname ‘LINE-NO’ can be interpreted in two ways depending upon the line set-up at your site:-
• An ‘auxiliary’ line is an actual telephone number in its own right. e.g. 12345 or 123456 or 1234567 or 12345678.
• A ‘suffix’ line is an extension number. e.g. /0001 or 12345/0001 or 123456/0001 or 1234567/0001 or 123456780001. Note that when an 8 digit local
number is combined with a suffix number there is insufficient room in the field to include the ‘/’ to separate the two. Thus if LINE-NO contains 12 digits
the first 8 are the local number and the last 4 are the suffix.
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 6 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
8.3 In the CD-ROM OneBillPlus Telephony details file, the dataname ‘RECORD-CLASS’ is assigned a data type of one of the following:-
• I = Bill header
• S = Summary data
• B = Breakdown data
• H = Hidden data
• G = At-a-glance data
• T = Bill trailer
8.4 In the CD-ROM OneBillPlus Telephony details file, the data name ‘CHARGE-BAND’ will have one of the following data types assigned :-
L = Local
N = National
I = International
T = Trunk
X = Operator raised credit (Record Type 570)
X = Local Data Call (Record Type 680)
Y = National Data Call
Z = International Data Call
O = Other
Spaces = No meaningful value could be placed or the record is a continuation record with no charge associated with it.
8.5 In the CD-ROM OneBillPlus Telephony details file, if Zero appears in the dataname ‘CALL DURATION’ then it should be identified as a SMS call.
The date fields on record types 805, 815, 825 and 826 can have value zero in two scenarios.
If the invoice was loaded before the new discount platform was implemented, the date fields will be populated with zero.
If the dates are spanned outside the bill period i.e. if the product does not change within the bill period, the product effective dates are set to zero. If the product becomes
effective within the billing period and remains effective till the end of it, the begin effective date will have the date when the product became effective, but the end date
will have zero. If the product which was effective before the billing period started, ceases to be effective within the billing period, the begin date will have zero while the
end date will have the date when the product ceased to be effective.
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 7 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
9. CD-ROM OneBillPlus Telephony Details File
This file, File 3, can contain the following record types:-
Record Type Description Record Type Number Page Number
General layout for all record types 8
File Header 000 8
Bill Header 100 9
Telemarketing Calls 550 10
Chargecard Calls 560 11
Operator and Select Services Calls 570 12
Low Usage Rebate 580 13
Advance Charges 590 14
Other Charges and Credits 600 15
VAT Zero Rated Items 610 16
Amendments to a Previous Bill 630 17
Cardphone Rebate - Unit based 640 18
Cardphone Rebate - Elapsed time based 645 19
New Format Itemised Calls 680 20
New Format Bulked Calls 690 21
Call Charges at a Glance 700 22
Refund of Deposit 720 23
Call Category Details 805 24
Calling Circle Details 815 25
Volume Threshold Eligible Amounts 825 26
Volume Threshold Savings Table 826 27
Bill Trailer 900 28
File Trailer 999 28
A description and the format of each of the fields on the records follows:-
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 8 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Record Name: GENERAL LAYOUT FOR ALL RECORD TYPES
Record Type: All
This is the basic format of all data records on the file (excluding file header and file trailer). Each record contains different fields in the 210 byte ‘DATA’ field at the end of
this record, of which at most 146 bytes will have some data value (Record type 805).
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘nnn’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account. 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
the invoice type followed by a numeric value. The value is sequential, providing a unique
identifier.
4
VERSION-NO This is normally 1. However, it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence number within invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
DATA 210
File Header (Record type 000) There will be one of these records on the file. It identifies the file as a telephony breakdown file, the creation date, your account number and the BT contact number.
Record Name: FILE HEADER
Record Type: 000
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘000’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account. 10
FILE-TYPE Identifies the file as the telephony breakdown file. 10 ‘BTCALLBAS
E’
INVOICE-ID The OneBillPlus Invoice Id. 4
RUN-DATE The date the file was created. 8 yyyymmdd
PROGRAM-ID Identifies the CD-ROM file type. 8
PROGRAM-VERSION-NO Identifies the version number of this file format. See note on file version in Section 6. 7
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 9 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Bill Header (Record type 100) There will be one of these records for each source invoice included in the OneBillPlus invoice. They will detail the date on which the bill was produced, indicate the type
of discount applied, the bill period and the rental start and end dates.
Record Name: BILL HEADER
Record Type: 100
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘100’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account. 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential, providing a unique
identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence number within invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
BILL-DATE The date the invoice was produced. 8 yyyymmdd
RELEASE-INDICATOR Flag indicating the discount platform applied 1 Spaces, ‘A’, ‘B’,
‘C’
BILL-START-DATE Start date of the bill period. 8 yyyymmdd
BILL-END-DATE End date of the bill period - see notes in section 8. 8 yyyymmdd
RENT-START-DATE Start date of the rental period 8 yyyymmdd
RENT-END-DATE End date of the rental period 8 yyyymmdd
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 10 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Telemarketing Calls (Record type 550) There will be one of these records for each source invoice with a TELEMARKETING number in the OneBillPlus invoice.
It details the TELEMARKETING telephone number, the start and end dates applicable, the number of calls, the net and gross cost of the calls, the discount amount, the
billing number and an indicator to describe the call type.
Record Name: TELEMARKETING CALLS
Record Type: 550
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘550’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account . 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
the invoice type followed by a numeric value. The value is sequential, providing a unique
identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence number within invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
TELEMARKETING NO The TELEMARKETING telephone number that the invoice is raised on. 12
CALL-CHARGE-START-DATE Start date of TELEMARKETING call charges. 8 yyyymmdd
CALL-CHARGE-END-DATE End date of TELEMARKETING call charges. 8 yyyymmdd
NO OF CALLS The actual number of calls. 7
COST The Net cost of the calls. 14
GROSS-COST The Gross cost of the calls. 14
DISCOUNT The discount amount. 14
BILL-REF This is the Billing Number on sub-headers. 12
INDICATOR This indicator describes the call type, i.e. F = Freephone, L = LoCall, N = National, I =
International, A = Advanced PSTN.
1 ‘F’, ‘L’, ‘N’,
‘I’, ‘A’
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 11 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Chargecard Calls (Record type 560) There will be one of these records for each source invoice with a Chargecard in the OneBillPlus invoice.
It details the Chargecard number, the Chargecard name, the date, time, duration, destination, call type and cost of the calls along with the charge band.
Record Name: CHARGECARD CALLS
Record Type: 560
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘560’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account . 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
the invoice type followed by a numeric value. The value is sequential, providing a unique
identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence number within the invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
CARD NO Charge card number. 6
CARD NAME Owners name. 27
CALL DATE The date the call was made. 8 yyyymmdd
CALL TIME Time call commenced. 4 hhmm
CALL DURATION Duration of call. 6 mmmmss
DESTINATION The telephone number called. 25
CALL TYPE Textual description of the call, e.g. ‘direct dialled’ or ‘via operator’. 14
COST Actual cost of call. 13
CHARGE-BAND Data type - see notes in section 8. 1 Spaces, ‘L’,
‘T’, ‘I’
NOTE: RT 560 can have continuation records to allow for Call Types longer than 14 characters. If the Call Duration field is blank, the Cost field is zero and the Call Type
field is not blank, it indicates that the record is a continuation record.
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 12 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Operator and Select Services Calls (Record type 570) There will be one of these records for each telephone number, which has had operator-controlled calls, or Select Services for each invoice in the OneBillPlus invoice.
It details the date, time, duration, destination, call type, cost of the calls and identifies the class of call. It also gives the charge band of the call.
Record Name: OPERATOR AND SELECT SERVICES CALLS
Record Type: 570
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘570’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account . 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential, providing a unique
identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence within the invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
NATIONAL NO Main Service number. 11
LINE NO Extension number - see notes in section 8. 12
CALL DATE The date the call was made. 8 yyyymmdd
CALL TIME Time call commenced. 4 hhmm
DESTINATION The telephone number called. 25
CALL TYPE Textual description of the call, e.g. rate of transfer (higher or lower). 14
CALL DURATION Duration of call. 6 mmmmss
COST Actual cost of call. 13
CALL CLASS Indicator to distinguish the 3 classes, i.e. for Operator Controlled Calls the value will be
‘O’, for Select Services the value will be ‘N’. ‘I’ is currently not used but will be used to
identify a tax exempt ICCV call i.e. International Charge Card call.
1 ‘O’ , ‘N’, ‘I’
CHARGE-BAND Data type - see notes in section 8. 1 Spaces, ‘L’,
‘T’, ‘I’, ‘X’
NOTE: RT 570 can have continuation records to allow for Call Types longer than 14 characters. If the Call Duration field is blank, the Cost field is zero and the Call Type
field is not blank, it indicates that the record is a continuation record.
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 13 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Record Name: LOW USAGE REBATE (Record type 580)
Record Type: 580
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘580’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account . 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential, providing a unique
identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence within invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
NATIONAL-NO Main Service number. 11
LINE-NO Extension number - see notes in section 8. 12
COST Actual value of rebate. 14
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 14 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Advance Charges (Record type 590)
There will be one of these records for each source invoice in the OneBillPlus invoice.
It details the description of the charges, the quantity of items charged, the quarterly rate per item, the total cost of advance charges and identifies the charge class to which
the charge applies.
Record Name: ADVANCE CHARGES
Record Type: 590
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘590’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account . 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential, providing a unique
identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence within invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
DESCRIPTION Textual description, e.g. rental, customer option (commas replaced by spaces). 50
QUANTITY Number of items. 7
QUARTERLY-RATE Cost per item per quarter. 11
COST Actual cost of items. 15
CHARGE TYPE Indicator to identify the charge type. For Line Rental the value will be ‘L’, for Equipment
Rental the value will be ‘E’, for Maintenance Charges the will be ‘M’, for Network Rental
the value will be “N”, for Additional Phonebook Entries the value will be ‘P’ and for
Customer Option Charges the value will be ‘O’.
1 ‘L’, ‘E’, ‘M’,
‘N’, ‘P’, ‘O’,
NOTE: RT 590 can have continuation records to allow for Descriptions longer than 50 characters. If the Quantity, Cost and Quarterly-Rate fields are zero and the
Description field is not blank, it indicates that the record is a continuation record.
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 15 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Other Charges and Credits (Record type 600) There will be one of these records for each source invoice with other charges and credits in the OneBillPlus invoice.
It details the charging period start and end dates, a description of the charges, the quantity of items charged, the quarterly rate per item, the total cost of the charges, whether
the charge is a broken period rental or a connection charge, the order number against, which the charge / credit is incurred and an indicator to identify the type of VAT charge
applied and the customer order reference.
Record Name: OTHER CHARGES AND CREDITS
Record Type: 600
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘600’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account . 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential , providing a unique
identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence within invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
DATE1 Start date of charging period for ‘other charges and credits’. 8 yyyymmdd
DATE2 End data of charging period for ‘other charges and credits’. 8 yyyymmdd
DESCRIPTION Textual description. 30
QUANTITY Number of items. 5
QUARTERLY-RATE Cost per item per quarter. 11
COST Actual cost of items. 15
OCC TYPE Indicator to identify the charge/credit type. For Broken Period Rental the value will be
‘B’, for Connection Charges the value will be ‘C’ and for Other Non-recurring Charges
the value will be ‘O’. If the value in this field is ‘O’ then refer to the VAT-TYPE field,
(described below).
1 ‘B’, ‘C’, ‘O’
ORDER NO Order number against which other charges or credits are incurred. This field is alpha
numeric i.e. the first 3 bytes are alpha and the last 3 bytes are numeric.
6 ABC123
VAT-TYPE Indicator to identify the type of VAT charge applied i.e. for Standard rate VAT the value
will be ‘S’ and for charges exempt of VAT the value will be ‘X’.
1 ‘S’, ‘X’
CUSTOMER-ORDER-
REFERENCE
Identifies the customer order reference (if any). 20
NOTE: RT 600 can have continuation records to allow for Descriptions longer than 30 characters. If the Quantity, Cost, Quarterly-Rate, Date1 & Date2 fields are zero,
and the Description field is not blank, it indicates that the record is a continuation record.
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 16 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
VAT Zero Rated Items (Record type 610) There will be one of these records for each VAT zero rated phone book for each source invoice in the OneBillPlus invoice. It details the debit date, a description of the
item, the cost of the item, the number of books and the section number of the item.
Record Name: VAT ZERO RATED ITEMS
Record Type: 610
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘610’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account . 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential, providing a unique
identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence within the invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
DEBIT-DATE The date the charge was made. 8 yyyymmdd
DESCRIPTION Textual description. 60
COST Actual cost of items. 13
NO-OF-BOOKS Number of phone books. 3
SECTION-NO Section number of the item. 3
NOTE: RT 610 can have continuation records to allow for Descriptions longer than 60 characters. If the Cost & No-Of-Books fields are zero and the Description field is
not blank, it indicates that the record is a continuation record.
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 17 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Amendments to a Previous Bill (Record type 630) There will be one of these records for each amendment to a previous bill, for each source invoice in the OneBillPlus invoice.
It details a description of the amendment, amount of the amendment and the bill date affected by the amendment.
Record Name: AMENDMENTS TO PREVIOUS BILL
Record Type: 630
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘630’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account . 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential, providing a unique
identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence within invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
DESCRIPTION Textual description of the amendment. 70
AMOUNT Actual cost of item. 13
AMENDED BILL DATE Bill date affected by the amendment. 8 yyyymmdd
NOTE: RT 630 can have continuation records to allow for Descriptions longer than 70 characters. If the Amount field is zero and the Description field is not blank, it
indicates that the record is a continuation record.
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 18 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Cardphone Rebate - Unit Based (Record type 640) There will be one of these records for each telephone number with a Cardphone rebate for each source invoice in the OneBillPlus invoice.
It details a call charging period start and end dates, the number of calls, the units used, the cost per unit and the actual value of the rebate (usually negative).
Record Name: CARDPHONE REBATE - Unit Based
Record Type: 640
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘640’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account . 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential, providing a unique
identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence number within invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
NATIONAL NO Main Service number. 11
LINE NO Extension number. 12
START DATE Call charge start date. 8 yyyymmdd
END DATE Call charge end date. 8 yyyymmdd
NO OF CALLS Actual number of calls made. 5
UNITS-USED Number of units used. 10
UNIT RATE Cost per unit. 8
COST Actual cost of rebate (usually a negative value). 13
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 19 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Cardphone Rebate - Elapsed time based (Record type 645) There will be one of these records for each telephone number with a Cardphone rebate for each source invoice in the OneBillPlus invoice. It details a call date, time,
destination, duration (elapsed time and units), the actual value of the rebate (usually negative) and the unit rate.
Record Name: CARDPHONE REBATE - Elapsed time based
Record Type: 645
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘645’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account . 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential therefore providing a
unique identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence number within invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
CALL DATE Date of call. 8 yyyymmdd
CALL TIME Time of call. 7
DESTINATION UNSPLIT The telephone number called, (Bytes 1 to 12 contain the textual description of the
destination. Bytes 13 to 25 contain the number).
25
CALL DURATION Duration of call, i.e. elapsed time where the last two bytes are milli-seconds. 8 hhmmssss
UNITS DURATION Units used during call. 8
PRICE OF CALL Cost of the call. 13
UNIT RATE Cost per unit. 7
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 20 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
New Format Itemised Calls (Record type 680) There will be one of these records for each itemised call for each source invoice included in the OneBillPlus invoice. They will detail the date, time, duration, call tariff,
cost of calls made to a particular telephone, and the threshold value for itemisation, the textual description if the call is a Select Service and the charge band of the call.
Record Name: NEW FORMAT ITEMISED CALLS
Record Type: 680
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘680’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account . 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential, providing a unique
identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence number within invoice 5
RECORD-CLASS Data type - see notes in section 8. 1
NATIONAL NO Main Service number. 11
LINE NO Extension number - see notes in section 8. 12
CALL DATE Date call was made. 8 yyyymmdd
CALL TIME Time call commenced. 4 hhmm
CALL DURATION Duration of call. 6 mmmmss
DESTINATION Telephone number dialled (commas replaced by spaces). 25
CALL-TARIFF Tariff rate applied to call. Reserved for special one-off promotions (otherwise unused by
standard rates i.e. local, national, international).
8
COST Cost of calls. 13
NOT LESS THAN Threshold value for itemisation, i.e. Direct-dialled calls over £nn.nnn. 12
NETWORK-CALL-TYPE Textual description of the call. This field is only populated if the call is a Select Service. 19
CHARGE-BAND Data type - see notes in section 8. 1 Spaces, ‘L’,
‘N’, ‘I’, ‘O’,
‘T’ ,‘X’, ‘Y’,
‘Z’
NOTE: RT 680 if Zero appears in ‘CALL DURATION’ then it should be identified as a SMS call.
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 21 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
New Format Bulked Calls (Record type 690) There will be one of these records for each telephone number applicable to each source invoice included in the OneBillPlus invoice. It details phone number, line number,
call from date, call to date, number of calls, total duration of calls, the cost and the charge band of the call.
Record Name: NEW FORMAT BULKED CALLS
Record Type: 690
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘690’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account . 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential, providing a unique
identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence number within invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
NATIONAL NO Main Service number. 11
LINE NO Extension number - see notes in section 8. 12
CALL-FROM-DATE Start date of calls. 8 yyyymmdd
CALL-TO-DATE End date of calls. 8 yyyymmdd
NUMBER-OF-CALLS The total number of calls made in the period. 5
TOTAL-DURATION The duration of all calls made. 8
COST Cost of calls made. 13
CHARGE-BAND Data type - see notes in section 8. 1 Spaces, ‘L’,
‘N’, ‘I’, ‘O’,
‘T’, ‘X’, ‘Y’,
‘Z’
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 22 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Call Charges at a Glance (Record type 700) There will be one of these records for each multi-line account with more than one Chargecard or where the account has more than one Telemarketing number for each
source invoice in the OneBillPlus invoice. It details the cost of various call charges (i.e. direct dial, operator calls and Select Services) and the total cost of the calls.
Record Name: CALL CHARGES AT A GLANCE
Record Type: 700
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘700’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account. 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential, providing a unique
identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence within invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
NATIONAL NO Main Service number. 11
LINE NO Extension number - see notes in section 8. 12
REC-TYPE ‘C’ = Call charges ‘B’ = Chargecard charges ‘L’ = TELEMARKETING charges 1
CREDIT CARD REF NO IF REC-TYPE = ‘B’ then this is the Chargecard reference number.
If REC-TYPE = ‘L’ then this is the TELEMARKETING main number.
8
UNITS USED Number of units used. (Only used if REC-TYPE = ‘C’). 10
COST-DIALLED-CALLS Total cost of dialled calls. (Only used if REC-TYPE = ‘C’).
If Site Options are used this field is not applicable.
15
COST-OP-CONTROLLED Total cost of operator controlled calls. (Only used if REC-TYPE = ‘C’). 15
COST-NETWK-SERVICES Total cost of Select service calls. (Only used if REC-TYPE = ‘C’). 15
TOTAL Total cost of calls. (Used for all three possible values of REC-TYPE). 15
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 23 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Refund of Deposit (Record type 720) There will be one of these records for each deposit paid to BT by you within the OneBillPlus invoice. It details the date at which deposit was paid, period to which the
interest calculation applies, interest rate, interest, income tax on the interest and the amount to be refunded.
Record Name: REFUND OF DEPOSIT
Record Type: 720
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘720’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account. 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential therefore providing a
unique identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence number within invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
DEP PAID DATE Date on which deposit was paid. 8 yyyymmdd
DEP FROM DATE Start date of period to which the interest calculation applies. 8 yyyymmdd
DEP TO DATE End date of period to which the interest calculation applies. 8 yyyymmdd
DEP INTEREST RATE Interest rate. 4
DEP INTEREST Amount of interest for the period given at the above interest rate. 13
DEP INC TAX Income Tax on the interest. 13
DEP CREDIT Total amount to be refunded. 13
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 24 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Call Category Details (Record type 805) If the discount is applied, there will be one of these records for each call category on a source invoice included in the OneBillPlus invoice. It gives the details of the
product option, description of the category to which it belongs, cost basic rate, percentage discount, total discount, net cost and the effective dates.
Record Name: CALL CATEGORY DETAILS
Record Type: 805
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘805’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account. 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential therefore providing a
unique identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence number within invoice. 5
RECORD-CLASS Data type -see notes in section 8. 1
OPTION-DESCRIPTION Description of the option used. 30
CATEGORY-DESCRIPTION Description of the category of the discount used. This will have the description of the Major
Category like Direct-dialled. However, it can have Minor Category like Local, National, etc.
can be added to it.
58
COST-BASIC-RATE The gross cost of the calls. 14
PERCENTAGE-DISCOUNT Rate of discount for this option. 8
TOTAL-DISCOUNT Amount of discount for the option. 14
COST-AFTER-DISCOUNT Actual cost payable after discount. 14
BEGIN-EFF-DATE The date when this became effective - see notes in section 8. 8 yyyymmdd
END-EFF-DATE The date when this ceased to be effective - see notes in section 8. 8 yyyymmdd
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 25 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Calling Circle Details (Record type 815) If this discount is applied, there will be one of these records, for each tier per product for a source invoice in the OneBillPlus invoice. It details the description of the
product option, the tier description, destination, gross amount, percentage discount, total discount and effective dates. There is a limit of 20 tiers for each Calling Circle
product detail and each tier within each Calling Circle product detail has a maximum of 100 numbers.
Record Name: CALLING CIRCLE DETAILS
Record Type: 815
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘815’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account. 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential therefore providing a
unique identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence number within invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
OPTION-DESCRIPTION Description of the option used. 30
TIER The tier name which this number is in. 30
DESTINATION The location and number of the call. 27
GROSS-AMOUNT The gross cost of calls. 14
PERCENTAGE-DISCOUNT Rate of discount for this option. 8
TOTAL-DISCOUNT Amount of discount for the option. 14
BEGIN-EFF-DATE The date when this became effective - see notes in section 8. 8 yyyymmdd
END-EFF-DATE The date when this ceased to be effective - see notes in section 8. 8 yyyymmdd
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 26 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Volume Threshold Eligible Amounts (Record type 825) For the Volume Threshold discount, there will one of these records for each eligible item for each source invoice on OneBillPlus invoice. It details the product option,
item description, item amount and the effective dates. There can be up to 5 eligible item records.
Record Name: VOLUME THRESHOLD ELIGIBLE AMOUNTS
Record Type: 825
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘825’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account. 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential therefore providing a
unique identifier.
4
VERSION-NO This is normally 1. However, it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence number within invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
OPTION-DESCRIPTION Description of the option used. 30
ITEM-DESCRIPTION Description of the eligible item. 50
ITEM-AMOUNT Eligible item amount. 14
BEGIN-EFF-DATE The date when this became effective - see notes in section 8. 8 yyyymmdd
END-EFF-DATE The date when this ceased to be effective - see notes in section 8. 8 yyyymmdd
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 27 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Volume Threshold Savings Table (Record type 826) For the Volume Threshold discount, there will be one of these for each range of values, for each eligible item from a source invoice on the OneBillPlus invoice. It gives
the details of the product option, the high and low value of the range this record applies to, the qualifying amount in this range, the percentage discount at this range, the
amount of discount at this range and the effective dates.
Record Name: VOLUME THRESHOLD SAVINGS TABLE
Record Type: 826
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘826’
ONEBIL-AC-NO The unique national BT account number to identify a particular OneBillPlus account. 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential therefore providing a
unique identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence number within invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
OPTION DESCRIPTION Description of the option used. 30
RANGE-LOW The bottom value of the range this record is applied to. 14
RANGE-HIGH The top value of the range this record applies to. 14
QUAL-AMOUNT The qualifying amount in this range. 14
DISCOUNT-RATE The percentage discount at this range. 8
DISCOUNT-AMOUNT The amount of discount at this range. 14
BEGIN-EFF-DATE The date when this became effective - see notes in section 8. 8 yyyymmdd
END-EFF-DATE The date when this ceased to be effective - see notes in section 8. 8 yyyymmdd
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 28 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Bill Trailer (Record type 900) There will be one of these records for each source invoice included in the OneBillPlus invoice. It details the total number of records on the file for a particular invoice.
Record Name: BILL TRAILER
Record Type: 900
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies the record type. 3 ‘900’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account . 10
CSS-AC-ID Source invoice account id. 12
INVOICE-ID Also displayed as ‘Bill Code’ on the OneBillPlus Invoices. The first character equates to
invoice type followed by a numeric value. The value is sequential, providing a unique
identifier.
4
VERSION-NO This is normally 1. However it is incremented if the invoice has been amended. 1
RECORD-NO Record sequence number within invoice. 5
RECORD-CLASS Data type - see notes in section 8. 1
RECORD-COUNT Total number of records on the file for this particular invoice. 10
File Trailer (Record type 999) There will be one of these records on the file.
It identifies the file as a telephony breakdown file and details the creation date, the customer account number and the number of records on the file.
Record Name: FILE TRAILER
Record Type: 999
FIELD DESCRIPTION SIZE FORM/VALUE
RECORD-TYPE Identifies record type. 3 ‘999’
ONEBILLPLUS-AC-NO The unique national BT account number to identify a particular OneBillPlus account . 10
FILE-TYPE Identifies the file as the telephony breakdown file. 10 ‘BTCALLBAS
E’
INVOICE-ID Invoice Id. 4
RUN-DATE The date the file was created. 8 yyyymmdd
PROGRAM-ID Identifies the Mag media file type. 8
PROGRAM-VERSION-NO Identifies the version number of this file format. See note on file version in section 6. 7
NO-OF-DATA-RECS The total number of records on the file (excluding the header and trailer). 9
OneBillPlus CD-ROM Technical Guide
Issue 4.0 Page 29 of 29
September 2006
Billing Consultants and Tactical Solutions
© Copyright α α α α 1999
Register of Amendments
Version
No
Amendment
4.0 Record Type 590 - CHARGE TYPE field amended to include “N” for Network Rental September 2006