Timbrado de CFDI

Además de generar el CFDI sellado, el servicio puede timbrarlo con el proveedor de timbrado configurado en el servidor. El primer proveedor disponible es CONTPAQi Factura Electrónica, operado por un agente que la plataforma administra: para ti como consumidor de la API, timbrar es solo agregar un parámetro a la petición de generación.

Timbrar al generar

Los cuatro endpoints de generación de CFDI aceptan el parámetro opt-in ?timbrar=true: tras sellar el CFDI, la app lo envía al proveedor de timbrado y responde 200 application/xml con el XML ya timbrado (con su TimbreFiscalDigital y UUID). Sin el parámetro, la respuesta es el CFDI solo sellado, como siempre.

POST /api/v1/cfdi/generar/ingreso?timbrar=true Authorization: Bearer <token> Content-Type: application/json

Prerequisito: ligar tu empresa

La empresa emisora debe tener ligada su empresa del agente de timbrado en el panel de empresas (campo "Empresa en el agente de timbrado"). El botón "Probar en agente" verifica la liga contra el agente y muestra el nombre de la empresa encontrada.

Errores

• 422 — la empresa emisora no tiene ligada su empresa del agente de timbrado.
• 422 — no hay agente de timbrado disponible en el servidor.
• 502 {"codigo", "mensaje"} — error de negocio del proveedor (código devuelto por su SDK, p. ej. licencia o dato rechazado).

Toda operación de timbrado (exitosa o con error) queda en la bitácora del servidor con el UUID y el XML timbrado cuando lo hubo.

Desde MCP

Las herramientas MCP generar_cfdi_ingreso, generar_cfdi_egreso, generar_cfdi_traslado y generar_cfdi_pago exponen el mismo flag opcional timbrar (default false). Ver Servidor MCP.