RECEIVE — SERVICIO CFDI + Timbrado (SOAP)

RECEIVE — SERVICIO CFDI + Timbrado (SOAP)

Estado Transacción: Vigente · Compatibilidad: XML Nativo (FactDocMX) v8 · Última revisión: 21/08/2026 · Próxima revisión:  21/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 la transacción 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í.


Warning
Esta transacción consume folios. Por cada solicitud que devuelve Result = true se descuenta medio folio de tu paquete vigente: cada dos recepciones exitosas equivalen a 1 folio. Una llamada que devuelve Result = false no descuenta nada.

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


Cómo saber si este es tu artículo

Si tu integración… Tu artículo es...
Necesita validar un CFDI de un proveedor y dejarlo resguardado en MYSuite, por SOAP Este artículo
Solo necesita el veredicto de validación, sin almacenar VALIDATE_DOCUMENT — CFDI + Timbrado (SOAP)
Necesita el XML o el PDF de un comprobante ya recibido RETRIEVE_DOCUMENT con Store = RECEIVED
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 CONVERT_NATIVE_XML — CFDI + Timbrado (SOAP)


Requisitos previos

  • Credenciales de integración vigentes que te proporciona MYSuite: Requestor y Entity.
  • Un paquete de folios disponibles (vigente).
  • 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.
  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 sobre SOAP con las credenciales, Transaction con valor RECEIVE, la cadena Base64 en Data1. Data2 y Data3 vacíos.
    Resultado: petición lista.
  6. Envía la petición al web service del ambiente que corresponda.
    Resultado: respuesta HTTP 200 con un sobre RequestTransactionResponse.
  7. Lee el elemento Result. Indica si la recepción se ejecutó, no si el CFDI está correcto. Con true ya se descontó el medio folio.
    Resultado: Result = true te permite continuar; Result = false te lleva a Solución de problemas.
  8. Lee ResponseData3: ahí se describen las observaciones encontradas en el comprobante. Este es el veredicto de la validación.
    Resultado: la lista de observaciones, o la constancia de que no hay ninguna.
  9. Concilia los datos del nodo Identifier 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 SOAP 1.1 / 1.2 sobre HTTPS
Servicio FactWSFront
Operación RequestTransaction
Namespace http://www.fact.com.mx/schema/ws
SOAPAction http://www.fact.com.mx/schema/ws/RequestTransaction
Valor <Transaction> 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 Result = true. Dos recepciones exitosas equivalen a 1 folio de tu paquete vigente. Con Result = false no hay descuento

2. Ambientes

Ambiente URL
Pruebas https://www.mysuitetest.com/mx.com.fact.wsfront/FactWSFront.asmx
Producción https://www.mysuitecfdi.com/mx.com.fact.wsfront/FactWSFront.asmx
Idea
El RFC solicitante en pruebas 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 en cada petición.

Campo Tipo Obligatorio Formato Descripción
Requestor GUID Sí GUID Dato que proporciona MYSuite, está ligado a la seguridad de la transacción, a la autenticación y autorización para aceptar solicitudes.
Country string Sí Valor fijo MX Código de país de la operación
Entity string Sí RFC (12–13 caracteres) RFC de quien recibe el comprobante y a cuyo paquete de folios se carga el descuento. Determina en qué almacén de recibidos queda el CFDI
User GUID Sí GUID Identificador del usuario de la integración, colocar el valor del Requestor proporcionado por MYSuite
UserName string Sí País.RFC.usuario Nombre de usuario. Ejemplo: MX.JES900109Q90.jan


Info
A diferencia de la transacción VALIDATE_DOCUMENT, aquí el comprobante sí se almacena. La plataforma exige que el Entity solicitante 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 Base64 XML del CFDI a recibir, codificado en Base64. Es el comprobante timbrado, no el XML Nativo
Data2 string No — Vacío Sin uso en esta transacción. El nodo debe existir y enviarse vacío
Data3 string No — Vacío Sin uso en esta transacción. El nodo debe existir y enviarse vacío


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

Data1 — 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
Complementos Todos

Data2 y Data3

Sin estructura. Ambos se envían vacíos.


6. Ejemplo de request

