VALIDATE_DOCUMENT — SERVICIO CFDI + Timbrado (API REST) - Request Transaction

VALIDATE_DOCUMENT — SERVICIO CFDI + Timbrado (API REST) - Request Transaction

Estado Transacción: Vigente · Compatibilidad: CFDI conforme al Anexo 20 vigente · Última revisión: 07/08/2026 · Próxima revisión: 07/11/2026 · Responsable: Jan Martínez


De un vistazo


Qué hace: revisa y valida la conformación de un CFDI conforme al Anexo 20 vigente, y te indica si el comprobante cumple con lo que la autoridad fiscal dispone. Junto con el veredicto devuelve los datos de identificación que extrajo del comprobante: emisor, receptor, serie, folio, Folio Fiscal, moneda e importe.


Cuándo se usa: para revisar CFDI que recibes de terceros antes de darlos por buenos en tu contabilidad; para verificar comprobantes generados por un sistema externo; y como diagnóstico cuando un comprobante es rechazado y no sabes por qué.


Cuándo no usarla: no valida el XML Nativo de MYSuite antes de timbrar; para eso valida localmente contra el esquema fx_2010_g.xsd. Tampoco timbra ni almacena el comprobante: solo lo revisa. Si además quieres que quede resguardado, usa RECEIVE.


Esta transacción consume folios. Por cada solicitud que devuelve resultField = true se descuenta un folio de tu paquete contratado. El descuento aplica igual si el comprobante sale sin observaciones o si sale con observaciones: lo que se cobra es la validación ejecutada, no el veredicto. Una llamada que devuelve resultField = false no descuenta folio.
Puedes validar comprobantes cuyo emisor y receptor sean distintos del RFC que solicita la transacción. No necesitas ser parte del comprobante para revisarlo.
Advertencia de homonimia. Existe la misma transacción en la modalidad CFDI + Timbrado sobre SOAP. Cada transporte se documenta en un artículo independiente. Este cubre exclusivamente API REST.


Cómo saber si este es tu artículo


Si tu integración… Tu artículo es...
Revisa si un CFDI ya timbrado cumple con el Anexo 20, enviando un cuerpo JSON por HTTP POST Este artículo
Hace lo mismo enviando un sobre SOAP a FactWSFront VALIDATE_DOCUMENT — CFDI + Timbrado (SOAP)
Necesita validar y dejar el comprobante resguardado en MYSuite, enviando un cuerpo JSON por HTTP POST RECEIVE — CFDI + Timbrado (API REST) - Request Transaction
Necesita revisar un XML Nativo antes de enviarlo a timbrar Validación local contra fx_2010_g.xsd. No requiere llamada al servicio ni consume folios
Va a emitir un CFDI a partir de un XML Nativo, enviando un cuerpo JSON por HTTP POST CONVERT_NATIVE_XML — CFDI + Timbrado (API REST) - Request Transaction


Requisitos previos

  • Credenciales de integración vigentes que te proporciona MYSuite: Requestor y Entity.
  • Un paquete de folios contratado con saldo disponible.
  • El XML del CFDI que quieres validar, ya timbrado. No el XML Nativo.
  • Capacidad de tu ERP para codificar en Base64.


Cómo hacerlo

  1. Obtén el XML del CFDI que quieres validar. Si está almacenado en MYSuite, recupéralo antes con RETRIEVE_DOCUMENT.
    Resultado: el archivo XML del comprobante timbrado, en UTF-8.
  2. Confirma que tu paquete de folios tiene saldo, recordando que cada validación ejecutada descuenta uno.
    Resultado: certeza de que la validación se va a ejecutar y a qué costo.
  3. Codifica el contenido completo del XML en Base64, sin saltos de línea intermedios.
    Resultado: una cadena Base64 en una sola línea.
  4. Arma el cuerpo JSON con los nueve campos: las credenciales, Transaction con valor VALIDATE_DOCUMENT, la cadena Base64 en Data1, Data2 y Data3 como cadenas vacías.
    Resultado: un JSON válido con los nueve campos presentes.
  5. Envía la petición POST al recurso /RequestTransaction con Content-Type: application/json.
    Resultado: respuesta HTTP 200 con un cuerpo JSON de tres objetos.
  6. Lee responseField.resultField. Indica si la validación pudo ejecutarse, no si el CFDI es correcto. Con true ya se descontó el folio.
    Resultado: resultField = true te permite continuar; resultField = false te lleva a Solución de problemas.
  7. Lee responseDataField.responseData3Field: ahí se describen las observaciones encontradas en el CFDI. Este es el veredicto de la validación, y llega en texto plano.
    Resultado: la lista de observaciones, o la constancia de que no hay ninguna.
  8. Concilia los datos de responseField.identifierField con lo que tu sistema esperaba del comprobante: emisor, receptor, serie, folio, Folio Fiscal, moneda e importe.
    Resultado: verificación de que el XML validado es el comprobante que creías.
  9. Decide en tu proceso qué hacer con el resultado: aceptar el comprobante, rechazarlo o escalarlo para revisión manual según las observaciones recibidas.
    Resultado: comprobante clasificado dentro de tu flujo de recepción.
  10. Guarda el resultado de la validación junto al comprobante, para no volver a validar lo mismo y para que el consumo del folio quede justificado y trazable.
    Resultado: validación auditable y consumo de folios controlado.

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


Contrato técnico

1. Endpoint y operación

Protocolo HTTP/1.1 sobre HTTPS · arquitectura REST con cuerpo JSON
Método POST
Recurso /RequestTransaction
Content-Type application/json
Accept application/json
Valor Transaction VALIDATE_DOCUMENT
Naturaleza Revisión. No emite, no almacena y no modifica el comprobante
Consumo Descuenta 1 folio del paquete contratado por cada solicitud con resultField = true. Con false no hay descuento


2. Ambientes

Ambiente URL
Pruebas https://api.mysuitetest.com/RequestTransaction
Producción https://api.mysuitecfdi.com/RequestTransaction

El RFC solicitante en pruebas para un cliente CFDI + Timbrado (API-REST) es JES900109Q90. A diferencia de las demás transacciones, el comprobante que envías a validar no tiene que pertenecer a ese emisor.


3. Autenticación

Esta modalidad no usa token: las credenciales viajan como campos del cuerpo JSON en cada petición.

Campo Tipo Obligatorio Formato Descripción
Requestor string Sí GUID Dato que proporciona MYSuite, relacionado con la seguridad de la transacción, con los procesos de autenticación y autorización
Transaction string Sí Literal en mayúsculas Método que quieres invocar. Para esta transacción: VALIDATE_DOCUMENT
Country string Sí Valor fijo MX Abreviatura del país
Entity string Sí RFC (12–13 caracteres) RFC de quien solicita la validación y a cuyo paquete de folios se carga el descuento. Puede ser distinto del emisor y del receptor del CFDI validado
User string Sí GUID Se repite el valor de Requestor
UserName string Sí Country.Entity.Usuario_ERP Identifica al usuario del ERP que originó la solicitud. Ejemplo: MX.JES900109Q90.Jan


4. Parámetros de entrada

Nombre Tipo Obligatorio. Límite Formato Descripción
Data1 string Sí Aplica el límite de 1 MB que rige en las transacciones síncronas Base64 XML del CFDI a validar, codificado en Base64. Es el comprobante timbrado, no el XML Nativo
Data2 string No — Cadena vacía "" Sin uso en esta transacción. El campo debe estar presente en el JSON con valor vacío
Data3 string No — Cadena vacía "" Sin uso en esta transacción. El campo debe estar presente en el JSON con valor vacío


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

