Referencia · Retenciones

cancelarRetencion

Cancela un CFDI de Retenciones.

POST/api/cancelarRetencion

Con el PFX que cargaste (y su contraseña en passwordPfx) o, si no hay, con tu CSD.

Lo que mandas

Campo	Tipo	Para qué
`rfcEmisor`obligatoriotexto	texto	El RFC emisor.
`uuid`obligatoriotexto	texto	El folio de la retención.
`motivo`obligatoriotexto	texto	Los mismos motivos 01 a 04.
`uuidRelacionado`texto	texto	El que la sustituye, con el motivo 01.
`passwordPfx`texto	texto	La contraseña del PFX que cargaste.

Lo que regresa

Campo	Tipo	Para qué
`Codigo`texto	texto	El código del SAT (1201, 1202, 1203, 1205).
`Mensaje`texto	texto	Qué significa.
`Acuse`texto	texto	El acuse del SAT.

Códigos

Código	HTTP	Qué significa
1201	200	Cancelado.
1202	200	Ya estaba cancelado.
1203	200	El folio no corresponde al emisor.
1205	200	El SAT no tiene ese folio.
301	200	El uuid, el uuidRelacionado o el rfcEmisor no tienen el formato del SAT; nada salió al PAC.

Ejemplo

curl https://pruebas.timbrado.idea15.com/api/cancelarRetencion \
  -u "$DUBSARIA_USUARIO:$DUBSARIA_CLAVE" \
  -H "Content-Type: application/json" \
  -d @- <<FIN
{
  "rfcEmisor": "EKU9003173C9",
  "uuid": "988B5F3A-889E-4C9C-BAC7-0FEE99589858",
  "motivo": "02",
  "uuidRelacionado": "",
  "passwordPfx": "$CLAVE_PFX"
}
FIN

Respuesta real en pruebas · HTTP 200

{
  "Codigo": "1205",
  "Mensaje": "El SAT no tiene registrado este folio fiscal",
  "Acuse": "<?xml version=\"1.0\"?><Acuse xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" Fecha=\"2026-10-29T21:24:29.6245224\" RfcEmisor=\"EKU9003173C9\" WorkProcessId=\"4f938b80-7e10-403f-b90e-41890aa9df94\" xmlns=\"http://www.sat.gob.mx/esquemas/retencionpago/1\"><Folios><UUID>7C82A8A8-5716-43F1-9E3D-4490488E657F</UUID><EstatusUUID>1205</EstatusUUID><Motivo>02</Motivo><Extemporaneo>true</Extemporaneo></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>EFu5dA+4Ynumopjdc/8E8oOqwuGOHyuuDO9CMVA3OySwZAdYftP2zs8nWbW1VnO+S4TQZaWjwqKNaInDj9wRvg==</DigestValue></Reference></SignedInfo><SignatureValue>CWQ2Dp4wu8ZrLRTvRoTgWUis4TRYbc34Ba+n1xiMzJMU8xgdw8KR4RIWzHdcv5JVAF0aoixxfrbGyhDidS+q9A==</SignatureValue><KeyInfo><KeyName>30001000000500002554</KeyName><KeyValue><RSAKeyValue><Modulus>hUcUOoGEtSDAlrF8KegQkGKY8aDAe9tNRkf48uj1+YirDP4cMEd8YEelQY1jLu1GINYKf9N9XxmOfHdL4FUr+cuOgrBviaGWcIsJfZ80IGpvox6kUSHoRt+h32yQayW0HuNOp0b3yiBp9Y6jTdYTFTAVzgzUjf4LfVt8n5FejVZ2xERIyROnGgbK8A4xBsPpFazHQkK2PCiYe+LYBm0Ux9UZYkYJ9Mu9rL5c51Sjgq8JJekorp0BzfKadRrSEFyD2Z6GwB0RswjLZQspojZGxUnqlbldvO6TjFUV4MT7EV8P7f2VTS0yr4qSwx0y080zoK10CbIoJXfsFROHypFj5w==</Modulus><Exponent>AQAB</Exponent></RSAKeyValue></KeyValue></KeyInfo></Signature></Acuse>"
}