<?xml version="1.0" encoding="utf-8"?><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.fact.com.mx/schema/ws">
<soapenv:Header/>
<soapenv:Body>
<ws:RequestTransaction>
<ws:Requestor>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</ws:Requestor>
<ws:Transaction>RECEIVE</ws:Transaction>
<ws:Country>MX</ws:Country>
<ws:Entity>JES900109Q90</ws:Entity>
<ws:User>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</ws:User>
<ws:UserName>MX.JES900109Q90.jacinto</ws:UserName>
<ws:Data1>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPGNmZGk6Q29tcHJvYmFudGUKICAgIHhzaTpzY2hlbWFMb2NhdGlvbj0iaHR0cDovL3d3dy5zYXQuZ29iLm14L2NmZC80IGh0dHA6Ly93d3cuc2F0LmdvYi5teC9zaXRpb19pbnRlcm5ldC9jZmQvNC9jZmR2NDAueHNkIgogICAgVmVyc2lvbj0iNC4wIiBTZXJpZT0iQSIgRm9saW89IkNVU1RJTlZDMTI3IiBGZWNoYT0iMjAyMy0wNy0wNVQxNjoxMzoyNyIKICAgIFNlbGxvPSJDN2h4R0FWTDJBeE9DSEkvRDcyWUZJMjVvbXNOWTY5QU1Nb2pFdkd0bi9oMGU1MU5UL2VsUFVDQnFxSDdZdTIrNi9SaldVRitSNS93Rnc5WDZZNDFXSitURUlXRXBBUXRCN21uaWVWb1B1a3BLTkZ3cjBhS0lCMHNoV05sYzJYYjRYL29uemk0cjZlS1pVdVFwdkZ0SlJldTBRVHppdWlUck1Dd0l2SzlFSzl1Rm4xem9iaDBCV0VicHdROURReDRvTVhRSGQxa2poRFM4MXBZT2RxWGRLd3BjeEZ3bVFudjV1c1JLcEhlZS9YYmUvVDJyTE1NQjdpMHZjSXhLUHNQSEV0bk1OYmIyUzVKbmc1emZRdHdLMEx1bzhva2pKaU1BbElubkR5UlhHSnFuencxa3VNUHRjeksyUlNET25XRFc1NmZEZWJsaldpY3J1SDdPanVZd0E9PSIKICAgIEZvcm1hUGFnbz0iMDMiIE5vQ2VydGlmaWNhZG89IjMwMDAxMDAwMDAwNTAwMDAzNDQ0IgogICAgQ2VydGlmaWNhZG89Ik1JSUZvVENDQTRtZ0F3SUJBZ0lVTXpBd01ERXdNREF3TURBMU1EQXdNRE0wTkRRd0RRWUpLb1pJaHZjTkFRRUxCUUF3Z2dFck1ROHdEUVlEVlFRRERBWkJReUJWUVZReExqQXNCZ05WQkFvTUpWTkZVbFpKUTBsUElFUkZJRUZFVFVsT1NWTlVVa0ZEU1U5T0lGUlNTVUpWVkVGU1NVRXhHakFZQmdOVkJBc01FVk5CVkMxSlJWTWdRWFYwYUc5eWFYUjVNU2d3SmdZSktvWklodmNOQVFrQkZobHZjMk5oY2k1dFlYSjBhVzVsZWtCellYUXVaMjlpTG0xNE1SMHdHd1lEVlFRSkRCUXpjbUVnWTJWeWNtRmtZU0JrWlNCallXeHBlakVPTUF3R0ExVUVFUXdGTURZek56QXhDekFKQmdOVkJBWVRBazFZTVJrd0Z3WURWUVFJREJCRFNWVkVRVVFnUkVVZ1RVVllTVU5QTVJFd0R3WURWUVFIREFoRFQxbFBRVU5CVGpFUk1BOEdBMVVFTFJNSU1pNDFMalF1TkRVeEpUQWpCZ2txaGtpRzl3MEJDUUlURm5KbGMzQnZibk5oWW14bE9pQkJRMFJOUVMxVFFWUXdIaGNOTWpNd05URTRNVE0xTWpJeldoY05NamN3TlRFNE1UTTFNakl6V2pDQnlERWlNQ0FHQTFVRUF4TVpTa2xOUlU1RldpQkZVMVJTUVVSQklGTkJURUZUSUVFZ1FURWlNQ0FHQTFVRUtSTVpTa2xOUlU1RldpQkZVMVJTUVVSQklGTkJURUZUSUVFZ1FURWlNQ0FHQTFVRUNoTVpTa2xOUlU1RldpQkZVMVJTUVVSQklGTkJURUZUSUVFZ1FURWxNQ01HQTFVRUxSTWNTa1ZUT1RBd01UQTVVVGt3SUM4Z1ZrRkVRVGd3TURreU4wUktNekVlTUJ3R0ExVUVCUk1WSUM4Z1ZrRkVRVGd3TURreU4waFRVbE5TVERBMU1STXdFUVlEVlFRTEV3cFRkV04xY25OaGJDQXlNSUlCSWpBTkJna3Foa2lHOXcwQkFRRUZBQU9DQVE4QU1JSUJDZ0tDQVFFQWlDWHFXZXpCODZMUWF1T1FSMGtDZW93YUNucVJiOXJienBjblNVNW85ZlBuZ1BhYStVNVkwWk1rUmJIL0tPZFh0SXhaZDRaWm1qdjhoMXdVdVk2Z0V5MGNrbnIrVFRTNHErczRPWHJsT1VORm16ZWUvbFNSSnhMVzd6RWRmWE5XTzM2c2x6WXBsTW1tTVdZUXVGczZLSTUxR2VCNlUyZlJGQmRiaG5yNENKWTJUNy8xZm9VOExrd1ROSWFYZTNGdHIzNHQ5U3JEU3BRZVlTVFNLaHVRYWYzUlI1L243ZVBDdUhnb3FHUDhVM1V5VXhTYUtzZE5WdTlXMWJQbk5ZTnFRcmE0aFA4RWFoZ3VUc1NrWnpiYUs5NHFTMkw0b3o0Q2NxRlZ4Q3NqbTBad1d3ZnZIUTVUUEtBbUdCZDhMNG1XN1liNnFQUVptaFU0YVJTR3JNTUdlUUlEQVFBQm94MHdHekFNQmdOVkhSTUJBZjhFQWpBQU1Bc0dBMVVkRHdRRUF3SUd3REFOQmdrcWhraUc5dzBCQVFzRkFBT0NBZ0VBWFZuMTVYQS94bndrdmJXT2tQSEVYSlRsbVl4S252OGVPY3R5YldsT1Q3Tk56cW05S3QxQnUyUHRZUGFLcnZjQllLZXpUMkRBUnNwMkhKTm1VL29HUEZMMmhERnFWYWMrRkx1WWZpV1kxR0JNaU50bk91OUdxaVBvdWFsS3ExVU00ZFVzcHVpcjZjY1JmMzNnbGJpNG04YWw4OVJ6K3ZaU1JTUkw0NGlZV1E0cDN3Nmt4RWsyM01UM1I4ZVFHNHBHRWNIWWZrVWNoaWJUMUJVVWV4M2FsVzF4SDlCdVNUNXpIaDh6aWkrYVdrQ0MvVVAybVRvbUVtTWY0dkpjMHhWdG5vTmI4bER2WU53Q080Wk9EYzBwc3NPOFFhQzRrRW1pU3FPZUd4Z2hPUkdrdnFkMGpvRFoyY25tUThpbGdXSitSQlZRenhueS9oZW0zQVFGelA1Q0dGZ1pRK0k2ZnJNVjk3alp6UGJPcW5MS3lqcmU2RmMrU2pQTitFeGZYTTBGckdNeGVlWE16QnVickQ4VWttRy9PVDVuWkk3dXJxWFZPeXdSWWJRa01WZisxOUJMaXVUWUhjdEJUeGpqUTdITld6NVNTMnFlS3pQdktMNEF2NzgyOGhCc3dlUnBpOCtLVnFueFRvRHpIMEZQTmlZRGV4TGcvUVFLRjlEaDRyeUVZb01jNTRZcGZDM0gvUStHTW1VZU1MZjQzbXYrNGJjU0Z3bktFRHN3WTM4VjRvb09QNHY5SUlLM3o3WVA5K0drNFZ1NCswa1RRckkxS3VJaVJZQ0dFUVBPTFdpNldjWUdVSEhPOUZEejVoVjBjWXNDODFRYldlbFNTcXhhenJyaGI5U25idFlScWxZemRwWStTOWdlY0J4K0pLdkRBckpUeXBnb21NVWVyNDQ9IgogICAgQ29uZGljaW9uZXNEZVBhZ289IjMwIGRpYXMiIFN1YlRvdGFsPSIxMDAwMC4wMCIgRGVzY3VlbnRvPSIwLjAwIiBNb25lZGE9Ik1YTiIgVGlwb0NhbWJpbz0iMSIKICAgIFRvdGFsPSIxMTYwMC4wMCIgVGlwb0RlQ29tcHJvYmFudGU9IkkiIEV4cG9ydGFjaW9uPSIwMSIgTWV0b2RvUGFnbz0iUFVFIiBMdWdhckV4cGVkaWNpb249IjAxMDMwIgogICAgeG1sbnM6Y2ZkaT0iaHR0cDovL3d3dy5zYXQuZ29iLm14L2NmZC80IiB4bWxuczp4c2k9Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvWE1MU2NoZW1hLWluc3RhbmNlIj4KICAgIDxjZmRpOkVtaXNvciBSZmM9IkpFUzkwMDEwOVE5MCIgTm9tYnJlPSJKSU1FTkVaIEVTVFJBREEgU0FMQVMgQSBBIiBSZWdpbWVuRmlzY2FsPSI2MDEiLz4KICAgIDxjZmRpOlJlY2VwdG9yIFJmYz0iSkVTOTAwMTA5UTkwIiBOb21icmU9Ik9QRVJBRE9SQSBERSBDSVVEQUQgSlVBUkVaIgogICAgICAgIERvbWljaWxpb0Zpc2NhbFJlY2VwdG9yPSIwMTAzMCIgUmVnaW1lbkZpc2NhbFJlY2VwdG9yPSI2MTYiIFVzb0NGREk9IlMwMSIvPgogICAgPGNmZGk6Q29uY2VwdG9zPgogICAgICAgIDxjZmRpOkNvbmNlcHRvIENsYXZlUHJvZFNlcnY9Ijg0MTExNTA2IiBOb0lkZW50aWZpY2FjaW9uPSJBbnRpY2lwbyBkZSBjbGllbnRlIgogICAgICAgICAgICBDYW50aWRhZD0iMS4wMDAwMDAiIENsYXZlVW5pZGFkPSJFNDgiIFVuaWRhZD0iU2VydiIKICAgICAgICAgICAgRGVzY3JpcGNpb249IiYjeEE7ICAgICAgICAgICAgICAgICAgICAmcXVvdDsmcXVvdDsmI3hBOyAgICAgICAgICAgICAgICAgICAgICAgICYjeEE7ICAgICAgICAgICAgICAgICIKICAgICAgICAgICAgVmFsb3JVbml0YXJpbz0iMTAwMDAuMDAiIEltcG9ydGU9IjEwMDAwLjAwIiBEZXNjdWVudG89IjAuMDAiIE9iamV0b0ltcD0iMDIiPgogICAgICAgICAgICA8Y2ZkaTpJbXB1ZXN0b3M+CiAgICAgICAgICAgICAgICA8Y2ZkaTpUcmFzbGFkb3M+CiAgICAgICAgICAgICAgICAgICAgPGNmZGk6VHJhc2xhZG8gQmFzZT0iMTAwMDAuMDAiIEltcHVlc3RvPSIwMDIiIFRpcG9GYWN0b3I9IlRhc2EiCiAgICAgICAgICAgICAgICAgICAgICAgIFRhc2FPQ3VvdGE9IjAuMTYwMDAwIiBJbXBvcnRlPSIxNjAwLjAwIi8+CiAgICAgICAgICAgICAgICA8L2NmZGk6VHJhc2xhZG9zPgogICAgICAgICAgICA8L2NmZGk6SW1wdWVzdG9zPgogICAgICAgIDwvY2ZkaTpDb25jZXB0bz4KICAgIDwvY2ZkaTpDb25jZXB0b3M+CiAgICA8Y2ZkaTpJbXB1ZXN0b3MgVG90YWxJbXB1ZXN0b3NUcmFzbGFkYWRvcz0iMTYwMC4wMCI+CiAgICAgICAgPGNmZGk6VHJhc2xhZG9zPgogICAgICAgICAgICA8Y2ZkaTpUcmFzbGFkbyBCYXNlPSIxMDAwMC4wMCIgSW1wdWVzdG89IjAwMiIgVGlwb0ZhY3Rvcj0iVGFzYSIgVGFzYU9DdW90YT0iMC4xNjAwMDAiCiAgICAgICAgICAgICAgICBJbXBvcnRlPSIxNjAwLjAwIi8+CiAgICAgICAgPC9jZmRpOlRyYXNsYWRvcz4KICAgIDwvY2ZkaTpJbXB1ZXN0b3M+CiAgICA8Y2ZkaTpDb21wbGVtZW50bz4KICAgICAgICA8dGZkOlRpbWJyZUZpc2NhbERpZ2l0YWwKICAgICAgICAgICAgeHNpOnNjaGVtYUxvY2F0aW9uPSJodHRwOi8vd3d3LnNhdC5nb2IubXgvVGltYnJlRmlzY2FsRGlnaXRhbCBodHRwOi8vd3d3LnNhdC5nb2IubXgvc2l0aW9faW50ZXJuZXQvY2ZkL1RpbWJyZUZpc2NhbERpZ2l0YWwvVGltYnJlRmlzY2FsRGlnaXRhbHYxMS54c2QiCiAgICAgICAgICAgIFZlcnNpb249IjEuMSIgVVVJRD0iZjJlNGE1ZTQtMjczNS00ODA4LWE5NTUtYWJhOTAwM2NkNzllIgogICAgICAgICAgICBGZWNoYVRpbWJyYWRvPSIyMDIzLTA3LTA1VDE2OjEzOjI4IiBSZmNQcm92Q2VydGlmPSJTUFIxOTA2MTNJNTIiCiAgICAgICAgICAgIFNlbGxvQ0ZEPSJDN2h4R0FWTDJBeE9DSEkvRDcyWUZJMjVvbXNOWTY5QU1Nb2pFdkd0bi9oMGU1MU5UL2VsUFVDQnFxSDdZdTIrNi9SaldVRitSNS93Rnc5WDZZNDFXSitURUlXRXBBUXRCN21uaWVWb1B1a3BLTkZ3cjBhS0lCMHNoV05sYzJYYjRYL29uemk0cjZlS1pVdVFwdkZ0SlJldTBRVHppdWlUck1Dd0l2SzlFSzl1Rm4xem9iaDBCV0VicHdROURReDRvTVhRSGQxa2poRFM4MXBZT2RxWGRLd3BjeEZ3bVFudjV1c1JLcEhlZS9YYmUvVDJyTE1NQjdpMHZjSXhLUHNQSEV0bk1OYmIyUzVKbmc1emZRdHdLMEx1bzhva2pKaU1BbElubkR5UlhHSnFuencxa3VNUHRjeksyUlNET25XRFc1NmZEZWJsaldpY3J1SDdPanVZd0E9PSIKICAgICAgICAgICAgTm9DZXJ0aWZpY2Fkb1NBVD0iMzAwMDEwMDAwMDA1MDAwMDM0NTYiCiAgICAgICAgICAgIFNlbGxvU0FUPSJQTW1vczl2VzJnL2p2N0Fpci9HeUNlTFJURzZIU0F5ZXZwNnZsMzRQaVhOSmY5dDBHRnROZGJpRmpKT0hMV0Q1WmRxSkp0K045ZEpXTHlZWGhxVzlBL3ZkSjJkMW1KeHhIeUhkVVdYamVoQms2NXY5MlgyN0hhRzB6RzdpZzNyOEJxeEV6SGNqcUZVRk9aOVd1a3cyTU1DYS9RTnM3UC9WcUdiTHozdFZMeHJvMnVvd0JFVFU4R2VsN0F3NmpuU2NsUnE1RWJxN1R6ZDJGdWIxcEFMT0loOVJ0UkJaZm5iM1pwcWE4SWY0RnYwVkxSSlNpcWNvN0hqWi9zdGVoL2p0NWlJYVVYenFYRTdYZ2RqbHNKNklWL0k1bzkwbFNVSThwbkRxeWVoRlFOQnJQYjA1cHVDT0NFTlVVUnFQbzFZRXdpMWorUjNKMlRuYTdQOEJPMkQ0L0E9PSIKICAgICAgICAgICAgeG1sbnM6dGZkPSJodHRwOi8vd3d3LnNhdC5nb2IubXgvVGltYnJlRmlzY2FsRGlnaXRhbCIvPgogICAgPC9jZmRpOkNvbXBsZW1lbnRvPgogICAgPGNmZGk6QWRkZW5kYT4KICAgICAgICA8Zng6RmFjdERvY01YCiAgICAgICAgICAgIHhzaTpzY2hlbWFMb2NhdGlvbj0iaHR0cDovL3d3dy5mYWN0LmNvbS5teC9zY2hlbWEvZnggaHR0cDovL3d3dy5teXN1aXRlbWV4LmNvbS9mYWN0L3NjaGVtYS9meF8yMDEwX2cueHNkIgogICAgICAgICAgICB4bWxuczpmeD0iaHR0cDovL3d3dy5mYWN0LmNvbS5teC9zY2hlbWEvZngiPgogICAgICAgICAgICA8Zng6VmVyc2lvbj44PC9meDpWZXJzaW9uPgogICAgICAgICAgICA8Zng6SWRlbnRpZmljYWNpb24+CiAgICAgICAgICAgICAgICA8Zng6Q2RnUGFpc0VtaXNvcj5NWDwvZng6Q2RnUGFpc0VtaXNvcj4KICAgICAgICAgICAgICAgIDxmeDpUaXBvRGVDb21wcm9iYW50ZT5GQUNUVVJBPC9meDpUaXBvRGVDb21wcm9iYW50ZT4KICAgICAgICAgICAgICAgIDxmeDpSRkNFbWlzb3I+SkVTOTAwMTA5UTkwPC9meDpSRkNFbWlzb3I+CiAgICAgICAgICAgICAgICA8Zng6UmF6b25Tb2NpYWxFbWlzb3I+SklNRU5FWiBFU1RSQURBIFNBTEFTIEEgQTwvZng6UmF6b25Tb2NpYWxFbWlzb3I+CiAgICAgICAgICAgICAgICA8Zng6VXN1YXJpbz5Pc3dhbGRvIENvbMOtbjwvZng6VXN1YXJpbz4KICAgICAgICAgICAgICAgIDxmeDpBc2lnbmFjaW9uU29saWNpdGFkYT4KICAgICAgICAgICAgICAgICAgICA8Zng6U2VyaWU+QTwvZng6U2VyaWU+CiAgICAgICAgICAgICAgICAgICAgPGZ4OkZvbGlvPkNVU1RJTlZDMTI3PC9meDpGb2xpbz4KICAgICAgICAgICAgICAgIDwvZng6QXNpZ25hY2lvblNvbGljaXRhZGE+CiAgICAgICAgICAgICAgICA8Zng6RXhwb3J0YWNpb24+MDE8L2Z4OkV4cG9ydGFjaW9uPgogICAgICAgICAgICAgICAgPGZ4Okx1Z2FyRXhwZWRpY2lvbj4wMTAzMDwvZng6THVnYXJFeHBlZGljaW9uPgogICAgICAgICAgICAgICAgPGZ4OkNhZGVuYU9yaWdpbmFsPnx8MS4xfGYyZTRhNWU0LTI3MzUtNDgwOC1hOTU1LWFiYTkwMDNjZDc5ZXwyMDIzLTA3LTA1VDE2OjEzOjI4fFNQUjE5MDYxM0k1MnxDN2h4R0FWTDJBeE9DSEkvRDcyWUZJMjVvbXNOWTY5QU1Nb2pFdkd0bi9oMGU1MU5UL2VsUFVDQnFxSDdZdTIrNi9SaldVRitSNS93Rnc5WDZZNDFXSitURUlXRXBBUXRCN21uaWVWb1B1a3BLTkZ3cjBhS0lCMHNoV05sYzJYYjRYL29uemk0cjZlS1pVdVFwdkZ0SlJldTBRVHppdWlUck1Dd0l2SzlFSzl1Rm4xem9iaDBCV0VicHdROURReDRvTVhRSGQxa2poRFM4MXBZT2RxWGRLd3BjeEZ3bVFudjV1c1JLcEhlZS9YYmUvVDJyTE1NQjdpMHZjSXhLUHNQSEV0bk1OYmIyUzVKbmc1emZRdHdLMEx1bzhva2pKaU1BbElubkR5UlhHSnFuencxa3VNUHRjeksyUlNET25XRFc1NmZEZWJsaldpY3J1SDdPanVZd0E9PXwzMDAwMTAwMDAwMDUwMDAwMzQ1Nnx8PC9meDpDYWRlbmFPcmlnaW5hbD4KICAgICAgICAgICAgPC9meDpJZGVudGlmaWNhY2lvbj4KICAgICAgICAgICAgPGZ4OkVtaXNvcj4KICAgICAgICAgICAgICAgIDxmeDpSZWdpbWVuRmlzY2FsPgogICAgICAgICAgICAgICAgICAgIDxmeDpSZWdpbWVuPjYwMTwvZng6UmVnaW1lbj4KICAgICAgICAgICAgICAgIDwvZng6UmVnaW1lbkZpc2NhbD4KICAgICAgICAgICAgPC9meDpFbWlzb3I+CiAgICAgICAgICAgIDxmeDpSZWNlcHRvcj4KICAgICAgICAgICAgICAgIDxmeDpDZGdQYWlzUmVjZXB0b3I+TVg8L2Z4OkNkZ1BhaXNSZWNlcHRvcj4KICAgICAgICAgICAgICAgIDxmeDpSRkNSZWNlcHRvcj5YQVhYMDEwMTAxMDAwPC9meDpSRkNSZWNlcHRvcj4KICAgICAgICAgICAgICAgIDxmeDpOb21icmVSZWNlcHRvcj5PUEVSQURPUkEgREUgQ0lVREFEIEpVQVJFWjwvZng6Tm9tYnJlUmVjZXB0b3I+CiAgICAgICAgICAgICAgICA8Zng6RG9taWNpbGlvRmlzY2FsUmVjZXB0b3I+MDEwMzA8L2Z4OkRvbWljaWxpb0Zpc2NhbFJlY2VwdG9yPgogICAgICAgICAgICAgICAgPGZ4OlJlZ2ltZW5GaXNjYWxSZWNlcHRvcj42MTY8L2Z4OlJlZ2ltZW5GaXNjYWxSZWNlcHRvcj4KICAgICAgICAgICAgICAgIDxmeDpVc29DRkRJPlMwMTwvZng6VXNvQ0ZEST4KICAgICAgICAgICAgPC9meDpSZWNlcHRvcj4KICAgICAgICAgICAgPGZ4OkNvbmNlcHRvcz4KICAgICAgICAgICAgICAgIDxmeDpDb25jZXB0bz4KICAgICAgICAgICAgICAgICAgICA8Zng6Q2FudGlkYWQ+MS4wMDAwMDA8L2Z4OkNhbnRpZGFkPgogICAgICAgICAgICAgICAgICAgIDxmeDpDbGF2ZVVuaWRhZD5FNDg8L2Z4OkNsYXZlVW5pZGFkPgogICAgICAgICAgICAgICAgICAgIDxmeDpVbmlkYWREZU1lZGlkYT5TZXJ2PC9meDpVbmlkYWREZU1lZGlkYT4KICAgICAgICAgICAgICAgICAgICA8Zng6Q2xhdmVQcm9kU2Vydj44NDExMTUwNjwvZng6Q2xhdmVQcm9kU2Vydj4KICAgICAgICAgICAgICAgICAgICA8Zng6Q29kaWdvPkFudGljaXBvIGRlIGNsaWVudGU8L2Z4OkNvZGlnbz4KICAgICAgICAgICAgICAgICAgICA8Zng6RGVzY3JpcGNpb24+ICIiIDwvZng6RGVzY3JpcGNpb24+CiAgICAgICAgICAgICAgICAgICAgPGZ4OlZhbG9yVW5pdGFyaW8+MTAwMDAuMDA8L2Z4OlZhbG9yVW5pdGFyaW8+CiAgICAgICAgICAgICAgICAgICAgPGZ4OkltcG9ydGU+MTAwMDAuMDA8L2Z4OkltcG9ydGU+CiAgICAgICAgICAgICAgICAgICAgPGZ4OkRlc2N1ZW50bz4wLjAwPC9meDpEZXNjdWVudG8+CiAgICAgICAgICAgICAgICAgICAgPGZ4Ok9iamV0b0ltcD4wMjwvZng6T2JqZXRvSW1wPgogICAgICAgICAgICAgICAgICAgIDxmeDpJbXB1ZXN0b3NTQVQ+CiAgICAgICAgICAgICAgICAgICAgICAgIDxmeDpUcmFzbGFkb3M+CiAgICAgICAgICAgICAgICAgICAgICAgICAgICA8Zng6VHJhc2xhZG8gQmFzZT0iMTAwMDAuMDAiIEltcG9ydGU9IjE2MDAuMDAiIEltcHVlc3RvPSIwMDIiCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgVGFzYU9DdW90YT0iMC4xNjAwMDAiIFRpcG9GYWN0b3I9IlRhc2EiLz4KICAgICAgICAgICAgICAgICAgICAgICAgPC9meDpUcmFzbGFkb3M+CiAgICAgICAgICAgICAgICAgICAgPC9meDpJbXB1ZXN0b3NTQVQ+CiAgICAgICAgICAgICAgICAgICAgPGZ4Ok9wY2lvbmVzLz4KICAgICAgICAgICAgICAgIDwvZng6Q29uY2VwdG8+CiAgICAgICAgICAgIDwvZng6Q29uY2VwdG9zPgogICAgICAgICAgICA8Zng6SW1wdWVzdG9zU0FUIFRvdGFsSW1wdWVzdG9zVHJhc2xhZGFkb3M9IjE2MDAuMDAiPgogICAgICAgICAgICAgICAgPGZ4OlRyYXNsYWRvcz4KICAgICAgICAgICAgICAgICAgICA8Zng6VHJhc2xhZG8gQmFzZT0iMTAwMDAuMDAiIEltcG9ydGU9IjE2MDAuMDAiIEltcHVlc3RvPSIwMDIiCiAgICAgICAgICAgICAgICAgICAgICAgIFRhc2FPQ3VvdGE9IjAuMTYwMDAwIiBUaXBvRmFjdG9yPSJUYXNhIi8+CiAgICAgICAgICAgICAgICA8L2Z4OlRyYXNsYWRvcz4KICAgICAgICAgICAgPC9meDpJbXB1ZXN0b3NTQVQ+CiAgICAgICAgICAgIDxmeDpUb3RhbGVzPgogICAgICAgICAgICAgICAgPGZ4Ok1vbmVkYT5NWE48L2Z4Ok1vbmVkYT4KICAgICAgICAgICAgICAgIDxmeDpUaXBvRGVDYW1iaW9WZW50YT4xPC9meDpUaXBvRGVDYW1iaW9WZW50YT4KICAgICAgICAgICAgICAgIDxmeDpTdWJUb3RhbEJydXRvPjEwMDAwLjAwPC9meDpTdWJUb3RhbEJydXRvPgogICAgICAgICAgICAgICAgPGZ4OlN1YlRvdGFsPjEwMDAwLjAwPC9meDpTdWJUb3RhbD4KICAgICAgICAgICAgICAgIDxmeDpEZXNjdWVudG8+MC4wMDwvZng6RGVzY3VlbnRvPgogICAgICAgICAgICAgICAgPGZ4OlRvdGFsPjExNjAwLjAwPC9meDpUb3RhbD4KICAgICAgICAgICAgICAgIDxmeDpUb3RhbEVuTGV0cmE+b25jZSBtaWwgc2Vpc2NpZW50b3MgcGVzb3MgMDAvMTAwPC9meDpUb3RhbEVuTGV0cmE+CiAgICAgICAgICAgICAgICA8Zng6Rm9ybWFEZVBhZ28+MDM8L2Z4OkZvcm1hRGVQYWdvPgogICAgICAgICAgICA8L2Z4OlRvdGFsZXM+CiAgICAgICAgICAgIDxmeDpDb21wcm9iYW50ZUV4PgogICAgICAgICAgICAgICAgPGZ4OlRlcm1pbm9zRGVQYWdvPgogICAgICAgICAgICAgICAgICAgIDxmeDpNZXRvZG9EZVBhZ28+UFVFPC9meDpNZXRvZG9EZVBhZ28+CiAgICAgICAgICAgICAgICAgICAgPGZ4OkNvbmRpY2lvbmVzRGVQYWdvPjMwIGRpYXM8L2Z4OkNvbmRpY2lvbmVzRGVQYWdvPgogICAgICAgICAgICAgICAgPC9meDpUZXJtaW5vc0RlUGFnbz4KICAgICAgICAgICAgPC9meDpDb21wcm9iYW50ZUV4PgogICAgICAgIDwvZng6RmFjdERvY01YPgogICAgPC9jZmRpOkFkZGVuZGE+CjwvY2ZkaTpDb21wcm9iYW50ZT4=</ws:Data1>
<ws:Data2></ws:Data2>
<ws:Data3></ws:Data3>
</ws:RequestTransaction>
</soapenv:Body>
</soapenv:Envelope>


