Qué hace: certifica un comprobante de retenciones conforme al Anexo 20 vigente. Le envías el XML del CFDI de Retenciones e Información de Pagos que construyó tu sistema, MYSuite lo sella, lo timbra y te devuelve el comprobante certificado en Base64.
Cuándo se usa: cuando tu empresa debe emitir constancias de retenciones e información de pagos, por ejemplo por pagos a residentes en el extranjero, dividendos, intereses, arrendamiento en fideicomiso o enajenación de acciones.
Cuándo no usarla: para comprobantes de ingreso, egreso, traslado, nómina o pago, que son CFDI ordinarios y se emiten con CONVERT_NATIVE_XML. Tampoco devuelve la representación gráfica: para el PDF de una retención se usa GET_DOCUMENT_RETENCIONES.


| Si tu integración… | Tu artículo es... |
|---|---|
| Emite constancias de retenciones e información de pagos, por SOAP | Este artículo |
| Emite CFDI de ingreso, egreso, traslado, nómina o pago | CONVERT_NATIVE_XML — CFDI + Timbrado (SOAP) |
| Necesita el PDF de una retención ya certificada | GET_DOCUMENT_RETENCIONES |
| Necesita el XML o el PDF de un CFDI ordinario almacenado | RETRIEVE_DOCUMENT — CFDI + Timbrado (SOAP) |
| Necesita validar un comprobante que recibiste | VALIDATE_DOCUMENT · RECEIVE |
Requestor y Entity.Sello="0", NoCertificado="00000000000000000000" y Certificado="0".retenciones:Addenda si quieres que la plataforma distribuya por correo el XML y el PDF. Es opcional.Transaction con valor FIRMAR_RETENCION, la cadena Base64 en Data1, el valor XML en Data2 y Data3 vacío.Data2 no dice XML, no vas a recibir el comprobante certificado.RequestTransactionResponse.Result.Result = true te permite continuar; Result = false te lleva a Solución de problemas.ResponseData1 desde Base64.Identifier, así que estos datos solo están dentro del comprobante.Si algo falla, ve a Solución de problemas.
| Protocolo | SOAP 1.1 / 1.2 sobre HTTPS |
|---|---|
| Servicio | FactWSFront |
| Operación | RequestTransaction |
| Namespace | http://www.fact.com.mx/schema/ws |
| SOAPAction | http://www.fact.com.mx/schema/ws/RequestTransaction |
Valor <Transaction> |
FIRMAR_RETENCION |
| Naturaleza | Emisión. Sella y certifica un comprobante fiscal de retención con efectos ante el SAT 1 |
| Consumo | 1 folio del paquete vigente |
| Ambiente | URL |
|---|---|
| Pruebas | https://www.mysuitetest.com/mx.com.fact.wsfront/FactWSFront.asmx |
| Producción | https://www.mysuitecfdi.com/mx.com.fact.wsfront/FactWSFront.asmx |
JES900109Q90 como RFC emisor (Entity). Esta modalidad no usa token: las credenciales viajan en cada petición.
| Campo | Tipo | Obligatorio | Formato | Descripción |
|---|---|---|---|---|
Requestor |
GUID | Sí | GUID | Dato que proporciona MYSuite, ligado a la seguridad de la transacción, autenticación y autorización |
Country |
string | Sí | Valor fijo MX |
Código de país de la operación |
Entity |
string | Sí | RFC (12–13 caracteres) | RFC del emisor de la retención. Determina con qué CSD se sella el comprobante. En pruebas debe ser JES900109Q90 |
User |
GUID | Sí | GUID | Identificador del usuario de la integración, colocar valor del Requestor proporcionado por MYSuite |
UserName |
string | Sí | País.RFC.usuario |
Nombre de usuario. Ejemplo MX.JES900109Q90.jan |
| Nombre | Tipo | Obligatorio | Límite | Formato | Descripción |
|---|---|---|---|---|---|
Data1 |
string | Sí | 1 MB | Base64 | XML del CFDI de Retenciones conforme al Anexo 20, con los atributos de Sello, NoCertificado y Certifiicado con valores como se ha indicado. Ver apartado 5 |
Data2 |
string | Sí | — | XML | Debe especificarse XML para que la respuesta traiga el comprobante certificado en Base64. |
Data3 |
string | No | — | Vacío | Sin uso en esta transacción. El nodo debe existir y enviarse vacío |
El comprobante se construye conforme al esquema que publica el SAT. A diferencia de las transacciones de emisión de CFDI ordinarios, aquí no interviene el XML Nativo de MYSuite: tu sistema entrega el comprobante fiscal ya armado y MYSuite solo lo sella y lo certifica.
| Esquema y documentación | CFDI de Retenciones — SAT |
|---|---|
| Anexo 20 | Anexo 20 — SAT |
| Versión del comprobante | 2.0 |
| Codificación de transporte | Base64, en una sola línea |
|
|
| Atributo | Valor que debes enviar | Valor que devuelve MYSuite |
|---|---|---|
Sello |
0 |
Sello digital del contribuyente emisor |
NoCertificado |
00000000000000000000 (20 ceros) |
Número de certificado del CSD del emisor |
Certificado |
0 |
Certificado del emisor |
En la estructura del CFDI de Retenciones puedes agregar los complementos fiscales que publica la autoridad, según el tipo de retención que ampares. El listado vigente está en Complementos de factura — SAT.
Si quieres que MYSuite envíe por correo el XML y el PDF del CFDI de Retención, incluye el elemento ams:AddendaMysuite dentro del elemento retenciones:Addenda del comprobante. Esquema: addenda-mysuite.xsd
<retenciones:Addenda>
<ams:AddendaMysuite
xsi:schemaLocation="mx.com.fact.addenda.mysuite http://www.mysuitemex.com/fact/schema/addenda-mysuite.xsd"
xmlns:ams="mx.com.fact.addenda.mysuite"
Version="1">
<ams:Procesamiento>
<ams:Dictionary name="email">
<ams:Entry k="from" v="ACCOUNT_OWNER"/>
<ams:Entry k="to" v="destinatario@dominio.com"/>
<ams:Entry k="formats" v="xml pdf"/>
</ams:Dictionary>
</ams:Procesamiento>
</ams:AddendaMysuite>
</retenciones:Addenda>Entrada (k) |
Obligatorio | Formato | Descripción |
|---|---|---|---|
from |
Sí | ACCOUNT_OWNER u otro valor |
Remitente del correo. ACCOUNT_OWNER usa la cuenta configurada en MYSuite |
to |
Sí | Direcciones de correo | Destinatarios del envío, por cada cuenta, separar con punto y coma (;) |
formats |
Sí | xml · pdf · xml pdf |
Archivos que se adjuntan al correo |
Data2 lleva el valor XML.
Data3 se envía vacío.<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.fact.com.mx/schema/ws">
<soapenv:Header/>
<soapenv:Body>
<ws:RequestTransaction>
<ws:Requestor>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</ws:Requestor>
<ws:Transaction>FIRMAR_RETENCION</ws:Transaction>
<ws:Country>MX</ws:Country>
<ws:Entity>JES900109Q90</ws:Entity>
<ws:User>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</ws:User>
<ws:UserName>MX.JES900109Q90.jan</ws:UserName>
<ws:Data1>PHJldGVuY2lvbmVzOlJldGVuY2lvbmVzIFZlcnNpb249IjIuMCIgRm9saW9JbnQ9IjMiIFNlbGxvPSIwIiBOb0NlcnRpZmljYWRvPSIwMDAwMDAwMDAwMDAwMDAwMDAwMCIgQ2VydGlmaWNhZG89IjAiIEZlY2hhRXhwPSIyMDI2LTA5LTExVDAwOjAwOjAxIiBMdWdhckV4cFJldGVuYz0iMDEwMzAiIEN2ZVJldGVuYz0iMTgiIHhzaTpzY2hlbWFMb2NhdGlvbj0iaHR0cDovL3d3dy5zYXQuZ29iLm14L2VzcXVlbWFzL3JldGVuY2lvbnBhZ28vMiBodHRwOi8vd3d3LnNhdC5nb2IubXgvZXNxdWVtYXMvcmV0ZW5jaW9ucGFnby8yL3JldGVuY2lvbnBhZ292Mi54c2QgaHR0cDovL3d3dy5zYXQuZ29iLm14L2VzcXVlbWFzL3JldGVuY2lvbnBhZ28vMS9wYWdvc2FleHRyYW5qZXJvcyBodHRwOi8vd3d3LnNhdC5nb2IubXgvZXNxdWVtYXMvcmV0ZW5jaW9ucGFnby8xL3BhZ29zYWV4dHJhbmplcm9zL3BhZ29zYWV4dHJhbmplcm9zLnhzZCIgeG1sbnM6cGFnb3NhZXh0cmFuamVyb3M9Imh0dHA6Ly93d3cuc2F0LmdvYi5teC9lc3F1ZW1hcy9yZXRlbmNpb25wYWdvLzEvcGFnb3NhZXh0cmFuamVyb3MiIHhtbG5zOnJldGVuY2lvbmVzPSJodHRwOi8vd3d3LnNhdC5nb2IubXgvZXNxdWVtYXMvcmV0ZW5jaW9ucGFnby8yIiB4bWxuczp4c2k9Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvWE1MU2NoZW1hLWluc3RhbmNlIj4KICAgIDxyZXRlbmNpb25lczpFbWlzb3IgUmZjRT0iSkVTOTAwMTA5UTkwIiBOb21EZW5SYXpTb2NFPSJKSU1FTkVaIEVTVFJBREEgU0FMQVMgQSBBIiBSZWdpbWVuRmlzY2FsRT0iNjAxIiAvPgogICAgPHJldGVuY2lvbmVzOlJlY2VwdG9yIE5hY2lvbmFsaWRhZFI9IkV4dHJhbmplcm8iPgogICAgICAgIDxyZXRlbmNpb25lczpFeHRyYW5qZXJvIE5vbURlblJhelNvY1I9Ik5JREVDIFBPV0VSVFJBSU4gU1lTVEVNUyBDT1JQT1JBVElPTiIgLz4KICAgIDwvcmV0ZW5jaW9uZXM6UmVjZXB0b3I+CiAgICA8cmV0ZW5jaW9uZXM6UGVyaW9kbyBNZXNJbmk9IjA4IiBNZXNGaW49IjA4IiBFamVyY2ljaW89IjIwMjUiIC8+CiAgICA8cmV0ZW5jaW9uZXM6VG90YWxlcyBNb250b1RvdE9wZXJhY2lvbj0iMjI5MjUzOS44MyIgTW9udG9Ub3RHcmF2PSIyMjkyNTM5LjgzIiBNb250b1RvdEV4ZW50PSIwIiBNb250b1RvdFJldD0iMjI5MjUzLjk4IiBJU1JDb3JyZXNwb25kaWVudGU9IjAiPgogICAgICAgIDxyZXRlbmNpb25lczpJbXBSZXRlbmlkb3MgQmFzZVJldD0iMjI5MjUzLjk4IiBJbXB1ZXN0b1JldD0iMDAxIiBNb250b1JldD0iMjI5MjUzLjk4IiBUaXBvUGFnb1JldD0iMDMiIC8+CiAgICA8L3JldGVuY2lvbmVzOlRvdGFsZXM+CiAgICA8cmV0ZW5jaW9uZXM6Q29tcGxlbWVudG8+CiAgICAgICAgPHBhZ29zYWV4dHJhbmplcm9zOlBhZ29zYWV4dHJhbmplcm9zIFZlcnNpb249IjEuMCIgRXNCZW5lZkVmZWN0RGVsQ29icm89Ik5PIj4KICAgICAgICAgICAgPHBhZ29zYWV4dHJhbmplcm9zOk5vQmVuZWZpY2lhcmlvIFBhaXNEZVJlc2lkUGFyYUVmZWNGaXNjPSJKUCIgQ29uY2VwdG9QYWdvPSIzIiBEZXNjcmlwY2lvbkNvbmNlcHRvPSJSZWdhbGlhcyBwb3IgYXNpc3RlbmNpYSB0ZWNuaWNhIiAvPgogICAgICAgIDwvcGFnb3NhZXh0cmFuamVyb3M6UGFnb3NhZXh0cmFuamVyb3M+CiAgICA8L3JldGVuY2lvbmVzOkNvbXBsZW1lbnRvPgo8L3JldGVuY2lvbmVzOlJldGVuY2lvbmVzPg==</ws:Data1>
<ws:Data2>XML</ws:Data2>
<ws:Data3></ws:Data3>
</ws:RequestTransaction>
</soapenv:Body>
</soapenv:Envelope><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<RequestTransactionResponse xmlns="http://www.fact.com.mx/schema/ws">
<RequestTransactionResult>
<Request>
<Requestor>00000000-0000-0000-0000-000000000000</Requestor>
<RequestorActive>true</RequestorActive>
<Transaction>FIRMAR_RETENCION</Transaction>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<User>00000000-0000-0000-0000-000000000000</User>
<UserName>Jan_Test</UserName>
<Id>d9658ad6-fc2b-49cb-a578-275285f40d0d</Id>
<TimeStamp>2026-09-11T10:58:06.3022094-06:00</TimeStamp>
</Request>
<Response>
<Result>true</Result>
<TimeStamp>2026-09-11T10:58:07.3614942-06:00</TimeStamp>
<LastResult/>
<Code>1</Code>
<Description/>
<Hint/>
<Data>5620 d9658ad6-fc2b-49cb-a578-275285f40d0d</Data>
<Processor>TEST-BACK03</Processor>
</Response>
<ResponseData>
<ResponseData1>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48cmV0ZW5jaW9uZXM6UmV0ZW5jaW9uZXMgVmVyc2lvbj0iMi4wIiBGb2xpb0ludD0iMyIgU2VsbG89Imx1TFQ4bzVvQ25aQmJjMTIySHZZOWFOUDl4dGVZWkFWNHRFeXh0YmhkNG9SeE40WDVzdHY5VzR0Y0F4ZnFSMXp6Rkx6cUQyS2R0V2xRcVl6bTZIb0pmQW9VRlNzZzJ3bFRLUzNCQXZDdHNKNENSd2NCc0xoRHI5Vm1SaUxweDdudEFJcDlENjZkYms2eVFZWmVxTHF2d0pLUmJnZkYxbjlMemlCZTZVL3hFVmgwTTBwaytVY0hyd1dXV2NKM0NHcGhpVmdGeDY3bHhnUWdBamtBOUJZSlVUTW1pNzkyREFOMWRPYmY3VzFabGhYNUt2Zm1wMFF3RE1seGl1M3BqeTVwakVmRWZBUkVaSkxtSkVzV2JPVHAraFdTOVlJYjUzSTl5OWY4S2o1aGNyMVl2aTY5TjMrNWpoRkc0ZkpnSWpFVEZCMnU0MWlUOHM1L3F4Q1QrWXFSZz09IiBOb0NlcnRpZmljYWRvPSIzMDAwMTAwMDAwMDUwMDAwMzQzNiIgQ2VydGlmaWNhZG89Ik1JSUZvVENDQTRtZ0F3SUJBZ0lVTXpBd01ERXdNREF3TURBMU1EQXdNRE0wTXpZd0RRWUpLb1pJaHZjTkFRRUxCUUF3Z2dFck1ROHdEUVlEVlFRRERBWkJReUJWUVZReExqQXNCZ05WQkFvTUpWTkZVbFpKUTBsUElFUkZJRUZFVFVsT1NWTlVVa0ZEU1U5T0lGUlNTVUpWVkVGU1NVRXhHakFZQmdOVkJBc01FVk5CVkMxSlJWTWdRWFYwYUc5eWFYUjVNU2d3SmdZSktvWklodmNOQVFrQkZobHZjMk5oY2k1dFlYSjBhVzVsZWtCellYUXVaMjlpTG0xNE1SMHdHd1lEVlFRSkRCUXpjbUVnWTJWeWNtRmtZU0JrWlNCallXeHBlakVPTUF3R0ExVUVFUXdGTURZek56QXhDekFKQmdOVkJBWVRBazFZTVJrd0Z3WURWUVFJREJCRFNWVkVRVVFnUkVVZ1RVVllTVU5QTVJFd0R3WURWUVFIREFoRFQxbFBRVU5CVGpFUk1BOEdBMVVFTFJNSU1pNDFMalF1TkRVeEpUQWpCZ2txaGtpRzl3MEJDUUlURm5KbGMzQnZibk5oWW14bE9pQkJRMFJOUVMxVFFWUXdIaGNOTWpNd05URTRNVEkxTVRRM1doY05NamN3TlRFNE1USTFNVFEzV2pDQnlERWlNQ0FHQTFVRUF4TVpTa2xOUlU1RldpQkZVMVJTUVVSQklGTkJURUZUSUVFZ1FURWlNQ0FHQTFVRUtSTVpTa2xOUlU1RldpQkZVMVJTUVVSQklGTkJURUZUSUVFZ1FURWlNQ0FHQTFVRUNoTVpTa2xOUlU1RldpQkZVMVJTUVVSQklGTkJURUZUSUVFZ1FURWxNQ01HQTFVRUxSTWNTa1ZUT1RBd01UQTVVVGt3SUM4Z1ZrRkVRVGd3TURreU4wUktNekVlTUJ3R0ExVUVCUk1WSUM4Z1ZrRkVRVGd3TURreU4waFRVbE5TVERBMU1STXdFUVlEVlFRTEV3cFRkV04xY25OaGJDQXhNSUlCSWpBTkJna3Foa2lHOXcwQkFRRUZBQU9DQVE4QU1JSUJDZ0tDQVFFQXFzVmRERjdXcHdNYzN6Q0RkSkhyMnVxSEJHNUNQbFYxZ3N6YXAzeFFaY3gyaCtiZitneEFOSlk4YU5kMlJhWVh6VkNvL1NRbHczTi9WWkY5Z2FEa29mN0RKQ3QwVWRaSEZWbzZGSW9Zb1I0eXV5V2JoYzBvdGwxS1pzUWErTkRveURQSGYyRklSWUh6clpmaDFrUElHMVNVeGRVUmdPZWlXeWIrUUpXZjh5c2YyQllIemk1bjJrVEtpcll3L2ZtcDN4YURxQldFWFpvaVhYWXp3cTRTN2xTVzM2MURTNVNLSHZXYktVcUNmbkNOc3BSSWgyMmNET043TXQyUVBtQ0M0NGdhMTVYaHFURm1JTUpQMGZEV2RGN3hGcnFQVkEyTEVjdFdNNlR3V0E3L1RpazcrTnlibklwTnp4bkRYczBJZUFick5ycTJUNEVBc1FlMVZjdWNNUUlEQVFBQm94MHdHekFNQmdOVkhSTUJBZjhFQWpBQU1Bc0dBMVVkRHdRRUF3SUd3REFOQmdrcWhraUc5dzBCQVFzRkFBT0NBZ0VBR1FqaWdXWlIrSVczMFZhRlNNVjJhUVAxcnU2OEFoUnpianpoWk1NNWkvVFpMS1NXOVdzaHFwd0VTQXdUOEJjWWNTdWdtTVBXSzQ5OWQ2QTdNaUhOWFJRUGZYMzBGNS8wZHptVW1EaEtjNTR1dFMvcjAzQ2pLd09RYmdEMFRnQjBkRHVSZDYrOXd1a1R4bUZmWWRmUTBuMGdUaGVEREhuaHRvemxPYXMydTNXWFNiYWZOdW5qek92Yk9YR1hreHZIK3l3S0prMG1CMjNjbmVVWGw4dnArVGJkMmRoY2U2S0oyUytyYXgwNDNualoxaWJoRFZKTDJnaksyMDJpOC80a2lUSHpob0pwM2dPV2NsZ1U0b2NZR0wzanlRTDNBMTh3WVBTRVQxcHRTaEN3K1dRYjZpTHRwSDROOXZDWVFZN0djRjRjK1NRYnVoSUZpR1JLRm5NVjIwallDQlRjTXVyYVlzZklrU0VaRVpmV0xpc2FsU3lodWU3NXFwM29tWm1JQjc2QlEzakpRUUdaUlUwbzVNMjdJa2xxU2pMMHE5MnZLajlUbnpRWFpTVkxEUTlKSzg5WXFwRGFsdHVGbUo1cHBMOTlBa3h4NzZ3bWs2bDdENXJCTldQMjhrN3RSc29DYTNMU0FCZUV4U2RJNDRCZDU4LzAxU3RORkRkR1ZPQ1hXaEt2OTg0TVhRaVJBZFM3dFZ0RjBzTSt6MjcrVHlnZHFlQ3FodC9NenlnbEdoMHlWU2draGJXbjhyRjNYczdmRGFWU2c3bE1qOGxjdjhVVEtWUnhMUWh6aGRoS2wybmluYVA3Z3V5UHZURzhxUnNOeks5dC9yR3plSkhIRDliT0FHdDhNN3VzdFY1eDlaRDNjVkVhZVFLUWhTZS83Wm5TTTE3VTFuZVQrL0E9IiBGZWNoYUV4cD0iMjAyNi0wOS0xMVQwMDowMDowMSIgTHVnYXJFeHBSZXRlbmM9IjAxMDMwIiBDdmVSZXRlbmM9IjE4IiB4c2k6c2NoZW1hTG9jYXRpb249Imh0dHA6Ly93d3cuc2F0LmdvYi5teC9lc3F1ZW1hcy9yZXRlbmNpb25wYWdvLzIgaHR0cDovL3d3dy5zYXQuZ29iLm14L2VzcXVlbWFzL3JldGVuY2lvbnBhZ28vMi9yZXRlbmNpb25wYWdvdjIueHNkIGh0dHA6Ly93d3cuc2F0LmdvYi5teC9lc3F1ZW1hcy9yZXRlbmNpb25wYWdvLzEvcGFnb3NhZXh0cmFuamVyb3MgaHR0cDovL3d3dy5zYXQuZ29iLm14L2VzcXVlbWFzL3JldGVuY2lvbnBhZ28vMS9wYWdvc2FleHRyYW5qZXJvcy9wYWdvc2FleHRyYW5qZXJvcy54c2QgIiB4bWxuczpyZXRlbmNpb25lcz0iaHR0cDovL3d3dy5zYXQuZ29iLm14L2VzcXVlbWFzL3JldGVuY2lvbnBhZ28vMiIgeG1sbnM6cGFnb3NhZXh0cmFuamVyb3M9Imh0dHA6Ly93d3cuc2F0LmdvYi5teC9lc3F1ZW1hcy9yZXRlbmNpb25wYWdvLzEvcGFnb3NhZXh0cmFuamVyb3MiIHhtbG5zOnhzaT0iaHR0cDovL3d3dy53My5vcmcvMjAwMS9YTUxTY2hlbWEtaW5zdGFuY2UiPjxyZXRlbmNpb25lczpFbWlzb3IgUmZjRT0iSkVTOTAwMTA5UTkwIiBOb21EZW5SYXpTb2NFPSJKSU1FTkVaIEVTVFJBREEgU0FMQVMgQSBBIiBSZWdpbWVuRmlzY2FsRT0iNjAxIiAvPjxyZXRlbmNpb25lczpSZWNlcHRvciBOYWNpb25hbGlkYWRSPSJFeHRyYW5qZXJvIj48cmV0ZW5jaW9uZXM6RXh0cmFuamVybyBOb21EZW5SYXpTb2NSPSJOSURFQyBQT1dFUlRSQUlOIFNZU1RFTVMgQ09SUE9SQVRJT04iIC8+PC9yZXRlbmNpb25lczpSZWNlcHRvcj48cmV0ZW5jaW9uZXM6UGVyaW9kbyBNZXNJbmk9IjA4IiBNZXNGaW49IjA4IiBFamVyY2ljaW89IjIwMjUiIC8+PHJldGVuY2lvbmVzOlRvdGFsZXMgTW9udG9Ub3RPcGVyYWNpb249IjIyOTI1MzkuODMiIE1vbnRvVG90R3Jhdj0iMjI5MjUzOS44MyIgTW9udG9Ub3RFeGVudD0iMCIgTW9udG9Ub3RSZXQ9IjIyOTI1My45OCIgSVNSQ29ycmVzcG9uZGllbnRlPSIwIj48cmV0ZW5jaW9uZXM6SW1wUmV0ZW5pZG9zIEJhc2VSZXQ9IjIyOTI1My45OCIgSW1wdWVzdG9SZXQ9IjAwMSIgTW9udG9SZXQ9IjIyOTI1My45OCIgVGlwb1BhZ29SZXQ9IjAzIiAvPjwvcmV0ZW5jaW9uZXM6VG90YWxlcz48cmV0ZW5jaW9uZXM6Q29tcGxlbWVudG8+PHBhZ29zYWV4dHJhbmplcm9zOlBhZ29zYWV4dHJhbmplcm9zIFZlcnNpb249IjEuMCIgRXNCZW5lZkVmZWN0RGVsQ29icm89Ik5PIj48cGFnb3NhZXh0cmFuamVyb3M6Tm9CZW5lZmljaWFyaW8gUGFpc0RlUmVzaWRQYXJhRWZlY0Zpc2M9IkpQIiBDb25jZXB0b1BhZ289IjMiIERlc2NyaXBjaW9uQ29uY2VwdG89IlJlZ2FsaWFzIHBvciBhc2lzdGVuY2lhIHRlY25pY2EiIC8+PC9wYWdvc2FleHRyYW5qZXJvczpQYWdvc2FleHRyYW5qZXJvcz48dGZkOlRpbWJyZUZpc2NhbERpZ2l0YWwgeHNpOnNjaGVtYUxvY2F0aW9uPSJodHRwOi8vd3d3LnNhdC5nb2IubXgvVGltYnJlRmlzY2FsRGlnaXRhbCBodHRwOi8vd3d3LnNhdC5nb2IubXgvc2l0aW9faW50ZXJuZXQvY2ZkL1RpbWJyZUZpc2NhbERpZ2l0YWwvVGltYnJlRmlzY2FsRGlnaXRhbHYxMS54c2QiIFZlcnNpb249IjEuMSIgVVVJRD0iZTY4YTBmMTMtYTNjMi00NjkwLTgyOGQtNWNjNWVmYjZlYWRmIiBGZWNoYVRpbWJyYWRvPSIyMDI2LTA5LTExVDEwOjU4OjA2IiBSZmNQcm92Q2VydGlmPSJTUFIxOTA2MTNJNTIiIFNlbGxvQ0ZEPSJsdUxUOG81b0NuWkJiYzEyMkh2WTlhTlA5eHRlWVpBVjR0RXl4dGJoZDRvUnhONFg1c3R2OVc0dGNBeGZxUjF6ekZMenFEMktkdFdsUXFZem02SG9KZkFvVUZTc2cyd2xUS1MzQkF2Q3RzSjRDUndjQnNMaERyOVZtUmlMcHg3bnRBSXA5RDY2ZGJrNnlRWVplcUxxdndKS1JiZ2ZGMW45THppQmU2VS94RVZoME0wcGsrVWNIcndXV1djSjNDR3BoaVZnRng2N2x4Z1FnQWprQTlCWUpVVE1taTc5MkRBTjFkT2JmN1cxWmxoWDVLdmZtcDBRd0RNbHhpdTNwank1cGpFZkVmQVJFWkpMbUpFc1diT1RwK2hXUzlZSWI1M0k5eTlmOEtqNWhjcjFZdmk2OU4zKzVqaEZHNGZKZ0lqRVRGQjJ1NDFpVDhzNS9xeENUK1lxUmc9PSIgTm9DZXJ0aWZpY2Fkb1NBVD0iMzAwMDEwMDAwMDA1MDAwMDM0NTYiIFNlbGxvU0FUPSJhVTdMUEdVVXV2UXlmYmgxR0JnTUdTQTdyajI5UGZua012d2VGN3FtTFVnWHNXSWRPSytKWEFEc2E2MmFLcHh5ZktqN1hkY1lmNFZnSnNVbTlDRXNlZUxmcndVdk5JRythMmdxVTY5VVNDZW5IQ2lSM3A2MDRiTFZtdEtqamtEaWRWSis3VDNtYjVmTTRCdktzS3pQT09jS0NlM2VzNUFTSDY0dlE2Wk12T1RMMXY1UTFPeWpaTVRWMFpoV0Fyek5pK1dxR2NMUjQreTM2UTFvaG5mSVYzUzFEU01hM216NFJjRFFPRkpHM2dWWnFyZHRGbW1pM0lSSVhOUzIzL1RnUFVJMzVwV3QvVXlkODJONWZtZjRtbWV1TG1UV0xySlFCVmM4akNIOGVpbTFJSXVlemFIWVhaWTA1T3FENEZ2TTJoS3ArdFhFNVQ1cmUvbk5RMGFQSXc9PSIgeG1sbnM6dGZkPSJodHRwOi8vd3d3LnNhdC5nb2IubXgvVGltYnJlRmlzY2FsRGlnaXRhbCIgLz48L3JldGVuY2lvbmVzOkNvbXBsZW1lbnRvPjwvcmV0ZW5jaW9uZXM6UmV0ZW5jaW9uZXM+</ResponseData1>
<ResponseData2/>
<ResponseData3/>
</ResponseData>
</RequestTransactionResult>
</RequestTransactionResponse>
</soap:Body>
</soap:Envelope>
La respuesta se organiza en tres bloques dentro de RequestTransactionResult.
| Bloque | Elemento | Contenido |
|---|---|---|
Request |
Eco de los parámetros de identidad | Devuelve Transaction, Country, Entity y UserName |
RequestorActive |
Indica si el solicitante está activo | |
Id · TimeStamp |
Identificador de la operación y momento de recepción | |
Response |
Result |
true cuando el comprobante fue certificado |
Code |
Código de resultado. Ver apartado 10 | |
TimeStamp |
Momento en que concluyó el procesamiento | |
LastResult · Description · Hint |
Vacíos en certificación exitosa. Ver apartado 9 | |
Data · Processor |
Referencia interna del procesamiento y Servidor que atendió la solicitud | |
ResponseData |
ResponseData1 |
Comprobante de Retención certificado, en Base64, sólo si enviaste el valor "XML" en Data2 |
ResponseData2 |
Vacío | |
ResponseData3 |
Vacío |
Identifier. A diferencia de CONVERT_NATIVE_XML, el servicio no te devuelve por separado el Folio Fiscal, la serie, el folio ni la fecha de timbrado. Esos datos existen únicamente dentro del comprobante certificado, en el nodo del Timbre Fiscal Digital. Para registrar la retención en tu ERP tienes que decodificar ResponseData1 y leer el XML.| Dato | Uso |
|---|---|
| Folio Fiscal (UUID) | Llave única de la retención. Registrar en el ERP |
| Fecha de timbrado | Momento de la certificación |
| Sello del SAT y sello del CFD | Evidencia de la certificación |
| RFC del proveedor de certificación | Identifica al PAC que timbró |
NoCertificado y Certificado del emisor |
Sustituidos por MYSuite. Confirman que el sellado se aplicó |
El sobre es el mismo del apartado 8. Cambia el contenido de Response y las cargas llegan vacías.
| Elemento | Contenido en error |
|---|---|
Result |
false: el comprobante no fue certificado |
Code |
Código del error. Ver apartado 10 |
Description |
Mensaje del error |
Hint |
Sugerencia de corrección, cuando la plataforma la proporciona |
Data |
Mensaje interno MYSuite |
LastResult |
Resultado de la operación previa asociada, cuando aplica |
Processor |
Servidor que atendió la solicitud |
ResponseData1 |
Vacío |
Result = false y HTTP 200. Evalúa siempre Result y no asumas éxito por el código de estado HTTP.| Aspecto | Valor |
|---|---|
| Comprobantes por llamada | Uno |
| Efectos fiscales | Irreversibles. La certificación incorpora el Timbre Fiscal Digital y el comprobante existe ante el SAT. Retirarlo requiere una cancelación formal |
| Consumo de folios | 1 folio del paquete vigente |
| Idempotencia | Solicitar certificar un mismo comprobante genera una notificación en donde se indica que MYSuite ya certificó ese CFDI de Retención |
| Recuperación ante TimeOut | No existe un equivalente conocido de LOOKUP_ISSUED_INTERNAL_ID. |
| Almacenamiento | Año actual y 5 años hacía atrás |
Tamaño máximo de Data1 |
1 MB |
| Timeout | 60 segundos en servidor front |
Problema. La certificación falla al enviar el comprobante con un sello real, con los atributos vacíos o sin ellos.
Entorno. CFDI + Timbrado · SOAP · FIRMAR_RETENCION · integraciones nuevas.
Resolución. Envía los tres atributos presentes y con valores de marcador: Sello="0", NoCertificado="00000000000000000000" y Certificado="0". No los omitas, porque el esquema del SAT los exige, y no los llenes con datos reales, porque el sellado lo hace MYSuite con el CSD que tienes cargado.
Causa. Se aplicó el criterio de otros flujos donde el emisor sella antes de enviar. Aquí el orden es el inverso: primero envías, después se sella.
Problema. Result es true pero ResponseData1 llega vacío, y el comprobante certificado no aparece por ningún lado.
Entorno. CFDI + Timbrado · SOAP · FIRMAR_RETENCION.
Resolución. Revisa el valor de Data2: debe llevar el literal XML para que la respuesta incluya la retención en Base64. Si ya certificaste sin recibirlo, el comprobante existe ante el SAT y no debes volver a certificarlo: recupéralo por otra vía antes de reintentar.
Causa. Data2 vacío o con un valor distinto.
Problema. El ERP busca el UUID en el nodo Identifier y no lo encuentra.
Entorno. CFDI + Timbrado · SOAP · integraciones que reutilizan el código de CONVERT_NATIVE_XML.
Resolución. Esta transacción no devuelve Identifier. Decodifica ResponseData1 y lee el Folio Fiscal, la fecha de timbrado y los sellos directamente del nodo del Timbre Fiscal Digital dentro del XML certificado.
Causa. La respuesta de las retenciones es más escueta que la de los CFDI ordinarios: entrega el comprobante y nada más. La capa de lectura de respuesta no se puede compartir entre ambas transacciones.
Problema. La respuesta solo trae el XML y el proceso necesita la representación gráfica para enviarla o archivarla.
Entorno. CFDI + Timbrado · SOAP · emisión de constancias de retención.
Resolución. Solicita la representación gráfica con GET_DOCUMENT_RETENCIONES. Si lo que necesitas es que el receptor la reciba por correo, puedes evitar esa llamada incluyendo la addenda de MYSuite con el elemento ams:Procesamiento en el comprobante que envías a certificar.
Causa. A diferencia de CONVERT_NATIVE_XML, que puede devolver el PDF en la misma llamada, aquí la representación gráfica se obtiene aparte.
Problema. El comprobante se certifica correctamente pero la distribución por correo no ocurre.
Entorno. CFDI + Timbrado · SOAP · retenciones con distribución automática.
Resolución. Verifica que ams:AddendaMysuite esté dentro del elemento retenciones:Addenda del comprobante, no en otro lugar del XML, y que el Dictionary se llame email con las tres entradas from, to y formats. Revisa también que el espacio de nombres ams y la ubicación del esquema estén declarados como indica el ejemplo.
Causa. La addenda colocada fuera del elemento que le corresponde se ignora silenciosamente: el comprobante es válido y se certifica igual, pero las instrucciones de procesamiento no se leen.
Problema. El ERP no recibe respuesta y no puede determinar si el comprobante quedó certificado.
Entorno. CFDI + Timbrado · SOAP · redes con latencia o cortes intermitentes.
Resolución. No reintentes a ciegas. Un reintento puede producir una segunda retención certificada, con efectos fiscales reales. Detén el proceso de ese comprobante y verifica antes de volver a enviarlo.
El CFDI de Retenciones e Información de Pagos no es una variante del CFDI de factura: es un comprobante distinto, con su propio esquema publicado por el SAT, sus propios complementos y su propio espacio de nombres. Ampara una obligación diferente —informar sobre impuestos retenidos y pagos efectuados— y por eso tiene una transacción propia en lugar de un tipo de comprobante dentro de la emisión ordinaria. Casi nada de lo que sabes de CONVERT_NATIVE_XML se traslada aquí.
En la emisión ordinaria, MYSuite ofrece un formato propio para que el ERP no tenga que conocer el Anexo 20: tú entregas datos y la plataforma construye el CFDI. En retenciones no existe esa capa intermedia: tu sistema entrega el comprobante fiscal ya armado conforme al esquema del SAT, y MYSuite solo sella y certifica. La consecuencia práctica es que el conocimiento normativo vive de tu lado, y que un cambio de versión del comprobante te obliga a modificar tu código, cosa que en la emisión ordinaria normalmente no ocurre.
El esquema del SAT declara Sello, NoCertificado y Certificado como atributos del comprobante, así que deben existir para que el XML sea válido. Pero su contenido solo puede calcularlo quien tiene la llave privada del CSD, y en este flujo esa llave la custodia MYSuite. Los valores de marcador resuelven la contradicción: satisfacen al esquema sin afirmar nada falso, y se sustituyen en el momento del sellado. Verlos como "campos reservados" en lugar de como datos evita la confusión.
Todo lo que la certificación produce está dentro del comprobante devuelto: el Folio Fiscal, la fecha de timbrado y los sellos viven en el Timbre Fiscal Digital. El servicio no los replica en un nodo aparte, como sí hace con los CFDI ordinarios a través de Identifier. Para quien integra esto tiene una consecuencia concreta: hace falta un paso de lectura del XML certificado que en la emisión ordinaria no era necesario, y conviene tratarlo como parte del flujo y no como un extra.
La certificación tiene efectos fiscales irreversibles y se ejecuta sobre una red que puede fallar. En los CFDI ordinarios ese riesgo está cubierto: el ERP escribe su Número Interno en el XML Nativo y, si pierde la respuesta, pregunta con LOOKUP_ISSUED_INTERNAL_ID antes de decidir. En retenciones no hay hoy un equivalente documentado, lo que deja al proceso sin red en el escenario exacto donde más se necesita. Si emites volumen relevante de retenciones, vale la pena resolver este punto con MYSuite antes de que ocurra el primer corte de conexión, y no después.
Podría haberse resuelto con parámetros de la transacción, pero se resolvió con una addenda. La razón es que la addenda viaja con el documento: las instrucciones de envío quedan asociadas al comprobante concreto y no a la llamada, lo que permite que cada retención lleve su propio destinatario sin cambiar la integración. El costo es que tienes que colocarla en el lugar exacto del XML, y que si te equivocas de lugar el comprobante se certifica igual pero el correo nunca se envía.
La representación gráfica de una retención se genera con plantillas distintas de las de un CFDI de factura, y se obtiene con GET_DOCUMENT_RETENCIONES. Separar la certificación de la representación mantiene la primera ligera, que es lo deseable en una operación con efectos fiscales: cuanto menos trabajo haga, menos superficie de falla tiene.
La transacción sería la misma operación de negocio en ambos transportes, pero cambia todo lo que rodea al dato: los encabezados, la forma del cuerpo, la nomenclatura de la respuesta y la manera de leerla. Documentar ambos en un solo artículo obligaría al lector a descartar la mitad del contrato técnico en cada consulta, y es precisamente donde se originan los errores de integración.
Emisión
Consulta y Recuperación
Validación y Recepción
CFDI de Retenciones
Esquema de cancelación