MostlyQR

Códigos serializados

Dê a cada unidade física seu próprio código único — não um código por linha de produto, mas um serial distinto e não enumerável por item. Isso desbloqueia análises por unidade, recall e verificação anti-contrafação. Plano Enterprise.

O modelo tem três camadas:

  • Campanha — o produto/SKU: um destino + marca + status. Criado no painel (aba Serialized) ou via API do painel.
  • Lote — um lote de produção sob uma campanha (criado no momento da cunhagem).
  • Unidade — um item físico, identificado por seu serial (mqr.sh/<serial>).

# Cunhar um lote

count unidades são cunhadas assincronamente sob uma campanha; você sonda o trabalho e depois exporta um manifesto pronto para impressão.

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

# Sondar o trabalho de cunhagem

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 um pacote pronto para impressão

Uma vez cunhado, construa um manifesto (CSV + opcional JSONL de cada serial + sua URL) e obtenha uma URL de download assinada de curta duração — entregue-a ao seu fornecedor de impressão/embalagem.

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 passaporte do produto

Cada serial pode ser renderizado como um QR, um DataMatrix ECC200 (empacotamento compacto) ou um GS1 Digital Link carregando GTIN + lote + validade + serial. Você também pode anexar um passaporte digital do produto (Modelo, Ano de lançamento, Material…) mostrado quando uma unidade é verificada.

# Anti-contrafação

Verificações por unidade executam uma heurística de detecção de clones (o mesmo serial aparecendo em geografias dispersas, ou viagem impossível) e disparam um webhook clone.suspected na transição da bandeira. Vereditos são exibidos publicamente via Verification.

# Notas

  • A cunhagem é limitada pela dotação serialized_codes do plano Enterprise — uma chave não Enterprise (ou uma cunhagem que excederia a dotação) recebe 409 (failed-precondition), com o limite na mensagem.
  • Unidades são documentos ultra-leves, portanto uma campanha se dimensiona para milhões sem overhead por unidade.

# Próximo