AAPT Invoice Data File (CSVI) Specification

Document Name: 09ebd0c08a24780a7f50ecb28bc15248.docx Author: AAPT Billing Systems Version Number and/or Status: 1.4 - Final Security Classification: AAPT Limited Confidential

Document Control

Revision History

Major changes to this document are listed in the table below for each version of the document distributed.

Version Date Author(s) Summary of Changes 1.0 12/06/2012 Peter Stelzer Initial version – demerged from overall wholesale focused document 1.2 05/07/2012 Bernardita Cruz Update of the CSV Files Layout. Introduction of the new record type for Service Details 1.3 22/03/2013 Bernardita Cruz Modification of FileType 003 to cater for Aggregated Usage 1.4 06/05/2013 Bernardita Cruz Addition of the unique Charge ID to voice usage records

AAPT Invoice Data File (CSVI) Specification

Note to Holders:

If you receive an electronic copy of this document and print it out, please write your name on the equivalent of the cover page for document control purposes. If you receive a hard copy of this document, please write your name on the front cover for document control purposes.

AAPT Invoice Data File (CSVI) Specification

Legal Notices

Copyright © 2012 AAPT Limited, all rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying, recording or otherwise without the prior written permission of the AAPT Project Manager. This document is the property of AAPT Limited and may not be disclosed to a third party, or copied without consent.

Use of Names

Throughout this document; AAPT Limited is referred to as AAPT and Telecom New Zealand Limited is referred to as Telecom.

Page 4 of 15 AAPT Limited ABN 22 052 082 416 Error! Reference source not found. Error! Reference source not found.

AAPT Invoice Data File (CSVI) Specification

Table of Contents

AAPT Invoice Data File (CSVI) Specification

1. Glossary

The following words, acronyms and abbreviations are referred to in this document

Term Definition CSVI Comma Separated Value Invoice – a collection of raw data files that the customer can use for analysis Frontier AAPT’s secure customer portal

AAPT Invoice Data File (CSVI) Specification

2. Introduction

The purpose of this document is to provide a specification of the CSV data invoice file available all of AAPT’s customers via Frontier, AAPT’s online and secure customer portal. The specification details each record by column and also includes some sample data which can assist with understanding. It is AAPT’s intention that this data file may be of use to our customers should they wish to analyse their invoice spends by product and usage types.

AAPT Invoice Data File (CSVI) Specification

3. Monthly Files

These files are produced for each Invoicing Period and correspond 1:1 to the invoices generated. Files will normally be available within 3 working days of the last day of the invoicing period.

3.1 CSVI - Invoice Data Files

These files contain the customer invoicing details in electronic format. The Invoice Data supplements the formatted invoice and enables detailed analysis by the customer. Note – both the formatted invoice and CSVI invoice data files are available through ‘Frontier’, the AAPT portal, for all customers. 3.1.1 Naming Convention

File name is: nnnnnnn.0.zip where: nnnnnnn = invoice number 3.1.2 Formatting and File Control

Within the zipped file is a maximum of 12 individual .csv (comma separated values) files (Rec001, Rec002 etc.). The number of files (for an account) can vary for each bill period depending on the data in the invoice. If there is no data for a particular category, then a file will not be created for the corresponding category. For example, when there is no calling card usage, the file type 08 would not exist. The files can be analysed on an individual or multiple account level. The account number provides a common unique key between all files. These are the 12 possible record files + mandatory “readme.txt” file.

File Type Description 001 Bill header / Front page 002 Standard Call Details (National, International, ISDN, etc) 003 Aggregated Usage 004 Account level recurring and non recurring charges and adjustments 005 Service level recurring and non recurring charges and adjustments 006 1800/1300/13 Calls 007 Mobile Calls 008 Calling Card usage 009 Miscellaneous calls 010 Internet usage 011 Teleconferencing usage 012 Service Details Readme.txt Definition of record structures (this file is always present in the zip file)

3.1.3 Record Layout

3.1.3.1 File type 001 - Bill header / Front page

# Field Max Length Type Sample Data 1 Record Type 3 Char 001 2 Account Number 144 Char 0001005848

AAPT Invoice Data File (CSVI) Specification

# Field Max Length Type Sample Data 3 Address Line 1 354 Char Steve Graham 4 Address Line 2 168 Char AMP 5 Address Line 3 225 Char Lvl, 18 Parkes Street 6 Address Line 4 225 Char 7 Address Line 5 105 Char 8 City/Suburb 105 Char Parramatta 9 State 84 Char NSW 10 Postcode 16 Char 2150 11 Statement Date 20 Char 09 Jun 2002 12 Payment Due Date 20 Char 21 Jul 2002 13 Bill Period From Date 20 Char 01 May 2002 14 Bill Period To Date 10 Char 31 May 2002 15 Bill Number 10 Char 98720 16 Previous Account 18 Char $70,458.01 17 Payments Received 18 Char $0.00 18 Previous Bill Adjustments 18 Char $70,458.01CR 19 Non-Recurring Charges 18 Char $2,717.69 20 Recurring Charges 18 Char $30,869.70 21 Usage Charges 18 Char $164,809.35 22 Discounts 18 Char $164.96CR 23 Adjustments 18 Char 24 Total (ex GST) 18 Char $198,231.78 25 GST Payable 18 Char $19,823.18 26 Current Charges (incl 18 Char $218,054.96 GST) 3.1.3.2 File type 002 – Call Details

