---
title: "Consultar estado SAT de factura"
method: POST
path: "/tools/invoice_getSATStatus"
tags: ["Invoices"]
---

# Consultar estado SAT de factura

`POST /tools/invoice_getSATStatus`

## Request

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

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`.

## Request body

- object
  - `id` string, 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 `200`

Estado de timbrado SAT de la factura

## Other responses

- `401`: No autorizado

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)