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.
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".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.| Si tu integración… | Tu artículo es... |
|---|---|
Envía el Nativo en XML, por SOAP o por API REST con RequestTransaction | Este artículo |
Envía el Nativo en JSON, por API REST con JsonServiceCall o por EndPoint | JSON Nativo de MYSuite v8 |
| Quiere saber qué transacción usar para emitir | CONVERT_NATIVE_XML, en la modalidad que corresponda |
| Emite constancias de retenciones | FIRMAR_RETENCION. Ese flujo no usa el Nativo: recibe el comprobante fiscal ya armado |
fx_2010_g.xsd, para validar localmente antes de enviar.xs:sequence, de modo que el orden importa.Para construir un XML Nativo y emitir con él:
fx:FactDocMX con el espacio de nombres http://www.fact.com.mx/schema/fx y la ubicación del esquema.fx:Version con el valor 8. Es fijo: cualquier otro valor invalida el documento.fx:Identificacion, fx:Emisor, fx:Receptor, fx:Conceptos y fx:Totales.fx:Identificacion/fx:NumeroInterno con el identificador de tu sistema. Es opcional en el esquema, pero sin él pierdes la verificación antiduplicado.fx_2010_g.xsd antes de enviar. No consume folios y detecta los errores más frecuentes.Si algo falla, ve a Solución de problemas.
| Nombre | XML Nativo de MYSuite · FactDocMX |
|---|---|
| Versión | 8, declarada en fx:Version con valor fijo |
| Esquema | fx_2010_g.xsd |
| Espacio de nombres | http://www.fact.com.mx/schema/fx |
| Elemento raíz | fx:FactDocMX |
| Compatibilidad | CFDI 4.0 únicamente. La transformación a 4.0 solo funciona con esta variante del esquema |
| Formato hermano | JSON Nativo de MYSuite v8, no equivalente campo por campo |
Conviene conocerlas antes de planear la implementación, porque explican por qué conviene generar el documento con herramientas y no a mano.
| Medida | Valor |
|---|---|
| Tamaño del archivo | 1,750,905 caracteres · 36,048 líneas |
| Elementos declarados | 1,623 |
| Tipos complejos | 659 |
| Tipos simples | 1,277, de los cuales 145 con nombre |
| Enumeraciones | 2,388 |
El elemento fx:FactDocMX tiene catorce hijos directos, en este orden.
| # | Nodo | Obligatoriedad | Qué contiene |
|---|---|---|---|
| 1 | fx:Version | Requerido · valor fijo 8 | Versión del formato |
| 2 | fx:Identificacion | Requerido | Paí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 |
| 3 | fx:Cancelaciones | Opcional | Datos de cancelación (uso en algunas addendas comerciales) |
| 4 | fx:InformacionGlobal | Opcional | Periodicidad, meses y año de la factura global |
| 5 | fx:CfdiRelacionados | Opcional | Tipo de relación y folios relacionados |
| 6 | fx:Origen | Opcional | Origen de la solicitud |
| 7 | fx:Procesamiento | Opcional | Instrucciones de procesamiento, entre ellas el envío por correo. Es de tipo TDictionaries |
| 8 | fx:Emisor | Requerido | Régimen fiscal y atributo del adquirente |
| 9 | fx:Receptor | Requerido | País, RFC, nombre, domicilio fiscal, residencia fiscal, identificador tributario, régimen fiscal y uso del CFDI |
| 10 | fx:Conceptos | Requerido | Los conceptos con sus impuestos, partes, información aduanera y cuenta predial |
| 11 | fx:ImpuestosSAT | Opcional | Resumen de impuestos trasladados y retenidos |
| 12 | fx:Totales | Requerido | Subtotal, descuento, moneda, tipo de cambio, total, forma de pago, total en letra |
| 13 | fx:Complementos | Opcional | Complementos fiscales del SAT. Es la rama más extensa: 322 elementos descendientes |
| 14 | fx:ComprobanteEx | Opcional | Datos comerciales. Ver el apartado 6 |
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.Estos elementos no corresponden a ningún atributo del CFDI: son requisitos de la plataforma o datos para la representación gráfica.
| Elemento | Consideració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.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.
fx:Identificacion
| Atributo o elemento del CFDI 4.0 | Disponibilidad | Ruta en el XML Nativo v8 |
|---|---|---|
Serie | Opcional | /fx:FactDocMX/fx:Identificacion/fx:AsignacionSolicitada/fx:Serie |
Folio | Opcional | /fx:FactDocMX/fx:Identificacion/fx:AsignacionSolicitada/fx:Folio |
Fecha | Requerido | /fx:FactDocMX/fx:Identificacion/fx:AsignacionSolicitada/fx:TiempoDeEmision |
TipoDeComprobante | Requerido | /fx:FactDocMX/fx:Identificacion/fx:TipoDeComprobanteMYSuite asigna el valor del catálogo catCFDI:c_TipoDeComprobante publicado por el SAT. |
Exportacion | Requerido | /fx:FactDocMX/fx:Identificacion/fx:ExportacionPara su llenado debe utilizarse el catálogo catCFDI:c_Exportacion publicado por el SAT. |
LugarExpedicion | Requerido | /fx:FactDocMX/fx:Identificacion/fx:LugarExpedicionPara su llenado debe utilizarse el catálogo catCFDI:c_CodigoPostal publicado por el SAT. |
Confirmacion | Condicional | /fx:FactDocMX/fx:Identificacion/fx:Confirmacion |
Rfc | Requerido | /fx:FactDocMX/fx:Identificacion/fx:RFCEmisor |
Nombre | Requerido | /fx:FactDocMX/fx:Identificacion/fx:RazonSocialEmisorEste elemento debe declararse conforme a la constancia fiscal del contribuyente. |
fx:InformacionGlobal
| Atributo o elemento del CFDI 4.0 | Disponibilidad | Ruta en el XML Nativo v8 |
|---|---|---|
Periodicidad | Requerido | /fx:FactDocMX/fx:InformacionGlobal/fx:PeriodicidadPara su llenado debe utilizarse el catálogo catCFDI:c_Periodicidad publicado por el SAT. |
Meses | Requerido | /fx:FactDocMX/fx:InformacionGlobal/fx:MesesPara su llenado debe utilizarse el catálogo catCFDI:c_Meses publicado por el SAT. |
Año | Requerido | /fx:FactDocMX/fx:InformacionGlobal/fx:Año |
fx:CfdiRelacionados
| Atributo o elemento del CFDI 4.0 | Disponibilidad | Ruta en el XML Nativo v8 |
|---|---|---|
TipoRelacion | Requerido | /fx:FactDocMX/fx:CfdiRelacionados/fx:TipoRelacionPara su llenado debe utilizarse el catálogo catCFDI:c_TipoRelacion publicado por el SAT. |
UUID | Requerido | /fx:FactDocMX/fx:CfdiRelacionados/fx:CfdiRelacionado/fx:UUID |
fx:Emisor
| Atributo o elemento del CFDI 4.0 | Disponibilidad | Ruta en el XML Nativo v8 |
|---|---|---|
RegimenFiscal | Requerido | /fx:FactDocMX/fx:Emisor/fx:RegimenFiscal/fx:RegimenPara su llenado debe utilizarse el catálogo catCFDI:c_RegimenFiscal publicado por el SAT. |
FacAtrAdquirente | Condicional | /fx:FactDocMX/fx:Emisor/fx:FacAtrAdquirente |
fx:Receptor
| Atributo o elemento del CFDI 4.0 | Disponibilidad | Ruta en el XML Nativo v8 |
|---|---|---|
Rfc | Requerido | /fx:FactDocMX/fx:Receptor/fx:RFCReceptor |
Nombre | Requerido | /fx:FactDocMX/fx:Receptor/fx:NombreReceptorEste elemento debe declararse conforme a la constancia fiscal del contribuyente. |
DomicilioFiscalReceptor | Requerido | /fx:FactDocMX/fx:Receptor/fx:DomicilioFiscalReceptor |
ResidenciaFiscal | Condicional | /fx:FactDocMX/fx:Receptor/fx:ResidenciaFiscalPara su llenado debe utilizarse el catálogo catCFDI:c_Pais publicado por el SAT. |
NumRegIdTrib | Condicional | /fx:FactDocMX/fx:Receptor/fx:TaxID |
RegimenFiscalReceptor | Requerido | /fx:FactDocMX/fx:Receptor/fx:RegimenFiscalReceptorPara su llenado debe utilizarse el catálogo catCFDI:c_RegimenFiscal publicado por el SAT. |
UsoCFDI | Requerido | /fx:FactDocMX/fx:Receptor/fx:UsoCFDIPara su llenado debe utilizarse el catálogo catCFDI:c_UsoCFDI publicado por el SAT. |
fx:Conceptos
| Atributo o elemento del CFDI 4.0 | Disponibilidad | Ruta en el XML Nativo v8 |
|---|---|---|
ClaveProdServ | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ClaveProdServPara su llenado debe utilizarse el catálogo catCFDI:c_ClaveProdServ publicado por el SAT. |
NoIdentificacion | Opcional | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Codigo |
Cantidad | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Cantidad |
ClaveUnidad | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ClaveUnidadPara su llenado debe utilizarse el catálogo catCFDI:c_ClaveUnidad publicado por el SAT. |
Unidad | Opcional | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:UnidadDeMedida |
Descripcion | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:DescripcionLongitud máxima 1000 caracteres. |
ValorUnitario | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ValorUnitario |
Importe | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Importe |
Descuento | Opcional | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Descuento |
ObjetoImp | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ObjetoImpPara su llenado debe utilizarse el catálogo catCFDI:c_ObjetoImp publicado por el SAT. |
Base | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@Base |
Impuesto | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@ImpuestoPara su llenado debe utilizarse el catálogo catCFDI:c_Impuesto publicado por el SAT. |
TipoFactor | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@TipoFactorPara su llenado debe utilizarse el catálogo catCFDI:c_TipoFactor publicado por el SAT. |
TasaOCuota | Condicional | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@TasaOCuota |
Importe | Condicional | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@Importe |
Base | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Retenciones/fx:Retencion/@Base |
Impuesto | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Retenciones/fx:Retencion/@ImpuestoPara su llenado debe utilizarse el catálogo catCFDI:c_Impuesto publicado por el SAT. |
TipoFactor | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Retenciones/fx:Retencion/@TipoFactorPara su llenado debe utilizarse el catálogo catCFDI:c_TipoFactor publicado por el SAT. |
TasaOCuota | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Retenciones/fx:Retencion/@TasaOCuota |
Importe | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ImpuestosSAT/fx:Retenciones/fx:Retencion/@Importe |
RfcACuentaTerceros | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ACuentaTerceros/fx:ACuentaTerceros/@RfcACuentaTercerosEs la Clave del Registro Federal de Contribuyentes del contribuyente Tercero, a cuenta del que se realiza la operación. |
NombreACuentaTerceros | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ACuentaTerceros/fx:ACuentaTerceros/@NombreACuentaTercerosEs el nombre, denominación o razón social del contribuyente Tercero correspondiente con el Rfc, a cuenta del que se realiza la operación. |
RegimenFiscalACuentaTerceros | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ACuentaTerceros/fx:ACuentaTerceros/@RegimenFiscalACuentaTercerosEs la clave del régimen del contribuyente Tercero, a cuenta del que se realiza la operación. |
DomicilioFiscalACuentaTerceros | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:ACuentaTerceros/fx:ACuentaTerceros/@DomicilioFiscalACuentaTercerosEs el código postal del domicilio fiscal del Tercero, a cuenta del que se realiza la operación. |
NumeroPedimento | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:DatosDeImportacion/fx:InformacionAduanera/fx:NumeroDePedimentoEs 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 |
Numero | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:CuentaPredialEs 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. |
ClaveProdServ | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:Parte/@ClaveProdServPara su llenado debe utilizarse el catálogo catCFDI:c_ClaveProdServ publicado por el SAT. |
NoIdentificacion | Opcional | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:Parte/@NoIdentificacionEs 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. |
Cantidad | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:Parte/@Cantidad |
Unidad | Opcional | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:Parte/@UnidadMedidaPara su llenado debe utilizarse el catálogo catCFDI:c_ClaveUnidad publicado por el SAT. |
Descripcion | Requerido | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:Parte/@DescripcionLongitud máxima 1000 caracteres. |
ValorUnitario | Opcional | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:Parte/@ValorUnitarioEs el valor o precio unitario del bien o servicio cubierto por la presente parte. No se permiten valores negativos. |
Importe | Opcional | /fx:FactDocMX/fx:Conceptos/fx:Concepto/fx:Opciones/fx:Parte/@ImporteEs 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. |
fx:ImpuestosSAT
| Atributo o elemento del CFDI 4.0 | Disponibilidad | Ruta en el XML Nativo v8 |
|---|---|---|
TotalImpuestosRetenidos | Condicional | /fx:FactDocMX/fx:ImpuestosSAT/@TotalImpuestosRetenidosEs 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. |
TotalImpuestosTrasladados | Condicional | /fx:FactDocMX/fx:ImpuestosSAT/@TotalImpuestosTrasladadosEs 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. |
Impuesto | Requerido | /fx:FactDocMX/fx:ImpuestosSAT/fx:Retenciones/fx:Retencion/@ImpuestoElemento 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. |
Importe | Requerido | /fx:FactDocMX/fx:ImpuestosSAT/fx:Retenciones/fx:Retencion/@ImporteEs el monto del impuesto retenido. No se permiten valores negativos. |
Base | Requerido | /fx:FactDocMX/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@BaseElemento para señalar la suma de los atributos Base de los conceptos del impuesto trasladado. No se permiten valores negativos. |
Impuesto | Requerido | /fx:FactDocMX/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@ImpuestoPara su llenado debe utilizarse el catálogo catCFDI:c_Impuesto publicado por el SAT. |
TipoFactor | Requerido | /fx:FactDocMX/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@TipoFactorPara su llenado debe utilizarse el catálogo catCFDI:c_TipoFactor publicado por el SAT. |
TasaOCuota | Condicional | /fx:FactDocMX/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@TasaOCuotaPara su llenado debe utilizarse el catálogo catCFDI:c_TasaoCuota publicado por el SAT. |
Importe | Condicional | /fx:FactDocMX/fx:ImpuestosSAT/fx:Traslados/fx:Traslado/@ImporteEs la suma del importe del impuesto trasladado, agrupado por impuesto, TipoFactor y TasaOCuota. No se permiten valores negativos. |
fx:Totales
| Atributo o elemento del CFDI 4.0 | Disponibilidad | Ruta en el XML Nativo v8 |
|---|---|---|
FormaPago | Condicional | /fx:FactDocMX/fx:Totales/fx:FormaDePagoPara su llenado debe utilizarse el catálogo catCFDI:c_FormaPago publicado por el SAT. |
SubTotal | Requerido | /fx:FactDocMX/fx:Totales/fx:SubTotalBrutoSi el Tipo de Comprobante es "T" (Traslado), entonces se toma de la ruta: /fx:FactDocMX/fx:Totales/fx:SubTotal |
Descuento | Condicional | /fx:FactDocMX/fx:Totales/fx:Descuento |
Moneda | Requerido | /fx:FactDocMX/fx:Totales/fx:MonedaPara su llenado debe utilizarse el catálogo catCFDI:c_Moneda publicado por el SAT. |
TipoCambio | Condicional | /fx:FactDocMX/fx:Totales/fx:TipoDeCambioVenta |
Total | Requerido | /fx:FactDocMX/fx:Totales/fx:Total |
fx:ComprobanteEx
| Atributo o elemento del CFDI 4.0 | Disponibilidad | Ruta en el XML Nativo v8 |
|---|---|---|
CondicionesDePago | Condicional | /fx:FactDocMX/fx:ComprobanteEx/fx:TerminosDePago/fx:CondicionesDePago |
MetodoPago | Condicional | /fx:FactDocMX/fx:ComprobanteEx/fx:TerminosDePago/fx:MetodoDePagoPara su llenado debe utilizarse el catálogo catCFDI:c_MetodoPago publicado por el SAT. |
fx:Complementos
| Atributo o elemento del CFDI 4.0 | Disponibilidad | Ruta en el XML Nativo v8 |
|---|---|---|
<cfdi:Complemento></cfdi:Complemento | Opcional | /fx:FactDocMX/fx:Complementos/ |
fx:ComprobanteEx: datos comerciales y addendasEs 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.
| Grupo | Para qué sirve |
|---|---|
| Datos de negocio | División, línea de negocio, región, sucursal, ejecutivo, vendedor |
| Datos de intercambio | Identificadores de emisor y receptor para intercambio electrónico |
| Datos comerciales | Orden de compra, contrarrecibo, contrato, número de cliente, número de proveedor |
| Términos de pago | Días de pago, fecha de vencimiento, periodo facturado, descuentos por pronto pago |
| Datos de embarque | Lugar de entrega, transportista, pedimento, contenedor, peso, volumen, piezas |
| Addendas por cliente | Estructuras específicas para receptores que las exigen |
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 |
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.
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í.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é detecta | Qué no detecta |
|---|---|
| Nodos obligatorios ausentes · orden incorrecto · tipos de dato inválidos · longitudes excedidas · claves fuera de catálogo | Coherencia aritmética de importes · vigencia del CSD · existencia del RFC en la Lista de RFC Inscritos · reglas de negocio de la plataforma |
fx:Version en 8 y la transformación a 4.0 solo opera con la variante g.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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.