1. Home
  2. Servicios
  3. Timbrado de Retenciones
  4. Cancelación (Retenciones CFDI – REST)
  1. Home
  2. Servicios
  3. Cancelaciones
  4. Cancelación (Retenciones CFDI – REST)
Searching...

Cancelación (Retenciones CFDI – REST)

Servicio que permite cancelar facturas de retenciones e información de pagos con sus complementos a través de un Web Service de tipo REST. Esto se realiza enviando un archivo XML o utilizando Certificados de Sellos Digitales (CSD).

URL´s

🛠️ Pruebas:
https://services.test.sw.com.mx 📄
🚀 Productivo:
https://services.sw.com.mx 📄

CancelaUno()

Servicio para cancelar enviando un XML con la información y folios de las facturas a cancelar. 

🔗 Endpoint

MétodoRuta
POST/retencion/cancel/xml

🔐 Autenticación y Headers

HeaderValue
AuthorizationBearer Token
Content-Typemultipart/form-data

🧾Parámetros Form

PropiedadUsoDescripción
xmlRequeridoXML estructurado conforme al estándar anexo 20 (pág. 110, en el portal oficial del SAT), con la información de los comprobantes a cancelar

Ejemplo Request

curl --location 'https://services.test.sw.com.mx/retencion/cancel/xml' \
--header 'Content-Type: multipart/form-data; boundary="----=_Part_11_11939969.1490230712432"' \
--header 'Authorization: Bearer T2lYQ0t4L0RHVkR4dHZ....' \
--data-raw '
------=_Part_11_11939969.1490230712432
Content-Type: text/xml
Content-Transfer-Encoding: binary
Content-Disposition: form-data; name=xml; filename=xml

