MostlyQR

Codici serializzati

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

Il modello ha tre livelli:

  • Campaign — il prodotto/SKU: una destinazione + marca + 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 singolo, identificato dal suo seriale (mqr.sh/u/<serial>).

# Coniare un batch

count unità vengono coniate in modo asincrono sotto 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": "mint_abc", "batch_id": "b-1718…", "total": 100000, "status": "queued" }

# Eseguire il polling del lavoro di coniazione

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 }

# Esportare un pacchetto 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 con firma a breve termine — 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 del prodotto

Ogni seriale può essere reso come un 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…) mostrato quando un’unità viene verificata.

# Anti-contraffazione

Gli scan per unità eseguono un’euristica di rilevamento dei cloni (lo stesso seriale appare in aree geografiche disperse, o viaggio impossibile) e attivano un webhook clone.suspected sulla transizione del flag. I verdetti si visualizzano pubblicamente tramite Verification.

# Note

  • La coniazione è limitata dall’assegnazione serialized_codes del piano Enterprise — una chiave non Enterprise riceve 403.
  • Le unità sono documenti ultra-leggeri, quindi una campagna scala a milioni senza overhead per unità.

# Successivo