CONSULTAR_DOCUMENTO — SERVICIO CFDI + Timbrado (SOAP)

CONSULTAR_DOCUMENTO — SERVICIO CFDI + Timbrado (SOAP)

Estado Transacción: Vigente · Compatibilidad: Esquema de cancelación vigente · Última revisión: 07/08/2026 · Próxima revisión: 07/11/2026 · Responsable: Jan Martínez


De un vistazo


Qué hace: consulta el estado de cancelación de un CFDI emitido o recibido que exista en la base de datos de MYSuite. Te dice si el comprobante está vigente o cancelado, si puede cancelarse y si esa cancelación requiere la aceptación del receptor.


Cuándo se usa: para confirmar el resultado de una cancelación solicitada con CANCEL_DOCUMENT_3; para saber si un comprobante puede cancelarse antes de intentarlo; y para verificar el estado de las facturas que recibes antes de registrarlas o pagarlas.


Cuándo no usarla: para obtener el XML o el PDF del comprobante, estos se piden con RETRIEVE_DOCUMENT. Tampoco solicita cancelar el CFDI.


Warning
El acuse que devuelve no tiene valor legal. No viene firmado digitalmente, así que sólo sirve como consulta operativa y como evidencia interna, pero no sustituye a los acuses formales del SAT.
Funciona en los dos sentidos: puedes consultar comprobantes que emitiste y comprobantes que recibiste. Lo que cambia es el criterio docType y qué RFC va en el campo emisor.
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 saber si un CFDI está vigente, en proceso de cancelación o cancelado, por SOAP Este artículo
Va a solicitar la cancelación de un CFDI CANCEL_DOCUMENT_3 — CFDI + Timbrado (SOAP)
Va a cancelar un CFDI de Retenciones CANCELAR_RETENCION_SINGLE_MYSUITE_3
Necesita el XML o el PDF del comprobante RETRIEVE_DOCUMENT — CFDI + Timbrado (SOAP)
Necesita validar si un CFDI está bien conformado VALIDATE_DOCUMENT
Necesita validar / recibir un CFDI de proveedor


Requisitos previos

  • Credenciales de integración vigentes que te proporciona MYSuite: Requestor y Entity.
  • Tener a la mano el Folio Fiscal (UUID) del comprobante que quieres consultar su estado de cancelación.
  • El RFC del emisor del comprobante, que en el caso de los cfdi's recibidos es el de tus proveedores, no el tuyo.
  • El año de emisión.
  • Que el comprobante exista en las bases de datos de MYSuite: los recibidos llegan ahí a través de la transacción RECEIVE.


Cómo hacerlo


  1. Identifica el Folio Fiscal (UUID), del comprobante que quieres consultar.
    Resultado: el criterio principal de la consulta.
  2. Determina si el comprobante es emitido o recibido: define el valor de docType, issued o received.
    Resultado: el tipo de documento declarado.
  3. Determina el RFC que va en emisor. Es siempre el del emisor de la factura: el tuyo si la emitiste, el de tu proveedor si la recibiste.
    Resultado: el RFC correcto para el tipo de documento elegido.
  4. Añade el año de emisión en year si el documento es emitido. En recibidos es opcional.
    Resultado: los criterios completos.
  5. Construye el JSON con los criterios y codifícalo en Base64.
    Resultado: una cadena Base64 en una sola línea.
  6. Arma el sobre SOAP con las credenciales, Transaction con valor CONSULTAR_DOCUMENTO, la cadena en Data1, Data2 y Data3 vacíos.
    Resultado: petición lista.
  7. Envía la petición al web service del ambiente que corresponda.
    Resultado: respuesta HTTP 200 con un sobre RequestTransactionResponse.
  8. Lee el elemento Result.
    Resultado: Result = true te permite continuar; Result = false te lleva a Solución de problemas.
  9. Decodifica ResponseData1 desde Base64 y analízalo como JSON.
    Resultado: los campos de estado del comprobante.
  10. Interpreta los tres campos que responden preguntas distintas: Estado dice si está vigente o cancelado, EstatusCancelacion dice en qué punto va una cancelación en trámite, y EsCancelable dice si el comprobante admite cancelación y bajo qué condición.
    Resultado: la situación real del comprobante, no una suposición.
  11. Conserva el acuse de ResponseData2 si lo necesitas como respaldo interno, y registra el estado en tu ERP.
    Resultado: consulta trazable y contabilidad alineada con la realidad fiscal.


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. El ejemplo publicado usa SOAP 1.2
Servicio FactWSFront
Operación RequestTransaction
Namespace http://www.fact.com.mx/schema/ws
SOAPAction http://www.fact.com.mx/schema/ws/RequestTransaction
Valor <Transaction> CONSULTAR_DOCUMENTO.
Modalidad ASP (CFDI + Timbrado SOAP)
Transacción para Emisor o Receptor
Naturaleza Consulta. No modifica el estado de ningún comprobante


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
Restricción del ambiente de pruebas. Un cliente CFDI + Timbrado (SOAP) debe usar JES900109Q90 como RFC solicitante (Entity). Solo consultas comprobantes del ambiente en que operas.


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, ligado a la seguridad de la transacción, la autenticación y la autorización
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 consulta, es decir el tuyo. No confundir con el campo emisor del JSON, que en comprobantes recibidos es el RFC de tu proveedor
User GUID Sí GUID Identificador del usuario, colocar el valor del Requestor proporcionado por MYSuite
UserName string Sí País.RFC.usuario Nombre de usuario. Ejemplo asociado al MX.JES900109Q90.jan


