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

# Microsoft-Bestellung anlegen

> Legt eine Bestellung an und startet ihre Ausführung; die Antwort kommt sofort mit Status `RECEIVED` (`202`). Sende dieselben Felder wie bei der Preisvorschau, dazu `expectedUnitPrice` aus der Vorschau und für jeden Schlüssel aus `requiredConfirmations` den Wert `true` in `confirmations`.

Wir prüfen die Bestellung erneut (Zuordnung, Kundenvereinbarung, Rechte, Preis, bei Reduzierungen das Stornofenster), reservieren sie und übermitteln sie genau einmal an Microsoft. Danach warten wir, bis das Ergebnis im Bestand sichtbar ist, und setzen `COMPLETED`. Lehnt Microsoft ab, steht der Grund in `error`; bei `subscription_locked` (Abo wegen Verlängerung gesperrt) nennt `retryNotBefore` den frühesten neuen Versuch. Ist der Ausgang unklar, steht die Bestellung auf `NEEDS_REVIEW`: Bestelle dann nicht erneut, unser Team prüft den Stand.

Je Abo bzw. je Tenant und Produkt läuft höchstens eine Bestellung gleichzeitig (`409 order_in_progress`). Mit `requestId` lässt sich eine Anfrage gefahrlos wiederholen.



## OpenAPI

````yaml /api-reference/openapi.json post /microsoft-licenses/orders
openapi: 3.1.0
info:
  title: NETZFABRIK API
  description: >-
    REST-API der NETZFABRIK-Plattform für Domains, DNS, Cloud-Server, Webspaces,
    E-Mail-Dienste und Konto. Authentifizierung per JWT (Authorization: Bearer)
    oder API-Token (X-API-TOKEN).
  termsOfService: https://www.netzfabrik.com/tos
  contact:
    name: NETZFABRIK GmbH
    url: https://www.netzfabrik.com
    email: info@netzfabrik.com
  license:
    name: Proprietary
    url: https://www.netzfabrik.com/license
  version: 2026-11-22-86541c47
servers:
  - url: https://api.netzfabrik.com
security:
  - JWT: []
  - ApiToken: []
tags:
  - name: Login
  - name: Zwei-Faktor-Authentifizierung
  - name: Passkeys
  - name: Benutzer
  - name: Konten
  - name: Kunden
  - name: Verträge
  - name: Rechnungen
  - name: Support-Tickets
  - name: Domains
  - name: Domain-Labels
  - name: Domain-Bestellungen
  - name: Premium-Domains
  - name: Inhaberwechsel
  - name: Handles (Kontakte)
  - name: Handle-Verifizierung
  - name: TLD-Daten
  - name: Domain-Preise
  - name: Preislisten-Vorlagen
  - name: Preislisten-Versionen
  - name: Preis-Überschreibungen
  - name: Preisänderungen
  - name: Domain-Aktionen
  - name: Öffentliche Preislisten
  - name: Domain-Reseller
  - name: DNS-Zonen
  - name: DNS-Records
  - name: Weiterleitungen
  - name: Webhooks
  - name: Cloud-Server
  - name: Cloud-Server-Vorlagen
  - name: Regionen
  - name: SSH-Keys
  - name: ISO-Images
  - name: Anwendungen
  - name: Webspaces
  - name: Webspace-Tarife
  - name: Object Storage
  - name: E-Mail-Protection
  - name: E-Mail-Security
  - name: E-Mail-Archiv
  - name: Colocation
  - name: Racks
  - name: Stromzuführungen
  - name: Interconnections
  - name: VLANs
  - name: Traffic
  - name: DnsZoneTemplate
  - name: DnsZoneTemplateRun
  - name: DnsZoneTemplateSettings
  - name: Microsoft-Lizenzen