Data1 — XML del CFDI

Un CFDI completo y timbrado, conforme al Anexo 20 de la versión con la que fue emitido. La transacción no espera una estructura propia de MYSuite: recibe el comprobante fiscal tal como existe.

Contenido XML del CFDI, incluido su Timbre Fiscal Digital
Codificación del archivo UTF-8, tal como lo emitió el PAC
Codificación de transporte Base64, en una sola línea
Versiones aceptadas Anexo 20 Vigente
Complementos Todos

Data2 y Data3

Sin estructura. Ambos se envían como cadena vacía.


6. Ejemplo de request

POST /RequestTransaction HTTP/1.1
Host: api.mysuitetest.com
Content-Type: application/json

{
"Requestor": "0c320b03-d4f1-47bc-9fb4-77995f9bf33e",
"Transaction": "VALIDATE_DOCUMENT",
"Country": "MX",
"Entity": "JES900109Q90",
"User": "0c320b03-d4f1-47bc-9fb4-77995f9bf33e",
"UserName": "MX.JES900109Q90.Jan",
"Data1": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48Y2ZkaTpDb21wcm9iYW50ZSB4c2k6c2NoZW1hTG9jYXRpb249Imh0dHA6Ly93d3cuc2F0LmdvYi5teC9jZmQvNCBodHRwOi8vd3d3LnNhdC5nb2IubXgvc2l0aW9faW50ZXJuZXQvY2ZkLzQvY2ZkdjQwLnhzZCIgVmVyc2lvbj0iNC4wIiBGZWNoYT0iMjAyNC0wOS0xMlQxNDoyMTozNiIgU2VsbG89ImdlTEZFMld6UGNsMTV1dmNXOG5PZU5MY05ucUVtSGw5SjdURVIzM0EyQW0rMFFRYkFxaVFvMGNCNlNxak9HQmhVUzhGQ1VOd0srZi96bE9FNDVyZFkvNldhd0o5WmdCRUkzckdvTzQ5Vll2YzAvN0RSMFQyS2c2c2JXcGxpNzBRQ1hXV1owK1d4OTRkS1ZOelovcGJKK3libEpmZ29mVjVpd1ZzOUx0NnNzQWhKZlgxZG1JdnpGUkxUV0hwdzBWZkV1UlJZb05ORm1ETXJoaGRiOEZqNVJvOW9NMVJsSkFqbTNEd244enQrQlhsWXhYK0tCbjl2RmtNUDFSTUsxQ2lMRjZUMWlxdlZNNDdUbWxxbHI5RmQxaTFFb2pyRlJSRmU2bnlnZ0hzTis4c3B5ZitwQVlUSGNnSzNvTnZpM3FPK0JWRFpmSjBlc1d3eWFQOHhidUxBQT09IiBGb3JtYVBhZ289Ijk5IiBOb0NlcnRpZmljYWRvPSIzMDAwMTAwMDAwMDUwMDAwMzQ0NCIgQ2VydGlmaWNhZG89Ik1JSUZvVENDQTRtZ0F3SUJBZ0lVTXpBd01ERXdNREF3TURBMU1EQXdNRE0wTkRRd0RRWUpLb1pJaHZjTkFRRUxCUUF3Z2dFck1ROHdEUVlEVlFRRERBWkJReUJWUVZReExqQXNCZ05WQkFvTUpWTkZVbFpKUTBsUElFUkZJRUZFVFVsT1NWTlVVa0ZEU1U5T0lGUlNTVUpWVkVGU1NVRXhHakFZQmdOVkJBc01FVk5CVkMxSlJWTWdRWFYwYUc5eWFYUjVNU2d3SmdZSktvWklodmNOQVFrQkZobHZjMk5oY2k1dFlYSjBhVzVsZWtCellYUXVaMjlpTG0xNE1SMHdHd1lEVlFRSkRCUXpjbUVnWTJWeWNtRmtZU0JrWlNCallXeHBlakVPTUF3R0ExVUVFUXdGTURZek56QXhDekFKQmdOVkJBWVRBazFZTVJrd0Z3WURWUVFJREJCRFNWVkVRVVFnUkVVZ1RVVllTVU5QTVJFd0R3WURWUVFIREFoRFQxbFBRVU5CVGpFUk1BOEdBMVVFTFJNSU1pNDFMalF1TkRVeEpUQWpCZ2txaGtpRzl3MEJDUUlURm5KbGMzQnZibk5oWW14bE9pQkJRMFJOUVMxVFFWUXdIaGNOTWpNd05URTRNVE0xTWpJeldoY05NamN3TlRFNE1UTTFNakl6V2pDQnlERWlNQ0FHQTFVRUF4TVpTa2xOUlU1RldpQkZVMVJTUVVSQklGTkJURUZUSUVFZ1FURWlNQ0FHQTFVRUtSTVpTa2xOUlU1RldpQkZVMVJTUVVSQklGTkJURUZUSUVFZ1FURWlNQ0FHQTFVRUNoTVpTa2xOUlU1RldpQkZVMVJTUVVSQklGTkJURUZUSUVFZ1FURWxNQ01HQTFVRUxSTWNTa1ZUT1RBd01UQTVVVGt3SUM4Z1ZrRkVRVGd3TURreU4wUktNekVlTUJ3R0ExVUVCUk1WSUM4Z1ZrRkVRVGd3TURreU4waFRVbE5TVERBMU1STXdFUVlEVlFRTEV3cFRkV04xY25OaGJDQXlNSUlCSWpBTkJna3Foa2lHOXcwQkFRRUZBQU9DQVE4QU1JSUJDZ0tDQVFFQWlDWHFXZXpCODZMUWF1T1FSMGtDZW93YUNucVJiOXJienBjblNVNW85ZlBuZ1BhYStVNVkwWk1rUmJIL0tPZFh0SXhaZDRaWm1qdjhoMXdVdVk2Z0V5MGNrbnIrVFRTNHErczRPWHJsT1VORm16ZWUvbFNSSnhMVzd6RWRmWE5XTzM2c2x6WXBsTW1tTVdZUXVGczZLSTUxR2VCNlUyZlJGQmRiaG5yNENKWTJUNy8xZm9VOExrd1ROSWFYZTNGdHIzNHQ5U3JEU3BRZVlTVFNLaHVRYWYzUlI1L243ZVBDdUhnb3FHUDhVM1V5VXhTYUtzZE5WdTlXMWJQbk5ZTnFRcmE0aFA4RWFoZ3VUc1NrWnpiYUs5NHFTMkw0b3o0Q2NxRlZ4Q3NqbTBad1d3ZnZIUTVUUEtBbUdCZDhMNG1XN1liNnFQUVptaFU0YVJTR3JNTUdlUUlEQVFBQm94MHdHekFNQmdOVkhSTUJBZjhFQWpBQU1Bc0dBMVVkRHdRRUF3SUd3REFOQmdrcWhraUc5dzBCQVFzRkFBT0NBZ0VBWFZuMTVYQS94bndrdmJXT2tQSEVYSlRsbVl4S252OGVPY3R5YldsT1Q3Tk56cW05S3QxQnUyUHRZUGFLcnZjQllLZXpUMkRBUnNwMkhKTm1VL29HUEZMMmhERnFWYWMrRkx1WWZpV1kxR0JNaU50bk91OUdxaVBvdWFsS3ExVU00ZFVzcHVpcjZjY1JmMzNnbGJpNG04YWw4OVJ6K3ZaU1JTUkw0NGlZV1E0cDN3Nmt4RWsyM01UM1I4ZVFHNHBHRWNIWWZrVWNoaWJUMUJVVWV4M2FsVzF4SDlCdVNUNXpIaDh6aWkrYVdrQ0MvVVAybVRvbUVtTWY0dkpjMHhWdG5vTmI4bER2WU53Q080Wk9EYzBwc3NPOFFhQzRrRW1pU3FPZUd4Z2hPUkdrdnFkMGpvRFoyY25tUThpbGdXSitSQlZRenhueS9oZW0zQVFGelA1Q0dGZ1pRK0k2ZnJNVjk3alp6UGJPcW5MS3lqcmU2RmMrU2pQTitFeGZYTTBGckdNeGVlWE16QnVickQ4VWttRy9PVDVuWkk3dXJxWFZPeXdSWWJRa01WZisxOUJMaXVUWUhjdEJUeGpqUTdITld6NVNTMnFlS3pQdktMNEF2NzgyOGhCc3dlUnBpOCtLVnFueFRvRHpIMEZQTmlZRGV4TGcvUVFLRjlEaDRyeUVZb01jNTRZcGZDM0gvUStHTW1VZU1MZjQzbXYrNGJjU0Z3bktFRHN3WTM4VjRvb09QNHY5SUlLM3o3WVA5K0drNFZ1NCswa1RRckkxS3VJaVJZQ0dFUVBPTFdpNldjWUdVSEhPOUZEejVoVjBjWXNDODFRYldlbFNTcXhhenJyaGI5U25idFlScWxZemRwWStTOWdlY0J4K0pLdkRBckpUeXBnb21NVWVyNDQ9IiBTdWJUb3RhbD0iNDI4Ni45MyIgTW9uZWRhPSJNWE4iIFRpcG9DYW1iaW89IjEiIFRvdGFsPSI0OTcyLjg0IiBUaXBvRGVDb21wcm9iYW50ZT0iSSIgRXhwb3J0YWNpb249IjAxIiBNZXRvZG9QYWdvPSJQUEQiIEx1Z2FyRXhwZWRpY2lvbj0iMDEwMzAiIEZvbGlvPSIzODk0NDAiIHhtbG5zOmNmZGk9Imh0dHA6Ly93d3cuc2F0LmdvYi5teC9jZmQvNCIgeG1sbnM6eHNpPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYS1pbnN0YW5jZSI+PGNmZGk6RW1pc29yIFJmYz0iSkVTOTAwMTA5UTkwIiBOb21icmU9IkpJTUVORVogRVNUUkFEQSBTQUxBUyBBIEEiIFJlZ2ltZW5GaXNjYWw9IjYwMSIgLz48Y2ZkaTpSZWNlcHRvciBSZmM9IkpFUzkwMDEwOVE5MCIgTm9tYnJlPSJKSU1FTkVaIEVTVFJBREEgU0FMQVMgQSBBIiBEb21pY2lsaW9GaXNjYWxSZWNlcHRvcj0iMDEwMzAiIFJlZ2ltZW5GaXNjYWxSZWNlcHRvcj0iNjAxIiBVc29DRkRJPSJHMDMiIC8+PGNmZGk6Q29uY2VwdG9zPjxjZmRpOkNvbmNlcHRvIENsYXZlUHJvZFNlcnY9Ijc4MTgxNTAxIiBDYW50aWRhZD0iMSIgQ2xhdmVVbmlkYWQ9IkU0OCIgVW5pZGFkPSJOL0EiIERlc2NyaXBjaW9uPSJTRVJWSUNJTyBERSBQSU5UVVJBICggUFVFUlRBIERFIE1PVE9SIiBWYWxvclVuaXRhcmlvPSIxOTk0LjY2IiBJbXBvcnRlPSIxOTk0LjY2IiBPYmpldG9JbXA9IjAyIj48Y2ZkaTpJbXB1ZXN0b3M+PGNmZGk6VHJhc2xhZG9zPjxjZmRpOlRyYXNsYWRvIEJhc2U9IjE5OTQuNjYiIEltcHVlc3RvPSIwMDIiIFRpcG9GYWN0b3I9IlRhc2EiIFRhc2FPQ3VvdGE9IjAuMTYwMDAwIiBJbXBvcnRlPSIzMTkuMTQ1NjAwIiAvPjwvY2ZkaTpUcmFzbGFkb3M+PC9jZmRpOkltcHVlc3Rvcz48L2NmZGk6Q29uY2VwdG8+PGNmZGk6Q29uY2VwdG8gQ2xhdmVQcm9kU2Vydj0iNzgxODE1MDEiIENhbnRpZGFkPSIxIiBDbGF2ZVVuaWRhZD0iRTQ4IiBVbmlkYWQ9Ik4vQSIgRGVzY3JpcGNpb249IlNFUlZJQ0lPIERFIFBJTlRVUkEgKCBERUZFTlNBIEMvVSIgVmFsb3JVbml0YXJpbz0iMTk5NC42NiIgSW1wb3J0ZT0iMTk5NC42NiIgT2JqZXRvSW1wPSIwMiI+PGNmZGk6SW1wdWVzdG9zPjxjZmRpOlRyYXNsYWRvcz48Y2ZkaTpUcmFzbGFkbyBCYXNlPSIxOTk0LjY2IiBJbXB1ZXN0bz0iMDAyIiBUaXBvRmFjdG9yPSJUYXNhIiBUYXNhT0N1b3RhPSIwLjE2MDAwMCIgSW1wb3J0ZT0iMzE5LjE0NTYwMCIgLz48L2NmZGk6VHJhc2xhZG9zPjwvY2ZkaTpJbXB1ZXN0b3M+PC9jZmRpOkNvbmNlcHRvPjxjZmRpOkNvbmNlcHRvIENsYXZlUHJvZFNlcnY9Ijc4MTgxNTAxIiBDYW50aWRhZD0iMC4xIiBDbGF2ZVVuaWRhZD0iRTQ4IiBVbmlkYWQ9Ik4vQSIgRGVzY3JpcGNpb249IlBVTElETyBERSBBVVRPQlVTRVMiIFZhbG9yVW5pdGFyaW89IjI5NzYuMDYiIEltcG9ydGU9IjI5Ny42MDYiIE9iamV0b0ltcD0iMDIiPjxjZmRpOkltcHVlc3Rvcz48Y2ZkaTpUcmFzbGFkb3M+PGNmZGk6VHJhc2xhZG8gQmFzZT0iMjk3LjYwNiIgSW1wdWVzdG89IjAwMiIgVGlwb0ZhY3Rvcj0iVGFzYSIgVGFzYU9DdW90YT0iMC4xNjAwMDAiIEltcG9ydGU9IjQ3LjYxNjk2MCIgLz48L2NmZGk6VHJhc2xhZG9zPjwvY2ZkaTpJbXB1ZXN0b3M+PC9jZmRpOkNvbmNlcHRvPjwvY2ZkaTpDb25jZXB0b3M+PGNmZGk6SW1wdWVzdG9zIFRvdGFsSW1wdWVzdG9zVHJhc2xhZGFkb3M9IjY4NS45MSI+PGNmZGk6VHJhc2xhZG9zPjxjZmRpOlRyYXNsYWRvIEJhc2U9IjQyODYuOTMiIEltcHVlc3RvPSIwMDIiIFRpcG9GYWN0b3I9IlRhc2EiIFRhc2FPQ3VvdGE9IjAuMTYwMDAwIiBJbXBvcnRlPSI2ODUuOTEiIC8+PC9jZmRpOlRyYXNsYWRvcz48L2NmZGk6SW1wdWVzdG9zPjxjZmRpOkNvbXBsZW1lbnRvPjx0ZmQ6VGltYnJlRmlzY2FsRGlnaXRhbCB4c2k6c2NoZW1hTG9jYXRpb249Imh0dHA6Ly93d3cuc2F0LmdvYi5teC9UaW1icmVGaXNjYWxEaWdpdGFsIGh0dHA6Ly93d3cuc2F0LmdvYi5teC9zaXRpb19pbnRlcm5ldC9jZmQvVGltYnJlRmlzY2FsRGlnaXRhbC9UaW1icmVGaXNjYWxEaWdpdGFsdjExLnhzZCIgVmVyc2lvbj0iMS4xIiBVVUlEPSIzNDEyMTI0My0wZTEyLTQ3M2EtODM2Ni1lMjM3NjA0NDIxYjYiIEZlY2hhVGltYnJhZG89IjIwMjQtMDktMTJUMTQ6MjE6MzciIFJmY1Byb3ZDZXJ0aWY9IlNQUjE5MDYxM0k1MiIgU2VsbG9DRkQ9ImdlTEZFMld6UGNsMTV1dmNXOG5PZU5MY05ucUVtSGw5SjdURVIzM0EyQW0rMFFRYkFxaVFvMGNCNlNxak9HQmhVUzhGQ1VOd0srZi96bE9FNDVyZFkvNldhd0o5WmdCRUkzckdvTzQ5Vll2YzAvN0RSMFQyS2c2c2JXcGxpNzBRQ1hXV1owK1d4OTRkS1ZOelovcGJKK3libEpmZ29mVjVpd1ZzOUx0NnNzQWhKZlgxZG1JdnpGUkxUV0hwdzBWZkV1UlJZb05ORm1ETXJoaGRiOEZqNVJvOW9NMVJsSkFqbTNEd244enQrQlhsWXhYK0tCbjl2RmtNUDFSTUsxQ2lMRjZUMWlxdlZNNDdUbWxxbHI5RmQxaTFFb2pyRlJSRmU2bnlnZ0hzTis4c3B5ZitwQVlUSGNnSzNvTnZpM3FPK0JWRFpmSjBlc1d3eWFQOHhidUxBQT09IiBOb0NlcnRpZmljYWRvU0FUPSIzMDAwMTAwMDAwMDUwMDAwMzQ1NiIgU2VsbG9TQVQ9ImdkTUZxUk4wYmZneG1PTlFzZXR0bng3L21vMUJDTTFHNWVOWjFkaVZIQUcrSTl5R1ZSYmNqV1dZVC9RMTN1SzYwOU9vand6eWNuZlU0Mll0eU5oYmJZMFNZcnJWaCs5Sm10ZDNHOStEOGRFR1J2YU5hWmMyT1NTWE1BSUhYNGI2Z3FqVWJ5NHZaOUYxaE9uRDRxUCswUmdWZ0d3Nk55LzhnZ2hzZGF4RUhUelVBU2JnNCtrZFdMQks1NE1GcW4vTXdKbHYwbE53KzBnWXJzYmxHS0dZVVU0K09WLzlteUpFUUlIRURNODVQOVdPRjNlZVoxRkdHZVVueHVyRUlHZ1grRGZpdU5iV28vOS9pSEY3czZBRnRtLzJGcy96RUU1Z1gvOGFaTjhTS09WQVVoUkxkc2VOMmE2YWgxcGpaT0NVYVZ4TEVWKzVSdjRCeGd1VVBjdzF3Zz09IiB4bWxuczp0ZmQ9Imh0dHA6Ly93d3cuc2F0LmdvYi5teC9UaW1icmVGaXNjYWxEaWdpdGFsIiAvPjwvY2ZkaTpDb21wbGVtZW50bz48Y2ZkaTpBZGRlbmRhPjxmeDpGYWN0RG9jTVggeHNpOnNjaGVtYUxvY2F0aW9uPSJodHRwOi8vd3d3LmZhY3QuY29tLm14L3NjaGVtYS9meCBodHRwOi8vd3d3Lm15c3VpdGVtZXguY29tL2ZhY3Qvc2NoZW1hL2Z4XzIwMTBfZy54c2QiIHhtbG5zOmZ4PSJodHRwOi8vd3d3LmZhY3QuY29tLm14L3NjaGVtYS9meCI+PGZ4OlZlcnNpb24+ODwvZng6VmVyc2lvbj48Zng6SWRlbnRpZmljYWNpb24+PGZ4OkNkZ1BhaXNFbWlzb3I+TVg8L2Z4OkNkZ1BhaXNFbWlzb3I+PGZ4OlRpcG9EZUNvbXByb2JhbnRlPkZBQ1RVUkE8L2Z4OlRpcG9EZUNvbXByb2JhbnRlPjxmeDpSRkNFbWlzb3I+SkVTOTAwMTA5UTkwPC9meDpSRkNFbWlzb3I+PGZ4OlJhem9uU29jaWFsRW1pc29yPkpJTUVORVogRVNUUkFEQSBTQUxBUyBBIEE8L2Z4OlJhem9uU29jaWFsRW1pc29yPjxmeDpVc3VhcmlvPmNhcmxvc2h6ODA8L2Z4OlVzdWFyaW8+PGZ4OkV4cG9ydGFjaW9uPjAxPC9meDpFeHBvcnRhY2lvbj48Zng6THVnYXJFeHBlZGljaW9uPjAxMDMwPC9meDpMdWdhckV4cGVkaWNpb24+PGZ4OkNhZGVuYU9yaWdpbmFsPnx8MS4xfDM0MTIxMjQzLTBlMTItNDczYS04MzY2LWUyMzc2MDQ0MjFiNnwyMDI0LTA5LTEyVDE0OjIxOjM3fFNQUjE5MDYxM0k1MnxnZUxGRTJXelBjbDE1dXZjVzhuT2VOTGNObnFFbUhsOUo3VEVSMzNBMkFtKzBRUWJBcWlRbzBjQjZTcWpPR0JoVVM4RkNVTndLK2YvemxPRTQ1cmRZLzZXYXdKOVpnQkVJM3JHb080OVZZdmMwLzdEUjBUMktnNnNiV3BsaTcwUUNYV1daMCtXeDk0ZEtWTnpaL3BiSit5YmxKZmdvZlY1aXdWczlMdDZzc0FoSmZYMWRtSXZ6RlJMVFdIcHcwVmZFdVJSWW9OTkZtRE1yaGhkYjhGajVSbzlvTTFSbEpBam0zRHduOHp0K0JYbFl4WCtLQm45dkZrTVAxUk1LMUNpTEY2VDFpcXZWTTQ3VG1scWxyOUZkMWkxRW9qckZSUkZlNm55Z2dIc04rOHNweWYrcEFZVEhjZ0szb052aTNxTytCVkRaZkowZXNXd3lhUDh4YnVMQUE9PXwzMDAwMTAwMDAwMDUwMDAwMzQ1Nnx8PC9meDpDYWRlbmFPcmlnaW5hbD48L2Z4OklkZW50aWZpY2FjaW9uPjxmeDpQcm9jZXNhbWllbnRvPjxmeDpEaWN0aW9uYXJ5IG5hbWU9ImVtYWlsIj48Zng6RW50cnkgaz0iZnJvbSIgdj0iQUNDT1VOVF9PV05FUiIgLz48Zng6RW50cnkgaz0idG8iIHY9ImNhcmxvc2h6ODBAZ21haWwuY29tICwgY2FybG9zaHo4MEBob3RtYWlsLmNvbSAsIGNhcmxvc2h6ODBAeWFob28uY29tLCBjYXJsb3MuaGVybmFuZGV6QG15c3VpdGVtZXguY29tIiAvPjxmeDpFbnRyeSBrPSJjYyIgdj0ibGVvbmVsQGdyZWVubGFrZS5teCIgLz48L2Z4OkRpY3Rpb25hcnk+PC9meDpQcm9jZXNhbWllbnRvPjxmeDpFbWlzb3I+PGZ4OlJlZ2ltZW5GaXNjYWw+PGZ4OlJlZ2ltZW4+NjAxPC9meDpSZWdpbWVuPjwvZng6UmVnaW1lbkZpc2NhbD48L2Z4OkVtaXNvcj48Zng6UmVjZXB0b3I+PGZ4OkNkZ1BhaXNSZWNlcHRvcj5NWDwvZng6Q2RnUGFpc1JlY2VwdG9yPjxmeDpSRkNSZWNlcHRvcj5KRVM5MDAxMDlROTA8L2Z4OlJGQ1JlY2VwdG9yPjxmeDpOb21icmVSZWNlcHRvcj5KSU1FTkVaIEVTVFJBREEgU0FMQVMgQSBBPC9meDpOb21icmVSZWNlcHRvcj48Zng6RG9taWNpbGlvRmlzY2FsUmVjZXB0b3I+MDEwMzA8L2Z4OkRvbWljaWxpb0Zpc2NhbFJlY2VwdG9yPjxmeDpSZWdpbWVuRmlzY2FsUmVjZXB0b3I+NjAxPC9meDpSZWdpbWVuRmlzY2FsUmVjZXB0b3I+PGZ4OlVzb0NGREk+RzAzPC9meDpVc29DRkRJPjwvZng6UmVjZXB0b3I+PGZ4OkNvbmNlcHRvcz48Zng6Q29uY2VwdG8+PGZ4OkNhbnRpZGFkPjE8L2Z4OkNhbnRpZGFkPjxmeDpDbGF2ZVVuaWRhZD5FNDg8L2Z4OkNsYXZlVW5pZGFkPjxmeDpVbmlkYWREZU1lZGlkYT5OL0E8L2Z4OlVuaWRhZERlTWVkaWRhPjxmeDpDbGF2ZVByb2RTZXJ2Pjc4MTgxNTAxPC9meDpDbGF2ZVByb2RTZXJ2PjxmeDpEZXNjcmlwY2lvbj5TRVJWSUNJTyBERSBQSU5UVVJBICggUFVFUlRBIERFIE1PVE9SPC9meDpEZXNjcmlwY2lvbj48Zng6VmFsb3JVbml0YXJpbz4xOTk0LjY2PC9meDpWYWxvclVuaXRhcmlvPjxmeDpJbXBvcnRlPjE5OTQuNjY8L2Z4OkltcG9ydGU+PGZ4Ok9iamV0b0ltcD4wMjwvZng6T2JqZXRvSW1wPjxmeDpJbXB1ZXN0b3NTQVQ+PGZ4OlRyYXNsYWRvcz48Zng6VHJhc2xhZG8gQmFzZT0iMTk5NC42NiIgSW1wdWVzdG89IjAwMiIgVGlwb0ZhY3Rvcj0iVGFzYSIgVGFzYU9DdW90YT0iMC4xNjAwMDAiIEltcG9ydGU9IjMxOS4xNDU2MDAiIC8+PC9meDpUcmFzbGFkb3M+PC9meDpJbXB1ZXN0b3NTQVQ+PGZ4OkNvbmNlcHRvRXg+PGZ4OlByZWNpb0xpc3RhPjE5OTQuNjY8L2Z4OlByZWNpb0xpc3RhPjxmeDpJbXBvcnRlTGlzdGE+MTk5NC42NjwvZng6SW1wb3J0ZUxpc3RhPjxmeDpJbXBvcnRlVG90YWw+MTk5NC42NjwvZng6SW1wb3J0ZVRvdGFsPjwvZng6Q29uY2VwdG9FeD48L2Z4OkNvbmNlcHRvPjxmeDpDb25jZXB0bz48Zng6Q2FudGlkYWQ+MTwvZng6Q2FudGlkYWQ+PGZ4OkNsYXZlVW5pZGFkPkU0ODwvZng6Q2xhdmVVbmlkYWQ+PGZ4OlVuaWRhZERlTWVkaWRhPk4vQTwvZng6VW5pZGFkRGVNZWRpZGE+PGZ4OkNsYXZlUHJvZFNlcnY+NzgxODE1MDE8L2Z4OkNsYXZlUHJvZFNlcnY+PGZ4OkRlc2NyaXBjaW9uPlNFUlZJQ0lPIERFIFBJTlRVUkEgKCBERUZFTlNBIEMvVTwvZng6RGVzY3JpcGNpb24+PGZ4OlZhbG9yVW5pdGFyaW8+MTk5NC42NjwvZng6VmFsb3JVbml0YXJpbz48Zng6SW1wb3J0ZT4xOTk0LjY2PC9meDpJbXBvcnRlPjxmeDpPYmpldG9JbXA+MDI8L2Z4Ok9iamV0b0ltcD48Zng6SW1wdWVzdG9zU0FUPjxmeDpUcmFzbGFkb3M+PGZ4OlRyYXNsYWRvIEJhc2U9IjE5OTQuNjYiIEltcHVlc3RvPSIwMDIiIFRpcG9GYWN0b3I9IlRhc2EiIFRhc2FPQ3VvdGE9IjAuMTYwMDAwIiBJbXBvcnRlPSIzMTkuMTQ1NjAwIiAvPjwvZng6VHJhc2xhZG9zPjwvZng6SW1wdWVzdG9zU0FUPjxmeDpDb25jZXB0b0V4PjxmeDpQcmVjaW9MaXN0YT4xOTk0LjY2PC9meDpQcmVjaW9MaXN0YT48Zng6SW1wb3J0ZUxpc3RhPjE5OTQuNjY8L2Z4OkltcG9ydGVMaXN0YT48Zng6SW1wb3J0ZVRvdGFsPjE5OTQuNjY8L2Z4OkltcG9ydGVUb3RhbD48L2Z4OkNvbmNlcHRvRXg+PC9meDpDb25jZXB0bz48Zng6Q29uY2VwdG8+PGZ4OkNhbnRpZGFkPjAuMTwvZng6Q2FudGlkYWQ+PGZ4OkNsYXZlVW5pZGFkPkU0ODwvZng6Q2xhdmVVbmlkYWQ+PGZ4OlVuaWRhZERlTWVkaWRhPk4vQTwvZng6VW5pZGFkRGVNZWRpZGE+PGZ4OkNsYXZlUHJvZFNlcnY+NzgxODE1MDE8L2Z4OkNsYXZlUHJvZFNlcnY+PGZ4OkRlc2NyaXBjaW9uPlBVTElETyBERSBBVVRPQlVTRVM8L2Z4OkRlc2NyaXBjaW9uPjxmeDpWYWxvclVuaXRhcmlvPjI5NzYuMDY8L2Z4OlZhbG9yVW5pdGFyaW8+PGZ4OkltcG9ydGU+Mjk3LjYwNjwvZng6SW1wb3J0ZT48Zng6T2JqZXRvSW1wPjAyPC9meDpPYmpldG9JbXA+PGZ4OkltcHVlc3Rvc1NBVD48Zng6VHJhc2xhZG9zPjxmeDpUcmFzbGFkbyBCYXNlPSIyOTcuNjA2IiBJbXB1ZXN0bz0iMDAyIiBUaXBvRmFjdG9yPSJUYXNhIiBUYXNhT0N1b3RhPSIwLjE2MDAwMCIgSW1wb3J0ZT0iNDcuNjE2OTYwIiAvPjwvZng6VHJhc2xhZG9zPjwvZng6SW1wdWVzdG9zU0FUPjxmeDpDb25jZXB0b0V4PjxmeDpQcmVjaW9MaXN0YT4yOTc2LjA2PC9meDpQcmVjaW9MaXN0YT48Zng6SW1wb3J0ZUxpc3RhPjI5Ny42MDY8L2Z4OkltcG9ydGVMaXN0YT48Zng6SW1wb3J0ZVRvdGFsPjI5Ny42MDY8L2Z4OkltcG9ydGVUb3RhbD48L2Z4OkNvbmNlcHRvRXg+PC9meDpDb25jZXB0bz48L2Z4OkNvbmNlcHRvcz48Zng6SW1wdWVzdG9zU0FUIFRvdGFsSW1wdWVzdG9zVHJhc2xhZGFkb3M9IjY4NS45MSI+PGZ4OlRyYXNsYWRvcz48Zng6VHJhc2xhZG8gQmFzZT0iNDI4Ni45MyIgSW1wdWVzdG89IjAwMiIgVGlwb0ZhY3Rvcj0iVGFzYSIgVGFzYU9DdW90YT0iMC4xNjAwMDAiIEltcG9ydGU9IjY4NS45MSIgLz48L2Z4OlRyYXNsYWRvcz48L2Z4OkltcHVlc3Rvc1NBVD48Zng6VG90YWxlcz48Zng6TW9uZWRhPk1YTjwvZng6TW9uZWRhPjxmeDpUaXBvRGVDYW1iaW9WZW50YT4xPC9meDpUaXBvRGVDYW1iaW9WZW50YT48Zng6U3ViVG90YWxCcnV0bz40Mjg2LjkzPC9meDpTdWJUb3RhbEJydXRvPjxmeDpTdWJUb3RhbD40Mjg2LjkzPC9meDpTdWJUb3RhbD48Zng6VG90YWw+NDk3Mi44NDwvZng6VG90YWw+PGZ4OlRvdGFsRW5MZXRyYT5DVUFUUk8gTUlMIE5PVkVDSUVOVE9TIFNFVEVOVEEgWSBET1MgUEVTT1MgODQvMTAwCiAgICAgICAgICAgIE0uTi48L2Z4OlRvdGFsRW5MZXRyYT48Zng6Rm9ybWFEZVBhZ28+OTk8L2Z4OkZvcm1hRGVQYWdvPjwvZng6VG90YWxlcz48Zng6Q29tcHJvYmFudGVFeD48Zng6RGF0b3NEZU5lZ29jaW8+PGZ4OlN1Y3Vyc2FsPkZJU0NBTERPTTwvZng6U3VjdXJzYWw+PC9meDpEYXRvc0RlTmVnb2Npbz48Zng6VGVybWlub3NEZVBhZ28+PGZ4Ok1ldG9kb0RlUGFnbz5QUEQ8L2Z4Ok1ldG9kb0RlUGFnbz48L2Z4OlRlcm1pbm9zRGVQYWdvPjxmeDpUZXh0b3NEZVBpZT48Zng6VGV4dG8+QUxGUkVETyBDRVJFWk8gKEQpIEFVVE9Cw5pTIDU5NDYgQVBJLVNJLU9OLTUxMDg8L2Z4OlRleHRvPjwvZng6VGV4dG9zRGVQaWU+PC9meDpDb21wcm9iYW50ZUV4PjwvZng6RmFjdERvY01YPjwvY2ZkaTpBZGRlbmRhPjwvY2ZkaTpDb21wcm9iYW50ZT4=",
"Data2": "",
"Data3": ""
}