<?xml version="1.0" encoding="utf-8" ?><Cancelacion xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Fecha="2025-08-12T05:35:05" RfcEmisor="EKU9003173C9" xmlns="http://www.sat.gob.mx/esquemas/retencionpago/1"><Folios><Folio UUID="3044cc3f-572f-4535-85e2-374c205f5b11" Motivo="02" FolioSustitucion=""/></Folios><Signature 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/2000/09/xmldsig#rsa-sha1"/><Reference URI=""><Transforms><Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/></Transforms><DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/><DigestValue>kLy96SjbSI/bQpAkaSnH5wAUZ1o=</DigestValue></Reference></SignedInfo><SignatureValue>M9aigTNqcPgFHgj16YxpsrJYg5kG6OBB7KybbOiWWNtpYSAVICUVc5tYqrwDQ6jUqVQhQ/RsbJeKv2H0CdH1mZKwAzlZHy9zjIviPMpckjTBBQdf/gHQmOxozRP3a9FsS/oFd9CbtIh6f+XAhDaVUeleRNaXsjwDz+9l5FTRTrP+clGDfEAYfc6imbpprAq6kd6jefBxzIMaHWjT0pO6LBGRVdhk6T244ZHi9xO2V1j4MQOZWz0Ra83enkfEpkA60lP1x4SBoRvwYPnlYcZ6y4lGPVrUbhk2B8mxrduNMW+1x+Lq+EDcb/3P7+/XA2Cy/QKGX3dIRsnOQpbe+N19GQ==</SignatureValue><KeyInfo><X509Data><X509Certificate>MIIFsDCCA5igAwIBAgIUMzAwMDEwMDAwMDA1MDAwMDM0MTYwDQYJKoZIhvcNAQELBQAwggErMQ8wDQYDVQQDDAZBQyBVQVQxLjAsBgNVBAoMJVNFUlZJQ0lPIERFIEFETUlOSVNUUkFDSU9OIFRSSUJVVEFSSUExGjAYBgNVBAsMEVNBVC1JRVMgQXV0aG9yaXR5MSgwJgYJKoZIhvcNAQkBFhlvc2Nhci5tYXJ0aW5lekBzYXQuZ29iLm14MR0wGwYDVQQJDBQzcmEgY2VycmFkYSBkZSBjYWxpejEOMAwGA1UEEQwFMDYzNzAxCzAJBgNVBAYTAk1YMRkwFwYDVQQIDBBDSVVEQUQgREUgTUVYSUNPMREwDwYDVQQHDAhDT1lPQUNBTjERMA8GA1UELRMIMi41LjQuNDUxJTAjBgkqhkiG9w0BCQITFnJlc3BvbnNhYmxlOiBBQ0RNQS1TQVQwHhcNMjMwNTE4MTE0MzUxWhcNMjcwNTE4MTE0MzUxWjCB1zEnMCUGA1UEAxMeRVNDVUVMQSBLRU1QRVIgVVJHQVRFIFNBIERFIENWMScwJQYDVQQpEx5FU0NVRUxBIEtFTVBFUiBVUkdBVEUgU0EgREUgQ1YxJzAlBgNVBAoTHkVTQ1VFTEEgS0VNUEVSIFVSR0FURSBTQSBERSBDVjElMCMGA1UELRMcRUtVOTAwMzE3M0M5IC8gVkFEQTgwMDkyN0RKMzEeMBwGA1UEBRMVIC8gVkFEQTgwMDkyN0hTUlNSTDA1MRMwEQYDVQQLEwpTdWN1cnNhbCAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtmecO6n2GS0zL025gbHGQVxznPDICoXzR2uUngz4DqxVUC/w9cE6FxSiXm2ap8Gcjg7wmcZfm85EBaxCx/0J2u5CqnhzIoGCdhBPuhWQnIh5TLgj/X6uNquwZkKChbNe9aeFirU/JbyN7Egia9oKH9KZUsodiM/pWAH00PCtoKJ9OBcSHMq8Rqa3KKoBcfkg1ZrgueffwRLws9yOcRWLb02sDOPzGIm/jEFicVYt2Hw1qdRE5xmTZ7AGG0UHs+unkGjpCVeJ+BEBn0JPLWVvDKHZAQMj6s5Bku35+d/MyATkpOPsGT/VTnsouxekDfikJD1f7A1ZpJbqDpkJnss3vQIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQsFAAOCAgEAFaUgj5PqgvJigNMgtrdXZnbPfVBbukAbW4OGnUhNrA7SRAAfv2BSGk16PI0nBOr7qF2mItmBnjgEwk+DTv8Zr7w5qp7vleC6dIsZFNJoa6ZndrE/f7KO1CYruLXr5gwEkIyGfJ9NwyIagvHHMszzyHiSZIA850fWtbqtythpAliJ2jF35M5pNS+YTkRB+T6L/c6m00ymN3q9lT1rB03YywxrLreRSFZOSrbwWfg34EJbHfbFXpCSVYdJRfiVdvHnewN0r5fUlPtR9stQHyuqewzdkyb5jTTw02D2cUfL57vlPStBj7SEi3uOWvLrsiDnnCIxRMYJ2UA2ktDKHk+zWnsDmaeleSzonv2CHW42yXYPCvWi88oE1DJNYLNkIjua7MxAnkNZbScNw01A6zbLsZ3y8G6eEYnxSTRfwjd8EP4kdiHNJftm7Z4iRU7HOVh79/lRWB+gd171s3d/mI9kte3MRy6V8MMEMCAnMboGpaooYwgAmwclI2XZCczNWXfhaWe0ZS5PmytD/GDpXzkX0oEgY9K/uYo5V77NdZbGAjmyi8cE2B2ogvyaN2XfIInrZPgEffJ4AB7kFA2mwesdLOCh0BLD9itmCve3A1FGR4+stO2ANUoiI3w3Tv2yQSg4bjeDlJ08lXaaFCLW2peEXMXjQUk7fmpb5MNuOUTW6BE=</X509Certificate><X509IssuerSerial><X509IssuerName>CN=AC UAT, O=SERVICIO DE ADMINISTRACION TRIBUTARIA, OU=SAT-IES Authority, E=oscar.martinez@sat.gob.mx, STREET=3ra cerrada de caliz, PostalCode=06370, C=MX, ST=CIUDAD DE MEXICO, L=COYOACAN, OID.2.5.4.45=2.5.4.45, OID.1.2.840.113549.1.9.2=responsable: ACDMA-SAT</X509IssuerName><X509SerialNumber>3330303031303030303030353030303033343136</X509SerialNumber></X509IssuerSerial></X509Data></KeyInfo></Signature></Cancelacion>

------=_Part_11_11939969.1490230712432--'

Ejemplo Response

