XML Nativo de MYSuite v8

XML Nativo de MYSuite v8

Estado: Vigente · Versión del formato: 8 · Esquema: fx_2010_g.xsd · Compatibilidad: CFDI 4.0 · Última revisión: 14/10/2026 · Próxima revisión: 14/01/2027 · Responsable: Jan Martínez


De un vistazo


Qué es: el formato propio de MYSuite para entregar los datos de un comprobante. Tú envías un XML Nativo y la plataforma construye a partir de él el CFDI conforme al Anexo 20, con sus espacios de nombres, su orden de nodos y su sellado. El elemento raíz es fx:FactDocMX.


Para qué sirve: para que tu ERP no tenga que conocer el Anexo 20 al detalle. Entregas datos de negocio y la plataforma se encarga de la forma fiscal.


Dónde se usa: en las transacciones de emisión de las modalidades SOAP y API REST por RequestTransaction.


La versión 8 es exclusiva de CFDI 4.0. El esquema declara fx:Version con valor fijo en 8, de modo que no admite ningún otro. Y la transformación que produce el CFDI 4.0 solo funciona con esta variante del esquema, la "g".
No confundas el XML Nativo con el CFDI. El Nativo es lo que tú envías; el CFDI es lo que MYSuite produce. Son dos documentos con esquemas distintos y espacios de nombres distintos. Validar tu archivo contra el esquema del CFDI no sirve de nada, y al revés tampoco.
Hay un formato hermano en JSON. Las modalidades que trabajan con JSON —API REST por JsonServiceCall y EndPoint— reciben el mismo modelo de datos serializado en JSON. Los dos formatos no son equivalentes campo por campo, así que cada uno tiene su propio artículo.


Cómo saber si este es tu artículo

Si tu integración…Tu artículo es...
Envía el Nativo en XML, por SOAP o por API REST con RequestTransactionEste artículo
Envía el Nativo en JSON, por API REST con JsonServiceCall o por EndPointJSON Nativo de MYSuite v8
Quiere saber qué transacción usar para emitirCONVERT_NATIVE_XML, en la modalidad que corresponda
Emite constancias de retencionesFIRMAR_RETENCION. Ese flujo no usa el Nativo: recibe el comprobante fiscal ya armado


Requisitos previos

  • El esquema fx_2010_g.xsd, para validar localmente antes de enviar.
  • Los catálogos del SAT que el formato referencia: régimen fiscal, uso de CFDI, clave de producto o servicio, clave de unidad, forma y método de pago, entre otros.
  • Un generador de XML que respete el orden de los nodos: el esquema usa xs:sequence, de modo que el orden importa.


Cómo hacerlo

Para construir un XML Nativo y emitir con él:

  1. Declara el elemento raíz fx:FactDocMX con el espacio de nombres http://www.fact.com.mx/schema/fx y la ubicación del esquema.
    Resultado: un documento que el validador puede reconocer.
  2. Escribe fx:Version con el valor 8. Es fijo: cualquier otro valor invalida el documento.
    Resultado: el documento queda anclado a la versión que produce CFDI 4.0.
  3. Completa los cuatro nodos obligatorios además de la versión: fx:Identificacion, fx:Emisor, fx:Receptor, fx:Conceptos y fx:Totales.
    Resultado: el mínimo que el esquema exige.
  4. Añade el nodo fx:Identificacion/fx:NumeroInterno con el identificador de tu sistema. Es opcional en el esquema, pero sin él pierdes la verificación antiduplicado.
    Resultado: el comprobante queda localizable desde tu ERP si se pierde una respuesta.
  5. Agrega los nodos opcionales que necesites: información global, CFDI relacionados, complementos fiscales, datos comerciales o instrucciones de procesamiento.
    Resultado: el comprobante completo conforme a tu operación.
  6. Respeta el orden de los nodos. El esquema los declara en secuencia, así que un documento con los nodos correctos pero desordenados no valida.
    Resultado: un documento que pasa la validación estructural.
  7. Valida localmente contra fx_2010_g.xsd antes de enviar. No consume folios y detecta los errores más frecuentes.
    Resultado: menos rechazos y menos llamadas desperdiciadas.
  8. Envía el documento con la transacción de emisión de tu modalidad, codificado según lo que esa transacción exija.
    Resultado: comprobante timbrado.

Si algo falla, ve a Solución de problemas.


El formato

1. Identidad del formato