Idea
El sobre 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

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<RequestTransactionResponse xmlns="http://www.fact.com.mx/schema/ws">
<RequestTransactionResult>
<Request>
<Requestor>00000000-0000-0000-0000-000000000000</Requestor>
<RequestorActive>true</RequestorActive>
<Transaction>RECEIVE</Transaction>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<User>00000000-0000-0000-0000-000000000000</User>
<UserName>MX.JES900109Q90.jacinto</UserName>
<Id>9ee0949b-d8a4-47c7-9f93-85c0d624d02e</Id>
<TimeStamp>2019-09-09T15:26:23.3198591-05:00</TimeStamp>
</Request>
<Response>
<Result>true</Result>
<TimeStamp>2019-09-09T15:26:23.6474596-05:00</TimeStamp>
<LastResult/>
<Code>1</Code>
<Description/>
<Hint/>
<Data>2946 9ee0949b-d8a4-47c7-9f93-85c0d624d02e</Data>
<Processor>TEST-BACK01</Processor>
<Identifier>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<FiscalName>AAA DIVISION</FiscalName>
<AYear/>
<ANumber/>
<Batch>ABB</Batch>
<Serial>692</Serial>
<DocumentGUID>UUID Folio Fiscal</DocumentGUID>
<IssuedTimeStamp>2019-09-02T15:34:30</IssuedTimeStamp>
<InternalID/>
<ReceiverCountry>MX</ReceiverCountry>
<ReceiverEntity>JES900109Q90</ReceiverEntity>
<ReceiverTaxID>JES900109Q90</ReceiverTaxID>
<ReceiverName>EMPRESA DE PRUEBA</ReceiverName>
<ClaveAgente/>
<NumeroDePoliza/>
<Currency>MXN</Currency>
<TotalAmount>5800.00</TotalAmount>
<Type1>I</Type1>
<Type2/>
<SuggestedFileName>RFCEMI_ABB_692_RFCREC</SuggestedFileName>
<SuggestedFileName2>02092019_ABB692</SuggestedFileName2>
<Observaciones/>
<ObservacionesHtml/>
</Identifier>
<BatchIdentifier/>
</Response>
<ResponseData>
<ResponseData1>1</ResponseData1>
<ResponseData2>0</ResponseData2>
<ResponseData3>Sin observaciones (bien).</ResponseData3>
</ResponseData>
</RequestTransactionResult>
</RequestTransactionResponse>
</soap:Body>
</soap:Envelope>


