FIRMAR_RETENCION — SERVICIO CFDI + Timbrado (SOAP)

FIRMAR_RETENCION — SERVICIO CFDI + Timbrado (SOAP)

Estado Transacción: Vigente · Compatibilidad: CFDI de Retenciones e Información de Pagos, Anexo 20 vigente · Última revisión: 21/08/2026 · Próxima revisión:  21/11/2026 · Responsable: Jan Martínez


De un vistazo


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.


Idea
El comprobante se envía sin sellar, pero con los atributos de sello presentes. En el XML que mandes en Data1 los atributos Sello, NoCertificado y Certificado deben llevar valores de marcador: Sello="0", NoCertificado="00000000000000000000" y Certificado="0". MYSuite los sustituye por los que correspondan al contribuyente emisor al certificar.

Alert
Advertencia de homonimia. Este artículo documenta el consumo por SOAP, contra el servicio FactWSFront.


Cómo saber si este es tu artículo


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


Requisitos previos

  • Credenciales de integración vigentes que te proporciona MYSuite: Requestor y Entity.
  • CSD del emisor cargado y vigente en la plataforma MYSuite (ambiente productivo).
  • Capacidad de tu sistema para construir el XML del CFDI de Retenciones conforme al esquema que publica el SAT (MYSuite no lo construye).
  • Capacidad de tu ERP para codificar y decodificar Base64, y para leer el XML certificado que recibas.


Cómo hacerlo

  1. Construye el XML del CFDI de Retenciones e Información de Pagos conforme al esquema vigente del SAT.
    Resultado: un comprobante de retención bien formado, aún sin certificar.
  2. Coloca los valores en los atributos de sello: Sello="0", NoCertificado="00000000000000000000" y Certificado="0".
    Resultado: el comprobante queda listo para que MYSuite lo selle.
  3. Agrega los complementos fiscales que correspondan al tipo de retención que estás emitiendo.
    Resultado: comprobante completo conforme a la obligación que amparas.
  4. Incluye la addenda de MYSuite dentro del elemento retenciones:Addenda si quieres que la plataforma distribuya por correo el XML y el PDF. Es opcional.
    Resultado: instrucciones de distribución embebidas en el comprobante.
  5. Codifica el XML completo en Base64, sin saltos de línea intermedios.
    Resultado: una cadena Base64 en una sola línea.
  6. Arma el sobre SOAP con las credenciales, Transaction con valor FIRMAR_RETENCION, la cadena Base64 en Data1, el valor XML en Data2 y Data3 vacío.
    Resultado: petición lista. Si Data2 no dice XML, no vas a recibir el comprobante certificado.
  7. Envía la petición al web service del ambiente que corresponda.
    Resultado: respuesta HTTP 200 con un sobre RequestTransactionResponse.
  8. Lee el elemento Result.
    Resultado: Result = true te permite continuar; Result = false te lleva a Solución de problemas.
  9. Decodifica ResponseData1 desde Base64.
    Resultado: el XML del comprobante de retención ya certificado, con su Timbre Fiscal Digital.
  10. Extrae del XML certificado los datos del Timbre Fiscal Digital: Folio Fiscal (UUID), fecha de timbrado y sello del SAT. La respuesta del servicio no incluye el nodo Identifier, así que estos datos solo están dentro del comprobante.
    Resultado: los identificadores necesarios para registrar la retención en tu sistema.
  11. Conserva el XML certificado y registra/guarda la retención en tu ERP. Si necesitas la representación gráfica, solicítala después con GET_DOCUMENT_RETENCIONES.
    Resultado: retención emitida, resguardada y conciliada.

Si algo falla, ve a Solución de problemas.


Contrato técnico

1. Endpoint y operación

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


2. Ambientes

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
Restricción del ambiente de pruebas. Un cliente CFDI + Timbrado (SOAP), debe usar JES900109Q90 como RFC emisor (Entity).
Los RFC admitidos como receptores están en el catálogo de RFC autorizados para pruebas:


3. Autenticación

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


4. Parámetros de entrada

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



5. Estructura de lo que se envía en Data1, Data2 y Data3

Data1 — CFDI de Retenciones e Información de Pagos

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

Atributos de sello: valores de marcador obligatorios
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


Los atributos deben estar presentes porque el esquema del SAT los exige, pero su contenido real lo pone MYSuite al certificar, usando el CSD que tienes cargado en la plataforma.

Complementos fiscales

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.


Distribución por correo

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 y Data3

Data2 lleva el valor XML.

Data3 se envía vacío.


6. Ejemplo de request

<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>


7. Ejemplo de response

<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>

8. Estructura de respuesta — éxito

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
Esta respuesta no incluye el nodo 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.


Datos que debes extraer del XML certificado, del nodo del Timbre Fiscal Digital:

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ó


9. Estructura de respuesta — error

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
Un error de negocio se reporta con Result = false y HTTP 200. Evalúa siempre Result y no asumas éxito por el código de estado HTTP.


10. Códigos de Error


11. Límites y comportamiento


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


12. Versionado y cumplimiento

  • La certificación se realiza conforme al Anexo 20 vigente para el CFDI de Retenciones e Información de Pagos.
  • MYSuite sella con el CSD del emisor y certifica en su calidad de PAC autorizado por el SAT. La conservación del XML certificado es obligación del emisor.
  • El esquema del comprobante lo publica el SAT, no MYSuite: los cambios normativos impactan directamente al sistema que construye el XML.
  • Versiones aceptadas del CFDI de Retenciones: 2.0

Solución de problemas

"Me rechaza el comprobante por el sello"


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.

"Dice que se timbró pero no me devolvió nada"


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.

"No encuentro el folio fiscal en la respuesta"


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.

"Necesito el PDF de la retención"


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.

"Puse la addenda y el correo nunca llegó"


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.

"Se cayó la conexión y no sé si la retención se timbró"


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.

Causa. Pendiente Desarrollo «pendiente: Desarrollo — para los CFDI ordinarios existe LOOKUP_ISSUED_INTERNAL_ID como verificación antiduplicado, apoyada en el Número Interno del XML Nativo. En retenciones no se documenta ni un identificador propio del ERP ni una transacción de búsqueda equivalente. Definir el procedimiento de verificación antes de que un cliente lo necesite en producción.»



Para entender más

Por qué la retención es otro documento

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í.

Por qué no hay XML Nativo en este flujo

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.

Por qué los atributos de sello van en cero

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.

Por qué la respuesta es tan escueta

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.

Por qué conviene resolver la verificación antiduplicado antes de salir a producción

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.

Por qué la distribución por correo viaja dentro del comprobante

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.

Por qué el PDF se pide aparte

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.

Por qué SOAP y REST se documentan por separado

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.


Más Transacciones Servicio CFDI + Timbrado (SOAP)

Emisión

Consulta y Recuperación

Validación y Recepción

CFDI de Retenciones

Esquema de cancelación