NombreXML Nativo de MYSuite · FactDocMX
Versión8, declarada en fx:Version con valor fijo
Esquemafx_2010_g.xsd
Espacio de nombreshttp://www.fact.com.mx/schema/fx
Elemento raízfx:FactDocMX
CompatibilidadCFDI 4.0 únicamente. La transformación a 4.0 solo funciona con esta variante del esquema
Formato hermanoJSON Nativo de MYSuite v8, no equivalente campo por campo


2. Dimensiones del esquema

Conviene conocerlas antes de planear la implementación, porque explican por qué conviene generar el documento con herramientas y no a mano.

MedidaValor
Tamaño del archivo1,750,905 caracteres · 36,048 líneas
Elementos declarados1,623
Tipos complejos659
Tipos simples1,277, de los cuales 145 con nombre
Enumeraciones2,388
Las 2,388 enumeraciones son, en su mayor parte, catálogos del SAT embebidos en el esquema. Esa es la razón de que validar localmente detecte tantos errores: el esquema no solo comprueba la estructura, también las claves.


3. Estructura de primer nivel

El elemento fx:FactDocMX tiene catorce hijos directos, en este orden.

#NodoObligatoriedadQué contiene
1fx:VersionRequerido · valor fijo 8Versión del formato
2fx:IdentificacionRequeridoPaís y RFC del emisor, tipo de comprobante, razón social, número interno, asignación de serie y folio, lugar de expedición, exportación, confirmación
3fx:CancelacionesOpcionalDatos de cancelación (uso en algunas addendas comerciales)
4fx:InformacionGlobalOpcionalPeriodicidad, meses y año de la factura global
5fx:CfdiRelacionadosOpcionalTipo de relación y folios relacionados
6fx:OrigenOpcionalOrigen de la solicitud
7fx:ProcesamientoOpcionalInstrucciones de procesamiento, entre ellas el envío por correo. Es de tipo TDictionaries
8fx:EmisorRequeridoRégimen fiscal y atributo del adquirente
9fx:ReceptorRequeridoPaís, RFC, nombre, domicilio fiscal, residencia fiscal, identificador tributario, régimen fiscal y uso del CFDI
10fx:ConceptosRequeridoLos conceptos con sus impuestos, partes, información aduanera y cuenta predial
11fx:ImpuestosSATOpcionalResumen de impuestos trasladados y retenidos
12fx:TotalesRequeridoSubtotal, descuento, moneda, tipo de cambio, total, forma de pago, total en letra
13fx:ComplementosOpcionalComplementos fiscales del SAT. Es la rama más extensa: 322 elementos descendientes
14fx:ComprobanteExOpcionalDatos comerciales. Ver el apartado 6
El orden es obligatorio. El esquema declara los catorce nodos dentro de una xs:sequence, de modo que un documento con todos los nodos correctos pero en otro orden no valida. Es el error estructural más frecuente en integraciones que construyen el XML concatenando cadenas.


4. Nodos propios de MYSuite, sin equivalente fiscal

Estos elementos no corresponden a ningún atributo del CFDI: son requisitos de la plataforma o datos para la representación gráfica.

ElementoConsideración
fx:FactDocMX
<fx:Version>8</fx:Version>La transformación fx-cfdv40 solo funciona con el XML nativo G v.8.
<fx:Identificacion>
<fx:CdgPaisEmisor>MX</fx:CdgPaisEmisor>MX
<fx:Usuario>JES900109Q90User</fx:Usuario>Nombre del usuario
<fx:Receptor>
<fx:CdgPaisReceptor>MX</fx:CdgPaisReceptor>En base a catálogo
<fx:Totales>
<fx:SubTotal>1000.00</fx:SubTotal>Se utiliza cuando el Tipo de Comprobante es un "TRASLADO", en caso de ser diferente el Tipo de Comprobante debe tener el mismo monto/valor que el elemento fx:SubTotalBruto
<fx:TotalEnLetra>UN MIL CINCUENTA Y TRES PESOS 33/100 M.N.</fx:TotalEnLetra>Importe en letra
fx:TotalEnLetra es un buen ejemplo de lo que distingue al Nativo del CFDI: el importe en letra no existe en el Anexo 20, pero casi toda representación gráfica lo lleva. El formato lo pide para no tener que deducirlo.


5. Correspondencia con el CFDI 4.0