4. Parámetros de entrada

Nombre Tipo Obligatorio Límite Formato Descripción
Data1 string Sí — Base64 de una cadena JSON Criterios para consultar el estado del CFDI. Ver apartado 5
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
Es la primera transacción de la modalidad SOAP que usa JSON en lugar de un Dictionary XML. Si vienes de implementar CANCEL_DOCUMENT_3 o RETRIEVE_DOCUMENT, la estructura de criterios es distinta aunque el sobre y la codificación en Base64 sean los mismos.


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

Data1 — criterios en JSON

{
"docType": "issued",
"emisor": "JES900109Q90",
"folioFiscal": "9ba6a41f-1e78-4f34-882d-d89cc2d8e38b",
"year": "2022"
}
Criterio Tipo Obligatorio Límite Formato Descripción
docType string Sí — issued ó received Tipo de documento que quieres consultar: emitido o recibido
emisor string Sí 12–13 RFC RFC del emisor de la factura que quieres consultar. En comprobantes recibidos es el RFC del proveedor que te facturó
folioFiscal string Sí 36 UUID Folio Fiscal de la factura que quieres consultar
year string Sólo para issued 4 dígitos AAAA Año de la fecha de emisión de la factura. Obligatorio en documentos emitidos


Data2 y Data3

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


6. Ejemplo de request

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ws="http://www.fact.com.mx/schema/ws">
<soap:Header/>
<soap:Body>
<ws:RequestTransaction>
<ws:Requestor>0c320b03-d4f1-47bc-9fb4-77995f9bf33e</ws:Requestor>
<ws:Transaction>CONSULTAR_DOCUMENTO</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.jan</ws:UserName>
<ws:Data1>eyAnZG9jVHlwZSc6ICdpc3N1ZWQnLCAnZW1pc29yJzogJ0pFUzkwMDEwOVE5MCcsICdmb2xpb0Zpc2NhbCc6ICc3YzdiODBjNS00YjNmLTQ5MWEtYjRkZi1jYjQ3ZWViY2I4NzInLCAneWVhcic6ICcyMDI2JyB9</ws:Data1>
<ws:Data2></ws:Data2>
<ws:Data3></ws:Data3>
</ws:RequestTransaction>
</soap:Body>
</soap:Envelope>


