Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nomos.energy/llms.txt

Use this file to discover all available pages before exploring further.

A smart meter (an intelligentes Messsystem, or iMSys) is the precondition for almost every product you can offer beyond a flat-rate tariff. Getting one is the bottleneck: the grundzuständige Messstellenbetreiber (gMSB) is obliged to roll out to the §29 MsbG mandatory cohort first; for everyone else, going through a wettbewerblicher Messstellenbetreiber (wMSB) is the only path with a predictable timeline. Through Nomos’s wMSB partnerships, your customers (mandatory cohort or not) reach an installed iMSys at a target lead time of around eight weeks.

​
What a smart meter unlocks

  • Dynamic pricing. The customer pays the actual hourly wholesale price they consumed at, not a smoothed annual average.
  • §14a EnWG savings. Heat pumps and wallboxes can claim Module 1, 2, or 3. The VNB only meters and dims a controllable load if there’s an iMSys behind it.
  • HEMS and EV-charger optimisation. Live 15-minute consumption data instead of monthly estimates.
  • Hands-off readings. The meter reports automatically; your ops team stops chasing customers for annual self-readings.

​
How to order

1

Enable the smart-meter product on your plan

Ask Nomos support to enable a smart-meter product on the plan you’ll be selling.
2

Order at checkout, or after the subscription exists

During checkout, include { type: "smart-meter" } in the product_orders array on Create a subscription. For an existing subscription, call Create a smart meter order with the subscription ID in the body.
3

Track status

Poll List smart meter orders or Retrieve a smart meter order until the order reaches activated. Daily polling is plenty; meter orders move on the timescale of weeks.
A heat-pump customer typically wants both: a smart meter to enable dynamic billing, and §14a Module 1 for the reduced grid fee. You can include both entries in a single product_orders array. See §14a grid fee reductions.
Customers can also place the order from the hosted customer portal, and your team can place one from the dashboard. Both call the same endpoint under the hood.

​
Status lifecycle

The happy path is waiting → ordered → checked → installation_planning → installation_scheduled → installation_finished → activated. Once the order reaches activated, dynamic prices are real and you can start showing them to the customer. Terminal states are activated (success), cancelled, and the two blocked* states, which usually need a human to unstick them.
  • waiting: Order accepted; collecting metering details (MaLo, MeLo) before handing it to the wMSB.
  • intended: Customer expressed interest at checkout but hasn’t finalised the order. Specific to the inexogy provider; the standard wMSB flow doesn’t surface this state.
  • ordered: Order is with the wMSB partner.
  • checked: The wMSB has validated the order and confirmed they will install.
  • installation_planning: Installation is being scheduled with the customer.
  • installation_scheduled: A concrete installation date is on the calendar.
  • installation_waiting: Date confirmed; waiting for the installation to happen.
  • installation_finished: Meter installed; meter data is being handed back to the network operator.
  • installed: Hardware is in place.
  • pre_installed: A smart meter was already installed at the location before Nomos placed the order.
  • activated: The meter is live and reporting; dynamic pricing and automatic readings are now possible.
  • blocked: Held for manual review (typically waiting on admin approval).
  • blocked_wim: Held inside the Wechselprozess im Messwesen, waiting on the network operator.
  • cancelled: Order is cancelled and won’t progress further.

​
FAQ

Around eight weeks end to end through a Nomos wMSB partner, though it depends on the customer’s region, meter access, and the wMSB’s local capacity.
Not directly. A subscription can have at most one meter order ever; once cancelled, a second POST /meter-orders returns 409 CONFLICT. Email support@nomos.energy to retry.
Coming soon. Until then, daily polling on the list endpoint covers the real-world cadence.
The order moves directly into pre_installed and then activated once the existing meter is registered to the new contract.