Zielnetzplanung (ZNP)

Load Layer 2 — AI-extracted transformer peak load from PDF (async job)

Accepts either the path of a PDF uploaded via POST /api/datasources/uploads or an inline Base64-encoded PDF (fileContentBase64). Parses the document with pdf-parse, then calls Gemini (structured JSON output) to extract the maximum simultaneous annual peak transformer load (Jahreshöchstlast), transformer ID, and nominal transformer capacity. The nominal capacity is converted to kW in the extractor using cos(phi)=0.95. Adds a Measurement node plus a calibration node and enables the Layer 2 short-circuit in calculateGFactor: the measured value replaces the theoretical Layer 1 estimate. REST callers receive HTTP 202 + jobId; poll GET /api/jobs/:jobId/status for Chain-of-Thought log messages.

post/api/znp/projects/:projectId/layer2

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/znp/projects/:projectId/layer2
  • Auth: none declared

Path parameters

projectIdstring required
Example:a1b2c3d4-0000-0000-0000-000000000001

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

OR

Example request

{
  "filePath": "/opt/cernion-energy-tools/uploads/lastprofil_trafo.pdf",
  "fileContentBase64": "JVBERi0xLjQKJcfs...",
  "fileName": "lastprofil_trafo.pdf"
}

Response

Job accepted — poll statusUrl for AI extraction logs and result.

successboolean
jobIdstring
statusstring
messagestring
statusUrlstring
resultUrlstring

Changes

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