Referencia · Cancelar y consultar

cancelarCFDI

Pide al SAT la cancelación de un CFDI, firmada con tu CSD.

POST/api/cancelarCFDI

La solicitud se firma con el sello que cargaste para el RFC emisor. El SAT responde de inmediato si la recibió; si el CFDI necesita que el receptor la acepte, queda en proceso hasta que conteste.

Para saber cómo terminó, consulta su estatus con consultarEstatusCFDI.

Lo que mandas

Campo	Tipo	Para qué
`rfcEmisor`obligatoriotexto	texto	El RFC del emisor del CFDI.
`uuid`obligatoriotexto	texto	El folio fiscal a cancelar.
`motivo`obligatoriotexto	texto	01 con errores con relación, 02 con errores sin relación, 03 no se llevó a cabo, 04 operación nominativa en una factura global.
`uuidRelacionado`texto	texto	El CFDI que lo sustituye. Obligatorio con el motivo 01.
`rfcReceptor · total`texto	texto	Se aceptan por compatibilidad con el servicio anterior.

Lo que regresa

Campo	Tipo	Para qué
`Codigo`texto	texto	El código del SAT (201, 202, 203, 204 o 205).
`Mensaje`texto	texto	Qué significa.
`Acuse`texto	texto	El acuse del SAT, en XML.

Códigos

Código	HTTP	Qué significa
201	200	Solicitud recibida.
202	200	Ya estaba cancelado.
203	200	El folio no corresponde al emisor.
204	200	No aplica para cancelación.
205	200	El SAT no tiene ese folio (en pruebas, siempre: ahí los timbres no llegan al SAT).
301	200	El uuid, el uuidRelacionado o el rfcEmisor no tienen el formato del SAT; nada salió al PAC.
500	200	No hay CSD cargado para el RFC emisor.
500	503	No se pudo confirmar. Reintenta.

Ejemplo

curl https://pruebas.timbrado.idea15.com/api/cancelarCFDI \
  -u "$DUBSARIA_USUARIO:$DUBSARIA_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"rfcEmisor":"EKU9003173C9","rfcReceptor":"EKU9003173C9","uuid":"988B5F3A-889E-4C9C-BAC7-0FEE99589858","total":"116.00","motivo":"02","uuidRelacionado":""}'

Respuesta real en pruebas · HTTP 200

{
  "Codigo": "205",
  "Mensaje": "El SAT no tiene registrado este folio fiscal",
  "Acuse": "<Acuse Fecha=\"2026-10-29T21:24:26.5212341\" RfcEmisor=\"EKU9003173C9\"><Folios xmlns=\"http://cancelacfd.sat.gob.mx\"><UUID>988B5F3A-889E-4C9C-BAC7-0FEE99589858</UUID><EstatusUUID>205</EstatusUUID></Folios><Signature Id=\"SelloSAT\" xmlns=\"http://www.w3.org/2000/09/xmldsig#\"><SignedInfo><CanonicalizationMethod Algorithm=\"http://www.w3.org/TR/2001/REC-xml-c14n-20010315\"/><SignatureMethod Algorithm=\"http://www.w3.org/2001/04/xmldsig-more#hmac-sha512\"/><Reference URI=\"\"><Transforms><Transform Algorithm=\"http://www.w3.org/TR/1999/REC-xpath-19991116\"><XPath>not(ancestor-or-self::*[local-name()='Signature'])</XPath></Transform></Transforms><DigestMethod Algorithm=\"http://www.w3.org/2001/04/xmlenc#sha512\"/><DigestValue>+FR9CVmLaeOCE5bd7MLMgIaM3pe9DvC9wmAn107QQJ8Mc22Z3sNoPMnFEFgpfqp+bmeerW6DuwY+OKOLA9Z8/g==</DigestValue></Reference></SignedInfo><SignatureValue>oK8NmWydi+tEK/TMYQfeQPzs7pFBh1RxOUhXi+PN0GlY4BLjItZIWKnstGWJ+EnrBuj3CywB9uGGVa1vSPpd6Q==</SignatureValue><KeyInfo><KeyName>30001000000500002554</KeyName><KeyValue><RSAKeyValue><Modulus>hUcUOoGEtSDAlrF8KegQkGKY8aDAe9tNRkf48uj1+YirDP4cMEd8YEelQY1jLu1GINYKf9N9XxmOfHdL4FUr+cuOgrBviaGWcIsJfZ80IGpvox6kUSHoRt+h32yQayW0HuNOp0b3yiBp9Y6jTdYTFTAVzgzUjf4LfVt8n5FejVZ2xERIyROnGgbK8A4xBsPpFazHQkK2PCiYe+LYBm0Ux9UZYkYJ9Mu9rL5c51Sjgq8JJekorp0BzfKadRrSEFyD2Z6GwB0RswjLZQspojZGxUnqlbldvO6TjFUV4MT7EV8P7f2VTS0yr4qSwx0y080zoK10CbIoJXfsFROHypFj5w==</Modulus><Exponent>AQAB</Exponent></RSAKeyValue></KeyValue></KeyInfo></Signature></Acuse>"
}