7. Ejemplo de response

{
"requestField": {
"requestorField": "00000000-0000-0000-0000-000000000000",
"requestorNameField": null,
"requestorActiveField": true,
"transactionField": 88,
"countryField": "MX",
"entityField": "JES900109Q90",
"userField": "00000000-0000-0000-0000-000000000000",
"userNameField": "MX.JES900109Q90.Jan",
"idField": "234fbfd4-dd06-45dd-ba02-7cb3c59053ff",
"timeStampField": "2026-09-28T11:31:31.4143923-06:00"
},
"responseField": {
"resultField": true,
"timeStampField": "2026-09-28T11:31:32.1364416-06:00",
"lastResultField": "",
"codeField": 1,
"descriptionField": "",
"hintField": "",
"dataField": " 5912 234fbfd4-dd06-45dd-ba02-7cb3c59053ff",
"processorField": "TEST-BACK03",
"identifierField": {
"countryField": "MX",
"entityField": "JES900109Q90",
"fiscalNameField": "JIMENEZ ESTRADA SALAS A A",
"aYearField": "",
"aNumberField": "",
"batchField": "",
"serialField": "389440",
"documentGUIDField": "34121243-0e12-473a-8366-e237604421b6",
"issuedTimeStampField": "2024-09-12T14:21:36",
"enrolledTimeStampField": null,
"paidTimeStampField": null,
"cancelledTimeStampField": null,
"internalIDField": "",
"batchIDField": null,
"batchTimeStampField": null,
"batchRequestorCountryField": null,
"batchRequestorEntityField": null,
"batchPositionField": null,
"receiverCountryField": "MX",
"receiverEntityField": "JES900109Q90",
"receiverTaxIDField": "JES900109Q90",
"receiverNameField": "JIMENEZ ESTRADA SALAS A A",
"claveAgenteField": "",
"numeroDePolizaField": "",
"currencyField": "MXN",
"totalAmountField": "4972.84",
"type1Field": "I",
"type2Field": "",
"suggestedFileNameField": "JES900109Q90__389440_JES900109Q90",
"suggestedFileName2Field": "12092024___389440_",
"observacionesField": "",
"observacionesHtmlField": ""
},
"batchIdentifierField": null
},
"responseDataField": {
"responseData1Field": "1",
"responseData2Field": "0",
"responseData3Field": "Sin observaciones (bien).\n\n",
"responseDataSetField": null
}
}


