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"
}'
{
"operation_id": "bo-gs1-001",
"message": ["Your GS1 serial range is being processed. We'll email you once it's ready."]
}
Operaciones en masa
Generar un rango de series GS1 en masa
POST /bulk-operation/gs1/serial-range-generate/
POST
/
bulk-operation
/
gs1
/
serial-range-generate
/
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"
}'
{
"operation_id": "bo-gs1-001",
"message": ["Your GS1 serial range is being processed. We'll email you once it's ready."]
}
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 (
Mismo patrón asíncrono que Generar códigos QR en masa — consulte Listar operaciones en masa. 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
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.string
requerido
Una etiqueta para esta operación.
string
requerido
El primer número de serie del rango, solo dígitos, máximo 20 caracteres.
integer
requerido
Cuántas series secuenciales generar, mínimo 1.
string
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.array
Los valores de campo GS1 compartidos por cada serie del rango, como JSON. Proporcione esto o
sample_qrid, no ninguno de los dos.integer
Un id de dominio personalizado para usar en los enlaces cortos de los códigos QR generados.
string
Datos del patrón de diseño aplicados a todos los códigos QR generados.
object
Regla opcional de desactivación automática aplicada a todos los códigos QR generados.
object
Parámetros de seguimiento UTM aplicados a los enlaces de todos los códigos QR generados.
integer
Un id de carpeta donde guardar los códigos QR generados.
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"
}'
{
"operation_id": "bo-gs1-001",
"message": ["Your GS1 serial range is being processed. We'll email you once it's ready."]
}
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 — el equivalente general basado en archivo para categorías que no son GS1.
- Listar operaciones en masa — esperar la finalización.
- Resumen de la API de gestión — el esquema de autenticación y las reglas de cuota aplicables a este endpoint.
Autorizaciones
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.
Respuesta
Generation started.
¿Esta página le ayudó?