Esta es la tabla que resuelve la pregunta más frecuente al implementar: ¿dónde pongo este dato del CFDI dentro del Nativo? Se indica la disponibilidad del atributo en el CFDI —requerido, opcional o condicional— y su ruta en el XML Nativo.

Los atributos del CFDI que no aparecen en esta tabla son los que MYSuite conforma durante el procesamiento: la versión, el sello, el número de certificado y el certificado. No los envíes.


Rama fx:Identificacion

Atributo o elemento del CFDI 4.0DisponibilidadRuta en el XML Nativo v8
SerieOpcional/fx:FactDocMX/fx:Identificacion/fx:AsignacionSolicitada/fx:Serie
FolioOpcional/fx:FactDocMX/fx:Identificacion/fx:AsignacionSolicitada/fx:Folio
FechaRequerido/fx:FactDocMX/fx:Identificacion/fx:AsignacionSolicitada/fx:TiempoDeEmision
TipoDeComprobanteRequerido/fx:FactDocMX/fx:Identificacion/fx:TipoDeComprobante
MYSuite asigna el valor del catálogo catCFDI:c_TipoDeComprobante publicado por el SAT.
ExportacionRequerido/fx:FactDocMX/fx:Identificacion/fx:Exportacion
Para su llenado debe utilizarse el catálogo catCFDI:c_Exportacion publicado por el SAT.
LugarExpedicionRequerido/fx:FactDocMX/fx:Identificacion/fx:LugarExpedicion
Para su llenado debe utilizarse el catálogo catCFDI:c_CodigoPostal publicado por el SAT.
ConfirmacionCondicional/fx:FactDocMX/fx:Identificacion/fx:Confirmacion
RfcRequerido/fx:FactDocMX/fx:Identificacion/fx:RFCEmisor
NombreRequerido/fx:FactDocMX/fx:Identificacion/fx:RazonSocialEmisor
Este elemento debe declararse conforme a la constancia fiscal del contribuyente.


Rama fx:InformacionGlobal

Atributo o elemento del CFDI 4.0DisponibilidadRuta en el XML Nativo v8
PeriodicidadRequerido/fx:FactDocMX/fx:InformacionGlobal/fx:Periodicidad
Para su llenado debe utilizarse el catálogo catCFDI:c_Periodicidad publicado por el SAT.
MesesRequerido/fx:FactDocMX/fx:InformacionGlobal/fx:Meses
Para su llenado debe utilizarse el catálogo catCFDI:c_Meses publicado por el SAT.
AñoRequerido/fx:FactDocMX/fx:InformacionGlobal/fx:Año


Rama fx:CfdiRelacionados

Atributo o elemento del CFDI 4.0DisponibilidadRuta en el XML Nativo v8
TipoRelacionRequerido/fx:FactDocMX/fx:CfdiRelacionados/fx:TipoRelacion
Para su llenado debe utilizarse el catálogo catCFDI:c_TipoRelacion publicado por el SAT.
UUIDRequerido/fx:FactDocMX/fx:CfdiRelacionados/fx:CfdiRelacionado/fx:UUID


Rama fx:Emisor

Atributo o elemento del CFDI 4.0DisponibilidadRuta en el XML Nativo v8
RegimenFiscalRequerido/fx:FactDocMX/fx:Emisor/fx:RegimenFiscal/fx:Regimen
Para su llenado debe utilizarse el catálogo catCFDI:c_RegimenFiscal publicado por el SAT.
FacAtrAdquirenteCondicional/fx:FactDocMX/fx:Emisor/fx:FacAtrAdquirente


Rama fx:Receptor

Atributo o elemento del CFDI 4.0DisponibilidadRuta en el XML Nativo v8
RfcRequerido/fx:FactDocMX/fx:Receptor/fx:RFCReceptor
NombreRequerido/fx:FactDocMX/fx:Receptor/fx:NombreReceptor
Este elemento debe declararse conforme a la constancia fiscal del contribuyente.
DomicilioFiscalReceptorRequerido/fx:FactDocMX/fx:Receptor/fx:DomicilioFiscalReceptor
ResidenciaFiscalCondicional/fx:FactDocMX/fx:Receptor/fx:ResidenciaFiscal
Para su llenado debe utilizarse el catálogo catCFDI:c_Pais publicado por el SAT.
NumRegIdTribCondicional/fx:FactDocMX/fx:Receptor/fx:TaxID
RegimenFiscalReceptorRequerido/fx:FactDocMX/fx:Receptor/fx:RegimenFiscalReceptor
Para su llenado debe utilizarse el catálogo catCFDI:c_RegimenFiscal publicado por el SAT.
UsoCFDIRequerido/fx:FactDocMX/fx:Receptor/fx:UsoCFDI
Para su llenado debe utilizarse el catálogo catCFDI:c_UsoCFDI publicado por el SAT.


