Qué hace: hace dos cosas en una sola llamada. Revisa la conformación de un CFDI conforme al Anexo 20 vigente y te devuelve las observaciones encontradas, y además guarda el comprobante en la base de datos de MYSuite, con lo que queda disponible en la sección Consultar Comprobantes Recibidos del portal web y recuperable después con RETRIEVE_DOCUMENT.
Cuándo se usa: en el proceso de recepción de facturas de proveedores, cuando además del veredicto de validación quieres que el comprobante quede resguardado y consultable de forma centralizada, sin depender de que cada área guarde su copia.
Cuándo no usarla: si solo quieres el veredicto y no te interesa almacenar el comprobante, usa VALIDATE_DOCUMENT. Si el comprobante ya fue recibido antes y lo que quieres es el archivo, usa RETRIEVE_DOCUMENT con Store = RECEIVED: recuperar no cuesta folios, recibir sí.
resultField = true se descuenta medio folio de tu paquete vigente: cada dos recepciones exitosas equivalen a 1 folio. Una llamada que devuelve resultField = false no descuenta nada. Tenlo presente antes de planear una carga masiva de facturas históricas.| Si tu integración… | Tu artículo es... |
|---|---|
| Valida un CFDI recibido y lo deja resguardado, enviando un cuerpo JSON por HTTP POST | Este artículo |
Hace lo mismo enviando un sobre SOAP a FactWSFront |
RECEIVE — CFDI + Timbrado (SOAP) |
| Solo necesita el veredicto de validación, sin almacenar | VALIDATE_DOCUMENT — CFDI + Timbrado (API REST) - Request Transaction |
| Necesita el XML o el PDF de un comprobante ya recibido, enviando un cuerpo JSON por HTTP POST | RETRIEVE_DOCUMENT — CFDI + Timbrado (API REST) - Request Transaction con Store = RECEIVED |
| 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 RECEIVE, 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 recepción se ejecutó, no si el CFDI está correcto. Con true ya se descontó el medio folio.responseField = true te permite continuar; responseField = false te lleva a Solución de problemas.responseDataField.responseData3Field: ahí se describen las observaciones encontradas en el comprobante. Este es el veredicto de la validación, y llega en texto plano.responseField.identifierField con la factura que esperabas del proveedor: emisor, 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 |
RECEIVE |
| Naturaleza | Validación más almacenamiento. No emite ni modifica el comprobante, pero sí lo persiste en el almacén de recibidos |
| Consumo | Descuenta 1/2 folio por cada solicitud con resultField = true. Dos recepciones exitosas equivalen a 1 folio. 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. Los comprobantes recibidos en pruebas quedan en el almacén de ese ambiente y no aparecen en el portal productivo.
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: RECEIVE |
Country |
string | Sí | Valor fijo MX |
Abreviatura del país |
Entity |
string | Sí | RFC (12–13 caracteres) | RFC de quien recibe el comprobante y a cuyo paquete de folios se carga el descuento. |
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 |
Entity coincida con el receptor declarado en el CFDI.| Nombre | Tipo | Obligatorio | Límite | Formato | Descripción |
|---|---|---|---|---|---|
Data1 |
string | Sí | 1 MB, que rige en las transacciones síncronas | Base64 | XML del CFDI a recibir, 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 te lo entregó el emisor.
| Contenido | XML del CFDI, incluido su Timbre Fiscal Digital |
|---|---|
| Codificación del archivo | UTF-8, tal como lo emitió el PAC del proveedor |
| Codificación de transporte | Base64, en una sola línea |
| Versiones aceptadas | Las que contenga el 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": "RECEIVE",
"Country": "MX",
"Entity": "JES900109Q90",
"User": "0c320b03-d4f1-47bc-9fb4-77995f9bf33e",
"UserName": "MX.JES900109Q90.Jan",
"Data1": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48Y2ZkaTpDb21wcm9iYW50ZSB4c2k6c2NoZW1hTG9jYXRpb249Imh0dHA6Ly93d3cuc2F0LmdvYi5teC9jZmQvNCBodHRwOi8vd3d3LnNhdC5nb2IubXgvc2l0aW9faW50ZXJuZXQvY2ZkLzQvY2ZkdjQwLnhzZCIgVmVyc2lvbj0iNC4wIiBGZWNoYT0iMjAyNi0wOS0yN1QyMjo1NjozMCIgU2VsbG89Ik1FK2g2U0JpNlhjY0RqSURmSHp1ZEpXMjlmUTg4dGNBZDBhOE13WS9YSjNtREREeGtyU3NSOVBDQlRmU3pjU2tQOGNUWWdUMlg1QlFtM3A3NkVZdHNET3BMdm1zNHFVQ3d3eTloa1pHZjc2Wm1yeGVueEFFdGpUVk9CclFtdGQ1aWZDUjczUTVyNEhuOFhlZ2Q5bmx1TDhBK0dVZWo5Q09FS3gzb21hMGJQRTVXelZMSXBSdFp3eHNsYkxNZWZVNUtPTEk5WGU4YUJVS1dwdXhFRWk1dFJOVWdYUGFKNjhiOU9SV0NYMFNWOHA0Z2FTV09iZFZDZW1IN2RDSmlpZnVZZTBsOGxNTkFMY0ZVVjUrODhmUWxpTll1N0wxdWhFZkViUDNqMm9nbTVSN3pCK1ZTaFIxY1NDa2E0bkM2eXpkNEEwckc0NnRwMXZZeHZ3UFlYQUQ0Zz09IiBGb3JtYVBhZ289Ijk5IiBOb0NlcnRpZmljYWRvPSIzMDAwMTAwMDAwMDUwMDAwMzQzNiIgQ2VydGlmaWNhZG89Ik1JSUZvVENDQTRtZ0F3SUJBZ0lVTXpBd01ERXdNREF3TURBMU1EQXdNRE0wTXpZd0RRWUpLb1pJaHZjTkFRRUxCUUF3Z2dFck1ROHdEUVlEVlFRRERBWkJReUJWUVZReExqQXNCZ05WQkFvTUpWTkZVbFpKUTBsUElFUkZJRUZFVFVsT1NWTlVVa0ZEU1U5T0lGUlNTVUpWVkVGU1NVRXhHakFZQmdOVkJBc01FVk5CVkMxSlJWTWdRWFYwYUc5eWFYUjVNU2d3SmdZSktvWklodmNOQVFrQkZobHZjMk5oY2k1dFlYSjBhVzVsZWtCellYUXVaMjlpTG0xNE1SMHdHd1lEVlFRSkRCUXpjbUVnWTJWeWNtRmtZU0JrWlNCallXeHBlakVPTUF3R0ExVUVFUXdGTURZek56QXhDekFKQmdOVkJBWVRBazFZTVJrd0Z3WURWUVFJREJCRFNWVkVRVVFnUkVVZ1RVVllTVU5QTVJFd0R3WURWUVFIREFoRFQxbFBRVU5CVGpFUk1BOEdBMVVFTFJNSU1pNDFMalF1TkRVeEpUQWpCZ2txaGtpRzl3MEJDUUlURm5KbGMzQnZibk5oWW14bE9pQkJRMFJOUVMxVFFWUXdIaGNOTWpNd05URTRNVEkxTVRRM1doY05NamN3TlRFNE1USTFNVFEzV2pDQnlERWlNQ0FHQTFVRUF4TVpTa2xOUlU1RldpQkZVMVJTUVVSQklGTkJURUZUSUVFZ1FURWlNQ0FHQTFVRUtSTVpTa2xOUlU1RldpQkZVMVJTUVVSQklGTkJURUZUSUVFZ1FURWlNQ0FHQTFVRUNoTVpTa2xOUlU1RldpQkZVMVJTUVVSQklGTkJURUZUSUVFZ1FURWxNQ01HQTFVRUxSTWNTa1ZUT1RBd01UQTVVVGt3SUM4Z1ZrRkVRVGd3TURreU4wUktNekVlTUJ3R0ExVUVCUk1WSUM4Z1ZrRkVRVGd3TURreU4waFRVbE5TVERBMU1STXdFUVlEVlFRTEV3cFRkV04xY25OaGJDQXhNSUlCSWpBTkJna3Foa2lHOXcwQkFRRUZBQU9DQVE4QU1JSUJDZ0tDQVFFQXFzVmRERjdXcHdNYzN6Q0RkSkhyMnVxSEJHNUNQbFYxZ3N6YXAzeFFaY3gyaCtiZitneEFOSlk4YU5kMlJhWVh6VkNvL1NRbHczTi9WWkY5Z2FEa29mN0RKQ3QwVWRaSEZWbzZGSW9Zb1I0eXV5V2JoYzBvdGwxS1pzUWErTkRveURQSGYyRklSWUh6clpmaDFrUElHMVNVeGRVUmdPZWlXeWIrUUpXZjh5c2YyQllIemk1bjJrVEtpcll3L2ZtcDN4YURxQldFWFpvaVhYWXp3cTRTN2xTVzM2MURTNVNLSHZXYktVcUNmbkNOc3BSSWgyMmNET043TXQyUVBtQ0M0NGdhMTVYaHFURm1JTUpQMGZEV2RGN3hGcnFQVkEyTEVjdFdNNlR3V0E3L1RpazcrTnlibklwTnp4bkRYczBJZUFick5ycTJUNEVBc1FlMVZjdWNNUUlEQVFBQm94MHdHekFNQmdOVkhSTUJBZjhFQWpBQU1Bc0dBMVVkRHdRRUF3SUd3REFOQmdrcWhraUc5dzBCQVFzRkFBT0NBZ0VBR1FqaWdXWlIrSVczMFZhRlNNVjJhUVAxcnU2OEFoUnpianpoWk1NNWkvVFpMS1NXOVdzaHFwd0VTQXdUOEJjWWNTdWdtTVBXSzQ5OWQ2QTdNaUhOWFJRUGZYMzBGNS8wZHptVW1EaEtjNTR1dFMvcjAzQ2pLd09RYmdEMFRnQjBkRHVSZDYrOXd1a1R4bUZmWWRmUTBuMGdUaGVEREhuaHRvemxPYXMydTNXWFNiYWZOdW5qek92Yk9YR1hreHZIK3l3S0prMG1CMjNjbmVVWGw4dnArVGJkMmRoY2U2S0oyUytyYXgwNDNualoxaWJoRFZKTDJnaksyMDJpOC80a2lUSHpob0pwM2dPV2NsZ1U0b2NZR0wzanlRTDNBMTh3WVBTRVQxcHRTaEN3K1dRYjZpTHRwSDROOXZDWVFZN0djRjRjK1NRYnVoSUZpR1JLRm5NVjIwallDQlRjTXVyYVlzZklrU0VaRVpmV0xpc2FsU3lodWU3NXFwM29tWm1JQjc2QlEzakpRUUdaUlUwbzVNMjdJa2xxU2pMMHE5MnZLajlUbnpRWFpTVkxEUTlKSzg5WXFwRGFsdHVGbUo1cHBMOTlBa3h4NzZ3bWs2bDdENXJCTldQMjhrN3RSc29DYTNMU0FCZUV4U2RJNDRCZDU4LzAxU3RORkRkR1ZPQ1hXaEt2OTg0TVhRaVJBZFM3dFZ0RjBzTSt6MjcrVHlnZHFlQ3FodC9NenlnbEdoMHlWU2draGJXbjhyRjNYczdmRGFWU2c3bE1qOGxjdjhVVEtWUnhMUWh6aGRoS2wybmluYVA3Z3V5UHZURzhxUnNOeks5dC9yR3plSkhIRDliT0FHdDhNN3VzdFY1eDlaRDNjVkVhZVFLUWhTZS83Wm5TTTE3VTFuZVQrL0E9IiBTdWJUb3RhbD0iMjAwMC4wMCIgTW9uZWRhPSJNWE4iIFRpcG9DYW1iaW89IjEiIFRvdGFsPSIyMzIwLjAwIiBUaXBvRGVDb21wcm9iYW50ZT0iSSIgRXhwb3J0YWNpb249IjAxIiBNZXRvZG9QYWdvPSJQUEQiIEx1Z2FyRXhwZWRpY2lvbj0iMDEwMzAiIFNlcmllPSJBQkIiIEZvbGlvPSIxMzg4NCIgeG1sbnM6Y2ZkaT0iaHR0cDovL3d3dy5zYXQuZ29iLm14L2NmZC80IiB4bWxuczp4c2k9Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvWE1MU2NoZW1hLWluc3RhbmNlIj48Y2ZkaTpFbWlzb3IgUmZjPSJKRVM5MDAxMDlROTAiIE5vbWJyZT0iSklNRU5FWiBFU1RSQURBIFNBTEFTIEEgQSIgUmVnaW1lbkZpc2NhbD0iNjAxIiAvPjxjZmRpOlJlY2VwdG9yIFJmYz0iSkVTOTAwMTA5UTkwIiBOb21icmU9IkpJTUVORVogRVNUUkFEQSBTQUxBUyBBIEEiIERvbWljaWxpb0Zpc2NhbFJlY2VwdG9yPSIwMTAzMCIgUmVnaW1lbkZpc2NhbFJlY2VwdG9yPSI2MDEiIFVzb0NGREk9IkcwMyIgLz48Y2ZkaTpDb25jZXB0b3M+PGNmZGk6Q29uY2VwdG8gQ2xhdmVQcm9kU2Vydj0iMDEwMTAxMDEiIENhbnRpZGFkPSIxIiBDbGF2ZVVuaWRhZD0iRTQ4IiBVbmlkYWQ9Ik5vIGFwbGljYSIgRGVzY3JpcGNpb249Ikhvbm9yYXJpb3MuIiBWYWxvclVuaXRhcmlvPSIyMDAwLjAwIiBJbXBvcnRlPSIyMDAwLjAwIiBPYmpldG9JbXA9IjAyIj48Y2ZkaTpJbXB1ZXN0b3M+PGNmZGk6VHJhc2xhZG9zPjxjZmRpOlRyYXNsYWRvIEJhc2U9IjIwMDAuMDAiIEltcHVlc3RvPSIwMDIiIFRpcG9GYWN0b3I9IlRhc2EiIFRhc2FPQ3VvdGE9IjAuMTYwMDAwIiBJbXBvcnRlPSIzMjAuMDAiIC8+PC9jZmRpOlRyYXNsYWRvcz48L2NmZGk6SW1wdWVzdG9zPjwvY2ZkaTpDb25jZXB0bz48L2NmZGk6Q29uY2VwdG9zPjxjZmRpOkltcHVlc3RvcyBUb3RhbEltcHVlc3Rvc1RyYXNsYWRhZG9zPSIzMjAuMDAiPjxjZmRpOlRyYXNsYWRvcz48Y2ZkaTpUcmFzbGFkbyBCYXNlPSIyMDAwLjAwIiBJbXB1ZXN0bz0iMDAyIiBUaXBvRmFjdG9yPSJUYXNhIiBUYXNhT0N1b3RhPSIwLjE2MDAwMCIgSW1wb3J0ZT0iMzIwLjAwIiAvPjwvY2ZkaTpUcmFzbGFkb3M+PC9jZmRpOkltcHVlc3Rvcz48Y2ZkaTpDb21wbGVtZW50bz48dGZkOlRpbWJyZUZpc2NhbERpZ2l0YWwgeHNpOnNjaGVtYUxvY2F0aW9uPSJodHRwOi8vd3d3LnNhdC5nb2IubXgvVGltYnJlRmlzY2FsRGlnaXRhbCBodHRwOi8vd3d3LnNhdC5nb2IubXgvc2l0aW9faW50ZXJuZXQvY2ZkL1RpbWJyZUZpc2NhbERpZ2l0YWwvVGltYnJlRmlzY2FsRGlnaXRhbHYxMS54c2QiIFZlcnNpb249IjEuMSIgVVVJRD0iNzcxM2Y4ZWMtOTEwMy00ZmE4LWI4YjYtYmRmNzA0YmFiMmFiIiBGZWNoYVRpbWJyYWRvPSIyMDI2LTA5LTI3VDIyOjU2OjMxIiBSZmNQcm92Q2VydGlmPSJTUFIxOTA2MTNJNTIiIFNlbGxvQ0ZEPSJNRStoNlNCaTZYY2NEaklEZkh6dWRKVzI5ZlE4OHRjQWQwYThNd1kvWEozbURERHhrclNzUjlQQ0JUZlN6Y1NrUDhjVFlnVDJYNUJRbTNwNzZFWXRzRE9wTHZtczRxVUN3d3k5aGtaR2Y3NlptcnhlbnhBRXRqVFZPQnJRbXRkNWlmQ1I3M1E1cjRIbjhYZWdkOW5sdUw4QStHVWVqOUNPRUt4M29tYTBiUEU1V3pWTElwUnRad3hzbGJMTWVmVTVLT0xJOVhlOGFCVUtXcHV4RUVpNXRSTlVnWFBhSjY4YjlPUldDWDBTVjhwNGdhU1dPYmRWQ2VtSDdkQ0ppaWZ1WWUwbDhsTU5BTGNGVVY1Kzg4ZlFsaU5ZdTdMMXVoRWZFYlAzajJvZ201Ujd6QitWU2hSMWNTQ2thNG5DNnl6ZDRBMHJHNDZ0cDF2WXh2d1BZWEFENGc9PSIgTm9DZXJ0aWZpY2Fkb1NBVD0iMzAwMDEwMDAwMDA1MDAwMDM0NTYiIFNlbGxvU0FUPSJSTm93UWp6czg4dVV6bERsTE1HVTh2V1FPSVNNa29kSmdhcjc5MkVZUEVLZmtMTDNGQkpyYnhpUTdkKzBjbnpDNGJCeEkydWVrenFDYkY3bGVmdDI3YkEyUjREaFZ2ekpHMklua0xIM2VVd1BIcGJCNW5MaisyUUFUUjZWL2JsZDhzYTExN1FzTFhaZU9JZlAza0drM2RmSy9UbXF6eVg1NzNlckZ3UDNHZlN2cldqN1U1d2loTGtjMCtaekJVdFFLTlZDaFhSR28yanM1clVaUWM3Z3Y2Ymd3MDBpdWRBVTFkbzkyYVlRcnhzN0NTWkxIV0szeVJaOGNYV0ZiUU1SWXhEQnNjTGhXTDdPaTRyaGFZSkJTSHIvODJYd0wvc21jTm42a1MyTGFDeUZkVnZRbS9nbDRJQ3kzWEdadWwrdkMrbVA1YjA5bWVVZGlRb2VnREFjb2c9PSIgeG1sbnM6dGZkPSJodHRwOi8vd3d3LnNhdC5nb2IubXgvVGltYnJlRmlzY2FsRGlnaXRhbCIgLz48L2NmZGk6Q29tcGxlbWVudG8+PGNmZGk6QWRkZW5kYT48Zng6RmFjdERvY01YIHhzaTpzY2hlbWFMb2NhdGlvbj0iaHR0cDovL3d3dy5mYWN0LmNvbS5teC9zY2hlbWEvZnggICBodHRwOi8vd3d3Lm15c3VpdGVtZXguY29tL2ZhY3Qvc2NoZW1hL2Z4XzIwMTBfZy54c2QiIHhtbG5zOmZ4PSJodHRwOi8vd3d3LmZhY3QuY29tLm14L3NjaGVtYS9meCI+PGZ4OlZlcnNpb24+ODwvZng6VmVyc2lvbj48Zng6SWRlbnRpZmljYWNpb24+PGZ4OkNkZ1BhaXNFbWlzb3I+TVg8L2Z4OkNkZ1BhaXNFbWlzb3I+PGZ4OlRpcG9EZUNvbXByb2JhbnRlPkZBQ1RVUkE8L2Z4OlRpcG9EZUNvbXByb2JhbnRlPjxmeDpSRkNFbWlzb3I+SkVTOTAwMTA5UTkwPC9meDpSRkNFbWlzb3I+PGZ4OlJhem9uU29jaWFsRW1pc29yPkpJTUVORVogRVNUUkFEQSBTQUxBUyBBIEE8L2Z4OlJhem9uU29jaWFsRW1pc29yPjxmeDpVc3VhcmlvPkNBTERFUk9OPC9meDpVc3VhcmlvPjxmeDpOdW1lcm9JbnRlcm5vPkFaVUwtVElNQi1ERU1PLTAwMDgtSDU3MzM0NjwvZng6TnVtZXJvSW50ZXJubz48Zng6RXhwb3J0YWNpb24+MDE8L2Z4OkV4cG9ydGFjaW9uPjxmeDpMdWdhckV4cGVkaWNpb24+MDEwMzA8L2Z4Okx1Z2FyRXhwZWRpY2lvbj48Zng6Q2FkZW5hT3JpZ2luYWw+fHwxLjF8NzcxM2Y4ZWMtOTEwMy00ZmE4LWI4YjYtYmRmNzA0YmFiMmFifDIwMjYtMDktMjdUMjI6NTY6MzF8U1BSMTkwNjEzSTUyfE1FK2g2U0JpNlhjY0RqSURmSHp1ZEpXMjlmUTg4dGNBZDBhOE13WS9YSjNtREREeGtyU3NSOVBDQlRmU3pjU2tQOGNUWWdUMlg1QlFtM3A3NkVZdHNET3BMdm1zNHFVQ3d3eTloa1pHZjc2Wm1yeGVueEFFdGpUVk9CclFtdGQ1aWZDUjczUTVyNEhuOFhlZ2Q5bmx1TDhBK0dVZWo5Q09FS3gzb21hMGJQRTVXelZMSXBSdFp3eHNsYkxNZWZVNUtPTEk5WGU4YUJVS1dwdXhFRWk1dFJOVWdYUGFKNjhiOU9SV0NYMFNWOHA0Z2FTV09iZFZDZW1IN2RDSmlpZnVZZTBsOGxNTkFMY0ZVVjUrODhmUWxpTll1N0wxdWhFZkViUDNqMm9nbTVSN3pCK1ZTaFIxY1NDa2E0bkM2eXpkNEEwckc0NnRwMXZZeHZ3UFlYQUQ0Zz09fDMwMDAxMDAwMDAwNTAwMDAzNDU2fHw8L2Z4OkNhZGVuYU9yaWdpbmFsPjwvZng6SWRlbnRpZmljYWNpb24+PGZ4OkVtaXNvcj48Zng6RG9taWNpbGlvRmlzY2FsPjxmeDpDYWxsZT5Bdi4gSW5zdXJnZW50ZXMgU3VyIDEyMzQ8L2Z4OkNhbGxlPjxmeDpDb2xvbmlhPkRlbCBWYWxsZTwvZng6Q29sb25pYT48Zng6TXVuaWNpcGlvPkJlbml0byBKdcOhcmV6PC9meDpNdW5pY2lwaW8+PGZ4OkVzdGFkbz5DaXVkYWQgZGUgTcOpeGljbzwvZng6RXN0YWRvPjxmeDpQYWlzPk1FWElDTzwvZng6UGFpcz48Zng6Q29kaWdvUG9zdGFsPjAxMDMwPC9meDpDb2RpZ29Qb3N0YWw+PC9meDpEb21pY2lsaW9GaXNjYWw+PGZ4OlJlZ2ltZW5GaXNjYWw+PGZ4OlJlZ2ltZW4+NjAxPC9meDpSZWdpbWVuPjwvZng6UmVnaW1lbkZpc2NhbD48L2Z4OkVtaXNvcj48Zng6UmVjZXB0b3I+PGZ4OkNkZ1BhaXNSZWNlcHRvcj5NWDwvZng6Q2RnUGFpc1JlY2VwdG9yPjxmeDpSRkNSZWNlcHRvcj5KRVM5MDAxMDlROTA8L2Z4OlJGQ1JlY2VwdG9yPjxmeDpOb21icmVSZWNlcHRvcj5KSU1FTkVaIEVTVFJBREEgU0FMQVMgQSBBPC9meDpOb21icmVSZWNlcHRvcj48Zng6RG9taWNpbGlvRmlzY2FsUmVjZXB0b3I+MDEwMzA8L2Z4OkRvbWljaWxpb0Zpc2NhbFJlY2VwdG9yPjxmeDpSZWdpbWVuRmlzY2FsUmVjZXB0b3I+NjAxPC9meDpSZWdpbWVuRmlzY2FsUmVjZXB0b3I+PGZ4OlVzb0NGREk+RzAzPC9meDpVc29DRkRJPjwvZng6UmVjZXB0b3I+PGZ4OkNvbmNlcHRvcz48Zng6Q29uY2VwdG8+PGZ4OkNhbnRpZGFkPjE8L2Z4OkNhbnRpZGFkPjxmeDpDbGF2ZVVuaWRhZD5FNDg8L2Z4OkNsYXZlVW5pZGFkPjxmeDpVbmlkYWREZU1lZGlkYT5ObyBhcGxpY2E8L2Z4OlVuaWRhZERlTWVkaWRhPjxmeDpDbGF2ZVByb2RTZXJ2PjAxMDEwMTAxPC9meDpDbGF2ZVByb2RTZXJ2PjxmeDpEZXNjcmlwY2lvbj5Ib25vcmFyaW9zLjwvZng6RGVzY3JpcGNpb24+PGZ4OlZhbG9yVW5pdGFyaW8+MjAwMC4wMDwvZng6VmFsb3JVbml0YXJpbz48Zng6SW1wb3J0ZT4yMDAwLjAwPC9meDpJbXBvcnRlPjxmeDpPYmpldG9JbXA+MDI8L2Z4Ok9iamV0b0ltcD48Zng6SW1wdWVzdG9zU0FUPjxmeDpUcmFzbGFkb3M+PGZ4OlRyYXNsYWRvIEJhc2U9IjIwMDAuMDAiIEltcHVlc3RvPSIwMDIiIFRpcG9GYWN0b3I9IlRhc2EiIFRhc2FPQ3VvdGE9IjAuMTYwMDAwIiBJbXBvcnRlPSIzMjAuMDAiIC8+PC9meDpUcmFzbGFkb3M+PC9meDpJbXB1ZXN0b3NTQVQ+PGZ4OkNvbmNlcHRvRXg+PGZ4OlByZWNpb0xpc3RhPjIwMDAuMDA8L2Z4OlByZWNpb0xpc3RhPjxmeDpJbXBvcnRlTGlzdGE+MjAwMC4wMDwvZng6SW1wb3J0ZUxpc3RhPjxmeDpJbXBvcnRlVG90YWw+MjAwMC4wMDwvZng6SW1wb3J0ZVRvdGFsPjwvZng6Q29uY2VwdG9FeD48L2Z4OkNvbmNlcHRvPjwvZng6Q29uY2VwdG9zPjxmeDpJbXB1ZXN0b3NTQVQgVG90YWxJbXB1ZXN0b3NUcmFzbGFkYWRvcz0iMzIwLjAwIj48Zng6VHJhc2xhZG9zPjxmeDpUcmFzbGFkbyBCYXNlPSIyMDAwLjAwIiBJbXB1ZXN0bz0iMDAyIiBUaXBvRmFjdG9yPSJUYXNhIiBUYXNhT0N1b3RhPSIwLjE2MDAwMCIgSW1wb3J0ZT0iMzIwLjAwIiAvPjwvZng6VHJhc2xhZG9zPjwvZng6SW1wdWVzdG9zU0FUPjxmeDpUb3RhbGVzPjxmeDpNb25lZGE+TVhOPC9meDpNb25lZGE+PGZ4OlRpcG9EZUNhbWJpb1ZlbnRhPjE8L2Z4OlRpcG9EZUNhbWJpb1ZlbnRhPjxmeDpTdWJUb3RhbEJydXRvPjIwMDAuMDA8L2Z4OlN1YlRvdGFsQnJ1dG8+PGZ4OlN1YlRvdGFsPjIwMDAuMDA8L2Z4OlN1YlRvdGFsPjxmeDpUb3RhbD4yMzIwLjAwPC9meDpUb3RhbD48Zng6VG90YWxFbkxldHJhPkRPUyBNSUwgVFJFU0NJRU5UT1MgVkVJTlRFIFBFU09TIDAwLzEwMCBNLk4uPC9meDpUb3RhbEVuTGV0cmE+PGZ4OkZvcm1hRGVQYWdvPjk5PC9meDpGb3JtYURlUGFnbz48L2Z4OlRvdGFsZXM+PGZ4OkNvbXByb2JhbnRlRXg+PGZ4OkRhdG9zRGVOZWdvY2lvPjxmeDpTdWN1cnNhbD5BQkI8L2Z4OlN1Y3Vyc2FsPjwvZng6RGF0b3NEZU5lZ29jaW8+PGZ4OlRlcm1pbm9zRGVQYWdvPjxmeDpNZXRvZG9EZVBhZ28+UFBEPC9meDpNZXRvZG9EZVBhZ28+PC9meDpUZXJtaW5vc0RlUGFnbz48Zng6VGV4dG9zRGVDYWJlY2VyYT48Zng6VGV4dG8+Q29tZXJjaWFsaXphZG9yYSBBenRlY2EsIFMuQS4gZGUgQy5WLiBbUE9MLUFaVUwtREVNTy0wMDA4XSBbQVotREVNTy0wMDA4XTwvZng6VGV4dG8+PC9meDpUZXh0b3NEZUNhYmVjZXJhPjwvZng6Q29tcHJvYmFudGVFeD48L2Z4OkZhY3REb2NNWD48L2NmZGk6QWRkZW5kYT48L2NmZGk6Q29tcHJvYmFudGU+",
"Data2": "",
"Data3": ""
}
VALIDATE_DOCUMENT. La única diferencia está en el valor de Transaction, y de ese valor depende que el comprobante se almacene o solo se revise.{
"requestField": {
"requestorField": "00000000-0000-0000-0000-000000000000",
"requestorNameField": null,
"requestorActiveField": true,
"transactionField": 31,
"countryField": "MX",
"entityField": "JES900109Q90",
"userField": "00000000-0000-0000-0000-000000000000",
"userNameField": "MX.JES900109Q90.Jan",
"idField": "d202d663-4e5a-490e-ae8f-480b472675c3",
"timeStampField": "2026-09-29T11:55:56.4578582-06:00"
},
"responseField": {
"resultField": true,
"timeStampField": "2026-09-29T11:55:56.8309207-06:00",
"lastResultField": "",
"codeField": 1,
"descriptionField": "",
"hintField": "",
"dataField": " 6457 d202d663-4e5a-490e-ae8f-480b472675c3",
"processorField": "TEST-BACK03",
"identifierField": {
"countryField": "MX",
"entityField": "JES900109Q90",
"fiscalNameField": "JIMENEZ ESTRADA SALAS A A",
"aYearField": "",
"aNumberField": "",
"batchField": "ABB",
"serialField": "13884",
"documentGUIDField": "7713f8ec-9103-4fa8-b8b6-bdf704bab2ab",
"issuedTimeStampField": "2026-09-27T22:56:30",
"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": "2320.00",
"type1Field": "I",
"type2Field": "",
"suggestedFileNameField": "JES900109Q90_ABB_13884_JES900109Q90",
"suggestedFileName2Field": "27092026___ABB13884_",
"observacionesField": "",
"observacionesHtmlField": ""
},
"batchIdentifierField": {
"batchIdField": null,
"batchTimeStampField": null,
"batchRequestorCountryField": null,
"batchRequestorEntityField": null,
"batchPositionField": 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 recepción se ejecutó. No es el veredicto sobre el CFDI, y es el valor que dispara el descuento del medio folio |
codeField |
Entero. Código de resultado. Ver apartado 10 |
timeStampField |
Momento en que concluyó el procesamiento |
lastResultField · descriptionField · hintField |
Vacíos cuando la recepció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 recibido. Ver desglose siguiente |
batchIdentifierField |
Objeto presente con todos sus campos en null en recepción individual. |
responseDataField — resultado de la validación:
| Campo | Contenido |
|---|---|
responseData1Field |
Cantidad de documentos procesados |
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. resultField = true con codeField = 1 significa que la plataforma procesó el comprobante y se descontó el medio folio. Si el CFDI tiene defectos, eso se expresa en responseData3Field. Un proceso que decida solo por resultField aceptará facturas con observaciones.responseField.identifierField — datos extraídos del comprobante recibido:
| Campo | Contenido |
|---|---|
documentGUIDField |
Folio Fiscal (UUID) del comprobante recibido. Llave para recuperarlo después con RETRIEVE_DOCUMENT |
countryField · entityField · fiscalNameField |
País, RFC y razón social del emisor del CFDI, es decir tu proveedor |
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 documento SAT; type2Field = Tipo de documento 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 y los campos de lote
|
Llegan null |
aYearField · aNumberField · internalIDField ·claveAgenteField · numeroDePolizaField |
Llegan como cadena vacía: son datos del ciclo de emisión propio, y aquí el emisor es un tercero |
batchIdentifierField llega aquí como un objeto con sus campos en null, en VALIDATE_DOCUMENT llega como null completo, y en RETRIEVE_DOCUMENT varios campos del identifier llegan como cadena vacía. Si compartes el modelo de deserialización entre transacciones —cosa razonable, porque el objeto es el mismo— declara todo lo opcional como admitido de nulo y no supongas que un campo ausente y un campo vacío son lo mismo.Tras una recepción exitosa, el comprobante queda disponible en la sección Consultar Comprobantes Recibidos del portal web de MYSuite.
El cuerpo mantiene los tres objetos del apartado 8. Cambia el contenido de responseField.
| Campo | Contenido en error |
|---|---|
resultField |
false: la recepción no se ejecutó. No se descuenta folio y el comprobante no queda almacenado |
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 · dataField ·hintField |
Mensaje del error y sugerencia de corrección |
processorField |
Servidor que atendió la solicitud |
identifierField |
No se entrega información relevante |
responseData3Field |
Mensaje del error |
resultField = false y no descuentan folios. Lo que descuenta es la recepción que sí se ejecutó.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.Dos que conviene tener presentes en este flujo son 3175 DUPLICATE_ON_RECEPTION y 3172 RECEIVE_EX_FAILED.
| Aspecto | Valor |
|---|---|
| Comprobantes por llamada | Uno |
| Consumo de folios | 1/2 folio por cada solicitud con resultField = true. Dos recepciones exitosas equivalen a 1 folio |
| Efecto sobre el almacenamiento | El comprobante se persiste en el almacén de recibidos del Entity y queda consultable en el portal y recuperable con RETRIEVE_DOCUMENT |
| Efectos fiscales | Ninguno. Recibir en MYSuite es un acto administrativo, no fiscal: no timbra, no cancela y no notifica al SAT |
| Idempotencia | Al enviar dos veces el mismo CFDI obtendrás código de error y no se descuenta otro medio folio |
Tamaño máximo de Data1 |
1 MB en servicio síncrono |
| Timeout | 60 segundos en servidor front |
| Concurrencia y cuotas | «pendiente: Desarrollo — relevante en la carga inicial de un histórico de facturas de proveedores, donde esta transacción se invoca en ciclo» |
| Retención del almacenamiento | Año actual y 5 años hacía atrás |
| Verificación de estatus ante el SAT | La recepción no incluye consulta del estado de cancelación ante el SAT |
VALIDATE_DOCUMENT.VALIDATE_DOCUMENT (1 folio) y RECEIVE (1/2 folio)Problema. El consumo del paquete de folios crece sin relación con los comprobantes emitidos.
Entorno. CFDI + Timbrado · API REST · procesos de recepción de facturas de proveedores.
Resolución. Cada recepción con resultField = true descuenta medio folio: veinte recepciones exitosas son diez folios. Cuenta las llamadas ejecutadas, no las facturas distintas, y revisa si tu proceso está recibiendo el mismo comprobante más de una vez. Antes de una carga inicial de histórico, calcula el consumo y valídalo con tu ejecutivo.
Causa. El artículo del portal para API REST sí menciona el consumo.
Problema. El proceso acepta facturas defectuosas porque interpreta resultField = true como que el CFDI es correcto.
Entorno. CFDI + Timbrado · API REST · RECEIVE.
Resolución. Lee el veredicto en responseData3Field. resultField solo te dice si la plataforma procesó el archivo. Tu lógica de aceptación de facturas debe basarse en ese otro campo.
Causa. En una recepción hay dos niveles: si el procesamiento se hizo, y qué encontró la validación. El descuento del medio folio sigue al primero, no al segundo.
Problema. El flujo llama primero a VALIDATE_DOCUMENT para decidir y después a RECEIVE para resguardar el mismo comprobante.
Entorno. CFDI + Timbrado · API REST · procesos de recepción diseñados por etapas.
Resolución. Llama solo a RECEIVE: hace la misma validación, devuelve el mismo veredicto en responseData3Field, deja el comprobante almacenado. Encadenar las dos sobre el mismo CFDI paga la validación dos veces, y genera una tarifa más alta.
Causa. Diseño del flujo que separa validar de archivar.
Problema. Un reproceso o un reintento envía a recibir un comprobante que ya se había recibido.
Entorno. CFDI + Timbrado · API REST · cargas masivas de histórico, o procesos con reintento automático.
Resolución. Lleva un registro propio de los Folios Fiscales que ya recibiste y consúltalo antes de llamar. Si necesitas confirmar si un comprobante ya está en el almacén, usa RETRIEVE_DOCUMENT con Store = RECEIVED, que no descuenta folios, en lugar de reenviarlo a recepción.
Problema. El modelo que funciona con otras transacciones de la modalidad lanza excepción aquí.
Entorno. CFDI + Timbrado · API REST · lenguajes con tipado estricto.
Resolución. Los campos sin valor no se expresan igual en todas las transacciones. Aquí batchIdentifierField llega como un objeto con sus campos en nulo; en VALIDATE_DOCUMENT llega como nulo completo; en RETRIEVE_DOCUMENT varios campos del identifier llegan como cadena vacía. Declara todo lo opcional como admitido de nulo en el modelo que compartas.
Causa. El objeto de identificación es común a varias transacciones, pero el tratamiento de lo vacío no está unificado.
Problema. El comprobante no aparece en Consultar Comprobantes Recibidos después de una recepción exitosa.
Entorno. CFDI + Timbrado · API REST · verificación posterior a la recepción.
Resolución. Verifica que estés consultando el portal del mismo ambiente en que ejecutaste la transacción, y con el RFC que usaste como Entity: el comprobante queda en el almacén de ese receptor. Si coincide todo, intenta recuperarlo con RETRIEVE_DOCUMENT usando Store = RECEIVED y el Folio Fiscal.
Problema. Duda sobre cuál de las dos transacciones usar en un proceso que solo necesita el veredicto.
Entorno. CFDI + Timbrado · API REST · validación previa a la aceptación de una factura.
Resolución. Usa VALIDATE_DOCUMENT, que revisa sin almacenar. Ten presente que su tarifa es de un folio por solicitud frente al medio folio de RECEIVE, así que conviene revisar si el resguardo centralizado te sirve de algo antes de descartarlo.
Causa. No es un error: son dos transacciones con alcances y tarifas distintas para escenarios parecidos.
La validación responde una pregunta y se olvida del comprobante. La recepción responde la misma pregunta y además deja el archivo guardado en la base de datos de MYSuite, donde queda consultable desde el portal y recuperable por servicio web. El cambio no es técnico sino operativo: convierte una revisión puntual en un buzón de facturas recibidas, con una copia centralizada que no depende de que cada área guarde la suya ni de que el correo del proveedor siga existiendo.
El almacén RECEIVED que consulta RETRIEVE_DOCUMENT no se llena por sí solo: se llena con esta transacción. Las dos forman un par. RECEIVE deposita, RETRIEVE_DOCUMENT extrae. Si un comprobante recibido no aparece al intentar recuperarlo, la primera pregunta es si alguna vez se ejecutó una recepción sobre él.
VALIDATE_DOCUMENT descuenta un folio completo por solicitud exitosa; ésta descuenta medio, y hace estrictamente más: la misma validación más el almacenamiento. Visto desde la integración la conclusión es directa: si el resguardo no te estorba, la recepción es la opción más conveniente en las dos dimensiones que importan, alcance y costo.
Es un acto administrativo, no fiscal. No hay notificación al SAT, no cambia el estatus del comprobante y no implica aceptación ni conformidad con la factura: para tu proveedor y para la autoridad, nada ocurre. Lo que ocurre es del lado de tu propia operación: el comprobante entra a tu buzón, queda validado y queda accesible. La decisión de pagar, rechazar o reclamar sigue siendo tuya y vive en tu ERP.
Como receptor, la obligación de conservar los CFDI que amparan tus deducciones es tuya. Que MYSuite los guarde te da consulta centralizada y recuperación cómoda, pero te ata a una política de retención que no controlas y a la disponibilidad de un tercero en el momento en que la autoridad te pida los archivos. Lo razonable es guardar el XML en tu propio repositorio y usar el almacén de MYSuite como respaldo de consulta, no como archivo único.
resultFieldHay dos preguntas encadenadas: si el procesamiento pudo hacerse, y qué encontró la validación. Colapsarlas en un booleano haría imposible distinguir «el servicio falló» de «la factura tiene defectos», que piden respuestas opuestas: en la primera reintentas, en la segunda rechazas la factura ante el proveedor. Y como el descuento sigue a resultField, esa separación también determina cuándo se cobra.
Si un comprobante con observaciones se almacena o no cambia por completo el significado del buzón de recibidos. Si se almacena todo, el buzón es un registro de lo que llegó y la calidad de cada comprobante es información aparte. Si solo se almacena lo limpio, el buzón es un registro de lo aceptado y resultField = true deja de garantizar el resguardo. Son dos modelos mentales distintos y conducen a integraciones distintas.
La transacción es la misma operación de negocio en ambos transportes: mismo comprobante, mismas reglas, mismo veredicto y mismo almacenamiento. 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