> ## 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.

# Record that a partner confirmed our registration in writing

> The Nachversand waits for AS4 evidence that a partner accepts us
before re-delivering a registration-class rejection. A partner who
fixed their master data and says so by mail sends no such message -
record their statement here and the sweep treats it as the evidence
it stands in for. Idempotent: setting it again updates stream and
reason.



## OpenAPI

````yaml /setup/internal-openapi.json put /v1/process/nachversand/belege/{key}
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/nachversand/belege/{key}:
    put:
      summary: Record that a partner confirmed our registration in writing
      description: |-
        The Nachversand waits for AS4 evidence that a partner accepts us
        before re-delivering a registration-class rejection. A partner who
        fixed their master data and says so by mail sends no such message -
        record their statement here and the sweep treats it as the evidence
        it stands in for. Idempotent: setting it again updates stream and
        reason.
      operationId: put_nachversand_beleg_v1_process_nachversand_belege__key__put
      parameters:
        - name: key
          in: path
          required: true
          schema:
            type: string
            description: The partner's MP-ID, or one of its MGA EICs
            title: Key
          description: The partner's MP-ID, or one of its MGA EICs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NachversandBelegRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NachversandBelegResponse'
        '404':
          description: The key names no known market party.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
        - HTTPBearer: []
components:
  schemas:
    NachversandBelegRequest:
      properties:
        stream:
          type: string
          enum:
            - partin
            - zuordnung
            - beide
          title: Stream
          default: beide
        reason:
          type: string
          maxLength: 300
          minLength: 3
          title: Reason
          description: >-
            The partner's own words, e.g. 'Laura Funke, nvb, 09.09.2026: wir
            haben Sie erst am 26.08. bei uns aufgebaut'
      type: object
      required:
        - reason
      title: NachversandBelegRequest
      description: |-
        Record in writing that a partner has registered our MP-ID.

        The Nachversand re-delivers a registration-class rejection (CONTRL 23
        / APERAK Z29) only once newer AS4 evidence shows the partner accepts
        us - their own PARTIN, or a positive acknowledgment. A partner who
        fixes their master data and says so by mail sends no such message, so
        the sweep would skip them forever. This records their statement as
        the evidence it stands in for, dated now.
    NachversandBelegResponse:
      properties:
        mp_id:
          type: string
          title: Mp Id
        name:
          type: string
          title: Name
          default: ''
        stream:
          type: string
          title: Stream
        reason:
          type: string
          title: Reason
        noted_at:
          type: string
          title: Noted At
      type: object
      required:
        - mp_id
        - stream
        - reason
        - noted_at
      title: NachversandBelegResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    HTTPBearer:
      type: http
      description: OIDC access token (Auth0 M2M)
      scheme: bearer

````