8. Estructura de respuesta — éxito

El cuerpo de la respuesta es un objeto JSON con tres objetos de primer nivel. Todos los nombres de campo llevan el sufijo Field.

requestField — eco de la petición:

Campo Contenido
requestorField · userField GUID recibidos en la petición
requestorNameField Nombre del solicitante. Puede llegar null
requestorActiveField Booleano. Indica si el solicitante está activo
transactionField Entero, no cadena
countryField · entityField · userNameField Eco de los valores recibidos
idField GUID de la operación en la plataforma. Dato a incluir al reportar incidencias
timeStampField Momento de recepción de la petición, con desplazamiento de zona horaria

responseField — resultado del procesamiento:

Campo Contenido
resultField Booleano. true cuando la validación se ejecutó. No es el veredicto sobre el CFDI, y es el valor que dispara el descuento del folio
codeField Entero. Código de resultado. Ver apartado 10
timeStampField Momento en que concluyó el procesamiento
lastResultField · descriptionField · hintField Vacíos cuando la validación se ejecuta. Ver apartado 9
dataField · processorField Referencia interna del procesamiento y Servidor que atendió la solicitud
identifierField Objeto con los datos que la plataforma extrajo del CFDI validado. Ver desglose siguiente
batchIdentifierField Llega null

responseDataField — resultado de la validación:

