{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Cancelar CFDI 4.0","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":"cancelar-cfdi-40","__idx":0},"children":["Cancelar CFDI 4.0"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Este endpoint permite ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["cancelar un CFDI 4.0"]}," que fue timbrado previamente a través del API"," ","de QRwey!. Se debe especificar el motivo de cancelación conforme al catálogo del SAT."]},{"$$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":"DELETE /v1/qrs/invoices/{invoiceId}\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}}\nContent-Type: application/json\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":["invoiceId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificador interno de la factura a cancelar (obtenido al timbrar el CFDI)"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request-body","__idx":4},"children":["Request body"]},{"$$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":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Requerido"},"children":["Requerido"]},{"$$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":["cfdiCancellationReason"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Si"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Código del motivo de cancelación del SAT"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["replacementUuid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Condicional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["UUID del CFDI sustituto. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Obligatorio"]}," cuando ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cfdiCancellationReason"]}," es ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["01"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"motivos-de-cancelación--cfdicancellationreason-","__idx":5},"children":["Motivos de cancelación (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cfdiCancellationReason"]},")"]},{"$$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":"Descripción"},"children":["Descripción"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"replacementUuid"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["replacementUuid"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["01"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Comprobante emitido con errores con relación"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Requerido"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["02"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Comprobante emitido con errores sin relación"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No aplica"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["03"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No se llevó a cabo la operación"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No aplica"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["04"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Operación nominativa relacionada en una factura global"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No aplica"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"precondiciones","__idx":6},"children":["Precondiciones"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["La factura debe existir y pertenecer al comercio del usuario autenticado."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["El estatus actual de la factura debe ser ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GENERATED"]},". Cualquier otro estatus"," ","(",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CANCELLED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CANCEL_REQUESTED"]},", etc.) provocará un error ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["412"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ejemplo-de-request--motivo-02-dev","__idx":7},"children":["Ejemplo de request — motivo 02 (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X DELETE \"https://api-dev.qrwey.com/v1/qrs/invoices/8f3a1c2d-9b4e-4a7f-91d6-2b8e7c5a1f3d\" \\\n  -H \"Authorization: Bearer {{access_token}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"cfdiCancellationReason\": \"02\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ejemplo-de-request--motivo-01-con-uuid-sustituto-dev","__idx":8},"children":["Ejemplo de request — motivo 01 con UUID sustituto (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X DELETE \"https://api-dev.qrwey.com/v1/qrs/invoices/8f3a1c2d-9b4e-4a7f-91d6-2b8e7c5a1f3d\" \\\n  -H \"Authorization: Bearer {{access_token}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"cfdiCancellationReason\": \"01\",\n    \"replacementUuid\": \"A1B2C3D4-E5F6-7890-ABCD-EF1234567890\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"respuesta","__idx":9},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"invoiceId\": \"8f3a1c2d-9b4e-4a7f-91d6-2b8e7c5a1f3d\",\n  \"invoiceStatus\": \"CANCELLED\",\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-tras-la-cancelación","__idx":10},"children":["Estatus posibles tras la cancelación"]},{"$$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":["CANCELLED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["El SAT acepto la cancelación de inmediato"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CANCEL_REQUESTED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La cancelación fue solicitada y queda pendiente de aceptación del receptor"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errores-comunes","__idx":11},"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":["Motivo de cancelación inválido, falta ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["replacementUuid"]}," cuando motivo es ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["01"]},", o el SAT rechazo la cancelación"]}]},{"$$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 o usuario no pertenece al comercio"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["412"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["El estatus de la factura no permite cancelación (no está en ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GENERATED"]},")"]}]}]}]}]},{"$$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":12},"children":["Buenas prácticas"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verifica el estatus de la factura antes de intentar cancelarla."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cuando uses motivo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["01"]},", asegurate de haber timbrado el CFDI sustituto antes de cancelar el original."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Conserva el ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["folioUuid"]}," y la respuesta completa para tu registro contable."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Si la respuesta es ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CANCEL_REQUESTED"]},", debes dar seguimiento al flujo de aceptación"," ","del receptor en el portal del SAT."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["La cancelación es una operación irreversible: una vez aceptada por el SAT, el CFDI"," ","no podrá reactivarse."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"qué-sigue","__idx":13},"children":["¿Qué sigue?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Vuelve a facturas de ingreso: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/stamp-cfdi"},"children":["Timbrar CFDI 4.0"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Genera notas de crédito: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/credit-notes"},"children":["Notas de crédito"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Vuelve al índice: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides"},"children":["Guias"]}]}]}]},"headings":[{"value":"Cancelar CFDI 4.0","id":"cancelar-cfdi-40","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":"Request body","id":"request-body","depth":2},{"value":"Motivos de cancelación ( cfdiCancellationReason )","id":"motivos-de-cancelación--cfdicancellationreason-","depth":3},{"value":"Precondiciones","id":"precondiciones","depth":2},{"value":"Ejemplo de request — motivo 02 (DEV)","id":"ejemplo-de-request--motivo-02-dev","depth":2},{"value":"Ejemplo de request — motivo 01 con UUID sustituto (DEV)","id":"ejemplo-de-request--motivo-01-con-uuid-sustituto-dev","depth":2},{"value":"Respuesta","id":"respuesta","depth":2},{"value":"Estatus posibles tras la cancelación","id":"estatus-posibles-tras-la-cancelación","depth":3},{"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":"Cancelar CFDI 4.0","description":"Cancelar un CFDI 4.0 previamente timbrado a través del API de QRwey!","seo":{"title":"Cancelar CFDI 4.0"}},"lastModified":"2026-04-22T23:50:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/cancel-cfdi","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}