Timbrado (Retenciones CFDI REST)

Servicio que realiza el timbrado de un comprobante CFDI de retenciones previamente sellado en formato XML, acepta complementos y es compatible con la versión vigente.
En ambiente de pruebas se permite el uso de CSD reales, aunque se recomienda utilizar los certificados de prueba.

URL´s

🛠️ Pruebas:

https://services.test.sw.com.mx 📄

🚀 Productivo:

https://services.sw.com.mx 📄

Timbrado Retenciones

🔗 Endpoint

Método	Ruta
POST	/retencion/stamp/v3

🔐 Autenticación y Headers

Header	Value
Authorization	Bearer Token
Content-Type	multipart/form-data

🧾 Parámetros FORM

Propiedad	Uso	Descripción
xml	Requerido	XML del comprobante a ser timbrado

Ejemplo de Request

curl --location 'http://services.test.sw.com.mx/retencion/stamp/v3' \
--header 'Authorization: bearer $token' \
--header 'Content-Type: multipart/form-data' \
--form 'xml=cfdi.xml'

Ejemplo de response

{
    "data": {
        "retencion": "<?xml version=\"1.0\" encoding=\"utf-8\"?><retenciones:Retenciones xmlns:retenciones=\"http://www.sat.gob.mx/esquemas/retencionpago/2\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:schemaLocation=\"http://www.sat.gob.mx/esquemas/retencionpago/2 http://www.sat.gob.mx/esquemas/retencionpago/2/retencionpagov2.xsd\" Version=\"2.0\" FolioInt=\"e0ff5458087c204afa08\" FechaExp=\"2025-07-17T12:59:01\" LugarExpRetenc=\"45110\" CveRetenc=\"01\" NoCertificado=\"30001000000500003416\" Certificado=\"MIIFsDCCA5igAwIBAgIUMzAwMDEwMDAwMDA1MDAwMDM0MTYwDQYJKoZIhvcNAQELBQAwggErMQ8wDQYDVQQDDAZBQyBVQVQxLjAsBgNVBAoMJVNFUlZJQ0lPIERFIEFETUlOSVNUUkFDSU9OIFRSSUJVVEFSSUExGjAYBgNVBAsMEVNBVC1JRVMgQXV0aG9yaXR5MSgwJgYJKoZIhvcNAQkBFhlvc2Nhci5tYXJ0aW5lekBzYXQuZ29iLm14MR0wGwYDVQQJDBQzcmEgY2VycmFkYSBkZSBjYWxpejEOMAwGA1UEEQwFMDYzNzAxCzAJBgNVBAYTAk1YMRkwFwYDVQQIDBBDSVVEQUQgREUgTUVYSUNPMREwDwYDVQQHDAhDT1lPQUNBTjERMA8GA1UELRMIMi41LjQuNDUxJTAjBgkqhkiG9w0BCQITFnJlc3BvbnNhYmxlOiBBQ0RNQS1TQVQwHhcNMjMwNTE4MTE0MzUxWhcNMjcwNTE4MTE0MzUxWjCB1zEnMCUGA1UEAxMeRVNDVUVMQSBLRU1QRVIgVVJHQVRFIFNBIERFIENWMScwJQYDVQQpEx5FU0NVRUxBIEtFTVBFUiBVUkdBVEUgU0EgREUgQ1YxJzAlBgNVBAoTHkVTQ1VFTEEgS0VNUEVSIFVSR0FURSBTQSBERSBDVjElMCMGA1UELRMcRUtVOTAwMzE3M0M5IC8gVkFEQTgwMDkyN0RKMzEeMBwGA1UEBRMVIC8gVkFEQTgwMDkyN0hTUlNSTDA1MRMwEQYDVQQLEwpTdWN1cnNhbCAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtmecO6n2GS0zL025gbHGQVxznPDICoXzR2uUngz4DqxVUC/w9cE6FxSiXm2ap8Gcjg7wmcZfm85EBaxCx/0J2u5CqnhzIoGCdhBPuhWQnIh5TLgj/X6uNquwZkKChbNe9aeFirU/JbyN7Egia9oKH9KZUsodiM/pWAH00PCtoKJ9OBcSHMq8Rqa3KKoBcfkg1ZrgueffwRLws9yOcRWLb02sDOPzGIm/jEFicVYt2Hw1qdRE5xmTZ7AGG0UHs+unkGjpCVeJ+BEBn0JPLWVvDKHZAQMj6s5Bku35+d/MyATkpOPsGT/VTnsouxekDfikJD1f7A1ZpJbqDpkJnss3vQIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQsFAAOCAgEAFaUgj5PqgvJigNMgtrdXZnbPfVBbukAbW4OGnUhNrA7SRAAfv2BSGk16PI0nBOr7qF2mItmBnjgEwk+DTv8Zr7w5qp7vleC6dIsZFNJoa6ZndrE/f7KO1CYruLXr5gwEkIyGfJ9NwyIagvHHMszzyHiSZIA850fWtbqtythpAliJ2jF35M5pNS+YTkRB+T6L/c6m00ymN3q9lT1rB03YywxrLreRSFZOSrbwWfg34EJbHfbFXpCSVYdJRfiVdvHnewN0r5fUlPtR9stQHyuqewzdkyb5jTTw02D2cUfL57vlPStBj7SEi3uOWvLrsiDnnCIxRMYJ2UA2ktDKHk+zWnsDmaeleSzonv2CHW42yXYPCvWi88oE1DJNYLNkIjua7MxAnkNZbScNw01A6zbLsZ3y8G6eEYnxSTRfwjd8EP4kdiHNJftm7Z4iRU7HOVh79/lRWB+gd171s3d/mI9kte3MRy6V8MMEMCAnMboGpaooYwgAmwclI2XZCczNWXfhaWe0ZS5PmytD/GDpXzkX0oEgY9K/uYo5V77NdZbGAjmyi8cE2B2ogvyaN2XfIInrZPgEffJ4AB7kFA2mwesdLOCh0BLD9itmCve3A1FGR4+stO2ANUoiI3w3Tv2yQSg4bjeDlJ08lXaaFCLW2peEXMXjQUk7fmpb5MNuOUTW6BE=\" Sello=\"SJbwa6Fr96k/pOQwnetSiJ88vbGgjYQYL2O9yTTASymGHnYdRZdYL3IZxMOCGj9a9Yb7GuoO2X6+/Jp8oXfmBKX4vKvetJ7MVlyCvxPx57dY52FkDbm6nRjiwO/lDElyIrj3e7ts4Hc7fwYaUafM4Ihc60tM7dZSNemoIpn6U0fDmtOGwgjqZlKIBQCL/CBfqdvnz7yHVOl5PMjIiVsxfvn5Rm4nSjkzrwB98OSo/7FUlfpHKcPdS2GIQuq4ckBxglDQVMj89cpEomkSO3hoKlK6v8sB36SGHT2NrWuY8jxri01SIAI5jY+Xf3eWLNPBYPYsW+OLjN4PDZQyKMoYag==\"><retenciones:Emisor RfcE=\"EKU9003173C9\" NomDenRazSocE=\"ESCUELA KEMPER URGATE\" RegimenFiscalE=\"601\" /><retenciones:Receptor NacionalidadR=\"Nacional\"><retenciones:Nacional RfcR=\"URE180429TM6\" NomDenRazSocR=\"UNIVERSIDAD ROBOTICA ESPAÑOLA\" DomicilioFiscalR=\"86991\" /></retenciones:Receptor><retenciones:Periodo MesIni=\"01\" MesFin=\"03\" Ejercicio=\"2023\" /><retenciones:Totales MontoTotOperacion=\"2000.00\" MontoTotGrav=\"2000.00\" MontoTotExent=\"0\" MontoTotRet=\"580.00\"><retenciones:ImpRetenidos BaseRet=\"2000\" ImpuestoRet=\"001\" MontoRet=\"580.00\" TipoPagoRet=\"03\" /></retenciones:Totales><retenciones:Complemento><tfd:TimbreFiscalDigital xsi:schemaLocation=\"http://www.sat.gob.mx/TimbreFiscalDigital http://www.sat.gob.mx/sitio_internet/cfd/TimbreFiscalDigital/TimbreFiscalDigitalv11.xsd\" Version=\"1.1\" UUID=\"92a4f888-e467-4646-a3bf-34a083ba7a32\" FechaTimbrado=\"2025-07-17T12:59:20\" RfcProvCertif=\"SPR190613I52\" SelloCFD=\"SJbwa6Fr96k/pOQwnetSiJ88vbGgjYQYL2O9yTTASymGHnYdRZdYL3IZxMOCGj9a9Yb7GuoO2X6+/Jp8oXfmBKX4vKvetJ7MVlyCvxPx57dY52FkDbm6nRjiwO/lDElyIrj3e7ts4Hc7fwYaUafM4Ihc60tM7dZSNemoIpn6U0fDmtOGwgjqZlKIBQCL/CBfqdvnz7yHVOl5PMjIiVsxfvn5Rm4nSjkzrwB98OSo/7FUlfpHKcPdS2GIQuq4ckBxglDQVMj89cpEomkSO3hoKlK6v8sB36SGHT2NrWuY8jxri01SIAI5jY+Xf3eWLNPBYPYsW+OLjN4PDZQyKMoYag==\" NoCertificadoSAT=\"30001000000500003456\" SelloSAT=\"TIYajKy/qBVafQvFEameYlNzu0g+0Ta72+vu0ey3ofkO4FQHB3AvKm+Uw/w82PBJUwx7R/S842MGReNru7qm5BPJMV+MFhjZvvaYXGV8dRjzxkgH5SSDETskDjsU4B951VBQ6M2yYCye0pyZdJK8X0wVDs1X1tqubxHWyPeRLWwZbTLxPEFh1aYLKCFtAgC+vZgYKdwtHtN2/SOJDX4VA7wvjyuJ0ubLdSu7uY+Ucfb9AwE7HvppwZXFmkfI/ksJVNLbtgMJyFp9hC9cE/8DxNrbeoxAajWC+LoEM9wRV/pn/Pfj/LYIRmucpzv35hRqo6detpX3VaYwdRl/yJd7kQ==\" xmlns:tfd=\"http://www.sat.gob.mx/TimbreFiscalDigital\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" /></retenciones:Complemento></retenciones:Retenciones>"
    },
    "status": "success"
}

{
    "message": "Reten20101 - El resultado de la digestión debe ser igual al resultado de la desencripción del sello.",
    "messageDetail": "El sello es incorrecto, la cadena original es: ||2.0|30001000000500003416|e0ff5458087c204afa08|2025-07-17T12:59:01|45110|01|EKU9003173C9|ESCUELA KEMPER URGAT|601|Nacional|URE180429TM6|UNIVERSIDAD ROBOTICA ESPAÑOLA|86991|01|03|2023|2000.00|2000.00|0|580.00|2000|001|580.00|03||",
    "data": null,
    "status": "error"
}

Atributo	Tipo	Descripción
message	String	Código regresado cuando existe un error.
messageDetail	String	Mensaje más descriptivo del error cuando existe uno.
data	object/null	Objeto de datos referente al timbrado cuando es exitoso.
status	String	“success” o “error”

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.

Updated on julio 25, 2025

Article Attachments

.zip

xmlRetencion 5 KB