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

RECEIVE — 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: 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í.


Esta transacción consume folios. Por cada solicitud que devuelve 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.
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...
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


Requisitos previos

  • Credenciales de integración vigentes que te proporciona MYSuite: Requestor y Entity.
  • Un paquete de folios vigente con saldo disponible.
  • El XML del CFDI que quieres recibir, ya timbrado. No el XML Nativo.
  • Un control propio de qué comprobantes ya recibiste, para no enviar el mismo dos veces y pagar de más.
  • Capacidad de tu ERP para codificar en Base64.


Cómo hacerlo

  1. Obtén el XML del CFDI que te emitió el proveedor.
    Resultado: el archivo XML del comprobante timbrado, en UTF-8.
  2. Verifica en tu propio registro que ese comprobante no haya sido recibido antes, usando su Folio Fiscal como llave.
    Resultado: certeza de que no vas a pagar dos veces por el mismo comprobante.
  3. Confirma que tu paquete de folios tiene saldo, contando media unidad por cada recepción exitosa.
    Resultado: certeza de que la recepción se va a ejecutar y a qué costo.
  4. Codifica el contenido completo del XML en Base64, sin saltos de línea intermedios.
    Resultado: una cadena Base64 en una sola línea.
  5. Arma el cuerpo JSON con los nueve campos: las credenciales, Transaction con valor RECEIVE, la cadena Base64 en Data1, Data2 y Data3 como cadenas vacías.
    Resultado: un JSON válido con los nueve campos presentes.
  6. 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.
  7. Lee responseField.resultField. Indica si la recepción se ejecutó, no si el CFDI está correcto. Con true ya se descontó el medio folio.
    Resultado: responseField = true te permite continuar; responseField = false te lleva a Solución de problemas.
  8. Lee responseDataField.responseData3Field: ahí se describen las observaciones encontradas en el comprobante. 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.
  9. Concilia los datos de responseField.identifierField con la factura que esperabas del proveedor: emisor, serie, folio, Folio Fiscal, moneda e importe.
    Resultado: verificación de que el comprobante recibido es el que corresponde.
  10. Decide en tu proceso qué hacer con el resultado: aceptar la factura, rechazarla ante el proveedor o escalarla para revisión manual según las observaciones recibidas.
    Resultado: factura clasificada dentro de tu flujo de cuentas por pagar.
  11. Registra el Folio Fiscal como recibido en tu sistema, junto con el veredicto y el consumo aplicado.
    Resultado: comprobante trazable, recuperable con RETRIEVE_DOCUMENT y sin riesgo de doble recepción.

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


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. Los comprobantes recibidos en pruebas quedan en el almacén de ese ambiente y no aparecen en el portal productivo.


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


Como aquí el comprobante se almacena, la plataforma exige que el Entity coincida con el receptor declarado en el CFDI.


4. Parámetros de entrada

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


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

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": "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": ""
}
Idea
El cuerpo es idéntico al de 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.


7. Ejemplo de response

{
"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
}
}

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 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.
¿se almacena el comprobante cuando la validación encuentra observaciones? Si se almacena, el buzón de recibidos puede contener comprobantes defectuosos. 

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
Tres formas distintas de decir «sin valor». En esta modalidad conviven las tres: 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.


Visualización en el portal web

Tras una recepción exitosa, el comprobante queda disponible en la sección Consultar Comprobantes Recibidos del portal web de MYSuite.



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 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
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 recepción que sí se ejecutó.
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

Dos que conviene tener presentes en este flujo son 3175 DUPLICATE_ON_RECEPTION y 3172 RECEIVE_EX_FAILED.


11. Límites y comportamiento


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


12. Versionado y cumplimiento

  • La validación se realiza conforme al Anexo 20 vigente, con las mismas reglas que VALIDATE_DOCUMENT.
  • El resultado es una revisión de MYSuite y no sustituye ni equivale a la verificación oficial del SAT.
  • El resguardo en MYSuite no sustituye tu obligación de conservación como receptor. Es una conveniencia operativa que te da consulta centralizada, no el resguardo legal.
  • El descuento se aplica sobre el paquete vigente. 
  • Relación de tarifas entre VALIDATE_DOCUMENT (1 folio) y RECEIVE (1/2 folio)


Solución de problemas

"Creía que recibir facturas era gratis"


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.

"Me responde que todo bien, pero la factura del proveedor tiene errores"


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.

"Valido con una transacción y guardo con otra, y estoy pagando dos veces"


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.

"Mandé la misma factura dos veces"


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.

Causa. El control de duplicados debe estar en tu sistema.

"Mi deserializador falla al mapear la respuesta"


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.

"La recepción salió bien pero no veo el comprobante en el portal"


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.

Causa. Lo más común es consultar el ambiente equivocado.

"Solo quiero revisar la factura, no guardarla"


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.


Para entender más

Qué agrega la recepción sobre la validación

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.

Cómo se relaciona con RETRIEVE_DOCUMENT

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.

Por qué conviene comparar el costo antes de elegir

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.

Qué significa «recibir» un CFDI en MYSuite

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.

Por qué el resguardo no sustituye tu conservación

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.

Por qué el veredicto no viaja en resultField

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

La duda de diseño que conviene cerrar antes de construir

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.

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


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