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 elemento. Eso desbloquea análisis por unidad, recall y verificación anti-falsificación. Plan Enterprise.

El modelo tiene tres niveles:

  • Campaign — el producto/SKU: un destino + marca + estado. Se crea en el panel de control (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 mint).
  • Unit — un elemento físico, identificado por su serial (mqr.sh/u/<serial>).

# Mint a batch

count unidades se crean de forma asincrónica bajo una campaña; consulta el trabajo, 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": "mint_abc", "batch_id": "b-1718…", "total": 100000, "status": "queued" }

# Poll the mint job

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

# Export a print-ready bundle

Una vez creado, construye un manifiesto (CSV + JSONL opcional de cada serial y su URL) y obtén una URL de descarga firmada de corta duración — entrégala a tu vendedor 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 el pasaporte de producto

Cada serial puede renderizarse como un QR, una ECC200 DataMatrix (empaque ajustado), o un GS1 Digital Link llevando GTIN + batch + expiry + serial. También puedes adjuntar un pasaporte digital de producto (Modelo, Año de lanzamiento, Material…) mostrado cuando se verifica una unidad.

# Anti-falsificación

Los escaneos por unidad ejecutan una heurística de detección de clones (el mismo serial apareciendo en geografías dispersas, o viaje imposible) e impulsan un webhook clone.suspected en la transición de bandera. Los veredictos se muestran públicamente a través de Verification.

# Notas

  • La creación está limitada por la asignación serialized_codes del plan Enterprise — una clave no Enterprise obtiene 403.
  • Las unidades son documentos ultra-ligeros, por lo que una campaña escala a millones sin gastos por unidad.

# Siguiente