Skip to content
Last updated

Este endpoint permite consultar el estatus actual de un CFDI directamente ante el SAT y actualizar el registro local con el resultado.

Es útil para dar seguimiento a facturas cuya cancelación fue solicitada (CANCEL_REQUESTED) o para verificar que un CFDI sigue vigente.

Endpoint

GET /v1/qrs/invoices/uuid/{uuid}/status

Host (DEV):

https://api-dev.qrwey.com

Host (PROD):

https://api.qrwey.com

Headers requeridos

Authorization: Bearer {{access_token}}

Parámetros de ruta

ParámetroDescripción
uuidFolio UUID del CFDI asignado por el SAT al timbrar la factura

Ejemplo de request (DEV)

curl -X GET "https://api-dev.qrwey.com/v1/qrs/invoices/uuid/F1G2H3I4-J5K6-7890-LMNO-PQ1234567890/status" \
  -H "Authorization: Bearer {{access_token}}"

Respuesta

{
  "invoiceId": "8f3a1c2d-9b4e-4a7f-91d6-2b8e7c5a1f3d",
  "invoiceStatus": "GENERATED",
  "folioUuid": "F1G2H3I4-J5K6-7890-LMNO-PQ1234567890",
  "sourceTaxId": "FUNK671228PH6",
  "sourceLegalName": "KARLA FUENTE NOLASCO",
  "targetTaxId": "EKU9003173C9",
  "targetLegalName": "ESCUELA KEMPER URGATE",
  "subtotal": 500.00,
  "iva": 80.00,
  "total": 580.00,
  "invoiceDate": "2026-03-19T15:00:00Z"
}

Estatus posibles

invoiceStatusSignificado
GENERATEDEl CFDI está vigente ante el SAT
CANCELLEDEl CFDI fue cancelado
CANCEL_IN_PROGRESSLa cancelación está en proceso ante el SAT

Comportamiento

  • El endpoint consulta el estatus del CFDI directamente ante el SAT usando el folioUuid.
  • Si el SAT reporta un estatus válido (GENERATED, CANCELLED o CANCEL_IN_PROGRESS), el registro local se actualiza automáticamente.
  • Si el SAT no puede resolver el estatus, se retorna un error 400.

Errores comunes

CódigoMotivo
400No fue posible obtener el estatus del CFDI ante el SAT
401Token inválido o expirado
404Factura no encontrada

Consulta: Manejo de errores

Buenas prácticas

  • Usa este endpoint para dar seguimiento a facturas con estatus CANCEL_REQUESTED.
  • No consultes el estatus de forma excesiva; el SAT puede limitar las consultas.
  • Si necesitas cancelar un CFDI, usa el endpoint de cancelación: Cancelar CFDI 4.0.

¿Qué sigue?