> ## 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 un rango de series GS1 en masa
> POST /bulk-operation/gs1/serial-range-generate/
Genera un rango contiguo de códigos QR GS1 a partir de un número de serie inicial, 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/gs1/serial-range-generate/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```
Sin subida de archivo — este endpoint genera el rango programáticamente a partir de `start_serial` y `count`.
Una etiqueta para esta operación.
El primer número de serie del rango, solo dígitos, máximo 20 caracteres.
Cuántas series secuenciales generar, mínimo 1.
El id de un QR GS1 existente del que copiar los valores de campo compartidos. Proporcione esto **o** `shared_info`, no ninguno de los dos.
Los valores de campo GS1 compartidos por cada serie del rango, como JSON. Proporcione esto **o** `sample_qrid`, no ninguno de los dos.
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.
Regla opcional de desactivación automática aplicada a todos los códigos QR generados.
Parámetros de seguimiento UTM aplicados a los enlaces de todos los códigos QR generados.
Un id de carpeta donde guardar los códigos QR generados.
```bash cURL theme={null}
curl -X POST "https://api.scanova.io/bulk-operation/gs1/serial-range-generate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"name": "GS1 batch 001-100",
"start_serial": "00000001",
"count": 100,
"sample_qrid": "a1b2c3d4"
}'
```
```json 200 theme={null}
{
"operation_id": "bo-gs1-001",
"message": ["Your GS1 serial range is being processed. We'll email you once it's ready."]
}
```
Mismo patrón asíncrono que [Generar códigos QR en masa](/es/api-reference/management-api/bulk-operation/generate) — consulte [Listar operaciones en masa](/es/api-reference/management-api/bulk-operation/list). El primer payload GS1 ensamblado del rango se valida contra el esquema antes de crear ningún código QR, por lo que una forma de `shared_info` malformada falla rápido.
`400` si el número de serie resultante supera los 20 caracteres en algún punto del rango, si no se proporciona ni `shared_info` ni `sample_qrid`, o si se supera la cuota (`BULK_OPERATION` o `TOTAL_QR_CODES`, comprobada contra el `count` completo). `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](/es/api-reference/management-api/bulk-operation/generate) — el equivalente general basado en archivo para categorías que no son GS1.
* [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/gs1/serial-range-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/gs1/serial-range-generate/:
post:
summary: Bulk-generate a GS1 serial range
description: >-
Generates a contiguous range of GS1 QR codes from a starting serial and
count, without a file upload. Requires either `shared_info` or
`sample_qrid` to supply the shared GS1 field values applied to every
serial in the range.
operationId: generateGs1SerialRange
requestBody:
content:
application/json:
example:
name: GS1 batch 001-100
start_serial: '00000001'
count: 100
sample_qrid: a1b2c3d4
custom_domain: null
folder: null
responses:
'200':
description: Generation started.
content:
application/json:
example:
operation_id: bo-gs1-001
message:
- >-
Your GS1 serial range is being processed. We'll email you
once it's ready.
'400':
description: >-
Serial range too long (>20 characters), neither shared_info nor
sample_qrid provided, 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.
````