7. Ejemplo de response

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/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>CONSULTAR_DOCUMENTO</Transaction>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<User>00000000-0000-0000-0000-000000000000</User>
<UserName>Jan_Test</UserName>
<Id>2117f1e1-b074-4ff0-b8c3-c1a40075b539</Id>
<TimeStamp>2026-09-15T09:54:02.2921382-06:00</TimeStamp>
</Request>
<Response>
<Result>true</Result>
<TimeStamp>2026-09-15T09:54:02.7071048-06:00</TimeStamp>
<LastResult/>
<Code>1</Code>
<Description/>
<Hint/>
<Data>5042 2117f1e1-b074-4ff0-b8c3-c1a40075b539</Data>
<Processor>TEST-BACK03</Processor>
<Identifier>
<Country>MX</Country>
<Entity>JES900109Q90</Entity>
<FiscalName>JIMENEZ ESTRADA SALAS A A</FiscalName>
<AYear>0</AYear>
<ANumber/>
<Batch>ABB</Batch>
<Serial>13819</Serial>
<DocumentGUID>7c7b80c5-4b3f-491a-b4df-cb47eebcb872</DocumentGUID>
<IssuedTimeStamp>2026-09-11T01:16:41</IssuedTimeStamp>
<EnrolledTimeStamp>2026-09-11T01:16:44</EnrolledTimeStamp>
<PaidTimeStamp/>
<CancelledTimeStamp/>
<InternalID>1</InternalID>
<BatchID/>
<BatchTimeStamp/>
<BatchRequestorCountry/>
<BatchRequestorEntity/>
<BatchPosition/>
<ReceiverCountry>MX</ReceiverCountry>
<ReceiverEntity>XAXX010101000</ReceiverEntity>
<ReceiverTaxID/>
<ReceiverName>PUBLICO EN GENERAL</ReceiverName>
<ClaveAgente/>
<NumeroDePoliza/>
<Currency>MXN</Currency>
<TotalAmount>420.00</TotalAmount>
<Type1>ingreso</Type1>
<Type2>FACTURA</Type2>
<SuggestedFileName>JES900109Q90_ABB_13819_XAXX010101000</SuggestedFileName>
<SuggestedFileName2>11092026__1_ABB13819_</SuggestedFileName2>
</Identifier>
</Response>
<ResponseData>
<ResponseData1>eyJDb2RpZ29Fc3RhdHVzIjoiUyAtIENvbXByb2JhbnRlIG9idGVuaWRvIHNhdGlzZmFjdG9yaWFtZW50ZS4iLCJFc0NhbmNlbGFibGUiOiJDYW5jZWxhYmxlIHNpbiBhY2VwdGFjacOzbiIsIkVzdGFkbyI6IlZpZ2VudGUiLCJFc3RhdHVzQ2FuY2VsYWNpb24iOiIiLCJWYWxpZGFjaW9uRUZPUyI6IjIwMCJ9</ResponseData1>
<ResponseData2>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjxBY3VzZSB4bWxuczp4c2k9Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvWE1MU2NoZW1hLWluc3RhbmNlIiB4bWxuczp4c2Q9Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvWE1MU2NoZW1hIj4NCiAgPEV4dGVuc2lvbkRhdGEgLz4NCiAgPENvZGlnb0VzdGF0dXM+UyAtIENvbXByb2JhbnRlIG9idGVuaWRvIHNhdGlzZmFjdG9yaWFtZW50ZS48L0NvZGlnb0VzdGF0dXM+DQogIDxFc0NhbmNlbGFibGU+Q2FuY2VsYWJsZSBzaW4gYWNlcHRhY2nDs248L0VzQ2FuY2VsYWJsZT4NCiAgPEVzdGFkbz5WaWdlbnRlPC9Fc3RhZG8+DQogIDxFc3RhdHVzQ2FuY2VsYWNpb24gLz4NCiAgPFZhbGlkYWNpb25FRk9TPjIwMDwvVmFsaWRhY2lvbkVGT1M+DQo8L0FjdXNlPg==</ResponseData2>
<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 consulta se ejecutó. No es el estado del comprobante
Code Código de resultado. Ver apartado 10
TimeStamp Momento en que concluyó el procesamiento
LastResult · Description · Hint Vacíos en consulta exitosa. Ver apartado 9
Data · Processor Referencia interna del procesamiento y Servidor que atendió la solicitud
Identifier Datos del comprobante tomados de la base de datos de MYSuite. Ver desglose siguiente
ResponseData ResponseData1 JSON en Base64 con el estado del comprobante. Es la respuesta principal
ResponseData2 XML en Base64 con el acuse de la consulta
ResponseData3 Vacío


Contenido de ResponseData1 una vez decodificado

