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. Criada no painel (aba Serialized) ou via API do painel.
  • Lote — um lote de produção sob uma campanha (criado no momento de cunhagem).
  • Unidade — um item físico, identificado pelo seu serial (mqr.sh/u/<serial>).

# Cunhar um lote

count unidades são cunhadas de forma assíncrona sob uma campanha; você faz uma consulta no job, 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": "mint_abc", "batch_id": "b-1718…", "total": 100000, "status": "queued" }

# Fazer poll do job de cunhagem

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 }

# Exportar um pacote pronto para impressão

Uma vez cunhado, construa um manifesto (CSV + JSONL opcional de cada serial + sua URL) e obtenha uma URL de download assinada de curta duração — entregue ao seu vendedor 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 o passaporte de produto

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

# Anti-contrafação

Varreduras 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 de flag. Vereditos aparecem publicamente via Verificação.

# Notas

  • A cunhagem é controlada pela provisão de serialized_codes do plano Enterprise — uma chave não-Enterprise recebe 403.
  • Unidades são docs ultraligeiros, então uma campanha escala para milhões sem overhead por unidade.

# Próximo