Campo Contenido
responseData1Field Cantidad de documentos validados
responseData2Field Cantidad de observaciones encontradas
responseData3Field Descripción de las observaciones encontradas en el CFDI. Es el veredicto de la validación. Llega en texto plano, no en Base64, y puede incluir saltos de línea
responseDataSetField Llega null
resultField no es el veredicto. true con codeField = 1 significa que la plataforma pudo revisar el comprobante y que se descontó el folio. Si el CFDI tiene defectos, eso se expresa en responseData3Field, no en resultField. Un proceso que decida solo por resultField aceptará comprobantes con observaciones.

responseField.identifierField — datos extraídos del comprobante validado:

Campo Contenido
documentGUIDField Folio Fiscal (UUID) del comprobante validado
countryField · entityField · fiscalNameField País, RFC y razón social del emisor del CFDI
batchField · serialField Serie y folio del comprobante
issuedTimeStampField Fecha y hora de emisión
receiverCountryField · receiverEntityField · receiverNameField País, RFC y nombre del receptor
receiverTaxIDField Identificador fiscal del receptor
currencyField · totalAmountField Moneda e importe total del comprobante
type1Field · type2Field type1Field = Tipo de Comprobante SAT; type2Field = Tipo de Comprobante MYSuite
observacionesField · observacionesHtmlField Llegan vacíos en el ejemplo publicado, aunque las observaciones sí viajan en responseData3Field.
suggestedFileNameField · suggestedFileName2Field Nombres sugeridos para guardar el archivo
enrolledTimeStampField · 
paidTimeStampField · 
cancelledTimeStampField · 
batchIDField · 
batchTimeStampField · 
batchRequestorCountryField · 
batchRequestorEntityField · 
batchPositionField
Llegan null: corresponden al ciclo de vida de un comprobante almacenado, y aquí el comprobante no lo está
aYearField · 
aNumberField · 
internalIDField · 
claveAgenteField · 
numeroDePolizaField
Llegan como cadena vacía: son datos del ciclo de emisión propio
Ojo con los nulos. Esta transacción devuelve null en los campos que no aplican, mientras que RETRIEVE_DOCUMENT devuelve cadena vacía en varios de esos mismos campos. Si compartes el modelo de deserialización entre ambas —cosa razonable, porque el objeto es el mismo— declara esos campos como admitidos de nulo o tu integración fallará al validar aunque funcione al recuperar.


