> ## 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.
# Générer une plage de numéros de série GS1 en masse
> POST /bulk-operation/gs1/serial-range-generate/
Génère une plage contiguë de codes QR GS1 à partir d'un numéro de série de départ, de manière asynchrone, sur l'hôte de l'**API de gestion** (`api.scanova.io`), authentifié avec votre clé d'API de gestion brute.
```
POST https://api.scanova.io/bulk-operation/gs1/serial-range-generate/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```
Aucun téléversement de fichier — cet endpoint génère la plage de manière programmatique à partir de `start_serial` et `count`.
Un libellé pour cette opération.
Le premier numéro de série de la plage, chiffres uniquement, 20 caractères maximum.
Le nombre de numéros de série séquentiels à générer, minimum 1.
L'id d'un QR GS1 existant à partir duquel copier les valeurs de champ partagées. Fournissez ceci **ou** `shared_info`, pas aucun des deux.
Les valeurs de champ GS1 partagées par chaque numéro de série de la plage, au format JSON. Fournissez ceci **ou** `sample_qrid`, pas aucun des deux.
Un id de domaine personnalisé à utiliser pour les liens courts des codes QR générés.
Données de motif de design appliquées à tous les codes QR générés.
Règle facultative de désactivation automatique appliquée à tous les codes QR générés.
Paramètres de suivi UTM appliqués aux liens de tous les codes QR générés.
Un id de dossier dans lequel enregistrer les codes QR générés.
```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."]
}
```
Même schéma asynchrone que [Générer des codes QR en masse](/fr/api-reference/management-api/bulk-operation/generate) — interrogez [Lister les opérations en masse](/fr/api-reference/management-api/bulk-operation/list). La première charge utile GS1 assemblée dans la plage est validée par rapport au schéma avant la création de tout code QR, de sorte qu'une forme `shared_info` mal formée échoue rapidement.
`400` si le numéro de série résultant dépasse 20 caractères à un moment quelconque de la plage, si ni `shared_info` ni `sample_qrid` n'est fourni, ou si le quota (`BULK_OPERATION` ou `TOTAL_QR_CODES`, vérifié par rapport au `count` complet) est dépassé. `403` si le compte n'a pas le quota `BULK_OPERATION`, a un plan inactif, ou n'a pas la permission `BULK_OPERATION_CAN_GENERATE`.
## Voir aussi
* [Générer des codes QR en masse](/fr/api-reference/management-api/bulk-operation/generate) — l'équivalent général basé sur fichier pour les catégories non GS1.
* [Lister les opérations en masse](/fr/api-reference/management-api/bulk-operation/list) — attendre l'achèvement.
* [Présentation de l'API de gestion](/fr/api-reference/management-api/overview) — le schéma d'authentification et les règles de quota applicables à cet 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.
````