> ## Documentation Index
> Fetch the complete documentation index at: https://docs.energy.nlead.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# Snapshot of Cloover's confirmed supply starts

> Sent by the Apps Script of Cloover's ramp-up sheet with the
read-only report key: per Netzbetreiber, Bilanzierungsgebiet, supply
start and forecast type the number of customers whose supply start
the DSO has confirmed - counts, no market locations. Replaces the
stored snapshot and triggers nothing; the Zeitreihen view
(``/zeitreihen/aktivierungen``) and ``/kundenhochlauf`` read it.



## OpenAPI

````yaml /setup/internal-openapi.json post /v1/process/kundenhochlauf/quellstand
openapi: 3.1.0
info:
  title: n:lead Scheduling Bridge — Internal API
  version: 0.4.0
  description: >-
    Internal API of the n:lead scheduling bridge: the process endpoints that
    drive the day-ahead pipeline (aggregate, publish the open position, submit
    schedules, generate forecasts, orchestrate) and the operator console
    endpoints. Requires the process API key; not for customer use.
servers:
  - url: https://{host}
    description: Deployed service
    variables:
      host:
        default: api.energy.nlead.ch
        description: >-
          The service hostname - n:lead provides it (see the Base URL on the API
          introduction page)
  - url: http://localhost:8000
    description: Local development
security: []
paths:
  /v1/process/kundenhochlauf/quellstand:
    post:
      summary: Snapshot of Cloover's confirmed supply starts
      description: |-
        Sent by the Apps Script of Cloover's ramp-up sheet with the
        read-only report key: per Netzbetreiber, Bilanzierungsgebiet, supply
        start and forecast type the number of customers whose supply start
        the DSO has confirmed - counts, no market locations. Replaces the
        stored snapshot and triggers nothing; the Zeitreihen view
        (``/zeitreihen/aktivierungen``) and ``/kundenhochlauf`` read it.
      operationId: post_kundenhochlauf_quellstand_v1_process_kundenhochlauf_quellstand_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/KundenhochlaufQuellstandRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: >-
                  Response Post Kundenhochlauf Quellstand V1 Process
                  Kundenhochlauf Quellstand Post
        '422':
          description: No valid row - the stored snapshot is kept.
      security:
        - APIKeyHeader: []
        - HTTPBearer: []
components:
  schemas:
    KundenhochlaufQuellstandRequest:
      properties:
        quelle:
          type: string
          maxLength: 200
          title: Quelle
          default: Apps Script
        stand:
          type: string
          maxLength: 100
          title: Stand
          description: The sheet's own last update
          default: ''
        eintraege:
          items:
            $ref: '#/components/schemas/KundenhochlaufZeile'
          type: array
          maxItems: 5000
          minItems: 1
          title: Eintraege
      type: object
      required:
        - eintraege
      title: KundenhochlaufQuellstandRequest
      description: |-
        Cloover's confirmed supply starts, aggregated by the ramp-up sheet's
        Apps Script. Stored as a snapshot - nothing is sent or applied.
    KundenhochlaufZeile:
      properties:
        netzbetreiber_mp_id:
          type: string
          maxLength: 200
          title: Netzbetreiber Mp Id
          default: ''
        netzbetreiber:
          type: string
          maxLength: 200
          title: Netzbetreiber
          default: ''
        bilanzierungsgebiet:
          type: string
          maxLength: 200
          title: Bilanzierungsgebiet
          default: ''
        regelzone:
          type: string
          maxLength: 200
          title: Regelzone
          default: ''
        lieferbeginn:
          type: string
          maxLength: 200
          title: Lieferbeginn
          description: Supply start, YYYY-MM-DD
          default: ''
        prognoseart:
          type: string
          maxLength: 200
          title: Prognoseart
          description: SLP, Interval (measured) or TLP
          default: ''
        zaehlertyp:
          type: string
          maxLength: 200
          title: Zaehlertyp
          default: ''
        anzahl:
          type: integer
          maximum: 1000000
          minimum: 0
          title: Anzahl
          default: 0
      type: object
      title: KundenhochlaufZeile
      description: |-
        Confirmed customers of one Netzbetreiber / Bilanzierungsgebiet with
        the same supply start, forecast type and meter type - a count, never
        the market locations themselves. Bounds are loose on purpose: the
        service drops a malformed row and counts it as ``verworfen``, so one
        bad cell does not turn the whole push away.
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    HTTPBearer:
      type: http
      description: OIDC access token (Auth0 M2M)
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.