Guias
Flujo de facturacion
En Timbrify, el flujo mas comun es bilateral via QR:
- Tu POS crea un ticket via API
- El consumidor escanea el QR e ingresa sus datos fiscales
- Timbrify timbra el CFDI automaticamente
Para facturacion directa (sin QR), usa el endpoint de invoices.
Crear un ticket (flujo 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": 5800.00,
"items": [{
"description": "Servicio de consultoria fiscal",
"quantity": 1,
"unitPrice": 5000.00,
"taxRate": 0.16
}]
}'Campos obligatorios CFDI 4.0
Desde CFDI 4.0, estos campos del receptor son obligatorios:
regimenFiscalReceptor y domicilioFiscalReceptor.
El consumidor los proporciona al escanear el QR.
Uso de CFDI mas comunes
| Codigo | Descripcion | Caso de uso |
|---|---|---|
G01 | Adquisicion de mercancias | Compra de productos |
G03 | Gastos en general | Servicios profesionales |
S01 | Sin efectos fiscales | Publico en general |
CP01 | Pagos | Complemento de pago (REP) |
Impuestos
Los impuestos se calculan por concepto. Los mas comunes:
| Impuesto | Codigo SAT | Tasa | Descripcion |
|---|---|---|---|
| IVA 16% | 002 | 0.160000 | Traslado estandar |
| IVA 0% | 002 | 0.000000 | Tasa cero (alimentos, medicinas) |
| ISR retencion | 001 | 0.100000 | Retencion por servicios profesionales |
| IVA retencion | 002 | 0.106667 | Retencion de 2/3 del IVA |