{
    "data": {
        "acuse": "<?xml version=\"1.0\"?><Acuse xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" Fecha=\"2025-08-14T11:33:52.0153648\" RfcEmisor=\"EKU9003173C9\" WorkProcessId=\"4d3162b9-102e-423f-a0c2-86a440fc462a\" xmlns=\"http://www.sat.gob.mx/esquemas/retencionpago/1\"><Folios><UUID>3044CC3F-572F-4535-85E2-374C205F5B11</UUID><EstatusUUID>1202</EstatusUUID><Motivo>02</Motivo><Extemporaneo>false</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>Ky5b3ESjfWTfYXJXTdaNNPpkN6aDdrXDj37lp7+4lqj0lZfODDXCDf9F/rkolszkszKdPMUGHHrdj/mfsi2DjA==</DigestValue></Reference></SignedInfo><SignatureValue>3gojaldMWMHCMygaM0gGd2vVRakASqwmrafr/GiGEOvWePPH65z80oT33MbfuUr7LbCjr+E25UiT0jt6mggTxA==</SignatureValue><KeyInfo><KeyName>30001000000500002554</KeyName><KeyValue><RSAKeyValue><Modulus>hUcUOoGEtSDAlrF8KegQkGKY8aDAe9tNRkf48uj1+YirDP4cMEd8YEelQY1jLu1GINYKf9N9XxmOfHdL4FUr+cuOgrBviaGWcIsJfZ80IGpvox6kUSHoRt+h32yQayW0HuNOp0b3yiBp9Y6jTdYTFTAVzgzUjf4LfVt8n5FejVZ2xERIyROnGgbK8A4xBsPpFazHQkK2PCiYe+LYBm0Ux9UZYkYJ9Mu9rL5c51Sjgq8JJekorp0BzfKadRrSEFyD2Z6GwB0RswjLZQspojZGxUnqlbldvO6TjFUV4MT7EV8P7f2VTS0yr4qSwx0y080zoK10CbIoJXfsFROHypFj5w==</Modulus><Exponent>AQAB</Exponent></RSAKeyValue></KeyValue></KeyInfo></Signature></Acuse>",
        "uuid": {
            "3044CC3F-572F-4535-85E2-374C205F5B11": "1202"
        }
    },
    "status": "success"
}
{
    "message": "CACFDI33 - Problemas con el xml.",
    "messageDetail": "CR1309 - Firma mal formada o inválida",
    "data": null,
    "status": "error"
}
AtributoTipoDescripción
messageStringCódigo regresado cuando existe un error.
messageDetailStringMensaje más descriptivo del error cuando existe uno
dataobject/nullContiene información del acuse de cancelación emitido por el SAT, incluyendo el XML del acuse y el estatus del UUID.
statusString“success” o “error”
Probar en Postman

CancelaUnoCSD()

Método utilizado para la cancelación de un único UUID utilizando el certificado y llave privada del emisor.

🔗 Endpoint

MétodoRuta
POST/retencion/cancel/csd

🔐 Autenticación y Headers

HeaderValue
AuthorizationBearer Token
Content-Typeapplication/json

🧾Parámetros JSON

PropiedadUsoDescripción
uuidRequeridoUUID del comprobante
rfcRequeridoRFC del emisor
motivoRequeridoClave para expresar el motivo de la cancelación
folioSustitucionOpcionalUUID del comprobante que sustituye
b64CerRequeridoArchivo Cer en Base64
b64KeyRequeridoArchivo Key en Base64
passwordRequeridoContraseña del certificado

Ejemplo Request

