Timbrify
Guias

El modelo bilateral

Timbrify permite que los consumidores soliciten facturas escaneando un codigo QR en su ticket de compra, sin intervencion del merchant.

Flujo del consumer

  1. El consumer escanea el QR en el ticket
  2. Ingresa su RFC y datos fiscales en la PWA (pwa.timbrify.com)
  3. Timbrify genera y timbra la factura automaticamente
  4. El consumer recibe su CFDI por email (XML + PDF)

Flujo del merchant

  1. Configura su cuenta en merchant.timbrify.com
  2. Sube su CSD y configura datos fiscales
  3. Su POS genera tickets via API (cada ticket tiene un QR)
  4. Las facturas se generan automaticamente cuando un consumer escanea

Crear un ticket con QR

curl -X POST https://api.timbrify.com/api/v1/tickets \
  -H "X-API-Key: tmb_live_TU_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "branchId": "uuid-de-tu-sucursal",
    "total": 350.50,
    "items": [{
      "description": "Producto A",
      "quantity": 2,
      "unitPrice": 175.25,
      "taxRate": 0.16
    }]
  }'

La respuesta incluye qrUrl que el merchant imprime en el ticket fisico.

Perfiles fiscales del consumer

Los consumidores pueden guardar sus datos fiscales en la PWA para no tener que ingresarlos cada vez. Timbrify almacena:

  • RFC
  • Nombre o razon social
  • Regimen fiscal
  • Domicilio fiscal (codigo postal)
  • Uso de CFDI preferido

El QR token expira segun la configuracion del merchant (default: 72 horas). Pasado ese tiempo, el consumer no puede solicitar factura para ese ticket.