Rama fx:Conceptos

Atributo o elemento del CFDI 4.0DisponibilidadRuta en el XML Nativo v8
ClaveProdServRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ClaveProdServ
Para su llenado debe utilizarse el catálogo catCFDI:c_ClaveProdServ publicado por el SAT.
NoIdentificacionOpcional/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Codigo
CantidadRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Cantidad
ClaveUnidadRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ClaveUnidad
Para su llenado debe utilizarse el catálogo catCFDI:c_ClaveUnidad publicado por el SAT.
UnidadOpcional/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:UnidadDeMedida
DescripcionRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Descripcion
Longitud máxima 1000 caracteres.
ValorUnitarioRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ValorUnitario
ImporteRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Importe
DescuentoOpcional/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Descuento
ObjetoImpRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ObjetoImp
Para su llenado debe utilizarse el catálogo catCFDI:c_ObjetoImp publicado por el SAT.
BaseRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@Base
ImpuestoRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@Impuesto
Para su llenado debe utilizarse el catálogo catCFDI:c_Impuesto publicado por el SAT.
TipoFactorRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@TipoFactor
Para su llenado debe utilizarse el catálogo catCFDI:c_TipoFactor publicado por el SAT.
TasaOCuotaCondicional/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@TasaOCuota
ImporteCondicional/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@Importe
BaseRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Retenciones/fx:Retencion/@Base
ImpuestoRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Retenciones/fx:Retencion/@Impuesto
Para su llenado debe utilizarse el catálogo catCFDI:c_Impuesto publicado por el SAT.
TipoFactorRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Retenciones/fx:Retencion/@TipoFactor
Para su llenado debe utilizarse el catálogo catCFDI:c_TipoFactor publicado por el SAT.
TasaOCuotaRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Retenciones/fx:Retencion/@TasaOCuota
ImporteRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Retenciones/fx:Retencion/@Importe
RfcACuentaTercerosRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ACuentaTerceros/fx:ACuentaTerceros/@RfcACuentaTerceros
Es la Clave del Registro Federal de Contribuyentes del contribuyente Tercero, a cuenta del que se realiza la operación.
NombreACuentaTercerosRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ACuentaTerceros/fx:ACuentaTerceros/@NombreACuentaTerceros
Es el nombre, denominación o razón social del contribuyente Tercero correspondiente con el Rfc, a cuenta del que se realiza la operación.
RegimenFiscalACuentaTercerosRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ACuentaTerceros/fx:ACuentaTerceros/@RegimenFiscalACuentaTerceros
Es la clave del régimen del contribuyente Tercero, a cuenta del que se realiza la operación.
DomicilioFiscalACuentaTercerosRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ACuentaTerceros/fx:ACuentaTerceros/@DomicilioFiscalACuentaTerceros
Es el código postal del domicilio fiscal del Tercero, a cuenta del que se realiza la operación.
NumeroPedimentoRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:DatosDeImportacion/fx:InformacionAduanera/fx:NumeroDePedimento
Es el número del pedimento que ampara la importación del bien que se expresa en el siguiente formato: últimos 2 dígitos del año de validación seguidos por dos espacios, 2 dígitos de la aduana de despacho seguidos por dos espacios, 4 dígitos del número de la patente seguidos por dos espacios, 1 dígito que corresponde al último dígito del año en curso, salvo que se trate de un pedimento consolidado iniciado en el año inmediato anterior o del pedimento original de una rectificación, seguido de 6 dígitos de la numeración progresiva por aduana. Para su llenado debe utilizarse el catálogo catCFDI:C_NumPedimentoAduana publicado por el SAT
NumeroRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:CuentaPredial
Es el número de la cuenta predial del inmueble cubierto por el presente concepto, o bien para incorporar los datos de identificación del certificado de participación inmobiliaria no amortizable, tratándose de arrendamiento. Puede utilizarse desde 1 hasta "n" números de cuenta predial.
ClaveProdServRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:Parte/@ClaveProdServ
Para su llenado debe utilizarse el catálogo catCFDI:c_ClaveProdServ publicado por el SAT.
NoIdentificacionOpcional/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:Parte/@NoIdentificacion
Es el número de serie, número de parte del bien o identificador del producto o del servicio amparado por la presente parte. Opcionalmente se puede utilizar claves del estándar GTIN.
CantidadRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:Parte/@Cantidad
UnidadOpcional/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:Parte/@UnidadMedida
Para su llenado debe utilizarse el catálogo catCFDI:c_ClaveUnidad publicado por el SAT.
DescripcionRequerido/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:Parte/@Descripcion
Longitud máxima 1000 caracteres.
ValorUnitarioOpcional/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:Parte/@ValorUnitario
Es el valor o precio unitario del bien o servicio cubierto por la presente parte. No se permiten valores negativos.
ImporteOpcional/fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:Parte/@Importe
Es el importe total de los bienes o servicios de la presente parte. Debe ser equivalente al resultado de multiplicar la cantidad por el valor unitario expresado en la parte. No se permiten valores negativos.