8. Estructura de respuesta — éxito

La respuesta se organiza en tres bloques dentro de RequestTransactionResult.

Bloque Elemento Contenido
Request Eco de los parámetros de identidad Devuelve Transaction, Country, Entity y UserName
RequestorActive Indica si el solicitante está activo
Id · TimeStamp Identificador de la operación y momento de recepción
Response Result true cuando la recepción se ejecutó. No es el veredicto sobre el CFDI, true es el valor que dispara el descuento del medio folio
Code Código de resultado. Ver apartado 10
TimeStamp Momento en que concluyó el procesamiento
LastResult · Description · Hint Vacíos cuando la recepción se ejecuta. Ver apartado 9
Data · Processor Referencia interna del procesamiento y Servidor que atendió la solicitud
Identifier Datos que la plataforma extrajo del CFDI recibido. Ver desglose siguiente
BatchIdentifier Llega vacío en recepción individual. 
ResponseData ResponseData1 «pendiente: Desarrollo — el artículo fuente no documenta este nodo. En el ejemplo publicado devuelve 1. Hipótesis por confirmar, no dar por buena: cantidad de documentos procesados»
ResponseData2 «pendiente: Desarrollo — el artículo fuente no documenta este nodo. En el ejemplo publicado devuelve 0. Hipótesis por confirmar, no dar por buena: cantidad de observaciones encontradas»
ResponseData3 Descripción de las observaciones encontradas en el CFDI. Es el veredicto de la validación. Llega en texto plano, no en Base64
Result no es el veredicto. Result = true con Code = 1 significa que la plataforma procesó el comprobante y se descontó el medio folio. Si el CFDI tiene defectos, eso se expresa en ResponseData3, no en Result. Un proceso que decida solo por Result 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 con observaciones.

