DOC 3 Especificación API

Plataforma de Timbrado como Servicio (TaaS)

Campo	Detalle
Versión	1.0.0
Estado	Final
Fecha	2026-05-04

---

1. Convenciones Generales

• Base URL: https://api.taas.mx/v1
• Autenticación:
  • X-API-Key: Para aplicaciones de facturación (Timbrado/Cancelación).
  • Bearer JWT: Para usuarios humanos (Administración/Consola).
• Formatos: JSON, XML (solo timbrado), YAML (solo timbrado).

2. Endpoints Principales

2.1 Timbrado Individual

POST /cfdi/timbrar

• Payload: Datos del CFDI + emisor_rfc.
• Modos: SINCRONO (espera respuesta) o ASINCRONO (envía a cola y notifica vía Webhook).
• Sellado: Si se omite el nodo Sello, TaaS lo genera automáticamente.

2.2 Timbrado por Lote

POST /lotes

• Procesa múltiples CFDIs de forma asíncrona.
• Requiere callback_url configurado.

2.3 Cancelación

POST /cfdi/{uuid}/cancelar

• Motivos: 01 (Sustitución), 02 (Errores), 03 (No llevado a cabo), 04 (Global).
• Siempre asíncrono. Genera acuse de cancelación oficial.

2.4 Gestión de Emisores

POST /emisores

• Registra un RFC y carga su CSD.
• Sincronización automática con el PAC (ProFact).

3. Catálogo de Errores Comunes

• INSUFFICIENT_CREDITS (402): El emisor o integrador no tiene saldo.
• CSD_NOT_ACTIVE (409): El CSD está vencido o no ha sido sincronizado con el PAC.
• PAC_REJECTION (422): Error de validación fiscal devuelto por el SAT/PAC.

---

Fin del documento — DOC 3