Inicio
Requisitos previos
- Una cuenta de merchant en merchant.timbrify.com
- Tu API Key (Configuracion > API Keys)
- CSD activo cargado en tu cuenta (Configuracion > Certificados)
Tu primera factura
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": 1160.00,
"items": [{
"description": "Servicio de consultoria",
"quantity": 1,
"unitPrice": 1000.00,
"taxRate": 0.16
}]
}'Respuesta exitosa
{
"data": {
"id": "uuid-del-ticket",
"qrToken": "tkn_xxxxxxxxxxxxxxxx",
"qrUrl": "https://pwa.timbrify.com/q/tkn_xxxxxxxxxxxxxxxx",
"total": 1160.00,
"status": "pending"
}
}CFDI 4.0 requiere regimenFiscalReceptor y domicilioFiscalReceptor
en el receptor. Sin estos campos el timbrado falla con error
INVALID_RECEPTOR_DATA.
Como funciona
- Tu POS crea un ticket via API y recibe un QR
- El consumidor escanea el QR con su telefono
- Ingresa sus datos fiscales en la PWA
- Timbrify genera y timbra el CFDI 4.0 automaticamente
- El consumidor recibe su factura (XML + PDF) por email
Siguiente paso
Lee Autenticacion para entender los tipos de API Key y como configurar webhooks.