Timbrify
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

  1. Tu POS crea un ticket via API y recibe un QR
  2. El consumidor escanea el QR con su telefono
  3. Ingresa sus datos fiscales en la PWA
  4. Timbrify genera y timbra el CFDI 4.0 automaticamente
  5. El consumidor recibe su factura (XML + PDF) por email

Siguiente paso

Lee Autenticacion para entender los tipos de API Key y como configurar webhooks.