Desglose de Identifier. Los valores provienen del comprobante recibido:

Elemento Contenido
DocumentGUID Folio Fiscal (UUID) del comprobante recibido. Llave para recuperarlo después con RETRIEVE_DOCUMENT
Country · Entity · FiscalName País, RFC y razón social del emisor del CFDI, es decir tu proveedor
Batch · Serial Serie y folio del comprobante
IssuedTimeStamp Fecha y hora de emisión
ReceiverCountry · ReceiverEntity · ReceiverName País, RFC y nombre del receptor
ReceiverTaxID Identificador fiscal del receptor. 
Currency · TotalAmount Moneda e importe total del comprobante
Type1 · Type2 Tipo de Comprobante SAT y Tipo de Comprobante MYSuite
Observaciones · ObservacionesHtml Observaciones encontradas
SuggestedFileName · SuggestedFileName2 Nombres sugeridos para guardar el archivo


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 sobre es el mismo del apartado 8. Cambia el contenido de Response.

Elemento Contenido en error
Result false: la recepción no se ejecutó. No se descuenta folio y el comprobante no queda almacenado
Code Código del error. Ver apartado 10
Description Mensaje del error
Hint Sugerencia de corrección, cuando la plataforma la proporciona
Data Notificación de nuestro servicio
LastResult Resultado de la operación previa asociada, cuando aplica
Processor Servidor que atendió la solicitud. Dato a incluir al reportar incidencias.
ResponseData1, 2 y 3 Vacíos


