> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.
# QR-Codes in großer Menge erstellen
> POST /bulk-operation/generate/
Erstellt viele QR-Codes asynchron aus einer hochgeladenen Tabelle, auf dem **Management-API**-Host (`api.scanova.io`), authentifiziert mit Ihrem rohen Management-API-Schlüssel.
```
POST https://api.scanova.io/bulk-operation/generate/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```
Eine Bezeichnung für diesen Vorgang, angezeigt in [Massenvorgänge auflisten](/de/api-reference/management-api/bulk-operation/list).
Die ausgefüllte Tabelle, eine Zeile pro QR-Code. Die Spalte `qr code id` **der ersten Zeile** liefert den Vorlagen-QR-Code — dessen Kategorie und Feldschema sind das, wogegen jede andere Zeile validiert wird.
Eine Domain-ID für benutzerdefinierte Domains, die für die Kurzlinks der erstellten QR-Codes verwendet wird.
Design-Musterdaten, die auf alle erstellten QR-Codes angewendet werden, typischerweise als JSON-String kodiert.
Optionale Regel zur automatischen Deaktivierung, die auf alle erstellten QR-Codes angewendet wird: `expire_on`/`activate_on` (zukünftige ISO-8601-Zeitstempel) und/oder `expire_on_scan_count` (positive Ganzzahl).
Eine Ordner-ID, in der die erstellten QR-Codes gespeichert werden.
```bash cURL theme={null}
curl -X POST "https://api.scanova.io/bulk-operation/generate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-F "name=September event QR batch" \
-F "file=@event-qrs.xlsx" \
-F 'auto_deactivate={"expire_on":"2026-12-31T23:59:59Z"}'
```
```json 200 theme={null}
{
"operation_id": "bo-8f3a1c",
"message": ["Your file is being processed. We'll email you once it's ready."]
}
```
## Dies ist asynchron
Die `200`-Antwort bestätigt, dass der Auftrag angenommen wurde, nicht dass die QR-Codes bereits existieren — die eigentliche Arbeit läuft auf einem Hintergrund-Worker. Fragen Sie [Massenvorgänge auflisten](/de/api-reference/management-api/bulk-operation/list) ab (lokal nach `operation_id` gefiltert) und beobachten Sie `status` (`new` → `completed`/`partially_completed`/`failed`) und `progress`, lesen Sie dann `result_file`/`log_file`, sobald abgeschlossen. Das Konto erhält bei Abschluss außerdem eine E-Mail-Benachrichtigung.
`400` bei einer ungültigen Datei/Spalten, einem fehlenden oder ungültigen Vorlagen-QR-Code, oder überschrittener Quota (`BULK_OPERATION` oder `TOTAL_QR_CODES`). `403`, wenn dem Konto die Quota `BULK_OPERATION` fehlt, der Plan inaktiv ist, oder die Berechtigung `BULK_OPERATION_CAN_GENERATE` fehlt.
## Verwandte Themen
* [QR-Codes in großer Menge erstellen (v2-Vorlagen)](/de/api-reference/management-api/bulk-operation/generate-v2) — das Äquivalent für v2-Vorlagen.
* [Massenvorgangs-Datei validieren](/de/api-reference/management-api/bulk-operation/validate) — die Datei vor diesem Aufruf prüfen.
* [Beispieldatei herunterladen](/de/api-reference/management-api/bulk-operation/sample-file) — womit die Tabelle begonnen werden sollte.
* [Massenvorgänge auflisten](/de/api-reference/management-api/bulk-operation/list) — auf den Abschluss warten.
* [Übersicht über die Management API](/de/api-reference/management-api/overview) — das Authentifizierungsschema und die Quota-Regeln für diesen Endpunkt.
## OpenAPI
````yaml api-reference/openapi/management-api.json POST /bulk-operation/generate/
openapi: 3.1.0
info:
title: Scanova Management API (v2)
description: >-
The complete Scanova Management API — every endpoint available at
api.scanova.io (QR codes, folders, tags, leads, forms, analytics, plans,
shared users & roles), plus the token-creation and usage-stats endpoints
used to authenticate against it. Every path and request/response shape below
was verified live against a real API key and the actual running backend
(Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
version: 2.0.0
servers:
- url: https://api.scanova.io
description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
- apiKeyAuth: []
paths:
/bulk-operation/generate/:
post:
summary: Bulk-generate QR codes
description: >-
Creates many QR codes from an uploaded sheet, asynchronously. Returns
immediately with an `operation_id` while a Celery task does the work —
poll [List bulk
operations](/api-reference/management-api/bulk-operation/list) for
`status`/`progress`, then fetch `result_file`/`log_file` once complete.
The sheet's first row's `qr code id` supplies the template QR whose
category and field schema every other row is validated against.
operationId: generateBulkOperation
requestBody:
content:
multipart/form-data:
example:
name: September event QR batch
file: (binary file)
custom_domain: null
pattern_info: '{"dotStyle":"round"}'
folder: null
auto_deactivate:
expire_on: '2026-12-31T23:59:59Z'
responses:
'200':
description: Generation started.
content:
application/json:
example:
operation_id: bo-8f3a1c
message:
- >-
Your file is being processed. We'll email you once it's
ready.
'400':
description: >-
Invalid file/columns, missing or invalid template QR, or quota
exceeded.
'403':
description: >-
Missing BULK_OPERATION quota, inactive plan, or missing
BULK_OPERATION_CAN_GENERATE permission.
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: Authorization
description: >-
Send your Management API key as the raw value of the Authorization
header — no "Bearer " or "Token " prefix, and no other characters.
Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
header containing more than one space-separated part is rejected
outright. Requests also require the request's Host header to be the
management API host (e.g. api.scanova.io) — the same key sent to the
regular API host will not authenticate.
````