SatConsultarEstatus

Descripción

Consulta el estatus de un CFDI directamente en el servicio de verificación del SAT: si está Vigente o Cancelado, si es cancelable y, en su caso, el estatus del trámite de cancelación. A diferencia del timbrado y la cancelación, esta consulta es un servicio directo del SAT y no pasa por el PAC. Si no se indican el RFC del receptor o el total, el nodo los completa automáticamente a partir del CFDI que quedó guardado al timbrar (buscado por UUID).

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial SAT
uuid	text	Sí	UUID (folio fiscal) del CFDI a consultar
rfc_emisor	text	No	RFC del emisor (si no se pasa, se toma de la credencial o del CFDI guardado)
rfc_receptor	text	No	RFC del receptor (si no se pasa, se toma del CFDI guardado)
total	text	No	Total del comprobante (si no se pasa, se toma del CFDI guardado)

Credenciales

Este módulo requiere una credencial de tipo sat con:

• RFC del emisor, razón social, régimen fiscal y código postal
• CSD (no se usa para esta consulta, pero es obligatorio en la credencial)
• Entorno: test o production, para elegir el endpoint de verificación correcto del SAT

Salida

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

Ejemplo de Uso

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

Con RFCs y total explícitos

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

Notas

• Esta consulta es un servicio DIRECTO del SAT (no pasa por el PAC), a diferencia del timbrado y la cancelación.
• Si el CFDI fue timbrado con SatTimbrarCFDI, no hace falta pasar rfc_receptor ni total: el nodo los recupera de lo que quedó guardado por UUID.
• El campo estado puede ser “Vigente”, “Cancelado” o “No Encontrado”, según lo que responda el SAT.

Nodos Relacionados

• SatTimbrarCFDI - Timbrar un CFDI
• SatCancelarCFDI - Cancelar un CFDI timbrado