El error no tiene costo. Los fallos de integración —credenciales incorrectas, Base64 mal formado, sobre SOAP inválido— devuelven Result = false y no descuentan folios. Lo que descuenta es la recepción que sí se ejecutó.
Un error de negocio se reporta con Result = false y HTTP 200. Evalúa siempre Result y no asumas éxito por el código de estado HTTP.


10. Códigos de Error


11. Límites y comportamiento


Aspecto Valor
Comprobantes por llamada Uno
Consumo de folios 1/2 folio por cada solicitud con Result = true. Dos recepciones exitosas equivalen a 1 folio. Sin descuento cuando Result = false
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 Si se envía a recepción más de una vez un CFDI que ya ha sido recibido, se indica en la respuesta "Este documento ya se encuentra en nuestra base de datos.", este no se almacena por duplicado, y el segundo envío no descuenta otro medio folio porque dio Result = false
Tamaño máximo de Data1 1 MB
Timeout 60 segundos en servidor front
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 del comprobante ante el SAT, sólo se limita a la validación/recepción del CFDI


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.
  • Cuando el SAT publica cambios al Anexo 20, las reglas de validación se actualizan del lado de MYSuite sin que tengas que modificar tu integración. 
  • El descuento se aplica sobre el paquete vigente. 
Solución de problemas

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


