DOC 4 Guía Integrador

Plataforma de Timbrado como Servicio (TaaS)

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

---

1. Introducción

Como integrador de TaaS, tu responsabilidad es generar los datos del CFDI 4.0. TaaS se encarga del sellado digital, la comunicación con el SAT/PAC, el resguardo del XML y la generación del PDF.

2. Pasos para la Integración

Paso 1: Obtención de Credenciales

• Recibirás un correo de invitación a la consola de administración.
• Dentro de la consola, obtén tu API Key en la sección de configuración.

Paso 2: Registro de Emisores

• Antes de timbrar, debes registrar a tus clientes emisores.
• Carga sus archivos .cer y .key (Certificado de Sello Digital - CSD).
• TaaS validará la vigencia y registrará al emisor ante el PAC de forma automática.

Paso 3: Configuración de Webhooks

• Define una URL en tu servidor para recibir notificaciones.
• TaaS enviará un POST JSON cada vez que un proceso asíncrono (timbrado masivo o cancelación) termine.

3. Ejemplo de Solicitud de Timbrado (JSON)

{
  "emisor_rfc": "AAA010101AAA",
  "modo": "SINCRONO",
  "cfdi": {
    "Version": "4.0",
    "Serie": "F",
    "Folio": "123",
    "Fecha": "2026-05-04T10:00:00",
    "Emisor": { "Rfc": "AAA010101AAA", "Nombre": "EMPRESA DEMO", "RegimenFiscal": "601" },
    "Receptor": { "Rfc": "XAXX010101000", "Nombre": "PUBLICO EN GENERAL", "UsoCFDI": "S01" },
    "Conceptos": [...]
  }
}

4. Mejores Prácticas

• Idempotencia: Usa tu propio folio/serie para evitar duplicados.
• Modo Asíncrono: Recomendado para procesos de más de 50 facturas simultáneas.
• Descarga: Almacena el UUID devuelto por TaaS para recuperar el XML en cualquier momento vía API.

---

Fin del documento — DOC 4