Source Exchange Object Structure
The below bulleted points are required to be read before understanding the figure 6 (Source
File Format)
Each record starts with CA001, CA020, CA003, CA004, CA005, CA006, CA016,
CA009, CA019, CA010, [Link] are identifiers for each record line. The end of
the file is identified by CA999.
Each record set contains the identifiers and is in the sequence as defined below. This
record set repeats in the file.
CA001, CA020, CA003, CA004, CA005, CA006, CA016, CA009, CA019, CA010,
CA011,CA999
CA006 and CA016 occurs only if CA005 is present in the record set.
CA019 occurs only if CA009 is present in the record set.
Occurrence (O) & Mandatory / Optional :
o CA001 – This is the start of the record set. Only occurs once and is
mandatory in a record set. This is represented as (O=1) in the figure.
o CA020 - Only 1 time and is mandatory in a record set. This is represented as
(O=1)
o CA003 - Only occurs once and is mandatory in a record set. This is
represented as (O=1)
o CA004 – It is mandatory but number of occurrence can vary in a record set.
This is represented as (O=1….M)
o CA005 – Optional. Maximum occurrence will be twice. This is represented as
(O=0,1,2)
o CA006 – Conditional Mandatory only if CA005 is present. If there is one
CA005, then there will be one occurrence of CA006. If there is two CA005,
then also there will be one occurrence of CA006. This is represented as
(O=1).
o CA016 - Conditional Mandatory only if CA005 is present. If there is one
CA005, then there may/ maynot be one occurrence of CA016. If there is two
CA005, then also there may/ maynot be one occurrence of CA016. This is
represented as (O=0,1).
o CA009 – Optional. Maximum occurrence will be once. This is represented as
(O=0,1)
o CA019 - Conditional Mandatory only if CA009 is present. If there is one
CA009, then there may/ maynot be one occurrence of CA019. This is
represented as (O=0,1).
o CA010 – Mandatory. Maximum occurrence will be twice. This is represented
as (O=1,2)
o CA011 – Optional. Maximum occurrence will be once. This is represented as
(O=0,1)
Footer CA999 is available at the end of the file. This occurs only once in the file.
Occurrence
CA001
O=1 CA Reference Number^Registration Record Type^Customer Account Title^Prefix^Badge Id^Office PIN^
Sales Channel^Change of Tenancy Flag^Customer Type^Data Protection^Gains Channel^
From Contract Splitter^Responsible for paying bills^Signed Date^Npower Batch Reference^Tiff Image location
CA020
O=1...M Customer Title^Customer Forename^Customer Surname^Customer Initials^Email Address ^Home
Telephone Number^Primary Code^Subscriber Code^Work Telephone Number^Primary Code ^Subscriber
Code^Mobile Tel. No.^Primary Code^Subscriber Code^Customer CPD Key^Preferred time of call^Preferred
day^Date Of Birth^Tenure,Point Of Sale_Online Bill View
O=1, 2 CA003
House Name^House Number^Street^Village^Town^County^Postcode^Address Usage Type
O=0..M CA004
Special Needs Flag^Special Needs Type^Customer Comments
CA005
O=0,1,2
Product Code^Product Start Date^MPAN Core^New Connection Flag^Profile Class Id^Meter/Timeswitch
Class Id^LLF Class Id
SOURCE FILE CA006
FORMAT
Previous Electricity Supplier^Standard Domestic Flag^Economy 7 or similar flag^Standing Charge Option
(One Record Set) O=1 ^Prepayment Meter,^Meter serial number^Meter Register 1^Meter Register 2^Meter Register 3^Meter
Register 4^Meter Register 5^Annual Elec Bill^Monthly DD Amount^Existing npower Customer Account
Number^Existing Product Type^Confirmation of DD Upsell^Electricity PP Type^Meter serial number 2^2/3
rate Meter serial number
CA006 and/or CA016 occurs CA016
only if CA005 is present O=0,1 Annual consumption^Annual consumption calculation basis^Competitors product^Competitors annual
price^npowers annual price^Annual saving^mdd amount
CA009
O=0,1 Product Code^Product Start Date^New Connection Flag^Current Supplier^Annual Gas Bill^Monthly DD
Amount^Prepayment Meter^M Number^Meter serial number^Meter Register 1^Existing npower Customer
Account Number^Existing Product Type^Confirmation of DD Upsell
CA019
O=0,1 Annual consumption^Annual consumption calculation basis^Competitors product^Competitors annual
CA019 occurs only
price^npowers annual price^Annual saving^mdd amount
if CA009 is present
O=1,2 CA010
Payment Method^Fuel Type^Kilo Indicator
CA011
O=0,1
Bank Sort Code^Account Number^Account Name^Direct Debit Amount^Direct Debit Start Date^Preferred DD
date
Figure 6: Source File Format
Registration Details (CA001) – Every record starts with CA001. In a file there could be
multiple records starting with CA001.
Attributes -
CA Reference Number,Registration Record Type,Customer Account Title,Prefix,Badge
Id,Office PIN,Sales Channel (Campaign Code),Change of Tenancy Flag,Customer Type,Data
Protection,Gains Channel,From Contract Splitter,Responsible for paying bills,Signed
Date,Npower Batch Reference,Tiff Image location
Customer Details (CA020) – Mandatory, Under CA001 there will be a section CA020 which
gives the customer details.
Attributes -
Customer Title,Customer Forename,Customer Surname,Customer Initials,Email
address,Home Telephone Number,Primary Code,Subscriber Code,Work Telephone
Number,Primary Code,Subscriber Code,Mobile Tel. No.,Primary Code,Subscriber
Code,Customer CPD Key,Preferred time of call,Preferred day,Date Of Birth,Tenure,Point Of
Sale_Online Bill View
Address Details (CA003) – Mandatory, Under CA001 there will be two (1..2) sections
CA003 which gives the customer address details.
Attributes -
House Name,House Number,Street,Village,Town,County,Postcode,Address Usage Type
Special Needs Details (CA004) – Mandatory, Under CA001 there will be a section CA004
which gives the Special needs details.
Attributes -
Special Needs Flag,Special Needs Type,Customer Comments
Electricity Registration Details (CA005) – Optional, Under CA001 there would be two
sections CA005 which gives the electricity registration details.
Attributes -
Product Code,Product Start Date,MPAN Core,New Connection Flag,Profile Class
Id,Meter/Timeswitch Class Id,LLF Class Id
#Note: Refer section 4.3.2 for the dependencies.
Electricity Tariff Details (CA006) – Conditional Mandatory, Under CA005 there would be a
section CA006 which gives the electricity tariff details. If there is no CA005 section in the file,
CA006 section will not be there. The conditional mandatory check would not be carried in PI.
Attributes -
Previous Electricity Supplier,Standard Domestic Flag,Economy 7 or similar flag,Standing
Charge Option,Prepayment Meter,Meter serial number,Meter Register 1,Meter Register
2,Meter Register 3,Meter Register 4,Meter Register 5,Annual Elec Bill,Monthly DD
Amount,Existing npower Customer Account Number,Existing Product Type,Confirmation of
DD Upsell,Electricity PP Type,Meter serial number 2,2/3 rate Meter serial number
Ofgem Electricity Tariff Details (CA016) – Conditional Mandatory, Under CA005 there
would be a section CA016 which gives the electricity tariff details. If there is no CA005 section
in the file, CA016 section will not be [Link] conditional mandatory check would not be
carried in PI.
Attributes -
Annual consumption, Annual consumption calculation basis, Competitors product,
Competitors annual price, npowers annual price, Annual saving, mdd amount
Gas Tariff Details (CA009) – Optional, Under CA001 there would be a section CA009 which
gives the Gas tariff details.
Attributes -
Product Code,Product Start Date,New Connection Flag,Current Supplier,Annual Gas
Bill,Monthly DD Amount,Prepayment Meter,M Number,Meter serial number,Meter Register
1,Existing ,npower Customer Account Number,Existing Product Type,Confirmation of DD
Upsell
#Note: Refer section 4.3.2 for the dependencies
Ofgem GAS Tariff Details (CA019) – Conditional Mandatory, Under CA009 there would be
a section CA019 which gives the Gas tariff details. If there is no CA009 section in the file,
CA019 section will not be there. The conditional mandatory check would not be carried in PI.
Attributes -
Annual consumption, Annual consumption calculation basis, Competitors product,
Competitors annual price, npowers annual price, Annual saving, mdd amount
Payment Details (CA010) – Optional, Under CA001 there would be two sections CA010,
this gives the payment details.
Attributes -
Payment Method,Fuel Type,Kilo Indicator
Direct Debit Details (CA011) – Optional, Under CA001 there would be a section CA011
which gives the Direct debit details.
Attributes -
Bank Sort Code,Account Number,Account Name,Direct Debit Amount,Direct Debit Start
Date,Preferred DD date.
File End (CA999) – Each file ends with E999. There is no record end identifier in the
CAVIF300 file format.