Problema. El proceso acepta facturas defectuosas porque interpreta Result = true como que el CFDI es correcto.

Entorno. CFDI + Timbrado · SOAP · RECEIVE.

Resolución. Lee el veredicto en ResponseData3, donde se describen las observaciones encontradas. Result solo te dice si la plataforma procesó el archivo. Tu lógica de aceptación de facturas debe basarse en el contenido de ResponseData3.

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.

"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 · SOAP · 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 a la transacción. 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. Intentar recibir un cfdi que ya se había recibido genera en MYSuite la respuesta: Este documento ya se encuentra en nuestra base de datos.

"El consumo de folios no me cuadra con el número de facturas"


Problema. El descuento observado en el paquete no coincide con la cantidad de comprobantes recibidos.

Entorno. CFDI + Timbrado · SOAP · conciliación de consumo.

Resolución. Cuenta media unidad por cada recepción con Result = true: veinte recepciones exitosas son diez folios. Las llamadas con Result = false no cuentan. Si además usas VALIDATE_DOCUMENT, recuerda que esa transacción descuenta un folio completo por solicitud, así que el total mezcla dos tarifas distintas.

Causa. El descuento es fraccionario, y con un número impar de recepciones el consumo queda en medias unidades.

"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 · SOAP · procesos de recepción diseñados por etapas.

