v0.1 draft

Tickets digitales, simples y validables.

Ticket Schema es un estándar abierto JSON Schema para tickets, recibos y comprobantes digitales. Sirve para reemplazar papel físico con documentos portables, verificables y fáciles de renderizar.

Importante: Ticket Schema está diseñado para documentos no fiscales. No sustituye facturas, CFDI ni comprobantes fiscales exigidos por una autoridad tributaria.

Validar un JSON Ver ejemplos GitHub

Qué puedes hacer

Las acciones principales están separadas para que no tengas que leer toda la documentación.

Validar

Prueba si un documento cumple con un perfil Ticket Schema.

Abrir validator →

Explorar ejemplos

Revisa tickets de venta, pagos, entregas, préstamos y servicios.

Abrir examples →

Previsualizar

Renderiza un JSON como ticket ligero para iframe o vista web.

Abrir preview →

Uso rápido

Flujo mínimo para integrar Ticket Schema en una app.

1. Crear un documento

Genera un JSON compatible con uno de los perfiles v0.1.

{
  "$schema": "https://ticketschema.org/schema/v0.1/profiles/retail-receipt.json",
  "ticketSchemaVersion": "0.1",
  "documentType": "retail_receipt",
  "status": "paid",
  "currency": "MXN",
  "amounts": { "total": 86, "paid": 86, "balance": 0 }
}

2. Validarlo

POST https://ticket-schema.pages.dev/api/validate
content-type: application/json

{ "valid": true, "errors": [] }

3. Obtener HTML dentro de JSON

POST https://ticket-schema.pages.dev/api/render
content-type: application/json

{
  "document": { "...": "Ticket Schema JSON" }
}

{
  "valid": true,
  "errors": [],
  "html": "<div class=\"ticket-schema-render\">...</div>"
}

4. Obtener HTML directo

POST https://ticket-schema.pages.dev/api/render/html
content-type: application/json

{
  "document": { "...": "Ticket Schema JSON" }
}

Responde text/html, listo para previsualizar o insertar.

5. Embed por URL

Si el documento ya está publicado como JSON, usa el renderer embebible.

https://ticket-schema.pages.dev/render/?src=/examples/v0.1/retail-receipt-mx.json

<iframe src="https://ticket-schema.pages.dev/render/?src=/examples/v0.1/retail-receipt-mx.json"></iframe>