{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Consultar estatus de CFDI","description":"QRwey! API es un API que te permite intenciones de autofactura con QRs para ser leidos en la App de QRwey!.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"consultar-estatus-de-cfdi","__idx":0},"children":["Consultar estatus de CFDI"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Este endpoint permite ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["consultar el estatus actual de un CFDI"]}," directamente ante el SAT"," ","y actualizar el registro local con el resultado."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Es útil para dar seguimiento a facturas cuya cancelación fue solicitada"," ","(",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CANCEL_REQUESTED"]},") o para verificar que un CFDI sigue vigente."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoint","__idx":1},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /v1/qrs/invoices/uuid/{uuid}/status\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host (DEV):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://api-dev.qrwey.com\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host (PROD):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://api.qrwey.com\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"headers-requeridos","__idx":2},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"parámetros-de-ruta","__idx":3},"children":["Parámetros de ruta"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parámetro"},"children":["Parámetro"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uuid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Folio UUID del CFDI asignado por el SAT al timbrar la factura"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ejemplo-de-request-dev","__idx":4},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api-dev.qrwey.com/v1/qrs/invoices/uuid/F1G2H3I4-J5K6-7890-LMNO-PQ1234567890/status\" \\\n  -H \"Authorization: Bearer {{access_token}}\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"respuesta","__idx":5},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"invoiceId\": \"8f3a1c2d-9b4e-4a7f-91d6-2b8e7c5a1f3d\",\n  \"invoiceStatus\": \"GENERATED\",\n  \"folioUuid\": \"F1G2H3I4-J5K6-7890-LMNO-PQ1234567890\",\n  \"sourceTaxId\": \"FUNK671228PH6\",\n  \"sourceLegalName\": \"KARLA FUENTE NOLASCO\",\n  \"targetTaxId\": \"EKU9003173C9\",\n  \"targetLegalName\": \"ESCUELA KEMPER URGATE\",\n  \"subtotal\": 500.00,\n  \"iva\": 80.00,\n  \"total\": 580.00,\n  \"invoiceDate\": \"2026-03-19T15:00:00Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"estatus-posibles","__idx":6},"children":["Estatus posibles"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"invoiceStatus"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoiceStatus"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Significado"},"children":["Significado"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GENERATED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["El CFDI está vigente ante el SAT"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CANCELLED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["El CFDI fue cancelado"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CANCEL_IN_PROGRESS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La cancelación está en proceso ante el SAT"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"comportamiento","__idx":7},"children":["Comportamiento"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["El endpoint consulta el estatus del CFDI directamente ante el SAT usando el ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["folioUuid"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Si el SAT reporta un estatus válido (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GENERATED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CANCELLED"]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CANCEL_IN_PROGRESS"]},"),"," ","el registro local se actualiza automáticamente."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Si el SAT no puede resolver el estatus, se retorna un error ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errores-comunes","__idx":8},"children":["Errores comunes"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Código"},"children":["Código"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Motivo"},"children":["Motivo"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No fue posible obtener el estatus del CFDI ante el SAT"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token inválido o expirado"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Factura no encontrada"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Consulta: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/error-handling"},"children":["Manejo de errores"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"buenas-prácticas","__idx":9},"children":["Buenas prácticas"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Usa este endpoint para dar seguimiento a facturas con estatus ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CANCEL_REQUESTED"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No consultes el estatus de forma excesiva; el SAT puede limitar las consultas."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Si necesitas cancelar un CFDI, usa el endpoint de cancelación: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/cancel-cfdi"},"children":["Cancelar CFDI 4.0"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"qué-sigue","__idx":10},"children":["¿Qué sigue?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cancela un CFDI: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/cancel-cfdi"},"children":["Cancelar CFDI 4.0"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Timbra un nuevo CFDI: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/stamp-cfdi"},"children":["Timbrar CFDI 4.0"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Vuelve al índice: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/customer-portal"},"children":["Gestión de Clientes"]}]}]}]},"headings":[{"value":"Consultar estatus de CFDI","id":"consultar-estatus-de-cfdi","depth":1},{"value":"Endpoint","id":"endpoint","depth":2},{"value":"Headers requeridos","id":"headers-requeridos","depth":2},{"value":"Parámetros de ruta","id":"parámetros-de-ruta","depth":2},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev","depth":2},{"value":"Respuesta","id":"respuesta","depth":2},{"value":"Estatus posibles","id":"estatus-posibles","depth":3},{"value":"Comportamiento","id":"comportamiento","depth":2},{"value":"Errores comunes","id":"errores-comunes","depth":2},{"value":"Buenas prácticas","id":"buenas-prácticas","depth":2},{"value":"¿Qué sigue?","id":"qué-sigue","depth":2}],"frontmatter":{"title":"Consultar estatus de CFDI","description":"Consultar el estatus actual de un CFDI ante el SAT a través del API de QRwey!","seo":{"title":"Consultar estatus de CFDI"}},"lastModified":"2026-06-18T21:09:09.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/cfdi-status","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}