> ## 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.
# Generar códigos QR en masa
> POST /bulk-operation/generate/
Crea muchos códigos QR a partir de una hoja subida, de forma asíncrona, en el host de la **API de gestión** (`api.scanova.io`), autenticado con su clave de API de gestión sin procesar.
```
POST https://api.scanova.io/bulk-operation/generate/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```
Una etiqueta para esta operación, mostrada en [Listar operaciones en masa](/es/api-reference/management-api/bulk-operation/list).
La hoja rellenada, una fila por código QR. La columna `qr code id` de la **primera fila** proporciona el QR plantilla — su categoría y esquema de campos son contra lo que se valida cada una de las demás filas.
Un id de dominio personalizado para usar en los enlaces cortos de los códigos QR generados.
Datos del patrón de diseño aplicados a todos los códigos QR generados, normalmente codificados como una cadena JSON.
Regla opcional de desactivación automática aplicada a todos los códigos QR generados: `expire_on`/`activate_on` (fechas y horas futuras en ISO-8601) y/o `expire_on_scan_count` (entero positivo).
Un id de carpeta donde guardar los códigos QR generados.
```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."]
}
```
## Esto es asíncrono
La respuesta `200` confirma que el trabajo fue aceptado, no que los códigos QR ya existan — el trabajo real se ejecuta en un proceso en segundo plano. Consulte [Listar operaciones en masa](/es/api-reference/management-api/bulk-operation/list) (filtrando localmente por `operation_id`) y observe `status` (`new` → `completed`/`partially_completed`/`failed`) y `progress`, luego lea `result_file`/`log_file` una vez finalizado. La cuenta también recibe una notificación por correo al completarse.
`400` por un archivo/columnas inválidos, un QR plantilla faltante o inválido, o cuota superada (`BULK_OPERATION` o `TOTAL_QR_CODES`). `403` si a la cuenta le falta la cuota `BULK_OPERATION`, tiene un plan inactivo, o carece del permiso `BULK_OPERATION_CAN_GENERATE`.
## Relacionado
* [Generar códigos QR en masa (plantillas v2)](/es/api-reference/management-api/bulk-operation/generate-v2) — el equivalente para plantillas v2.
* [Validar un archivo de operación en masa](/es/api-reference/management-api/bulk-operation/validate) — comprobar el archivo antes de gastar esta llamada.
* [Descargar un archivo de ejemplo](/es/api-reference/management-api/bulk-operation/sample-file) — desde dónde comenzar la hoja.
* [Listar operaciones en masa](/es/api-reference/management-api/bulk-operation/list) — esperar la finalización.
* [Resumen de la API de gestión](/es/api-reference/management-api/overview) — el esquema de autenticación y las reglas de cuota aplicables a este endpoint.
## 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.
````