Timbra

Appearance

On this page

API Masivo · CFDI 4.0

Timbrado y cancelación por API

Integra la emisión de CFDI 4.0 en tu sistema con una API REST. Usa el mismo contrato para probar en Sandbox y para emitir facturas reales ante el SAT.

Crear mi API KeyHacer mi primer timbrado

Lo que puedes hacer ​

Timbrar desde JSONEnvía los datos del CFDI y recibe el XML timbrado y su UUID.Timbrar desde XMLEnvía un XML sin sellar o pre-sellado y recibe el CFDI timbrado por el PAC.Cancelar por UUIDCancela un CFDI sin necesidad de enviar tus certificados CSD.Cancelar por CSDFirma la solicitud de cancelación con tus Certificados de Sello Digital.

URL base ​

Todas las rutas de esta documentación parten de la misma URL, tanto en Live como en Test:

https://dashboard.timbra.com.mx/api/masivo

Flujo de integración ​

  1. Crea una API Key en el panel de Timbra, en la sección API Keys. Elige el entorno Live o Test.
  2. Guarda la llave en un lugar seguro. Se muestra completa solo al crearla.
  3. Envía tu CFDI a la ruta de timbrado JSON o XML con el header Authorization: Bearer <API_KEY>.
  4. Recibe el UUID y el XML timbrado en la respuesta. En modo Live también se descuenta un timbre de tu saldo y el CFDI se guarda en tu cuenta.
  5. Cancela cuando lo necesites por UUID o por CSD, según el caso.

Empieza en Sandbox

Una llave tmb_test_... timbra contra el entorno de pruebas del PAC, no descuenta timbres y no guarda los CFDI de prueba en tu cuenta. Puedes repetir todas las pruebas que necesites sin costo.

Endpoints ​

MétodoRutaDescripción
POST/v3/cfdi33/issue/json/v4Timbra un CFDI a partir de un JSON (aplica CSD automáticamente).
POST/cfdi33/issue/v4Emite y timbra un XML sin sellar (sellado automático con CSD).
POST/cfdi33/stamp/json/v4Timbra un XML de CFDI 4.0 previamente sellado.
POST/cfdi33/cancel/csdCancela un CFDI con tus CSD.
POST/cfdi33/cancel/uuidCancela un CFDI por UUID con JSON.
POST/cfdi33/cancel/:rfc/:uuid/:motivo/:folioSustituto?Cancela un CFDI por UUID con parámetros en la URL.

Ambientes ​

AmbientePrefijo de la llaveSaldoPersistenciaPAC
Livetmb_live_Descuenta 1 timbre por CFDIGuarda el CFDI en tu cuentaProducción
Test / Sandboxtmb_test_No descuentaNo guarda el CFDIPruebas

La URL y el contrato de las rutas son los mismos. El ambiente se determina por el tipo de API Key que envíes. Consulta Ambientes Live y Test para conocer los RFCs de prueba permitidos.

Colección de Postman ​

Descarga la colección y el environment para probar todos los endpoints desde Postman:

Sigue la guía de Colección de Postman para importarlos y configurar tus variables.

Recursos ​