CD-ROM Technical Guide (Telephony) File 3

29
OneBillPlus CD-ROM Technical Guide Issue 4.0 Page 1 of 29 September 2006 Billing Consultants and Tactical Solutions [email protected] © Copyright α α α 1999 BT OneBillPlus CD-ROM Technical Guide (Telephony) File 3

Transcript of CD-ROM Technical Guide (Telephony) File 3

Page 1: 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

[email protected]

© Copyright αααα 1999

BT OneBillPlus

CD-ROM Technical Guide

(Telephony)

File 3

Page 2: 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

[email protected]

© 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

Page 3: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 3 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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.

Page 4: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 4 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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.

Page 5: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 5 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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.

Page 6: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 6 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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.

Page 7: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 7 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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:-

Page 8: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 8 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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

Page 9: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 9 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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

Page 10: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 10 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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’

Page 11: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 11 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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.

Page 12: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 12 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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.

Page 13: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 13 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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

Page 14: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 14 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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.

Page 15: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 15 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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.

Page 16: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 16 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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.

Page 17: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 17 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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.

Page 18: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 18 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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

Page 19: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 19 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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

Page 20: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 20 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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.

Page 21: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 21 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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’

Page 22: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 22 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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

Page 23: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 23 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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

Page 24: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 24 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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

Page 25: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 25 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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

Page 26: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 26 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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

Page 27: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 27 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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

Page 28: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 28 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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

Page 29: CD-ROM Technical Guide (Telephony) File 3

OneBillPlus CD-ROM Technical Guide

Issue 4.0 Page 29 of 29

September 2006

Billing Consultants and Tactical Solutions

[email protected]

© 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