MostlyQR

Codici serializzati

Assegna a ogni unità fisica un suo codice univoco — non un codice per linea di prodotto, ma un seriale distinto e non enumerabile per articolo. Questo sblocca l’analisi per unità, il richiamo e la verifica anti-contraffazione. Piano Enterprise.

Il modello ha tre livelli:

  • Campaign — il prodotto/SKU: una destinazione + marchio + stato. Creato nel dashboard (scheda Serialized) o tramite l’API del dashboard.
  • Batch — un lotto di produzione sotto una campagna (creato al momento della coniazione).
  • Unit — un articolo fisico, identificato dal suo seriale (mqr.sh/<serial>).

# Coniare un batch

count unità vengono coniate in modo asincrono in una campagna; esegui il polling del lavoro, quindi esporta un manifesto pronto per la stampa.

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" }

# Esegui il polling del lavoro di coniazione

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 }

# Esporta un bundle pronto per la stampa

Una volta coniato, crea un manifesto (CSV + JSONL opzionale di ogni seriale + il suo URL) e ottieni un URL di download firmato di breve durata — consegnalo al tuo fornitore di stampa/imballaggio.

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 }

# Simbologia e passaporto digitale del prodotto

Ogni seriale può essere renderizzato come QR, un ECC200 DataMatrix (imballaggio compatto) o un GS1 Digital Link che trasporta GTIN + batch + scadenza + seriale. Puoi anche allegare un passaporto digitale del prodotto (Modello, Anno di rilascio, Materiale…) visualizzato quando un’unità viene verificata.

# Anti-contraffazione

Le scansioni per unità eseguono un’euristica di rilevamento dei cloni (lo stesso seriale che appare in aree geografiche disperse, o viaggi impossibili) e attivano un webhook clone.suspected alla transizione del flag. I verdetti vengono visualizzati pubblicamente tramite Verification.

# Note

  • La coniazione è limitata all’assegnazione serialized_codes del piano Enterprise — una chiave non-Enterprise (o una coniazione che supera l’assegnazione) ottiene 409 (failed-precondition), con il limite nel messaggio.
  • Le unità sono documenti ultra-leggeri, quindi una campagna scala a milioni senza overhead per unità.

# Avanti