Netzfahrplan / fNAV

Validate fNAV profile against grid connection capacity (Phase 5)

Applies the fNAV capacity model (§14a EnWG) for a proposed grid connection. Runs N-1 compliance check with hybrid threshold (Option C: domain default + tenant/project/scenario override). Reports technical feasibility and enforces governance gate (Option B: final status is requires_governance_decision until legalStatus=approved AND contractStatus=signed). Delegates to grid-operations.netzfahrplanGenerate for the deterministic core.

post/api/grid-connection/fnav/validate

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/grid-connection/fnav/validate
  • 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

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

Voltage level of the connection point

ownerContactstring

Responsible owner — required for governance approval

tokenstring

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

Example request

{
  "gridOperatorName": "STROMDAO Netze",
  "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"
  },
  "n1ThresholdOverride": {
    "project": 78
  },
  "ownerContact": "netzplanung@stromdao.de"
}

Response

fNAV validation result with capacity model, N-1 check, and governance status

capacityModelobject

Normalised fNAV capacity model

n1Checkobject

N-1 compliance result

feasibility'feasible' | 'conditional' | 'copper_needed'
governanceStatusstring
governanceBlockersstring[]
contractGateobject

Explicit contract-gate assessment

governanceArtifactobject nullable
decisionChainobject[]
proofobject
findingsobject[]
metadataobject
sourcestring

Changes

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