{
"CodigoEstatus": "S - Comprobante obtenido satisfactoriamente.",
"EsCancelable": "Cancelable sin aceptación",
"Estado": "Vigente",
"EstatusCancelacion": "",
"ValidacionEFOS": "200"
}
Campo Qué responde Valores
CodigoEstatus Si la consulta en sí obtuvo el comprobante Código y descripción
Estado Si el comprobante está Vigente o Cancelado Estado del CFDI ante el SAT; Valores: Vigente o Cancelado
EsCancelable Si el comprobante admite cancelación y bajo qué condición Valores: Cancelable sin aceptación o Cancelable con aceptación
EstatusCancelacion En qué punto va una cancelación en trámite. Llega vacío cuando no hay ninguna Valores: En proceso, No Cancelable, Cancelado sin aceptación, Cancelado con aceptación, Cancelado plazo vencido y Solicitud rechazada
ValidacionEFOS Resultado de la validación del emisor frente a las listas del artículo 69-B Valores:

Código= 100

Este código de respuesta se presentará cuando la validación del RFC Emisor del CFDI se encuentre dentro de la lista de Empresa que Factura Operaciones Simuladas (EFOS)

Código=200

Este código de respuesta se presentará cuando la validación del RFC Emisor del CFDI no se encuentre dentro de la lista de Empresa que Factura Operaciones Simuladas (EFOS).
Trata el JSON como extensible: lee los campos por nombre y no supongas un conjunto fijo ni un orden. 


Contenido de ResponseData2 una vez decodificado

Un XML de acuse con los mismos campos que el JSON, dentro de un elemento Acuse: ExtensionData, CodigoEstatus, EsCancelable, Estado, EstatusCancelacion y, cuando aplica, ValidacionEFOS.

Este acuse no está firmado digitalmente, así que no es un acuse en sentido legal. Guárdalo como evidencia operativa interna, no como respaldo ante la autoridad.


Desglose de Identifier

A diferencia del JSON de estado de cancelación, que refleja la situación fiscal del CFDI, el Identifier trae los datos que MYSuite tiene registrados del comprobante: emisor, receptor, serie, folio, fechas, moneda, importe y clasificación. Es el mismo conjunto de elementos que devuelve RETRIEVE_DOCUMENT.


Elemento Contenido
DocumentGUID Folio Fiscal consultado
Country · Entity · FiscalName País, RFC y razón social del emisor
Batch · Serial Serie y folio del comprobante
IssuedTimeStamp · EnrolledTimeStamp Fecha de emisión y de registro en MYSuite
PaidTimeStamp · CancelledTimeStamp Fechas de pago y de cancelación registradas en MYSuite. Para el estado fiscal usa el JSON, no estos campos
ReceiverCountry · ReceiverEntity · ReceiverName Datos del receptor
Currency · TotalAmount Moneda e importe total
Type1 · Type2 Type1 Tipo de Comprobante SAT; Type2 Tipo de Comprobante MYSuite


9. Estructura de respuesta — error

El sobre es el mismo del apartado 8. Cambia el contenido de Response y las cargas llegan vacías.

Elemento Contenido en error
Result false: la consulta no se pudo ejecutar
Code Código del error. Ver apartado 10
LastResult Identificador simbólico del error. Es el valor más estable para ramificar tu lógica
Description · Hint Mensaje del error y sugerencia de corrección
Data Bloque de diagnóstico. Dato a incluir al reportar la incidencia a Soporte
Processor Servidor que atendió la solicitud. Dato a incluir al reportar la incidencia a Soporte
ResponseData1 · ResponseData2 Vacíos
Distinción necesaria. Result = false significa que la consulta no se ejecutó, no que el comprobante no exista ni que esté cancelado. El estado fiscal solo se lee en ResponseData1, y solo cuando Result es true.


10. Códigos de Error


11. Límites y comportamiento


Aspecto Valor
Comprobantes por llamada Uno. El criterio es un único Folio Fiscal
Alcance Comprobantes emitidos y recibidos que existan en las bases de datos de MYSuite
Alcance temporal Determinado por year en documentos emitidos
Idempotencia Es una transacción de consulta: no modifica el estado de ningún comprobante, por lo que reintentarla no tiene efectos colaterales
Valor legal del acuse Ninguno. No viene firmado digitalmente
Consumo de folios Ninguno
Latencia La consulta se resuelve contra el servicio de cancelación del SAT, de eso depende el tiempo de respuesta y el comportamiento si el SAT no está disponible.
Frecuencia recomendada En MYSuite realizamos una consulta de manera automática cada 24 horas (una vez que se solicitó cancelar un CFDI)
Timeout 60 segundos en servidor front