9. Estructura de respuesta — error

El cuerpo mantiene los tres objetos del apartado 8. Cambia el contenido de responseField.

Campo Contenido en error
resultField false: la validación no se pudo ejecutar. No se descuenta folio
codeField Código del error. Ver apartado 10
lastResultField Identificador simbólico del error. Es el valor más estable para ramificar tu lógica
descriptionField · hintField Mensaje del error y sugerencia de corrección
processorField Servidor que atendió la solicitud
identifierField Cuando el XML se pudo leer pero la validación no concluyó no muestra información del CFDI
responseData3Field Llega con el motivo de la falla
El error no tiene costo. Los fallos de integración —credenciales incorrectas, Base64 mal formado, JSON inválido— devuelven resultField = false y no descuentan folios. Lo que descuenta es la validación que sí se ejecutó, aunque el comprobante haya salido con observaciones.
Un error de negocio se reporta con resultField = false dentro de un cuerpo JSON válido. Evalúa siempre ese campo 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
Consumo de folios 1 por cada solicitud con resultField = true, con o sin observaciones en el comprobante
Alcance por identidad Ninguna restricción: el emisor y el receptor del CFDI validado pueden ser distintos del Entity solicitante
Efectos sobre el comprobante Ninguno. No emite, no almacena, no cancela y no modifica
Idempotencia No produce efectos fiscales, pero no es gratuita: cada llamada que se ejecuta descuenta un folio. A diferencia de las transacciones de búsqueda, repetir la validación del mismo comprobante sí tiene costo
Tamaño máximo de Data1 1 MB servicio síncrono
Timeout 60 segundos en servidor front
Verificación de estatus ante el SAT No se incluye en esta transacción


