Inicio Rápido - Timbre by Taxo

Comienza en tres pasos

Empieza a crear facturas desde tickets con la API de Timbre.

Paso 1: Obtén tu llave API

Genera tu llave API

Inicia sesión en tu cuenta de Timbre en api.usatimbre.com
Navega a la configuración de tu perfil
Genera una nueva llave API o copia la existente

Mantén tu llave API segura y nunca la expongas en código del lado del cliente.

Prueba tu llave API

Verifica que tu llave API funcione llamando al endpoint de perfil:

curl -X GET "https://api.usatimbre.com/api/profile/TU_RFC" \
  -H "Authorization: Bearer tmb_tu_llave_api_aqui"

Reemplaza TU_RFC con tu RFC real y usa tu llave API real.

Paso 2: Configura tu perfil

Verifica tu información fiscal

Antes de crear facturas, asegúrate de que tu información fiscal esté actualizada:

curl -X GET "https://api.usatimbre.com/api/profile/TU_RFC/tax-info" \
  -H "Authorization: Bearer tmb_tu_llave_api_aqui"

Actualiza la información fiscal si es necesario

Actualiza tu información fiscal con los campos requeridos:

curl -X PATCH "https://api.usatimbre.com/api/profile/TU_RFC/tax-info" \
  -H "Authorization: Bearer tmb_tu_llave_api_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "postal_code": "12345",
    "invoice_fiscal_regimen": "601",
    "invoice_cfdi_use": "G03"
  }'

Paso 3: Crea tu primera factura

Crea factura desde ticket

Envía una imagen de ticket para crear una factura:

curl -X POST "https://api.usatimbre.com/api/timbre/facturar-ticket" \
  -H "Authorization: Bearer tmb_tu_llave_api_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "receipt_image": "datos_imagen_base64",
    "cfdi_usage": "G03",
    "expense_description": "Gasto empresarial"
  }'

Esta operación requiere 1 crédito. Asegúrate de tener créditos suficientes.

Siguientes pasos

Explora las capacidades completas de la API:

Gestión de Perfiles

Administra perfiles de usuario e información fiscal.

Gestión de Organizaciones

Administra organizaciones y miembros.

Crear Facturas

Crea facturas desde imágenes de tickets.

Obtener Detalles de Factura

Recupera archivos PDF y XML de facturas.

Códigos de Uso CFDI Comunes

Código	Descripción
`G01`	Adquisición de mercancías
`G02`	Devoluciones, descuentos o bonificaciones
`G03`	Gastos en general
`P01`	Por definir

Códigos de Régimen Fiscal Comunes

Código	Descripción
`601`	General de Ley Personas Morales
`603`	Personas Morales con Fines no Lucrativos
`605`	Sueldos y Salarios
`606`	Arrendamiento
`612`	Personas Físicas con Actividades Empresariales
`625`	Régimen Simplificado de Confianza

¿Necesitas ayuda? Contacta a soporte en soporte@usatimbre.com.

​Comienza en tres pasos

​Paso 1: Obtén tu llave API

​Paso 2: Configura tu perfil

​Paso 3: Crea tu primera factura

​Siguientes pasos

Gestión de Perfiles

Gestión de Organizaciones

Crear Facturas

Obtener Detalles de Factura

​Códigos de Uso CFDI Comunes

​Códigos de Régimen Fiscal Comunes

Comienza en tres pasos

Paso 1: Obtén tu llave API

Paso 2: Configura tu perfil

Paso 3: Crea tu primera factura

Siguientes pasos

Códigos de Uso CFDI Comunes

Códigos de Régimen Fiscal Comunes