12. Versionado y cumplimiento

  • Forma parte del conjunto de transacciones del esquema de cancelación vigente.
  • El acuse que devuelve no es un acuse en sentido legal, porque no viene firmado digitalmente. Para respaldo formal ante la autoridad, usa los medios del SAT.
  • La consulta no sustituye la verificación oficial del comprobante ante el SAT.
  • El campo ValidacionEFOS se relaciona con las listas del artículo 69-B del Código Fiscal de la Federación.

Solución de problemas

"Cancelé una factura y necesito saber si ya quedó cancelada"


Problema. Después de CANCEL_DOCUMENT_3 no se sabe si la cancelación se consumó o sigue en trámite.

Entorno. CFDI + Timbrado · SOAP · procesos de cancelación.

Resolución. Consulta aquí y lee Estado junto con EstatusCancelacion. El primero te dice si el comprobante sigue vigente o ya está cancelado; el segundo, si hay un trámite en curso y en qué punto va. Registra la cancelación en tu contabilidad solo cuando Estado lo confirme, no cuando CANCEL_DOCUMENT_3 haya devuelto Result = true.

Causa. Solicitar la cancelación y que la cancelación surta efecto son dos momentos distintos. Cuando se requiere la aceptación del receptor, entre uno y otro puede pasar tiempo.

"Consulto una factura que me emitieron y no la encuentra"


Problema. La consulta de un comprobante recibido no devuelve resultado.

Entorno. CFDI + Timbrado · SOAP · docType con valor received.

Resolución. Revisa dos cosas. Primero, que el campo emisor lleve el RFC de tu proveedor y no el tuyo: tu RFC va en Entity, fuera del JSON. Segundo, que el comprobante exista en las bases de datos de MYSuite, lo que ocurre si lo diste de alta con RECEIVE; si nunca lo recibiste por esa vía, no hay nada que consultar.

Causa. En comprobantes emitidos, Entity y emisor coinciden y la distinción pasa desapercibida. En recibidos dejan de coincidir, igual que ocurre con IssuerTaxId en RETRIEVE_DOCUMENT.

"Consulto una factura que emití y me responde que no existe"


Problema. La consulta de un comprobante propio no devuelve resultado.

Entorno. CFDI + Timbrado · SOAP · docType con valor issued.

Resolución. Verifica que el JSON incluya year con el año de emisión: es obligatorio para documentos emitidos y su ausencia deja el comprobante fuera de alcance. Comprueba también que el Folio Fiscal esté completo, con sus 36 caracteres y sus guiones, y que consultes el mismo ambiente en que se emitió.

Causa. El criterio year solo es opcional en recibidos, así que un JSON que funciona para un caso no sirve tal cual para el otro.

"Me rechaza el JSON de criterios"


Problema. La petición falla al construir el contenido de Data1.

Entorno. CFDI + Timbrado · SOAP · integraciones nuevas, o migradas desde otras transacciones.

Resolución. El contenido de Data1 es JSON, no un Dictionary XML como en CANCEL_DOCUMENT_3 y RETRIEVE_DOCUMENT. Genera el JSON con tu serializador habitual, que producirá comillas dobles, y codifícalo completo en Base64 en una sola línea.

Causa. Es la única transacción documentada de esta modalidad que recibe JSON, así que la capa de armado de criterios no se puede compartir con el resto.

"No sé interpretar los campos de estado"


Problema. El JSON devuelve varios campos con valores en texto y no queda claro cuál manda.

Entorno. CFDI + Timbrado · SOAP · automatización de decisiones sobre comprobantes.

Resolución. Cada campo responde una pregunta distinta y no son intercambiables. Estado responde qué es el comprobante hoy. EstatusCancelacion responde si hay un trámite en curso. EsCancelable responde qué podrías hacer con él. Para saber si puedes darlo por cancelado usa Estado; para saber si tiene sentido intentar cancelarlo usa EsCancelable.