12. Versionado y cumplimiento

  • La validación se realiza conforme al Anexo 20 vigente, e indica si el comprobante cumple con lo que dispone la autoridad fiscal.
  • El resultado es una revisión de MYSuite y no sustituye ni equivale a la verificación oficial del SAT. Para el estatus del comprobante ante la autoridad, usa los medios que el SAT dispone.
  • Cuando el SAT publica cambios al Anexo 20, las reglas de esta validación se actualizan del lado de MYSuite sin que tengas que modificar tu integración. 
  • El descuento se aplica sobre el paquete contratado. 

Solución de problemas

"Me responde que todo bien, pero el CFDI tiene errores"


Problema. El proceso acepta comprobantes defectuosos porque interpreta resultField = true como que el CFDI es correcto.

Entorno. CFDI + Timbrado · API REST · VALIDATE_DOCUMENT.

Resolución. Lee el veredicto en responseData3Field, donde se describen las observaciones encontradas. resultField solo te dice si la plataforma pudo revisar el archivo. Tu lógica de aceptación debe basarse en el contenido de ese campo.

Causa. Se aplicó el patrón de las transacciones de emisión, donde resultField sí es el resultado de la operación. En una validación hay dos niveles: si la revisión se hizo, y qué encontró. El descuento del folio sigue al primero, no al segundo.

"Se me están acabando los folios y no he emitido tantas facturas"


Problema. El consumo del paquete no coincide con la cantidad de comprobantes emitidos.

Entorno. CFDI + Timbrado · API REST · integraciones que validan comprobantes de proveedores.

Resolución. Cuenta cuántas validaciones ejecutó tu integración: cada solicitud que devolvió resultField = true descontó un folio, aunque el comprobante haya salido con observaciones. Guarda el resultado de cada validación junto al comprobante para no repetirla, y saca esta transacción de cualquier proceso que la invoque de forma cíclica o preventiva.

Causa. El paquete se descuenta por validación ejecutada. Si además usas RECEIVE, recuerda que esa transacción descuenta medio folio, así que el total mezcla dos tarifas distintas.

"Mi deserializador falla en los campos de fecha"


Problema. El mapeo de la respuesta lanza excepción al leer identifierField, aunque el mismo modelo funciona con RETRIEVE_DOCUMENT.

Entorno. CFDI + Timbrado · API REST · lenguajes con tipado estricto.