curl --location 'https://services.test.sw.com.mx/retencion/cancel/csd' \
--header 'Authorization: Bearer T2lYQ0...' \
--header 'Content-Type: application/json' \
--data '{
  "uuid": "1fae5735-ca51-4be4-9180-827c44fdb227",
  "password": "12345678a",
  "rfc": "EKU9003173C9",
  "motivo": "02",
  "b64Cer": "MIIFsDCCA5igAwIBAgIUMzAwMDEwMDAwMDA1MDAwMDM0MTYwDQYJKoZIhvcNAQELBQAwggErMQ8wDQYDVQQDDAZBQyBVQVQxLjAsBgNVBAoMJVNFUlZJQ0lPIERFIEFETUlOSVNUUkFDSU9OIFRSSUJVVEFSSUExGjAYBgNVBAsMEVNBVC1JRVMgQXV0aG9yaXR5MSgwJgYJKoZIhvcNAQkBFhlvc2Nhci5tYXJ0aW5lekBzYXQuZ29iLm14MR0wGwYDVQQJDBQzcmEgY2VycmFkYSBkZSBjYWxpejEOMAwGA1UEEQwFMDYzNzAxCzAJBgNVBAYTAk1YMRkwFwYDVQQIDBBDSVVEQUQgREUgTUVYSUNPMREwDwYDVQQHDAhDT1lPQUNBTjERMA8GA1UELRMIMi41LjQuNDUxJTAjBgkqhkiG9w0BCQITFnJlc3BvbnNhYmxlOiBBQ0RNQS1TQVQwHhcNMjMwNTE4MTE0MzUxWhcNMjcwNTE4MTE0MzUxWjCB1zEnMCUGA1UEAxMeRVNDVUVMQSBLRU1QRVIgVVJHQVRFIFNBIERFIENWMScwJQYDVQQpEx5FU0NVRUxBIEtFTVBFUiBVUkdBVEUgU0EgREUgQ1YxJzAlBgNVBAoTHkVTQ1VFTEEgS0VNUEVSIFVSR0FURSBTQSBERSBDVjElMCMGA1UELRMcRUtVOTAwMzE3M0M5IC8gVkFEQTgwMDkyN0RKMzEeMBwGA1UEBRMVIC8gVkFEQTgwMDkyN0hTUlNSTDA1MRMwEQYDVQQLEwpTdWN1cnNhbCAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtmecO6n2GS0zL025gbHGQVxznPDICoXzR2uUngz4DqxVUC/w9cE6FxSiXm2ap8Gcjg7wmcZfm85EBaxCx/0J2u5CqnhzIoGCdhBPuhWQnIh5TLgj/X6uNquwZkKChbNe9aeFirU/JbyN7Egia9oKH9KZUsodiM/pWAH00PCtoKJ9OBcSHMq8Rqa3KKoBcfkg1ZrgueffwRLws9yOcRWLb02sDOPzGIm/jEFicVYt2Hw1qdRE5xmTZ7AGG0UHs+unkGjpCVeJ+BEBn0JPLWVvDKHZAQMj6s5Bku35+d/MyATkpOPsGT/VTnsouxekDfikJD1f7A1ZpJbqDpkJnss3vQIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQsFAAOCAgEAFaUgj5PqgvJigNMgtrdXZnbPfVBbukAbW4OGnUhNrA7SRAAfv2BSGk16PI0nBOr7qF2mItmBnjgEwk+DTv8Zr7w5qp7vleC6dIsZFNJoa6ZndrE/f7KO1CYruLXr5gwEkIyGfJ9NwyIagvHHMszzyHiSZIA850fWtbqtythpAliJ2jF35M5pNS+YTkRB+T6L/c6m00ymN3q9lT1rB03YywxrLreRSFZOSrbwWfg34EJbHfbFXpCSVYdJRfiVdvHnewN0r5fUlPtR9stQHyuqewzdkyb5jTTw02D2cUfL57vlPStBj7SEi3uOWvLrsiDnnCIxRMYJ2UA2ktDKHk+zWnsDmaeleSzonv2CHW42yXYPCvWi88oE1DJNYLNkIjua7MxAnkNZbScNw01A6zbLsZ3y8G6eEYnxSTRfwjd8EP4kdiHNJftm7Z4iRU7HOVh79/lRWB+gd171s3d/mI9kte3MRy6V8MMEMCAnMboGpaooYwgAmwclI2XZCczNWXfhaWe0ZS5PmytD/GDpXzkX0oEgY9K/uYo5V77NdZbGAjmyi8cE2B2ogvyaN2XfIInrZPgEffJ4AB7kFA2mwesdLOCh0BLD9itmCve3A1FGR4+stO2ANUoiI3w3Tv2yQSg4bjeDlJ08lXaaFCLW2peEXMXjQUk7fmpb5MNuOUTW6BE=",
  "b64Key": "MIIFDjBABgkqhkiG9w0BBQ0wMzAbBgkqhkiG9w0BBQwwDgQIAgEAAoIBAQACAggAMBQGCCqGSIb3DQMHBAgwggS/AgEAMASCBMh4EHl7aNSCaMDA1VlRoXCZ5UUmqErAbucoZQObOaLUEm+I+QZ7Y8Giupo+F1XWkLvAsdk/uZlJcTfKLJyJbJwsQYbSpLOCLataZ4O5MVnnmMbfG//NKJn9kSMvJQZhSwAwoGLYDm1ESGezrvZabgFJnoQv8Si1nAhVGTk9FkFBesxRzq07dmZYwFCnFSX4xt2fDHs1PMpQbeq83aL/PzLCce3kxbYSB5kQlzGtUYayiYXcu0cVRu228VwBLCD+2wTDDoCmRXtPesgrLKUR4WWWb5N2AqAU1mNDC+UEYsENAerOFXWnmwrcTAu5qyZ7GsBMTpipW4Dbou2yqQ0lpA/aB06n1kz1aL6mNqGPaJ+OqoFuc8Ugdhadd+MmjHfFzoI20SZ3b2geCsUMNCsAd6oXMsZdWm8lzjqCGWHFeol0ik/xHMQvuQkkeCsQ28PBxdnUgf7ZGer+TN+2ZLd2kvTBOk6pIVgy5yC6cZ+o1Tloql9hYGa6rT3xcMbXlW+9e5jM2MWXZliVW3ZhaPjptJFDbIfWxJPjz4QvKyJk0zok4muv13Iiwj2bCyefUTRz6psqI4cGaYm9JpscKO2RCJN8UluYGbbWmYQU+Int6LtZj/lv8p6xnVjWxYI+rBPdtkpfFYRp+MJiXjgPw5B6UGuoruv7+vHjOLHOotRo+RdjZt7NqL9dAJnl1Qb2jfW6+d7NYQSI/bAwxO0sk4taQIT6Gsu/8kfZOPC2xk9rphGqCSS/4q3Os0MMjA1bcJLyoWLp13pqhK6bmiiHw0BBXH4fbEp4xjSbpPx4tHXzbdn8oDsHKZkWh3pPC2J/nVl0k/yF1KDVowVtMDXE47k6TGVcBoqe8PDXCG9+vjRpzIidqNo5qebaUZu6riWMWzldz8x3Z/jLWXuDiM7/Yscn0Z2GIlfoeyz+GwP2eTdOw9EUedHjEQuJY32bq8LICimJ4Ht+zMJKUyhwVQyAER8byzQBwTYmYP5U0wdsyIFitphw+/IH8+v08Ia1iBLPQAeAvRfTTIFLCs8foyUrj5Zv2B/wTYIZy6ioUM+qADeXyo45uBLLqkN90Rf6kiTqDld78NxwsfyR5MxtJLVDFkmf2IMMJHTqSfhbi+7QJaC11OOUJTD0v9wo0X/oO5GvZhe0ZaGHnm9zqTopALuFEAxcaQlc4R81wjC4wrIrqWnbcl2dxiBtD73KW+wcC9ymsLf4I8BEmiN25lx/OUc1IHNyXZJYSFkEfaxCEZWKcnbiyf5sqFSSlEqZLc4lUPJFAoP6s1FHVcyO0odWqdadhRZLZC9RCzQgPlMRtji/OXy5phh7diOBZv5UYp5nb+MZ2NAB/eFXm2JLguxjvEstuvTDmZDUb6Uqv++RdhO5gvKf/AcwU38ifaHQ9uvRuDocYwVxZS2nr9rOwZ8nAh+P2o4e0tEXjxFKQGhxXYkn75H3hhfnFYjik/2qunHBBZfcdG148MaNP6DjX33M238T9Zw/GyGx00JMogr2pdP4JAErv9a5yt4YR41KGf8guSOUbOXVARw6+ybh7+meb7w4BeTlj3aZkv8tVGdfIt3lrwVnlbzhLjeQY6PplKp3/a5Kr5yM0T4wJoKQQ6v3vSNmrhpbuAtKxpMILe8CQoo="
}'