# Field Max Length Type Sample Data 1 Record Type 3 Char 002 2 Account Number 144 Char 0001005848 3 Department Description 240 Char Sales Department 4 Service Number 144 Char 0298872323 5 Service Type 240 Char Sales 1 6 Usage Type Description 240 Char ISDN 7 Date 10 Char 15 May 2002 8 Time 10 Char 09:15 9 Rate 240 Char Morning 10 Duration 10 Char 0:45 11 Destination 144 Char 0393953242 12 Destination Location 240 Char Melbourne 13 Charge (ex GST) 18 Char $0.18 14 GST Rate 20 Char 10.0000% 15 Origin 144 Char 0284135200 16 Raw Units 18 Char 45 17 Raw Units Type 240 Char Seconds 18 Secondary Rated Amount 18 Char $0.18 19 Charge Id 163 Char 22249011.11.3.0 (Unique ID of the charge)

AAPT Invoice Data File (CSVI) Specification

3.1.3.3 File type 003 – Aggregated Usage

# Field Max Length Type Sample Data 1 Record Type 3 Char 003 2 Account Number 144 Char 0001005848 3 Department Description 240 Char Sales Department 4 Service Number 144 Char 18001234 5 Service Type 240 Char Reach 6 Usage Type Description 240 Char 1800 National 7 Tariff Band 240 Char Standard 8 Qty 7 Char 96 9 Charge (ex GST) 18 Char $104.45 10 GST Rate 20 Char 10.0000% 11 Units 18 Char 1,011:10 12 Units Type 240 Char Min:Sec 13 Raw Units 18 Char 60670 14 Raw Units Type 240 Char Seconds 15 Secondary Rated Amount 18 Char $104.45 3.1.3.4 File type 004 – Account Level Charges / Discounts / Adjustments

# Field Max Length Type Sample Data 1 Record Type 3 Char 004 2 Account Number 144 Char 0001005848 3 Department Description 240 Char Sales Department 4 Description 240 Char Recurring & Other Charges 5 Details 240 Char Network Access Fee 6 Date From 10 Char 01 May 2002 7 Date To 10 Char 31 May 2002 8 Qty 7 Char 1 9 Rate 18 Char $25.00 10 Charge (ex GST) 18 Char $02.50 11 GST Rate 20 Char 10.0000% 3.1.3.5 File type 005 – Service Level Charges / Discounts / Adjustments

# Field Max Length Type Sample Data 1 Record Type 3 Char 005 2 Account Number 144 Char 0001005848 3 Department Description 240 Char Sales Department 4 Service Number 144 Char 0298872323 5 Service Type 240 Char Sales 1 6 Charge Type 240 Char Recurring & Other Charges 7 Details 240 Char Network Access Fee 8 Date From 10 Char 01 May 2002 9 Date To 10 Char 31 May 2002 10 Qty 7 Char 1 11 Rate 18 Char $25.00 12 Charge (ex GST) 18 Char $02.50 13 GST Rate 20 Char 10.0000%

AAPT Invoice Data File (CSVI) Specification

3.1.3.6 File type 006 – 1800/1300/13 Calls

# Field Max Length Type Sample Data 1 Record Type 3 Char 006 2 Account Number 144 Char 0001005848 3 Department Description 240 Char Sales Department 4 Service Number 144 Char 1800036055 5 Service Type 240 Char 1800 Marketing line 6 Destination 240 Char 0299091212 7 Usage Type Description 240 Char Free call 1800/1300/13 8 Date 10 Char 07 May 2002 9 Time 10 Char 15:45 10 Duration 10 Char 2:20 11 Origin 144 Char 0393952424 12 Origin Location 240 Char Melbourne 13 Charge (ex GST) 18 Char $0.85 14 GST Rate 20 Char 10.0000% 15 Raw Units 18 Char 140 16 Raw Units Type 240 Char Seconds 17 Secondary Rated Amount 18 Char $0.85 18 Charge Id 163 Char 22249012.11.3.0 (Unique ID of the charge) 3.1.3.7 File type 007 – Mobile Calls

# Field Max Length Type Sample Data 1 Record Type 3 Char 007 2 Account Number 144 Char 0001005848 3 Department Description 240 Char Sales Department 4 Service Number 144 Char 414526242 5 Service Type 240 Char Mobile 6 Usage Type Description 240 Char Mobile Voice 7 Date 10 Char 09 May 2002 8 Rate 240 Char Afternoon 8 Units 10 Char 2:45 10 Units Type 240 Char Min:Sec 11 Charge (ex GST) 18 Char $4.85 12 GST Rate 20 Char 10.0000% 13 Destination 144 Char 0425735861 14 Raw Units 18 Char 165 15 Raw Units Type 240 Char Seconds 16 Secondary Rated Amount 18 Char $4.85 17 Charge Id 163 Char 22249013.11.3.0 (Unique ID of the charge) 3.1.3.8 File type 008 – Calling Card Calls

