Electricity and gas bills
import { parseElectricityRef, validateElectricityRef, validateGasConsumerNumber } from 'pakdatakit/bills'
Checks the bill numbers people are asked for when they pay or look up a utility bill. The formats are those the utilities’ own bill pages ask for: a 14-digit DISCO reference number with a separate U/R choice, a 10-digit DISCO customer ID (11 digits for LESCO), a 13-digit K-Electric account number starting from 04000, and gas consumer numbers of 11 digits for SNGPL and 10 for SSGC.
parseElectricityRef() Valid
- Kind
- DISCO reference number
- Formatted
- 12 34567 8901234 U
- Urban/rural
- U
- Company
- —
validateGasConsumerNumber() Valid
Examples
Section titled “Examples”import { parseElectricityRef, validateGasConsumerNumber } from 'pakdatakit';
parseElectricityRef('12 34567 8901234 U');// → {// "type": "reference",// "digits": "12345678901234",// "formatted": "12 34567 8901234 U",// "urbanRural": "U",// "disco": null// }
parseElectricityRef('0400012345678');// → {// "type": "k-electric",// "digits": "0400012345678",// "formatted": "0400012345678",// "urbanRural": null,// "disco": "K-Electric"// }
validateGasConsumerNumber('12345678901', 'SNGPL');// → true
validateGasConsumerNumber('12345678901', 'SSGC');// → falsefrom pakdatakit import parse_electricity_ref, validate_gas_consumer_number
parse_electricity_ref('12 34567 8901234 U')# → {# "type": "reference",# "digits": "12345678901234",# "formatted": "12 34567 8901234 U",# "urban_rural": "U",# "disco": None# }
parse_electricity_ref('0400012345678')# → {# "type": "k-electric",# "digits": "0400012345678",# "formatted": "0400012345678",# "urban_rural": None,# "disco": "K-Electric"# }
validate_gas_consumer_number('12345678901', 'SNGPL')# → True
validate_gas_consumer_number('12345678901', 'SSGC')# → Falseimport 'package:pakdatakit/pakdatakit.dart';
parseElectricityRef('12 34567 8901234 U');// → {// "type": "reference",// "digits": "12345678901234",// "formatted": "12 34567 8901234 U",// "urbanRural": "U",// "disco": null// }
parseElectricityRef('0400012345678');// → {// "type": "k-electric",// "digits": "0400012345678",// "formatted": "0400012345678",// "urbanRural": null,// "disco": "K-Electric"// }
validateGasConsumerNumber('12345678901', 'SNGPL');// → true
validateGasConsumerNumber('12345678901', 'SSGC');// → falseusing PakDataKit;
Bills.ParseElectricityRef("12 34567 8901234 U");// → {// "type": "reference",// "digits": "12345678901234",// "formatted": "12 34567 8901234 U",// "urbanRural": "U",// "disco": null// }
Bills.ParseElectricityRef("0400012345678");// → {// "type": "k-electric",// "digits": "0400012345678",// "formatted": "0400012345678",// "urbanRural": null,// "disco": "K-Electric"// }
Bills.ValidateGasConsumerNumber("12345678901", GasCompany.Sngpl);// → true
Bills.ValidateGasConsumerNumber("12345678901", GasCompany.Ssgc);// → falseuse PakDataKit\Bills;
Bills::parseElectricityRef('12 34567 8901234 U');// → {// "type": "reference",// "digits": "12345678901234",// "formatted": "12 34567 8901234 U",// "urbanRural": "U",// "disco": null// }
Bills::parseElectricityRef('0400012345678');// → {// "type": "k-electric",// "digits": "0400012345678",// "formatted": "0400012345678",// "urbanRural": null,// "disco": "K-Electric"// }
Bills::validateGasConsumerNumber('12345678901', 'SNGPL');// → true
Bills::validateGasConsumerNumber('12345678901', 'SSGC');// → falseReference
Section titled “Reference”parseElectricityRef()
Section titled “parseElectricityRef()”function parseElectricityRef(input: string): ElectricityRef | null;
type ElectricityRefType = 'reference' | 'customer-id' | 'k-electric';
interface ElectricityRef { type: ElectricityRefType; digits: string; // without separators or the U/R letter formatted: string; // 01 14111 1234567 U for a reference, the digits otherwise urbanRural: 'U' | 'R' | null; disco: 'K-Electric' | null;}Parameters. input: a DISCO reference number (14 digits, optionally followed by U for urban or R for rural), a DISCO customer ID (10 digits, or 11 for LESCO) or a K-Electric account number (13 digits starting 04000). Spaces, dashes and dots are ignored, and Urdu digits are accepted.
Returns the identifier, or null when it matches none of the formats. It never throws. A reference is formatted as 2, 5 and 7 digits, as on PITC’s bill illustration.
Caveats. disco is K-Electric for a K-Electric account and otherwise always null, because no official source maps reference or customer ID digits to a DISCO. No check digit is published, so only the format is checked. IESCO notes that reference numbers can change.
Related: validateElectricityRef().
validateElectricityRef()
Section titled “validateElectricityRef()”function validateElectricityRef(input: string): boolean;Parameters. input: as for parseElectricityRef().
Returns true when the input is one of the electricity bill formats above.
Related: parseElectricityRef().
validateGasConsumerNumber()
Section titled “validateGasConsumerNumber()”function validateGasConsumerNumber(input: string, company: GasCompany): boolean;
type GasCompany = 'SNGPL' | 'SSGC';Parameters. input: the consumer number from the gas bill. company: SNGPL or SSGC; anything else returns false.
Returns true for 11 digits with SNGPL or 10 digits with SSGC, as their bill pages ask for.
Caveats. No check digit is published, so only the format is checked.
Related
Section titled “Related”- CNIC and phone checks for the same forms.
- API reference for
pakdatakit/bills.