Rama fx:ImpuestosSAT

Atributo o elemento del CFDI 4.0DisponibilidadRuta en el XML Nativo v8
TotalImpuestosRetenidosCondicional/fx:FactDocMX/fx:ImpuestosSAT/@TotalImpuestosRetenidos
Es el total de los impuestos retenidos que se desprenden de los conceptos expresados en el comprobante fiscal digital por Internet. No se permiten valores negativos. Es requerido cuando en los conceptos se registren impuestos retenidos.
TotalImpuestosTrasladadosCondicional/fx:FactDocMX/fx:ImpuestosSAT/@TotalImpuestosTrasladados
Es el total de los impuestos trasladados que se desprenden de los conceptos expresados en el comprobante fiscal digital por Internet. No se permiten valores negativos. Es requerido cuando en los conceptos se registren impuestos trasladados.
ImpuestoRequerido/fx:FactDocMX/fx:ImpuestosSAT/fx:Retenciones/fx:Retencion/@Impuesto
Elemento para señalar la clave del tipo de impuesto retenido. Para su llenado debe utilizarse el catálogo catCFDI:c_Impuesto publicado por el SAT.
ImporteRequerido/fx:FactDocMX/fx:ImpuestosSAT/fx:Retenciones/fx:Retencion/@Importe
Es el monto del impuesto retenido. No se permiten valores negativos.
BaseRequerido/fx:FactDocMX/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@Base
Elemento para señalar la suma de los atributos Base de los conceptos del impuesto trasladado. No se permiten valores negativos.
ImpuestoRequerido/fx:FactDocMX/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@Impuesto
Para su llenado debe utilizarse el catálogo catCFDI:c_Impuesto publicado por el SAT.
TipoFactorRequerido/fx:FactDocMX/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@TipoFactor
Para su llenado debe utilizarse el catálogo catCFDI:c_TipoFactor publicado por el SAT.
TasaOCuotaCondicional/fx:FactDocMX/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@TasaOCuota
Para su llenado debe utilizarse el catálogo catCFDI:c_TasaoCuota publicado por el SAT.
ImporteCondicional/fx:FactDocMX/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@Importe
Es la suma del importe del impuesto trasladado, agrupado por impuesto, TipoFactor y TasaOCuota. No se permiten valores negativos.


Rama fx:Totales

Atributo o elemento del CFDI 4.0DisponibilidadRuta en el XML Nativo v8
FormaPagoCondicional/fx:FactDocMX/fx:Totales/fx:FormaDePago
Para su llenado debe utilizarse el catálogo catCFDI:c_FormaPago publicado por el SAT.
SubTotalRequerido/fx:FactDocMX/fx:Totales/fx:SubTotalBruto
Si el Tipo de Comprobante es "T" (Traslado), entonces se toma de la ruta: /fx:FactDocMX/fx:Totales/fx:SubTotal
DescuentoCondicional/fx:FactDocMX/fx:Totales/fx:Descuento
MonedaRequerido/fx:FactDocMX/fx:Totales/fx:Moneda
Para su llenado debe utilizarse el catálogo catCFDI:c_Moneda publicado por el SAT.
TipoCambioCondicional/fx:FactDocMX/fx:Totales/fx:TipoDeCambioVenta
TotalRequerido/fx:FactDocMX/fx:Totales/fx:Total


Rama fx:ComprobanteEx