Resolución. Llama solo a RECEIVE: hace la misma validación y devuelve el mismo veredicto en ResponseData3, y además deja el comprobante almacenado. Encadenar las dos transacciones sobre el mismo CFDI paga la validación dos veces.

Causa. Diseño del flujo que separa validar de archivar sin advertir que la recepción ya incluye ambas cosas.

"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 · SOAP · 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 · SOAP · validación previa a la aceptación de una factura.

Resolución. Usa VALIDATE_DOCUMENT: revisa sin almacenar. Ten presente que su tarifa es de un folio por solicitud, frente a medio folio de RECEIVE. Si el resguardo centralizado te sirve de algo, la recepción es la opción más conveniente.

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.

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 Result

Hay dos preguntas encadenadas: si el procesamiento pudo hacerse, y qué encontró la validación. Result responde la primera y ResponseData3 la segunda. 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 Result, esa separación también determina cuándo se cobra.

Por qué conviene resolver la pregunta del almacenamiento con observaciones

Queda una duda de diseño que vale la pena cerrar antes de construir sobre esta transacción: si un comprobante con observaciones se almacena o no. De la respuesta depende cómo se interpreta el 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 Result = 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 sería la misma operación de negocio en ambos transportes, pero cambia todo lo que rodea al dato: los encabezados, la forma del cuerpo, la nomenclatura de la respuesta y la manera de leerla. Documentar ambos en un solo artículo obligaría al lector a descartar la mitad del contrato técnico en cada consulta, y es precisamente donde se originan los errores de integración.


Más Transacciones Servicio CFDI + Timbrado (SOAP)

Emisión

Consulta y Recuperación

Validación y Recepción

CFDI de Retenciones

Esquema de cancelación