Netzfahrplan / fNAV

Calculate fNAV economics: avoided CAPEX, annual fee, payback (Phase 5)

Deterministic fNAV economics assessment. Computes:

  • avoidedCopperCapexEur: cost of conventional grid expansion avoided by fNAV
  • annualFeeEur: recurring cost of the fNAV contract
  • paybackYears: avoidedCapex / annualFee
  • sensitivityFlags: qualitative flags for high uncertainty inputs

Option B: calls eog-calculator.capexEstimate for TOTEX-based CAPEX reference; if unavailable, uses parametric fallback (FN_ECONOMICS_PARTIAL).

Governance Option B: governanceStatus is always requires_governance_decision until legalStatus=approved AND contractStatus=signed.

post/api/finance-agent/fnav/economics

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/finance-agent/fnav/economics
  • Auth: none declared

Query parameters

tokenstring

Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.

Request body

voltageLevel'NS' | 'MS' | 'HS'
gridOperatorstring

Used for eog-calculator lookup

annualFeeEurnumber

Annual fNAV contract fee (EUR/yr)

ownerContactstring
avoidedCapexOverrideEurnumber

Override avoided CAPEX (EUR)

tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "fnavProfile": {
    "requestedCapacity": 5000,
    "firmCapacity": 3000,
    "flexibleCapacity": 2000,
    "curtailmentWindow": 4,
    "signalPriorityPolicy": "Netzsignal Vorrang vor Vermarktungs- und Fahrplanoptimierung",
    "controlEvidenceRef": "SCADA-ATTACHMENT-42 / Fernwirknachweis 2026-05",
    "contractStatus": "negotiating",
    "legalStatus": "pending"
  },
  "gridOperator": "STROMDAO Netze",
  "annualFeeEur": 12000,
  "ownerContact": "netzplanung@stromdao.de",
  "avoidedCapexOverrideEur": 1500000
}

Response

fNAV economics result

avoidedCopperCapexEurnumber
annualFeeEurnumber
paybackYearsnumber
capexSource'eog_calculator' | 'parametric_fallback' | 'override'
sensitivityFlagsstring[]
governanceStatusstring
governanceBlockersstring[]
contractGateobject

Explicit contract-gate assessment

governanceArtifactobject nullable
decisionChainobject[]
proofobject
findingsobject[]
metadataobject

Changes

No recorded changes to this operation across all 2 revisions of this API.