Atributo o elemento del CFDI 4.0DisponibilidadRuta en el XML Nativo v8
CondicionesDePagoCondicional/fx:FactDocMX/fx:ComprobanteEx/fx:TerminosDePago/fx:CondicionesDePago
MetodoPagoCondicional/fx:FactDocMX/fx:ComprobanteEx/fx:TerminosDePago/fx:MetodoDePago
Para su llenado debe utilizarse el catálogo catCFDI:c_MetodoPago publicado por el SAT.


Rama fx:Complementos

Atributo o elemento del CFDI 4.0DisponibilidadRuta en el XML Nativo v8
<cfdi:Complemento></cfdi:ComplementoOpcional/fx:FactDocMX/fx:Complementos/


6. fx:ComprobanteEx: datos comerciales y addendas

Es el nodo de extensión del formato y el gran ausente de la documentación actual. Agrupa información que no es fiscal pero que el receptor exige: referencias de compra, datos de embarque, condiciones de pago comerciales, y estructuras completas de addenda para clientes concretos.

GrupoPara qué sirve
Datos de negocioDivisión, línea de negocio, región, sucursal, ejecutivo, vendedor
Datos de intercambioIdentificadores de emisor y receptor para intercambio electrónico
Datos comercialesOrden de compra, contrarrecibo, contrato, número de cliente, número de proveedor
Términos de pagoDías de pago, fecha de vencimiento, periodo facturado, descuentos por pronto pago
Datos de embarqueLugar de entrega, transportista, pedimento, contenedor, peso, volumen, piezas
Addendas por clienteEstructuras específicas para receptores que las exigen


7. Complementos fiscales soportados

El formato admite los complementos vigentes para CFDI 4.0, a nivel de comprobante y a nivel de concepto.

Ruta en el XML Nativo
fx:Opciones/fx:ComplementoConcepto
fx:Opciones/fx:ComplementoConcepto/fx:InstEducativas
fx:Opciones/fx:ComplementoConcepto/fx:VentaVehiculos11
fx:Opciones/fx:ComplementoConcepto/fx:HidroYPetro
fx:FactDocMX/fx:Complementos
fx:FactDocMX/fx:Complementos/fx:Nomina12
fx:FactDocMX/fx:Complementos/fx:PagoEnEspecie
fx:FactDocMX/fx:Complementos/fx:Aerolineas
fx:FactDocMX/fx:Complementos/fx:ValesDeDespensa
fx:FactDocMX/fx:Complementos/fx:ConsumoDeCombustibles11
fx:FactDocMX/fx:Complementos/fx:EstadoDeCuentaCombustible12
fx:FactDocMX/fx:Complementos/fx:NotariosPublicos
fx:FactDocMX/fx:Complementos/fx:LeyendasFiscales
fx:FactDocMX/fx:Complementos/fx:VehiculoUsado
fx:FactDocMX/fx:Complementos/fx:renovacionysustitucionvehiculos
fx:FactDocMX/fx:Complementos/fx:certificadodedestruccion
fx:FactDocMX/fx:Complementos/fx:parcialesconstruccion
fx:FactDocMX/fx:Complementos/fx:INE11
fx:FactDocMX/fx:Complementos/fx:ComercioExterior20
fx:FactDocMX/fx:Complementos/fx:Pagos20
fx:FactDocMX/fx:Complementos/fx:ImpuestosLocal
fx:FactDocMX/fx:Complementos/fx:TuristaPasajeroExtranjero
fx:FactDocMX/fx:Complementos/fx:PFintegranteCoordinado
fx:FactDocMX/fx:Complementos/fx:obrasarteantiguedades
fx:FactDocMX/fx:Complementos/fx:detallista
fx:FactDocMX/fx:Complementos/fx:GastosHidrocarburos
fx:FactDocMX/fx:Complementos/fx:IngresosHidrocarburos
fx:FactDocMX/fx:Complementos/fx:CUV
fx:FactDocMX/fx:Complementos/fx:CartaPorte31


8. Instrucciones de procesamiento

fx:Procesamiento es de tipo TDictionaries: la misma estructura Dictionary/Entry que usan los criterios de las transacciones de consulta y cancelación. Dentro del documento sirve para pedir acciones a la plataforma, siendo el envío por correo del XML y el PDF la más usada.

Conviene notar la simetría: el patrón Dictionary no es exclusivo de las peticiones, también vive dentro del documento. Si ya tienes código que lo construye para una consulta, lo reutilizas aquí.


9. Validación local

Validar contra fx_2010_g.xsd antes de enviar es la medida de mayor rendimiento de toda la integración: no consume folios, se ejecuta en tu servidor y detecta los errores más frecuentes.