# Field Max Length Type Sample Data 1 Record Type 3 Char 008 2 Account Number 144 Char 0001005848 3 Department Description 240 Char Sales Department 4 Service Number 144 Char 0299882323

AAPT Invoice Data File (CSVI) Specification

# Field Max Length Type Sample Data 5 Usage Type Description 240 Char Calling Card 6 Date 10 Char 28 May 2002 7 Time 10 Char 5:45 PM 8 Origin 240 Char United Kingdom 9 Duration 10 Char 0:45 10 Destination 144 Char 029905848 11 Destination Location 240 Char North Sydney 12 Charge (ex GST) 18 Char $0.85 13 GST Rate 20 Char 10.0000% 14 Raw Units 18 Char 45 15 Raw Units Type 240 Char Seconds 16 Secondary Rated Amount 18 Char $0.85 17 Charge Id 163 Char 22249014.11.3.0 (Unique ID of the charge) 3.1.3.9 File type 009 – Miscellaneous Calls

# Field Max Length Type Sample Data 1 Record Type 3 Char 009 2 Account Number 144 Char 0001005848 3 Department Description 240 Char Sales Department 4 Service Number 144 Char 0299882323 5 Service Type 240 Char Sales 1 6 Usage Type Description 240 Char Other Misc. Network 7 Date 10 Char 28 May 2002 8 Time 10 Char 5:45 PM 9 Rate 240 Char Off-peak 10 Duration 10 Char 0:45 11 Destination 144 Char 029905848 12 Type 240 Char Information Call 13 Charge (ex GST) 18 Char $0.85 14 GST Rate 20 Char 10.0000% 15 Origin 144 Char 0732117372 16 Raw Units 18 Char 45 17 Raw Units Type 240 Char Seconds 18 Secondary Rated Amount 18 Char $0.85 19 Charge Id 163 Char 22249015.11.3.0 (Unique ID of the charge) 3.1.3.10 File type 010 – Internet Usage

# Field Max Length Type Sample Data 1 Record Type 3 Char 010 2 Account Number 144 Char 0001005848 3 Department Description 240 Char Sales Department 4 Service Number 144 Char 6005782 5 Service Type 240 Char IP Line 6 Usage Type Description 240 Char IP Download 7 Date 10 Char 28 May 2002 8 Rate 240 Char Internet 9 Units 10 Char 0.07

AAPT Invoice Data File (CSVI) Specification

# Field Max Length Type Sample Data 10 Units Type 240 Char Mbytes 11 Charge (ex GST) 18 Char $520.85 12 GST Rate 20 Char 10.0000% 13 Secondary Number 144 Char 5015239 14 Secondary Number 240 Char IP Line Link Description 15 Raw Units 18 Char 0.07 16 Raw Units Type 240 Char M Bytes 17 Secondary Rated Amount 18 Char $520.85 3.1.3.11 File type 011 – Teleconferencing Calls

# Field Max Length Type Sample Data 1 Record Type 3 Char 011 2 Account Number 144 Char 0001005848 3 Department Description 240 Char Sales Department 4 Service Number 144 Char CONF738833 5 Service Type 240 Char Marketing 6 Conference Reference 96 Char S432091 7 Usage Type Description 240 Char Dail-In Anytime 8 Date 10 Char 03 May 2002 9 Time 10 Char 2:45 PM 10 Rate 240 Char Standard 11 Duration 10 Char 0:45 12 Origin Location 240 Char HK FreePhone 13 Destination 144 Char 029905848 14 Destination Location 240 Char Brisbane 15 Charge (ex GST) 18 Char $6.85 16 GST Rate 20 Char 10.0000% 17 Raw Units 18 Char 45 18 Raw Units Type 240 Char Seconds 19 Secondary Rated Amount 18 Char $6.85 20 Charge Id 163 Char 22249016.11.3.0 (Unique ID of the charge) 3.1.3.12 File type 012 – Service Details

# Field Max Length Type Sample Data 1 Record Type 3 Char 012 2 Account Number 144 Char 0001005848 3 Department Description 240 Char Sales Department 4 Service Number 144 Char 5016747 5 Service Type 240 Char e-Line 6 Service Description 200 Char Connecting Access 1082193 to Access 1078169 7 Service Attributes 200 Char 20Mbps 8 Additional Description 200 Char 9 Customer Supplied 200 Char Reference ID

AAPT Invoice Data File (CSVI) Specification

Sample Files

AAPT Sample File – Voice Services and Usage

AAPT Sample File – Data Services with Recurring and Non-recurring charges

AAPT Invoice Data File (CSVI) Specification

- End of Document -

AAPT Invoice Data File (CSVI) Specification