Causa. Los tres campos describen dimensiones diferentes del mismo comprobante, y sus valores llegan como texto en lenguaje natural en lugar de claves.

"Quiero usar el acuse como respaldo ante la autoridad"


Problema. Se pretende usar el XML de ResponseData2 como comprobante formal del estado de una factura.

Entorno. CFDI + Timbrado · SOAP · procesos de auditoría o aclaración.

Resolución. El acuse no viene firmado digitalmente, así que no tiene valor probatorio. Consérvalo como evidencia operativa interna de qué consultaste y cuándo, y obtén el respaldo formal por los medios del SAT.

Causa. La propia documentación de la transacción lo advierte: no es un acuse en sentido legal.


Para entender más

Por qué esta transacción es necesaria

Desde el esquema de 2022, cancelar dejó de ser un acto instantáneo. CANCEL_DOCUMENT_3 presenta la solicitud, pero cuando se requiere la aceptación del receptor el desenlace queda en manos de un tercero. Sin una forma de preguntar, el ERP se queda sin saber en qué terminó. Las dos transacciones forman un par: una abre el trámite, la otra lo cierra. Diseñar la cancelación sin incluir la consulta produce contabilidades que registran como cancelado algo que ante el SAT sigue vigente.

Tres campos, tres preguntas distintas

Conviene no colapsarlos. Estado describe el presente del comprobante: vigente o cancelado. EstatusCancelacion describe un proceso: si hay un trámite abierto y en qué punto va. EsCancelable describe una posibilidad: si el comprobante admite cancelación y si esa cancelación necesitará que alguien la acepte. Un comprobante vigente con un trámite en curso es una situación normal y transitoria, y solo se entiende leyendo los tres campos juntos.

Por qué EsCancelable conviene consultarlo antes de cancelar

Saber de antemano si una cancelación requerirá aceptación del receptor cambia lo que tu proceso debe esperar: en un caso el desenlace es inmediato y en el otro puede tardar. Consultar antes te permite decidir si conviene avisar al cliente, cuánto tiempo mantener el comprobante en un estado intermedio en tu ERP, y con qué frecuencia volver a preguntar.

Por qué el comprobante debe existir en MYSuite

La consulta opera sobre los comprobantes que la plataforma tiene registrados. Para los que emites eso es automático. Para los que recibes no: un CFDI de proveedor solo está ahí si lo diste de alta con RECEIVE. Es una consecuencia poco evidente de esa transacción, y explica por qué un área de cuentas por pagar que quiera verificar el estado de sus facturas necesita primero haberlas recibido en la plataforma.

Por qué el acuse no tiene valor legal

Un acuse adquiere valor probatorio por la firma digital de quien lo emite, y este llega sin firmar. Eso no lo hace inútil: documenta qué consultaste, cuándo y qué te respondieron, que es exactamente lo que necesitas para una conciliación interna o para justificar una decisión operativa. Lo que no puedes es presentarlo como prueba frente a la autoridad.

Por qué los criterios viajan en JSON y no en un Dictionary

El resto de la modalidad SOAP usa estructuras Dictionary en XML; esta transacción usa JSON. Es razonable suponer que se debe a que fue desarrollada después, cuando la plataforma ya exponía una modalidad REST y el formato JSON era el natural del lado del servidor. Para quien integra el efecto es concreto: el sobre y la codificación en Base64 son los mismos, pero la capa que arma los criterios no se puede reutilizar. Es una muestra más de que en esta plataforma los tres nodos de datos no tienen un formato fijo: cada transacción define el suyo.

Qué es ValidacionEFOS

Es el resultado de contrastar al emisor contra las listas que publica el SAT conforme al artículo 69-B del Código Fiscal de la Federación, que señalan a contribuyentes con operaciones presuntamente inexistentes. Para un área de cuentas por pagar es información valiosa: recibir una factura de un emisor listado tiene consecuencias sobre la deducibilidad. Que el campo aparezca en un ejemplo y no en otro sugiere que se incorporó después, y es un buen recordatorio de que conviene leer este JSON por nombre de campo y tolerar que traiga más elementos de los que esperabas.

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.


Transacciones del servicio CFDI + Timbrado (SOAP)

Emisión

Consulta y Recuperación

Validación y Recepción

CFDI de Retenciones

Esquema de cancelación