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
- El consumer escanea el QR en el ticket
- Ingresa su RFC y datos fiscales en la PWA (
pwa.timbrify.com) - Timbrify genera y timbra la factura automaticamente
- El consumer recibe su CFDI por email (XML + PDF)
Flujo del merchant
- Configura su cuenta en
merchant.timbrify.com - Sube su CSD y configura datos fiscales
- Su POS genera tickets via API (cada ticket tiene un QR)
- 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.