Ejemplo Response

{
    "data": {
        "acuse": "<?xml version=\"1.0\"?><Acuse xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" Fecha=\"2025-08-14T10:47:02.7666676\" RfcEmisor=\"EKU9003173C9\" WorkProcessId=\"eff53f64-6807-4b21-bf18-a84709941c3a\" xmlns=\"http://www.sat.gob.mx/esquemas/retencionpago/1\"><Folios><UUID>1fae5735-ca51-4be4-9180-827c44fdb227</UUID><EstatusUUID>1202</EstatusUUID><Motivo>02</Motivo><Extemporaneo>false</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>Abdk2w4HjDfvbHxb02i0+ugoibtzKC+dfl/EprymZmuE2QT/pVFBe88PX5UQLrxYICMNdwBaFtl2jDjK9lZYAQ==</DigestValue></Reference></SignedInfo><SignatureValue>NiAJqjTq5McWeJtgXGHJEZp9dltASEN69mkSgS1nZJeAPtiq1Fua1mtNkzUaIE8jzMBwcLeKxlNBGogRtgZKug==</SignatureValue><KeyInfo><KeyName>30001000000500002554</KeyName><KeyValue><RSAKeyValue><Modulus>hUcUOoGEtSDAlrF8KegQkGKY8aDAe9tNRkf48uj1+YirDP4cMEd8YEelQY1jLu1GINYKf9N9XxmOfHdL4FUr+cuOgrBviaGWcIsJfZ80IGpvox6kUSHoRt+h32yQayW0HuNOp0b3yiBp9Y6jTdYTFTAVzgzUjf4LfVt8n5FejVZ2xERIyROnGgbK8A4xBsPpFazHQkK2PCiYe+LYBm0Ux9UZYkYJ9Mu9rL5c51Sjgq8JJekorp0BzfKadRrSEFyD2Z6GwB0RswjLZQspojZGxUnqlbldvO6TjFUV4MT7EV8P7f2VTS0yr4qSwx0y080zoK10CbIoJXfsFROHypFj5w==</Modulus><Exponent>AQAB</Exponent></RSAKeyValue></KeyValue></KeyInfo></Signature></Acuse>",
        "uuid": {
            "1fae5735-ca51-4be4-9180-827c44fdb227": "1202"
        }
    },
    "status": "success"
}
{
    "message": "CACFDI33 - Problemas con el xml.",
    "messageDetail": "CR1308 - Certificado revocado o caduco",
    "data": null,
    "status": "error"
}
AtributoTipoDescripción
messageStringCódigo regresado cuando existe un error.
messageDetailStringMensaje más descriptivo del error cuando existe uno.
dataobject/nullContiene información del acuse de cancelación emitido por el SAT, incluyendo el XML del acuse y el estatus del UUID.
statusString“success” o “error”
Probar en Postman

