Netzfahrplan / fNAV

Generate Netzfahrplan / fNAV feasibility assessment

Deterministic fNAV feasibility assessment — evaluates whether a flexible Netzanschlussvertrag (§14a EnWG) is a viable alternative to conventional grid expansion.

Capacity model (Option B):

  • firmCapacityKW: guaranteed, contractually fixed power
  • flexibleCapacityKW: legally curtailable portion under §14a
  • resultingEffectiveCapacityKW: firm + flexible × (1 − curtailmentFactor)

N-1 threshold (Option C — hybrid default + override):

  • Domain defaults: HS=81 MVA, MS=20 MVA, NS=0.63 MVA (env-configurable)
  • tenant/project/scenario overrides are applied in priority order
  • Result always reports thresholdMVA, thresholdSource, and overrideApplied

Governance (Option B):

  • Technical feasibility is reported deterministically
  • Final governanceStatus is requires_governance_decision until legalStatus=approved AND contractStatus=signed
  • Flexible profiles should explicitly document Netzsignal-Vorrang plus a control-evidence reference for the contract gate
post/api/netzfahrplan/generate

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/netzfahrplan/generate
  • 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

gridOperatorIdstring

MaStR grid operator ID

gridOperatorNamestring

Grid operator name

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

Voltage level of the connection point

requestedCapacityKWnumber required

Requested connection capacity in kW

firmCapacityKWnumber

Guaranteed firm capacity in kW (defaults to requestedCapacityKW if omitted)

flexibleCapacityKWnumber

Curtailable flex capacity in kW under §14a

curtailmentWindownumber

Max hours per day the VNB may curtail (0–24)

operatingConstraintstring

Free-text operating constraint

signalPriorityPolicystring

Optional contract-gate wording that explicitly documents grid-signal priority over schedule/market optimisation

controlEvidenceRefstring

Optional reference to the control/remote-control evidence backing the contract gate

contractStatusstring

Contract status

legalStatusstring

Legal/regulatory status

ownerContactstring

Responsible owner or contact (required for governance approval)

tokenstring

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

Example request

{
  "gridOperatorId": "SNB935578300972",
  "gridOperatorName": "STROMDAO Netze",
  "requestedCapacityKW": 5000,
  "firmCapacityKW": 3000,
  "flexibleCapacityKW": 2000,
  "curtailmentWindow": 4,
  "operatingConstraint": "§14a max 2h/event, 30-min notice",
  "signalPriorityPolicy": "Netzsignal Vorrang vor Vermarktungs- und Fahrplanoptimierung",
  "controlEvidenceRef": "SCADA-ATTACHMENT-42 / Fernwirknachweis 2026-05",
  "contractStatus": "negotiating",
  "legalStatus": "pending",
  "ownerContact": "netzplanung@stromdao.de",
  "n1ThresholdOverride": {
    "project": 78
  }
}

Response

fNAV feasibility assessment result

capacityModelobject

Normalised capacity model

n1Checkobject

N-1 compliance result

feasibility'feasible' | 'conditional' | 'copper_needed'

Technical feasibility verdict

governanceStatusstring

Governance decision status

governanceBlockersstring[]
contractGateobject

Explicit contract-gate assessment for grid-signal priority and control evidence

governanceArtifactobject nullable

Optional interface-placeholder / HITL artifact created for governance blockers

decisionChainobject[]

Additive six-step A²MDM trace for the Phase-5 decision

proofobject

Compact proof/provenance payload for audit-friendly handoff

findingsobject[]
metadataobject

Changes

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