Skip to main content

Extract data from utility supply contracts

A utility supply contract is the agreement a customer signs with an energy, gas, or water supplier that sets the price and the terms before a single unit is billed. It is not the monthly statement: a utility bill applies rates to metered consumption after the fact, while the contract is what fixes those rates, the term, and the conditions in the first place. This agreement names the supplier and the customer, identifies the exact metering or delivery point being served, states the tariff, and sets how long the arrangement runs and how it renews. Procurement teams, energy managers, and the accounts-payable staff who later check invoices against the deal all read the same terms from it. What drives the cost is the unit price, the base fee, the estimated consumption, and the contract mechanics. Unit price is charged per unit consumed, per kWh for electricity or per cubic meter for gas or water, while the base fee is a fixed standing charge billed regardless of use, so the estimated annual cost is the unit price applied to the estimated consumption plus the standing charge. Its supply point identifier, a metering-point number such as a German Zaehlpunkt, ties the contract to a physical meter. Contract term, the notice period required to leave or decline renewal, any early-termination fee, and the price-adjustment clause that allows indexation all decide how locked-in the customer is. Where a tariff is banded, the price components and consumption tiers spell out the rate at each level. Talonic reads the utility supply contract and returns the supplier and customer, the supply point, the utility type, the unit price and base fee, the estimated consumption, and the term and notice period as typed fields, keeping the price components and consumption tiers as tables. A contract from Rheinstrom Energie GmbH to Brandt Manufacturing GmbH for an electricity supply point, effective 2026-01-01 on a 24-month term, at 0.25 EUR per kWh with a 20 EUR monthly base fee against an estimated 500,000 kWh per year, giving an estimated annual value of 125,240 EUR and a term value of 250,480 EUR, loads into a contract register instead of a filed PDF. In short, Talonic structures the terms as written and does not check the tariff against a bill or advise on the deal.

What gets extracted from utility supply contracts

Contract NumberUC-2026-0091
SupplierRheinstrom Energie GmbH
CustomerBrandt Manufacturing GmbH
Supply Point IDDE0001234567890123456789012345Metering point (Zaehlpunkt)
Utility TypeElectricity
Unit Price0.25 EUR per kWh
Base Fee20 EUR per month
Estimated Annual Consumption500,000 kWh
Contract Term24 months
Notice Period3 months

How extraction works for utility supply contracts

Utility supply contracts come from energy retailers, network operators, and municipal utilities, each with its own tariff sheet and clause order, so the rate and the term sit in different places from one supplier to the next. Talonic reads the contract and resolves each value against the utility-supply field set that the Field Registry maintains, which keeps the supplier and customer, the supply point and utility type, the pricing, and the term-and-exit clauses as separate fields rather than one tariff page. Unit price, base fee, estimated annual consumption, and early-termination fee are typed as numbers in their ISO 4217 currency and with their units, so the estimated annual cost can be reconciled from the unit price applied to consumption plus the standing charge. Effective and expiration dates and the contract term and notice period are parsed, the price-adjustment clause is captured as its own field, and the price components and consumption tiers each load as a table so a banded tariff is legible per level. Provenance follows DIN SPEC 91491, attaching a confidence score and a source-region pointer to every value, so an energy manager can verify the unit rate or the notice period against the contract. Ultimately, Talonic captures the terms as written and does not reconcile them against a bill or advise on the tariff.

Sample extraction

A 24-month electricity supply contract for a commercial site

{
  "document_number": "UC-2026-0091",
  "document_date": "2025-12-10",
  "effective_date": "2026-01-01",
  "expiration_date": "2027-12-31",
  "currency": "EUR",
  "total_amount": 250480,
  "payment_terms": "Monthly installment payments (Abschlagszahlung), settled on annual meter reading",
  "governing_law": "Germany",
  "supplier.name": "Rheinstrom Energie GmbH",
  "supplier.address": "Rheinallee 12, 40219 Duesseldorf",
  "customer.name": "Brandt Manufacturing GmbH",
  "customer.address": "Industriestrasse 44, 14513 Teltow",
  "supply_point_id": "DE0001234567890123456789012345",
  "utility_type": "electricity",
  "contract_term": "24 months",
  "notice_period": "3 months",
  "base_fee": 20,
  "unit_price": 0.25,
  "price_unit": "EUR/kWh",
  "estimated_annual_consumption": 500000,
  "consumption_unit": "kWh",
  "price_adjustment_clause": "Prices may be adjusted for statutory levies and grid fees with 6 weeks written notice",
  "early_termination_fee": 2500,
  "price_components": [
    {
      "component_name": "Base fee",
      "unit_price": 20,
      "unit": "EUR/month",
      "applies_to": "Fixed standing charge"
    },
    {
      "component_name": "Energy price",
      "unit_price": 0.25,
      "unit": "EUR/kWh",
      "applies_to": "All consumption"
    }
  ]
}

Frequently asked

How is a utility supply contract different from a utility bill?

A utility supply contract sets the tariff, term, and conditions before consumption is billed. A utility bill applies those rates to metered usage after the fact. Talonic reads the contract on its own schema and cross-links to the utility-bill extractor for the invoice.

Does it capture the tariff detail?

Yes. The unit price, the base fee, and the estimated annual consumption are typed with their units and currency, and the price components and consumption tiers load as tables, so a banded tariff is read per level rather than as a single rate.

Can I check the estimated annual cost?

The estimated annual cost can be reconciled from the unit price applied to the estimated consumption plus the standing charge, so 500,000 kWh at 0.25 EUR plus a 20 EUR monthly base fee gives an estimated 125,240 EUR per year and 250,480 EUR over the 24-month term.

Does Talonic reconcile the contract against a bill?

No. It structures the terms the contract states and links each to its source region. Comparing the contracted rate to what a later invoice charges is a task for the energy manager, not the extraction.

Author note

Reviewed by Talonic engineering, contracts schema review · last reviewed 2026-07-09