ContaDB.mx
Iniciar sesiónCrear cuenta

API CFDI para developers. REST + SDK Python.

Timbra CFDI 4.0, complementos de Pagos, Nómina y Carta Porte desde tu propio sistema. Bolsa prepagada, idempotency keys y auto-recarga vía Stripe.

EmpezarVer bolsasSDK en PyPI
contadb_sdk · quickstart
# pip install contadb-sdk
from contadb_sdk import ContaDBClient
 
with ContaDBClient(api_token="cdb_sk_TU_TOKEN_AQUI") as client:
    resultado = client.timbrar(
        cfdi_xml=cfdi_firmado_xml,
        idempotency_key="factura-001",
    )
 
print(f"UUID:           {resultado.uuid}")
print(f"Saldo restante: {resultado.saldo_restante} timbres")

Quickstart

Tu primer timbrado en 3 líneas

Genera un token desde tu panel, instala el SDK y manda tu primer CFDI a producción.

POST /api/v1/timbrar
# pip install contadb-sdk
from contadb_sdk import ContaDBClient
 
with ContaDBClient(api_token="cdb_sk_TU_TOKEN_AQUI") as client:
    resultado = client.timbrar(
        cfdi_xml=cfdi_firmado_xml,
        idempotency_key="factura-001",
    )
 
print(f"UUID:           {resultado.uuid}")
print(f"Saldo restante: {resultado.saldo_restante} timbres")
PASO 1
Crea tu cuenta
Regístrate gratis en menos de 1 minuto.
PASO 2
Genera un token
Desde el panel /api obtienes tu Bearer token.
PASO 3
Compra una bolsa
Desde $200 MXN (100 timbres, sin mensualidad).

Bolsas de timbres

Pago único. Sin mensualidad.

Recarga cuando quieras o activa la auto-recarga vía Stripe. Tu saldo no vence pronto.

100
timbres
$200MXN

+ IVA · pago único

  • Vigencia 12 meses
  • $2.00 por timbre
  • Auto-recarga opcional
Crear cuenta
Más popular
500
timbres
$850MXN

+ IVA · pago único

  • Vigencia 12 meses
  • $1.70 por timbre
  • Auto-recarga opcional
Crear cuenta
1,000
timbres
$1,500MXN

+ IVA · pago único

  • Vigencia 12 meses
  • $1.50 por timbre
  • Auto-recarga opcional
Crear cuenta
10,000
timbres
$10,000MXN

+ IVA · pago único

  • Vigencia 24 meses
  • $1.00 por timbre
  • Auto-recarga opcional
Crear cuenta

Precios MXN, antes de IVA. Pago único vía Stripe. La auto-recarga compra el mismo paquete cuando el saldo baja del umbral que tú definas.

Endpoints

REST sobre api.contadb.mx

Autenticación con Authorization: Bearer <token>.

POST
/api/v1/timbrar
Timbra un CFDI 4.0 ya firmado. Devuelve UUID + XML timbrado.
POST
/api/v1/cancelar
Solicita cancelación al SAT con motivo y CSD del emisor.
GET
/api/v1/saldo
Consulta timbres disponibles, bolsas activas y vencimientos.
GET
/api/v1/paquetes
Lista los paquetes disponibles para recarga.
POST
/api/v1/recargas
Genera un Stripe Checkout para comprar una bolsa.
GET/PUT/DELETE
/api/v1/autorecarga
Configura recarga automática cuando el saldo baja del umbral.

Complementos soportados

Todo el ecosistema CFDI 4.0

Recepción de Pagos 2.0
Complemento 2.0 para CFDI tipo P.
Nómina 1.2
Complemento nomina12 para CFDI tipo N.
Carta Porte 3.1
Builders incluidos en el SDK Python.
CFDI relacionados
Sustitución, devoluciones, notas de crédito.
Cancelación
Motivos 01, 02, 03 y 04 con acuse XML.

Detalles técnicos

Pensado para producción

Idempotency keys

Envía Idempotency-Key en cada timbrado para evitar duplicados en reintentos.

Rate limit: 10 req/s

Por token. Si excedes recibes HTTP 429 con RATE_LIMIT_EXCEEDED.

Protección anti-abuso

Bloqueo automático de 5 minutos tras 5 errores consecutivos del mismo token.

Auto-recarga vía Stripe

Define un umbral y un paquete preferido: cuando el saldo baja, recargamos por ti.

Crea tu cuenta, genera un token, timbra.

Sin mensualidad, sin compromisos. Paga sólo los timbres que uses.

Crear cuenta gratisVer SDK en PyPI