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.
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.| 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 |
Requestor y Entity.Transaction con valor VALIDATE_DOCUMENT, la cadena Base64 en Data1, Data2 y Data3 como cadenas vacías.POST al recurso /RequestTransaction con Content-Type: application/json.responseField.resultField. Indica si la validación pudo ejecutarse, no si el CFDI es correcto. Con true ya se descontó el folio.resultField = true te permite continuar; resultField = false te lleva a Solución de problemas.responseDataField.responseData3Field: ahí se describen las observaciones encontradas en el CFDI. Este es el veredicto de la validación, y llega en texto plano.responseField.identifierField con lo que tu sistema esperaba del comprobante: emisor, receptor, serie, folio, Folio Fiscal, moneda e importe.Si algo falla, ve a Solución de problemas.
| 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 |
| 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.
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 |
| 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 |
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 |
Sin estructura. Ambos se envían como cadena vacía.
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": ""
}{
"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
}
}
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 |
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.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 |
resultField = false y no descuentan folios. Lo que descuenta es la validación que sí se ejecutó, aunque el comprobante haya salido con observaciones.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. | 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 |
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.
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.
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.
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.
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.
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.
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.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.
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.
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.
resultField y no al veredictoEl 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.
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.
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.
resultFieldEn 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.
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.
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.
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.
Vía RequestTransaction