Resolución. Esta transacción devuelve null en los campos que no aplican —enrolledTimeStampField, paidTimeStampField, cancelledTimeStampField y los de lote— mientras que la recuperación devuelve cadena vacía en varios de ellos. Declara esos campos como admitidos de nulo en tu modelo compartido.

Causa. El objeto de identificación es el mismo en ambas transacciones, pero el tratamiento de los campos sin valor no está unificado.

"Quiero validar mi archivo antes de timbrarlo y me lo rechaza"


Problema. El intento de validar un XML Nativo de MYSuite falla.

Entorno. CFDI + Timbrado · API REST · integraciones nuevas que buscan una revisión previa a la emisión.

Resolución. Esta transacción valida CFDI ya timbrados, no XML Nativos. Para revisar tu archivo antes de emitir, valídalo localmente contra el esquema fx_2010_g.xsd: no descuenta folios, no requiere llamada al servicio y detecta los errores de estructura y de orden de nodos, que son los más frecuentes.

Causa. Son dos xml's distintos. El XML Nativo es el formato de entrada de MYSuite; el XML del CFDI es el comprobante fiscal que resulta de procesarlo.

"Necesito validar facturas de mis proveedores y creo que no puedo"


Problema. Duda sobre si es posible validar comprobantes en los que el RFC solicitante no es emisor ni receptor.

Entorno. CFDI + Timbrado · API REST · procesos de recepción de facturas.

Resolución. Sí puedes. Se permite validar documentos cuyo emisor y receptor sean distintos del Entity que solicita la transacción. Envía el XML del proveedor sin modificar tus credenciales: el folio se descuenta de tu paquete y el identifierField de la respuesta te devuelve los datos del comprobante ajeno.

Causa. No es un error, es una capacidad poco documentada de la transacción.

"No sé qué significan los números que me devuelve"


Problema. responseData1Field y responseData2Field devuelven valores sin documentación asociada.

Entorno. CFDI + Timbrado · API REST · integraciones que intentan automatizar la decisión.

Resolución. Basa tu lógica en responseData3Field, que es el único campo cuyo significado está documentado. Ten en cuenta además que llegan como cadenas, no como números.

Causa. responseData1Field (número de documentos validados) y responseData2Field (número de observaciones encontradas). Es la brecha más relevante de esta transacción, y se arrastra igual en la modalidad SOAP.

"La validación dice que está bien pero el SAT lo tiene como cancelado"


Problema. Un comprobante que pasó la validación resulta estar cancelado ante la autoridad.

Entorno. CFDI + Timbrado · API REST · procesos de recepción que usan la validación como único control.

Resolución. No es contradictorio: son dos cosas distintas. Esta transacción revisa la conformación del archivo conforme al Anexo 20; el estatus de vigencia o cancelación es información que mantiene el SAT. Si tu proceso necesita ambas certezas, complementa la validación con la verificación de estatus por los medios del SAT.

Causa. Un CFDI puede estar perfectamente conformado y estar cancelado. La estructura y el estado son dimensiones independientes.


Para entender más

Qué significa validar un CFDI

Validar aquí significa revisar la conformación del archivo: que su estructura, sus catálogos, sus importes y su sello correspondan a lo que el Anexo 20 dispone. Es una pregunta sobre el documento, no sobre su historia. Un comprobante puede estar impecablemente conformado y, al mismo tiempo, estar cancelado, no haber sido pagado o pertenecer a un emisor en la lista del artículo 69-B. Conviene tener presente ese límite: la validación responde una pregunta útil, pero solo una.

Por qué la validación descuenta un folio

Revisar un CFDI contra el Anexo 20 implica el mismo trabajo de análisis, verificación de sello y contraste con catálogos que la plataforma hace al emitir. Es una operación de cómputo comparable a un timbrado, y de ahí que se cobre igual. La consecuencia de diseño para quien integra es directa: la validación no es una consulta barata que se pueda poner dentro de un bucle. Guardar el resultado de cada validación junto al comprobante deja de ser una optimización y pasa a ser parte del diseño razonable.

Por qué el cobro se ancla a resultField y no al veredicto

El folio se descuenta cuando la validación se llevó a cabo. Que el comprobante haya salido limpio o con observaciones no cambia nada: en ambos casos MYSuite hizo el trabajo completo de revisarlo, y encontrar defectos es precisamente el servicio que se pidió. Cobrar solo las validaciones limpias castigaría el caso de uso principal, que es detectar comprobantes malos antes de aceptarlos. La contraparte también es coherente: cuando no hubo validación no hay nada que cobrar, así que los tropiezos de la etapa de desarrollo no cuestan folios.

Si vas a resguardar el comprobante, compara antes

RECEIVE hace la misma validación, devuelve el mismo veredicto y además deja el comprobante almacenado, con una tarifa de medio folio frente al folio completo de esta transacción. Si el resguardo centralizado te sirve de algo, conviene revisar cuál de las dos encaja mejor en tu proceso antes de construir sobre ésta.

Por qué puedes validar comprobantes que no son tuyos

El caso de uso central no es revisar lo que emites —eso ya lo revisó MYSuite al timbrarlo— sino revisar lo que recibes. Un área de cuentas por pagar necesita saber si la factura de un proveedor está bien conformada antes de registrarla y deducirla. Por eso la transacción no exige que el Entity solicitante sea parte del comprobante: si lo exigiera, quedaría inútil para su propósito principal. El folio se descuenta a quien pregunta, que es quien obtiene el beneficio de la respuesta.

Por qué el veredicto no viaja en resultField

En una transacción de emisión hay un solo desenlace posible: se timbró o no. En una validación hay dos preguntas encadenadas: si la revisión pudo hacerse, y qué encontró. Colapsarlas en un solo booleano haría imposible distinguir «el servicio falló» de «el comprobante tiene defectos», que son situaciones con respuestas operativas opuestas: en la primera reintentas, en la segunda rechazas la factura. Y como el descuento sigue a resultField, esa separación también determina cuándo se cobra.

En qué se diferencia de validar contra el XSD

Validar localmente contra un esquema comprueba que el XML esté bien formado y que sus elementos aparezcan donde deben. No comprueba el sello, ni que las claves usadas existan en los catálogos del SAT, ni que los importes cuadren. Son controles complementarios y con costos muy distintos: el XSD es gratuito y se ejecuta en tu servidor, la validación completa descuenta un folio y se ejecuta en MYSuite. Lo razonable es usar el XSD sobre tu XML Nativo antes de emitir, y reservar esta transacción para los comprobantes que llegan de fuera.

Por qué el objeto de identificación llega tan vacío

Al validar, MYSuite no consulta su base de datos: lee el archivo que le enviaste. Por eso devuelve lo que el comprobante declara y deja en nulo todo lo que pertenece al ciclo de vida de un documento almacenado, como la fecha de registro, la de pago o la de cancelación. No es que falten datos: es que para un archivo que la plataforma no custodia, esos datos no existen.

Por qué SOAP y REST se documentan por separado

La transacción es la misma operación de negocio en ambos transportes: mismo comprobante, mismas reglas, mismo veredicto. Lo que cambia es 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.


Transacciones del servicio CFDI + Timbrado (API REST)


Vía RequestTransaction


      Emisión
      Consulta y Recuperación
      Validación y Recepción
      CFDI de Retenciones


Vía JsonServiceCall

      Autenticación (obtención de token)
      Emisión
      Consulta y Recuperación
      Esquema de cancelación