CancelaUnoPFX()

Método utilizado para la cancelación de un único UUID utilizando el archivo .PFX del emisor.

💡Visita nuestra herramienta: Generador de Certificado PFX

🔗 Endpoint

MétodoRuta
POST/retencion/cancel/pfx

🔐 Autenticación y Headers

HeaderValue
AuthorizationBearer Token
Content-Typeapplication/json

🧾Parámetros JSON

PropiedadUsoDescripción
uuidRequeridoUUID del comprobante
rfcRequeridoRFC del emisor
motivoRequeridoClave para expresar el motivo de la cancelación
folioSustitucionOpcionalUUID del comprobante que sustituye
b64PfxRequeridoArchivo PFX en Base64
passwordRequeridoContraseña del certificado

Ejemplo Request

curl --request POST \
  --url https://services.test.sw.com.mx/retencion/cancel/pfx \
  --header 'Authorization: Bearer $token' \
  --header 'Content-Type: application/json' \
  --data '{
  "uuid":"578052ce-710f-4d0b-9ffc-6ca73daf92a5",
  "password": "12345678a",
  "rfc": "EKU9003173C9",
  "motivo": "01",
  "folioSustitucion":"fe4e71b0-8959-4fb9-8091-f5ac4fb0fef8"
  "b64Pfx": "$Pfx"
}'

Ejemplo Response

