---
title: "Generate Netzfahrplan / fNAV feasibility assessment"
method: POST
path: "/api/netzfahrplan/generate"
tags: ["Netzfahrplan / fNAV"]
---

# Generate Netzfahrplan / fNAV feasibility assessment

`POST /api/netzfahrplan/generate`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/netzfahrplan/generate`
- Auth: none declared

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

## Query parameters

- `token` string

## Request body

- object
  - `gridOperatorId` string: MaStR grid operator ID
  - `gridOperatorName` string: Grid operator name
  - `voltageLevel` 'NS' | 'MS' | 'HS': Voltage level of the connection point
  - `requestedCapacityKW` number, required: Requested connection capacity in kW
  - `firmCapacityKW` number: Guaranteed firm capacity in kW (defaults to requestedCapacityKW if omitted)
  - `flexibleCapacityKW` number: Curtailable flex capacity in kW under §14a
  - `curtailmentWindow` number: Max hours per day the VNB may curtail (0–24)
  - `operatingConstraint` string: Free-text operating constraint
  - `signalPriorityPolicy` string: Optional contract-gate wording that explicitly documents grid-signal priority over schedule/market optimisation
  - `controlEvidenceRef` string: Optional reference to the control/remote-control evidence backing the contract gate
  - `contractStatus` string: Contract status
  - `legalStatus` string: Legal/regulatory status
  - `ownerContact` string: Responsible owner or contact (required for governance approval)
  - `n1ThresholdOverride` object: Override N-1 thresholds (MVA) at tenant/project/scenario level
    - `tenant` number
    - `project` number
    - `scenario` number
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

fNAV feasibility assessment result

- object
  - `capacityModel` object: Normalised capacity model
  - `n1Check` object: N-1 compliance result
  - `feasibility` 'feasible' | 'conditional' | 'copper_needed': Technical feasibility verdict
  - `governanceStatus` string: Governance decision status
  - `governanceBlockers` string[]
  - `contractGate` object: Explicit contract-gate assessment for grid-signal priority and control evidence
  - `governanceArtifact` object, nullable: Optional interface-placeholder / HITL artifact created for governance blockers
  - `decisionChain` object[]: Additive six-step A²MDM trace for the Phase-5 decision
  - `proof` object: Compact proof/provenance payload for audit-friendly handoff
  - `findings` object[]
  - `metadata` object

---

[API](https://skmtc.dev/cernion/apis/cernion-energy-tools-api.md) · [All operations](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/revisions/cdb94473b538?raw)