ALalegra
Invoices

Consultar estado SAT de factura

Herramienta MCP: invoice_getSATStatus.

Solo lectura. Exclusiva de México: solo está disponible cuando la empresa de Alegra es mexicana.

Consulta el estado de timbrado SAT de UNA factura por su ID de Alegra. El campo emissionStatus puede ser:

  • PENDING: sin timbrar.
  • STAMPED_AND_WAITING_RESPONSE: enviada, el PAC o el SAT aún no confirma.
  • STAMPED_AND_ACCEPTED: CFDI válido.
  • STAMPED_AND_REJECTED: timbrado rechazado.
  • CANCELLED_AND_WAITING_RESPONSE: cancelación solicitada, sin confirmar.
  • STAMPED_AND_CANCELLED: cancelada ante el SAT.

Devuelve además una descripción en lenguaje claro (emissionStatusDescription), el uuid (folio fiscal; null si nunca se timbró), la numeración, el cliente, los importes y un bloque stamp ligero.

Úsalo cuando el usuario pregunte si una factura está timbrada, cuál es su UUID o cómo terminó una llamada de timbrado o cancelación. Si el usuario no nombra una factura, usa invoice_listRejectedSAT. Si necesita la factura completa (ítems, impuestos, pagos), usa invoice_getInvoiceById.

post/tools/invoice_getSATStatus

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/tools/invoice_getSATStatus
  • Auth
    HTTP bearer

Request body

idstring required

ID interno de la factura en Alegra (por ejemplo, "1234"). Es el campo id que devuelve invoice_getInvoices, no el número de factura (por ejemplo, "A-15") ni el UUID del SAT. Si solo tienes el número, resuelve primero el ID con invoice_getInvoiceByNumber.

Response

Estado de timbrado SAT de la factura

Changes

No recorded changes to this operation across all 1 revision of this API.