MostlyQR

Códigos serializados

Dale a cada unidad física su propio código único — no un código por línea de producto, sino un serial distinto y no enumerable por artículo. Esto desbloquea análisis por unidad, recuperación y verificación anti-falsificación. Plan Enterprise.

El modelo tiene tres niveles:

  • Campaign — el producto/SKU: un destino + marca + estado. Creado en el panel (pestaña Serialized) o a través de la API del panel.
  • Batch — un lote de producción bajo una campaña (creado en tiempo de acuñación).
  • Unit — un artículo físico, identificado por su serial (mqr.sh/<serial>).

# Acuñar un lote

Se acuñan count unidades de forma asincrónica bajo una campaña; sondea el trabajo y luego exporta un manifiesto listo para imprimir.

bash
curl https://mostlyqr.com/api/v1/serialized/campaigns/CAMPAIGN_ID/mint \
  -H "Authorization: Bearer mtq_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "count": 100000, "label": "Spring run 04" }'
json
{ "job_id": "9f3a2c7b", "batch_id": "b-1718…", "total": 100000, "status": "queued" }

# Sondear el trabajo de acuñación

bash
curl https://mostlyqr.com/api/v1/serialized/jobs/9f3a2c7b \
  -H "Authorization: Bearer mtq_live_…"
json
{ "job_id": "9f3a2c7b", "status": "running", "total": 100000, "minted": 42000, "progress": 0.42 }

# Exportar un paquete listo para imprimir

Una vez acuñado, construye un manifiesto (CSV + JSONL opcional de cada serial + su URL) y obtén una URL de descarga firmada de corta duración — entrégala a tu proveedor de impresión/empaque.

bash
curl https://mostlyqr.com/api/v1/serialized/campaigns/CAMPAIGN_ID/export \
  -H "Authorization: Bearer mtq_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "batch_id": "b-1718…", "includeJsonl": true }'
json
{ "url": "https://…signed…/spring-run-04.zip", "count": 100000, "filename": "spring-run-04.zip", "expires_in_ms": 86400000 }

# Simbología y pasaporte del producto

Cada serial puede representarse como un QR, un DataMatrix ECC200 (empaque compacto), o un GS1 Digital Link que lleve GTIN + lote + caducidad + serial. También puedes adjuntar un pasaporte digital del producto (Modelo, Año de lanzamiento, Material…) que se muestre cuando se verifique una unidad.

# Anti-falsificación

Los escaneos por unidad ejecutan una heurística de detección de clones (el mismo serial apareciéndose en geografías dispersas, o viaje imposible) y disparan un webhook clone.suspected en la transición de bandera. Los veredictos aparecen públicamente a través de Verificación.

# Notas

  • La acuñación está limitada por la asignación serialized_codes del plan Enterprise — una clave no Enterprise (o una acuñación que excedería la asignación) obtiene 409 (failed-precondition), con el límite en el mensaje.
  • Las unidades son documentos ultra ligeros, por lo que una campaña escala a millones sin gastos por unidad.

# Siguiente