Qué detectaQué no detecta
Nodos obligatorios ausentes · orden incorrecto · tipos de dato inválidos · longitudes excedidas · claves fuera de catálogoCoherencia aritmética de importes · vigencia del CSD · existencia del RFC en la Lista de RFC Inscritos · reglas de negocio de la plataforma


10. Versionado y cumplimiento

  • La versión 8 del formato aplica únicamente a CFDI 4.0. El esquema fija fx:Version en 8 y la transformación a 4.0 solo opera con la variante g.
  • El XML Nativo no es un comprobante fiscal: es el insumo con el que MYSuite lo construye. No tiene sello, ni timbre, ni valor probatorio.
  • Los catálogos que el formato referencia los publica el SAT. Cuando el SAT los actualiza, la plataforma incorpora el cambio; tu integración solo se ve afectada si usaba una clave que dejó de existir.

Solución de problemas

"Mi XML tiene todos los nodos y aun así no valida"


Problema. El validador rechaza el documento señalando un elemento inesperado, aunque ese elemento sí existe en el esquema.

Entorno. Emisión · integraciones que construyen el XML concatenando cadenas.

Resolución. Revisa el orden de los nodos. El esquema los declara en secuencia, así que fx:Totales después de fx:Complementos es inválido aunque ambos existan. El orden correcto de los catorce nodos de primer nivel está en el apartado 3.

Causa. Es el error estructural más frecuente. Generar el XML con una librería que respete el esquema lo evita de raíz.

"Validé contra el esquema del CFDI y no funciona"


Problema. La validación local falla por completo, con errores de espacio de nombres.

Entorno. Emisión · integraciones nuevas.

Resolución. Son dos documentos distintos. El XML Nativo usa http://www.fact.com.mx/schema/fx y se valida contra fx_2010_g.xsd; el CFDI usa el espacio de nombres del SAT y su propio esquema. Valida tu archivo de entrada contra el primero.

Causa. Confusión entre lo que envías y lo que recibes.

"No sé dónde va un dato del CFDI dentro del Nativo"


Problema. El ERP tiene el dato pero no se sabe a qué nodo corresponde.

Entorno. Emisión · implementación inicial.

Resolución. Consulta la tabla de correspondencia del apartado 5, que recorre el CFDI 4.0 atributo por atributo y da la ruta en el Nativo. Si el atributo no aparece, lo más probable es que MYSuite lo genere durante el procesamiento: la versión, el sello, el número de certificado y el certificado no se envían.

Causa. No todo atributo del CFDI tiene origen en el Nativo.

"El receptor me exige una addenda y no encuentro el nodo"


Problema. Se busca un elemento fx:Addenda que no existe.

Entorno. Emisión · clientes con requisitos de addenda.

Resolución. Las addendas de cliente viven dentro de fx:ComprobanteEx, el décimocuarto nodo de primer nivel. No confundas ese nodo con fx:Procesamiento, que es para instrucciones de proceso como el envío por correo.

Causa. El vocabulario de la documentación designa dos cosas distintas con la misma palabra.

"Emito con versión 8 y el CFDI sale en 3.3"


Problema. El comprobante resultante no es de la versión esperada.

Entorno. Emisión · migraciones a CFDI 4.0.

Resolución. Verifica que estés validando y generando contra fx_2010_g.xsd y no contra una variante anterior del esquema. La transformación que produce CFDI 4.0 solo opera con esa variante. Si tu proyecto conserva un esquema antiguo en su carpeta de recursos, es el primer sitio donde mirar.

Causa. Esquema desactualizado en el proyecto, aunque el contenido del documento sea correcto.

"Me rechaza una clave que existe en el catálogo del SAT"


Problema. El validador local rechaza un valor que el contribuyente usa sin problema en otros sistemas.

Entorno. Emisión · validación local.

Resolución. El esquema lleva los catálogos embebidos como enumeraciones, de modo que valida las claves además de la estructura. Si el SAT publicó una clave nueva y tu copia del esquema es anterior, el rechazo es de tu copia y no del servicio. Actualiza el esquema antes de escalar.

Causa. Copia local del esquema desfasada respecto a los catálogos vigentes.

"Pasé mi Nativo a JSON y lo rechaza"


Problema. La conversión directa del XML a JSON no funciona al cambiar de modalidad.

Entorno. Migraciones entre modalidades.

