How your data is organized
Your utility data in Nectar follows a simple hierarchy:Sites
A site is a physical location — a building, warehouse, office, or facility. Sites are the central organizing unit in Nectar. Every meter belongs to a site, and all your analytics roll up to site and portfolio levels. Example: Your headquarters at 123 Main Street is a site. So is your warehouse at 456 Industrial Ave. Related docs: Sites overviewMeters
A meter tracks one type of utility at a site. Each meter measures a specific commodity like electricity, natural gas, or water. A single site might have multiple meters — one for electricity, one for gas, and one for water. Example: Your headquarters might have an electricity meter (tracking kWh) and a natural gas meter (tracking therms). Related docs: Meters overview, Meter detailAccounts
An account is your billing relationship with a utility company, identified by an account number. Accounts are discovered automatically when you connect to a utility portal. One account can have multiple meters. Example: Your PG&E account #123456789 might include both your electricity and gas service. Related docs: Accounts overview, Account detailBills
A bill is a single utility statement covering a specific time period. Bills contain usage data (how much you consumed) and charges (how much it cost). Nectar processes bills from connections, uploads, or manual entry. Related docs: Bills overview, Bill detailUsage vs. charges: two types of data
Every bill contains two distinct types of information:Usage data
What you consumed — measured in physical units like kWh (electricity), therms (gas), or gallons (water). This is the basis for consumption tracking, emissions calculations, and benchmarking.
Charge data
What you paid — the dollar amounts on your bill. This includes energy charges, delivery fees, taxes, and credits. Used for cost tracking and budget analysis.
Usage and charges don’t always move together. You might see high charges with moderate usage (due to demand charges or rate increases) or low charges with high usage (due to credits or promotional rates).
Understanding billing periods
The billing period is the date range a bill covers. Most utility bills cover about a month, but the exact dates vary by utility and meter read schedule.Key dates
| Date | What it means |
|---|---|
| Start date | First day of service covered by this bill |
| End date | Last day of service covered (also called the “bill date”) |
| Due date | When payment is expected |
Why billing periods matter
Billing periods rarely align with calendar months. A bill dated January 20 might cover December 21 – January 20. This is why Nectar converts billing data to calendar months for consistent reporting.Total charges vs. current charges
Understanding this distinction helps you interpret your bills correctly:Total charges
The full amount due — what you’d pay to settle the account. Includes new charges plus any previous unpaid balance, minus payments received.Current charges
The cost of this period only — charges generated by your consumption during this billing period. This is what Nectar uses for analytics to avoid counting carried-over balances.How connections work
A connection links Nectar to a utility provider. Once set up, Nectar automatically collects new bills on a regular schedule.| Connection type | How it works |
|---|---|
| Online connection | Nectar logs into the utility portal using your credentials |
| Email connection | You forward bill emails to a Nectar email address |
- Downloads the bill documents
- Extracts usage, charges, and meter information
- Matches data to existing meters (or creates new ones)
- Makes the data available in your dashboard