SatConsultarEstatus

Description

Checks a CFDI’s status directly against the SAT’s verification service: whether it is Valid or Cancelled, whether it is cancelable and, when applicable, the status of the cancellation process. Unlike stamping and cancellation, this query is a direct SAT service and does not go through the PAC. If the recipient RFC or the total are not provided, the node fills them in automatically from the CFDI that was stored when it was stamped (looked up by UUID).

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	SAT credential
uuid	text	Yes	UUID (fiscal folio) of the CFDI to check
rfc_emisor	text	No	Issuer RFC (if omitted, taken from the credential or the stored CFDI)
rfc_receptor	text	No	Recipient RFC (if omitted, taken from the stored CFDI)
total	text	No	Receipt total (if omitted, taken from the stored CFDI)

Credentials

Requires a sat credential type with:

• Issuer RFC, legal name, fiscal regime and postal code
• CSD (not used for this query, but still required on the credential)
• Environment: test or production, to pick the correct SAT verification endpoint

Output

{
  "success": true,
  "uuid": "A1B2C3D4-E5F6-4A5B-9C8D-1234567890AB",
  "estado": "Vigente",
  "esCancelable": "Cancelable sin aceptación",
  "estatusCancelacion": null,
  "codigoEstatus": "S - Comprobante obtenido satisfactoriamente"
}

Usage Example

{
  "credentials_id": "cred-sat-prod",
  "uuid": "A1B2C3D4-E5F6-4A5B-9C8D-1234567890AB"
}

With explicit RFCs and total

{
  "credentials_id": "cred-sat-prod",
  "uuid": "A1B2C3D4-E5F6-4A5B-9C8D-1234567890AB",
  "rfc_emisor": "AAA010101AAA",
  "rfc_receptor": "XAXX010101000",
  "total": "1160.00"
}

Notes

• This query is a DIRECT SAT service (it does not go through the PAC), unlike stamping and cancellation.
• If the CFDI was stamped with SatTimbrarCFDI, there is no need to pass rfc_receptor or total: the node recovers them from what was stored by UUID.
• The estado field can be “Vigente” (valid), “Cancelado” (cancelled), or “No Encontrado” (not found), as returned by the SAT.

Related Nodes

• SatTimbrarCFDI - Stamp a CFDI
• SatCancelarCFDI - Cancel a stamped CFDI