{
    "data": {
        "acuse": "<?xml version=\"1.0\"?><Acuse xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" Fecha=\"2025-08-14T10:47:02.7666676\" RfcEmisor=\"EKU9003173C9\" WorkProcessId=\"eff53f64-6807-4b21-bf18-a84709941c3a\" xmlns=\"http://www.sat.gob.mx/esquemas/retencionpago/1\"><Folios><UUID>578052CE-710F-4D0B-9FFC-6CA73DAF92A5</UUID><EstatusUUID>1202</EstatusUUID><Motivo>02</Motivo><Extemporaneo>false</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>Abdk2w4HjDfvbHxb02i0+ugoibtzKC+dfl/EprymZmuE2QT/pVFBe88PX5UQLrxYICMNdwBaFtl2jDjK9lZYAQ==</DigestValue></Reference></SignedInfo><SignatureValue>NiAJqjTq5McWeJtgXGHJEZp9dltASEN69mkSgS1nZJeAPtiq1Fua1mtNkzUaIE8jzMBwcLeKxlNBGogRtgZKug==</SignatureValue><KeyInfo><KeyName>30001000000500002554</KeyName><KeyValue><RSAKeyValue><Modulus>hUcUOoGEtSDAlrF8KegQkGKY8aDAe9tNRkf48uj1+YirDP4cMEd8YEelQY1jLu1GINYKf9N9XxmOfHdL4FUr+cuOgrBviaGWcIsJfZ80IGpvox6kUSHoRt+h32yQayW0HuNOp0b3yiBp9Y6jTdYTFTAVzgzUjf4LfVt8n5FejVZ2xERIyROnGgbK8A4xBsPpFazHQkK2PCiYe+LYBm0Ux9UZYkYJ9Mu9rL5c51Sjgq8JJekorp0BzfKadRrSEFyD2Z6GwB0RswjLZQspojZGxUnqlbldvO6TjFUV4MT7EV8P7f2VTS0yr4qSwx0y080zoK10CbIoJXfsFROHypFj5w==</Modulus><Exponent>AQAB</Exponent></RSAKeyValue></KeyValue></KeyInfo></Signature></Acuse>",
        "uuid": {
            "578052CE-710F-4D0B-9FFC-6CA73DAF92A5": "1202"
        }
    },
    "status": "success"
}
{
    "message": "CACFDI33 - Problemas con el xml.",
    "messageDetail": "CR1308 - Certificado revocado o caduco",
    "data": null,
    "status": "error"
}
AtributoTipoDescripción
messageStringCódigo regresado cuando existe un error.
messageDetailStringMensaje más descriptivo del error cuando existe uno.
dataobject/nullContiene información del acuse de cancelación emitido por el SAT, incluyendo el XML del acuse y el estatus del UUID.
statusString“success” o “error”
Probar en Postman

CancelacionMasiva()

Método utilizado para la cancelación de múltiples UUIDs utilizando un XML de cancelación previamente firmado.

💡Nota Importante: Para lograr un mejor rendimiento, es recomendable enviar un archivo XML con un máximo de 500 UUID de CFDI para su cancelación.

🔗 Endpoint

MétodoRuta

🔐 Autenticación y Headers

HeaderValue

Parámetros

PropiedadUsoDescripción
💡Nota Importante: Si desconoces la estructura del XML de cancelación, mira el siguiente video: ¿Cómo crear XML de Cancelación para CFDI y Retenciones?. También puede ser útil: Herramienta para Firmar XML

Ejemplo Request






Ejemplo Response






  

    
    
    
  

  





























AtributoTipoDescripción














Probar en Postman












ConsultaAcuseCancelacion()





Método para consultar el estado de UUIDs cancelados previamente, especialmente útil para verificar facturas canceladas a través de nuestro servicio de cancelación masiva.






    

       💡Nota Importante:  El tiempo de disponibilidad de los acuses de cancelación devueltos por este servicio varía en proporción a la cantidad de UUID enviados para su cancelación.
    







🔗 Endpoint





MétodoRuta





🔐 Autenticación y Headers





HeaderValue





Parámetros





PropiedadUsoDescripción





Ejemplo Request










Ejemplo Response






  

    
    
    
  

  





























AtributoTipoDescripción














Probar en Postman












En SW® somos mejores para TI, es por ello que tu opinión es muy importante, por favor ayúdanos calificando este articulo y dejando tus comentarios. 


      
          
        How useful was this post?      
              
        Click on a star to rate it!      
        
      
                      
  •                       
    •                   
  •                       
    •                   
  •                       
    •                   
  •                       
    •                   
  •                       
    •               
    
    
        
          
    
          
    
  
                
  
    We are sorry that this post was not useful for you!  
  
    Let us improve this post!  
    
    
      Tell us how we can improve this post?    
            
      
    
    
  
  
    

				
			


							

					Updated on agosto 20, 2025				

			
			


			


    Tagged: 

			
			
							

     
    

        
Related Articles