Resolución. Los dos formatos no son equivalentes campo por campo. No basta con convertir la sintaxis: hay que trabajar sobre la estructura publicada para JSON. Consulta el artículo del JSON Nativo y los archivos de ejemplo que lo acompañan.

Causa. La diferencia entre modalidades no es solo de transporte, también de modelo de datos.

"No envié número interno y ahora no puedo verificar una emisión"


Problema. Tras perder una respuesta, no hay forma de saber si el comprobante se emitió.

Entorno. Emisión · recuperación ante cortes de conexión.

Resolución. El número interno es opcional en el esquema pero es el único dato tuyo que viaja con el comprobante y permite localizarlo después con las transacciones de búsqueda. Incorpóralo siempre, y hazlo único por comprobante en tu sistema: si lo reutilizas, el conteo deja de ser una señal fiable.

Causa. La capacidad de recuperarse de un corte se decide al implementar la emisión, no al implementar la recuperación.


Para entender más

Qué problema resuelve el Nativo

El Anexo 20 es extenso y cambia. Si cada ERP tuviera que construir el CFDI directamente, cada cambio normativo obligaría a tocar todos los sistemas de todos los clientes. El Nativo interpone una capa: tú entregas datos de negocio con una estructura estable y la plataforma absorbe la complejidad fiscal. Cuando el SAT cambia algo, lo habitual es que tu integración ni se entere.

El coste de ese arreglo es que hay un formato más que aprender. La compensación se nota con el tiempo: el Nativo ha pasado por ocho versiones mientras el CFDI iba por varias revisiones, y la mayoría de esos cambios no llegaron al cliente.

Por qué la versión 8 solo sirve para 4.0

El esquema fija fx:Version en 8, lo que significa que un documento de esta versión no puede declarar otra cosa. Y la transformación que produce el comprobante —la pieza que convierte el Nativo en CFDI— está escrita contra esta variante del esquema. Son dos candados que apuntan en la misma dirección: versión del formato y versión del comprobante van juntas y no se mezclan.

Para quien integra, la consecuencia práctica es que migrar a CFDI 4.0 no es cambiar un par de campos: es adoptar la versión 8 del formato completa.

Lo que el Nativo tiene y el CFDI no

Tres cosas, y conviene distinguirlas porque responden a propósitos distintos. El número interno es tuyo y sirve para reconciliar; no tiene efecto fiscal pero es lo que te salva tras un corte de conexión. El total en letra y otros datos de presentación existen para la representación gráfica, no para la autoridad. Y fx:ComprobanteEx guarda los datos comerciales que el receptor exige en su addenda, que tampoco son fiscales.

Vistas juntas, las tres explican por qué el Nativo es más grande que el CFDI que produce: lleva información para tres destinatarios —la autoridad, el receptor y tu propio sistema— mientras que el CFDI solo sirve al primero.

Por qué el orden de los nodos importa

El esquema usa xs:sequence y no xs:all, de modo que los elementos deben aparecer en el orden declarado. Es una decisión habitual en esquemas grandes porque hace la validación más rápida y el análisis más predecible, pero sorprende a quien viene de JSON, donde el orden de las claves es indiferente. Si tu integración genera el XML concatenando cadenas, ese es el primer sitio donde buscar cuando algo no valida.

La validación local es la mejor inversión de la integración

El esquema lleva 2,388 enumeraciones embebidas, que son en su mayor parte catálogos del SAT. Eso convierte la validación local en algo más que una comprobación de estructura: también verifica las claves. Y todo ello sin consumir folios ni depender de la red.

Conviene ser claro sobre sus límites, para no confiarse: no comprueba la aritmética de los importes, ni la vigencia del CSD, ni que el RFC exista en la Lista de RFC Inscritos. Esas validaciones ocurren del lado de la plataforma y del SAT, y son las que producen los rechazos que sí cuestan.

Por qué hay dos formatos y no uno

El Nativo nació en XML, que era el formato natural cuando se diseñó y el que encajaba con un servicio SOAP. Cuando aparecieron las modalidades que intercambian JSON, obligar a sus clientes a generar XML para envolverlo en JSON habría sido incómodo, así que el mismo modelo se publicó serializado en JSON.

Lo importante es que la traducción no fue mecánica: los dos formatos no son equivalentes campo por campo. Por eso tienen artículos separados, y por eso migrar entre modalidades obliga a reescribir la capa que genera el documento de entrada y no solo la que lo envía.