paths:
  /microsoft-licenses/orders:
    post:
      tags:
        - Microsoft-Lizenzen
      summary: Microsoft-Bestellung anlegen
      description: >-
        Legt eine Bestellung an und startet ihre Ausführung; die Antwort kommt
        sofort mit Status `RECEIVED` (`202`). Sende dieselben Felder wie bei der
        Preisvorschau, dazu `expectedUnitPrice` aus der Vorschau und für jeden
        Schlüssel aus `requiredConfirmations` den Wert `true` in
        `confirmations`.


        Wir prüfen die Bestellung erneut (Zuordnung, Kundenvereinbarung, Rechte,
        Preis, bei Reduzierungen das Stornofenster), reservieren sie und
        übermitteln sie genau einmal an Microsoft. Danach warten wir, bis das
        Ergebnis im Bestand sichtbar ist, und setzen `COMPLETED`. Lehnt
        Microsoft ab, steht der Grund in `error`; bei `subscription_locked` (Abo
        wegen Verlängerung gesperrt) nennt `retryNotBefore` den frühesten neuen
        Versuch. Ist der Ausgang unklar, steht die Bestellung auf
        `NEEDS_REVIEW`: Bestelle dann nicht erneut, unser Team prüft den Stand.


        Je Abo bzw. je Tenant und Produkt läuft höchstens eine Bestellung
        gleichzeitig (`409 order_in_progress`). Mit `requestId` lässt sich eine
        Anfrage gefahrlos wiederholen.
      operationId: createMicrosoftLicenseOrder
      parameters:
        - $ref: '#/components/parameters/CustomerId'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                  enum:
                    - NEW_SUBSCRIPTION
                    - INCREASE_QUANTITY
                    - DECREASE_QUANTITY
                    - ENABLE_AUTO_RENEW
                    - DISABLE_AUTO_RENEW
                tenantId:
                  type: string
                  format: uuid
                catalogueProductId:
                  type: string
                  format: uuid
                  description: Nur für `NEW_SUBSCRIPTION`.
                subscriptionId:
                  type: string
                  format: uuid
                  description: Für alle Änderungen.
                quantity:
                  type: integer
                  description: 'Neues Abo: Menge. Mengenänderung: neue Gesamtmenge.'
                autoRenew:
                  type: boolean
                  description: 'Neues Abo: automatische Verlängerung, Standard `true`.'
                expectedUnitPrice:
                  type: string
                  description: >-
                    `unitSell` aus der Preisvorschau. Weicht der aktuelle Preis
                    ab, antwortet der Endpunkt mit `409 price_changed`.
                confirmations:
                  type: object
                  additionalProperties:
                    type: boolean
                  description: >-
                    Je Schlüssel aus `requiredConfirmations` der Vorschau
                    `true`.
                requestId:
                  type: string
                  description: >-
                    Optional, 8 bis 64 Zeichen. Dieselbe `requestId` liefert die
                    bereits angelegte Bestellung statt einer neuen.
              required:
                - type
                - tenantId
            example:
              type: NEW_SUBSCRIPTION
              tenantId: 0195a1b2-0000-7000-8000-000000000001
              catalogueProductId: 0195a1b2-0000-7000-8000-000000000003
              quantity: 5
              autoRenew: true
              expectedUnitPrice: '12.500000'
              confirmations:
                price: true
                commitment: true
                cancellationPolicy: true
              requestId: bestellung-2026-11-22-001
        required: true
      responses:
        '200':
          description: >-
            Dieselbe `requestId` wurde schon angenommen: die vorhandene
            Bestellung.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  type:
                    type: string
                  typeLabel:
                    type: string
                  status:
                    type: string
                    enum:
                      - RECEIVED
                      - RESERVED
                      - SUBMITTING
                      - SUBMITTED
                      - COMPLETED
                      - REJECTED
                      - NEEDS_REVIEW
                      - FAILED
                  statusLabel:
                    type: string
                  tenantId:
                    type: string
                    format: uuid
                  subscriptionId:
                    type:
                      - string
                      - 'null'
                    format: uuid
                  catalogueProductId:
                    type:
                      - string
                      - 'null'
                    format: uuid
                  productName:
                    type: string
                  quantity:
                    type: integer
                  quantityBefore:
                    type:
                      - integer
                      - 'null'
                  unitSell:
                    type:
                      - string
                      - 'null'
                    description: Netto, Dezimalzahl mit sechs Nachkommastellen.
                    example: '12.500000'
                  confirmedTexts:
                    type: object
                    additionalProperties:
                      type: string
                  error:
                    type:
                      - object
                      - 'null'
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                  retryAfterSeconds:
                    type:
                      - integer
                      - 'null'
                  retryNotBefore:
                    type:
                      - string
                      - 'null'
                    format: date-time
                  createdAt:
                    type: string
                    format: date-time
                  completedAt:
                    type:
                      - string
                      - 'null'
                    format: date-time
                  events:
                    type: array
                    items:
                      type: object
                      properties:
                        occurredAt:
                          type: string
                          format: date-time
                        fromStatus:
                          type:
                            - string
                            - 'null'
                        toStatus:
                          type: string
                        actorType:
                          type: string
                        message:
                          type: string
        '202':
          description: Bestellung angenommen, wird ausgeführt.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  type:
                    type: string
                  typeLabel:
                    type: string
                  status:
                    type: string
                    enum:
                      - RECEIVED
                      - RESERVED
                      - SUBMITTING
                      - SUBMITTED
                      - COMPLETED
                      - REJECTED
                      - NEEDS_REVIEW
                      - FAILED
                  statusLabel:
                    type: string
                  tenantId:
                    type: string
                    format: uuid
                  subscriptionId:
                    type:
                      - string
                      - 'null'
                    format: uuid
                  catalogueProductId:
                    type:
                      - string
                      - 'null'
                    format: uuid
                  productName:
                    type: string
                  quantity:
                    type: integer
                  quantityBefore:
                    type:
                      - integer
                      - 'null'
                  unitSell:
                    type:
                      - string
                      - 'null'
                    description: Netto, Dezimalzahl mit sechs Nachkommastellen.
                    example: '12.500000'
                  confirmedTexts:
                    type: object
                    additionalProperties:
                      type: string
                  error:
                    type:
                      - object
                      - 'null'
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                  retryAfterSeconds:
                    type:
                      - integer
                      - 'null'
                  retryNotBefore:
                    type:
                      - string
                      - 'null'
                    format: date-time
                  createdAt:
                    type: string
                    format: date-time
                  completedAt:
                    type:
                      - string
                      - 'null'
                    format: date-time
                  events:
                    type: array
                    items:
                      type: object
                      properties:
                        occurredAt:
                          type: string
                          format: date-time
                        fromStatus:
                          type:
                            - string
                            - 'null'
                        toStatus:
                          type: string
                        actorType:
                          type: string
                        message:
                          type: string
        '403':
          description: >-
            Keine Berechtigung oder Funktion für das Konto nicht freigeschaltet
            (`feature_disabled`, `ordering_disabled`).
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
        '404':
          description: >-
            Nicht gefunden (auch: Tenant, Abo oder Bestellung gehört nicht zum
            Kundenkontext).
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
        '409':
          description: >-
            `price_changed` (mit neuer Vorschau in `quote`) oder
            `order_in_progress` (mit `orderId`).
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
        '422':
          description: >-
            Ungültig, nicht buchbar (`blockers`) oder Bestätigung fehlt
            (`confirmation_missing`).
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
components:
  parameters:
    CustomerId:
      name: X-Customer-Id
      in: header
      required: false
      description: >-
        Optionaler Kundenkontext. Ohne Header arbeitet die Anfrage im
        Standard-Kunden des angemeldeten Benutzers. Mit der ID eines anderen
        Kunden handelt die Anfrage in dessen Kontext: Listen, Lese- und
        Schreibzugriffe beziehen sich dann auf diesen Kunden.


        Erlaubt sind der eigene Kunde, jeder Unterkunde im eigenen Teilbaum
        (Reseller handelt für seinen Endkunden) sowie Kunden, in denen der
        Benutzer selbst Mitglied ist. Übergeordnete oder fremde Kunden werden
        mit `403 Forbidden` abgewiesen, eine unbekannte ID ebenfalls.


        Die IDs der erreichbaren Kunden liefern `GET /user/customers` und `GET
        /customers/{id}/children`.
      schema:
        type: string
        example: 01JD4Q8W3N6Y2K5T7R9V0B1C2D
  securitySchemes:
    JWT:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Access-Token aus `POST /auth/login` (E-Mail und Passwort), gesendet als
        `Authorization: Bearer <token>`.


        Das Token ist zeitlich begrenzt gültig. Mit dem `refresh_token` aus
        derselben Antwort holt `POST /auth/token/refresh` ein neues Token-Paar,
        ohne das Passwort erneut zu senden; `POST /auth/token/invalidate` macht
        den Refresh-Token beim Abmelden ungültig.


        Ist für das Konto ein zweiter Faktor aktiv oder vorgeschrieben, liefert
        der Login statt des Token-Paars `mfaRequired: true` bzw.
        `mfaEnrollmentRequired: true` und ein kurzlebiges `preAuthToken`. Mit
        diesem Token (ebenfalls als Bearer) wird der zweite Faktor über `POST
        /auth/2fa/verify` bestätigt; erst danach gibt es das volle Token-Paar.
    ApiToken:
      type: apiKey
      in: header
      name: X-API-TOKEN
      description: >-
        Persönlicher API-Token für Skripte, CI/CD und
        Server-zu-Server-Integrationen, gesendet im Header `X-API-TOKEN:
        <token>`.


        Tokens werden im Kundenpanel unter **Einstellungen → Sicherheit**
        angelegt oder per `POST /user/api-tokens` mit einem gültigen JWT. Der
        Klartext erscheint nur einmal in der Antwort beim Anlegen. Ein Token
        handelt mit den Rechten des Benutzers, der ihn erstellt hat, kann ein
        Ablaufdatum haben und wird mit `DELETE /user/api-tokens/{id}` sofort
        widerrufen.

````

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