BillConverter

A MeterID resource

Guides 5

Commodities Electric · Gas · Water · Sewer · Steam

Get data out of
your utility bills.

Learn which fields to capture, how bill identifiers differ, and which checks catch missing or misread data.

Read the guidesField reference
Sample account · Electric · kWh13 periods
Monthly electric usage for a sample commercial account, in kWh
PeriodUsage (kWh)Read type
Jul 202441,200actual
Aug 202444,800actual
Sep 202438,600actual
Oct 202429,400actual
Nov 202424,100actual
Dec 202423,700actual
Jan 202525,900actual
Feb 202518,900estimated
Mar 202533,600true-up
Apr 202528,500actual
May 202531,200actual
Jun 202543,900actual
Jul 202546,300actual
Read type

February was estimated. March includes the correction after an actual read. Treating both entries as ordinary monthly usage would create a false dip and spike.


Extraction · 10 printed lines · 12 stored fields

What a printed line becomes

A useful extraction does more than copy text. It separates dates, keeps units beside quantities, normalizes labels, and preserves values needed for review.

Printed on the billIllustrative example
ACCOUNT NUMBER   6512 4400 0034 1
SERVICE ADDRESS  410 W 34TH ST
METER #          E-88213041
SERVICE PERIOD   Jun 14 - Jul 15
RATE             SC 9 RATE I
TOTAL USED       46,300 KWH
READING          ACTUAL
CURRENT CHARGES  $8,214.66
PREVIOUS BALANCE $7,905.10
TOTAL DUE        $16,119.76
What you store1 row / meter / period
{
  "account_number": "651244000341",
  "service_address": "410 W 34th St",
  "meter_number": "E-88213041",
  "service_period_start": "2025-06-14",
  "service_period_end": "2025-07-15",
  "rate_schedule": "SC 9 Rate I",
  "usage_quantity": 46300,
  "usage_unit": "kWh",
  "read_type": "actual",
  "current_charges": 8214.66,
  "prior_balance": 7905.10,
  "total_amount_due": 16119.76
}
Not 1:1

The service period becomes separate start and end dates. Usage becomes a number plus a unit. Labels such as “READING” and “TOTAL USED” become consistent field names, while the printed values are preserved.

Minimum schema · 15 fields · 4 groups

A working minimum schema

Account number, total due, and usage are enough for a payment record, but not for reliable analysis. These 15 fields form a practical starting point. Use one row per meter, commodity, and service period so multi-meter bills remain usable.

FieldGroupWhy it matters
account_numberIdentityStore as text to preserve leading zeros and dashes.
meter_numberIdentitySerial on the physical device. Changes when the meter is swapped.
point_of_delivery_idIdentityService Agreement ID, ESI ID, POD ID, or another location-level identifier.
rate_scheduleIdentityTariff code as printed. Useful when cost changes but usage does not.
commodityIdentityelectric, natural_gas, water, sewer, steam.
service_period_startDatesFirst day covered by the usage entry. Do not substitute the bill date.
service_period_endDatesLast day covered, stored as an ISO 8601 date.
read_typeDatesActual or estimated. Estimates can distort month-to-month comparisons.
usage_quantityUsagePair every quantity with its unit in the same row.
usage_unitUsagekWh, therms, CCF, MCF, gal, kGal. Convert in the query layer, not on ingest.
demand_quantityUsageCommercial electric demand, usually in kW or kVA.
current_chargesMoneyCharges for the current service period.
supply_chargesMoneyGeneration, energy supply, or basic service charges.
delivery_chargesMoneyDistribution, transmission, and related delivery charges.
total_amount_dueMoneyAmount payable, which may include a prior balance, fees, or credits.

Compute days_in_period, average_daily_usage, andblended_rate from these rather than reading them off the bill. The printed figures may use different rounding rules. Recomputing them keeps the dataset consistent. Thefull forty-field version has types, units, and the ones not worth bothering with.

Units · 6 common labels

Units that are easy to confuse

A quantity without its unit cannot be interpreted safely. One CCF of water is about 748 gallons; one CCF of natural gas is a volume that must be converted to energy with the bill's heat-content factor.

kWhElectric

Common on electric bills. Some large accounts print MWh instead.

thermGas

100,000 BTU. A heat unit, not a volume unit.

CCFGas · Water

100 cubic feet. For gas, convert with the heat-content factor on the bill.

HCFWater

The same thing as CCF. Different abbreviation, same 100 cubic feet.

MCFGas

1,000 cubic feet. Ten times CCF, and the two get confused.

kGalWater

1,000 gallons. One CCF of water is 748 gallons.


If it outgrew the spreadsheet

Have hundreds of bills every month?

MeterID collects utility bills, checks the data, and delivers structured output for multi-site portfolios. It is built for teams that no longer want to maintain this process by hand.

See MeterID