Soluciona el mensaje «Error del servicio de timbrado Aspel 301 - XML mal formado» que se despliega al timbrar un Comprobante Fiscal Digital por Internet (CFDI).
Este error se presenta cuando el PAC no puede leer correctamente el XML porque la estructura, etiquetas o sintaxis están rotas. En operación diaria suele aparecer cuando faltan cierres de etiquetas, hay caracteres inválidos o el XML se alteró al exportarlo o transmitirlo. Cuando eso pasa, el PAC o el SAT bloquean el timbrado hasta que el dato quede consistente con el XML, los catálogos y el expediente fiscal que soporta la operación. El error 301 normalmente bloquea el timbrado hasta corregir el dato o cálculo inconsistente.
Causas Comunes del Error 301
Las causas de un XML mal formado pueden ser diversas y se manifiestan de distintas maneras en el sistema de timbrado:
Problemas en la Estructura y Sintaxis del XML
- El archivo se generó incompleto y quedó con nodos sin cerrar o con comillas rotas.
- Una addenda, complemento o posproceso modificó el XML y rompió su sintaxis.
- Se insertaron caracteres especiales o textos copiados desde Excel sin sanitizar el contenido.
- El CFDI no tiene una estructura XML correcta.
Falta de Atributos o Datos Incorrectos
- Esto se deriva debido a la falta del atributo obligatorio, como lo indica el sistema: Error del servicio de timbrado Aspel: 301 - XML mal formado. XML Validation: Required attribute ‘ClaveProdServ’ is Missing. Location: /*:Comprobante[1]/*:Conceptos[1]/*:Concepto[1] Detalle: 301.
- El error 301 - XML mal formado puede presentarse al momento de timbrar un CFDI de nómina, cuando los datos bancarios del colaborador no cumplen con el formato requerido.
- Mensajes como «La longitud del campo ‘Control de Banco’ debe tener longitud de 10, 11, 16 o 18 posiciones, verifica los datos del trabajador» indican datos bancarios incorrectos.
- El error cvc-enumeration-valid: El valor ‘000’ no es de faceta válida con respecto a la enumeración. Debe ser un valor de la enumeración, lo que indica que el CFDI tiene un valor no permitido en alguno de sus campos.
- El mensaje 301 NOM109 indica que el campo ImporteExento no está configurado correctamente. También puede aparecer si la percepción con clave 038 tiene un valor en ImporteExento distinto de cero, ya que esa clave no permite monto exento.
- El mensaje que indica el sistema (“XML mal formado” y código 301) se debe a que algún dato del CFDI no coincide con los valores permitidos por la enumeración del SAT.
Inconsistencias con el Certificado de Sello Digital (CSD)
- El mensaje aparece cuando el XML no contiene el sello digital.
- Probablemente el CSD ya está caducado, deberás obtener un nuevo CSD. Recuerda que el SAT tarda entre 24 y 72 horas en ponerlo en línea, una vez que se le solicita el registro.
- El certificado presentado para realizar el timbrado no es un CSD (Certificado de sello digital), sino un FIEL (Firma Electronica Avanzada).
- El certificado usado al timbrar contiene el RFC del contribuyente quien lo generó. El CSD tiene 3 componentes: un certificado (archivo .CER), una llave privada (archivo .KEY) y una contraseña.
Otros Factores
- El documento generado para solicitar el timbrado tiene el timbre producido para una Factura procesada anteriormente.
- De acuerdo con las disposiciones publicadas por el SAT, el CFDI ver. 3.3 con el complemento de Nómina será vigente hasta el 30 de Junio de 2023.
Soluciones para el Error 301 - XML Mal Formado
Para corregir este error, es crucial identificar el origen exacto del problema y aplicar las siguientes soluciones:
Corrección General del XML
- Abre el XML en un validador sintáctico para ubicar la línea o nodo donde se rompe la estructura.
- Corrige etiquetas, atributos, comillas y caracteres especiales desde el generador del CFDI, no a mano en producción.
- Vuelve a exportar el XML y valídalo antes de reenviarlo al PAC.
Para revisarlo con criterio práctico, conviene identificar exactamente qué campo cambió, si el error viene del dato capturado, del cálculo o de una plantilla desactualizada, y luego regenerar el comprobante completo.
Lea también: Análisis errores 301/302
Soluciones Específicas para Datos y Atributos
Para Clave SAT de Producto o Servicio:
- Captura la Clave SAT del producto o servicio a facturar, ingresas desde la ruta: menú Inventarios, das clic en el ícono Productos y servicios.
- Eliges el producto o servicio y das clic en el ícono Modificar que se encuentra en la barra de herramientas.
- En la ventana que se despliega, pulsas en la pestaña Fiscales y eliges la Clave SAT que corresponda; oprime el ícono Ayuda, para una selección más específica.
- Corrobora que todos los datos fiscales requeridos se encuentren capturados y al finalizar pulsas en el botón Aceptar.
- Genera nuevamente la factura.
Para Datos Bancarios de Nómina:
Identificar y corregir esta información permite asegurar que la cuenta bancaria o la Clave Bancaria Estandarizada (CLABE) esté correctamente registrada, lo que facilita la generación del timbrado sin errores y la correcta emisión de los recibos de nómina.
- Accede al detalle del colaborador: Dirígete al menú Nómina y haz clic en Trabajadores.
- Selecciona al colaborador y haz clic en el ícono Modificar.
- Haz clic en Datos generales y selecciona la pestaña Salario.
- Verifica el campo Control de Banco: Localiza la sección Depósito de nómina y revisa el campo Control de Banco.
- Si ya indicaste el banco operador, asegúrate de registrar la cuenta bancaria a 11 dígitos o la CLABE a 18 posiciones, correspondiente al depósito de nómina.
Para Valores Incorrectos en Enumeraciones o ImporteExento:
- Revisa el CFDI y reemplaza el valor no permitido por uno válido de la enumeración.
- Debes revisar la percepción en la nómina y asegurarte de que ImporteExento sea 0, ya que esa clave no permite monto exento.
Soluciones Relacionadas con el CSD
- Revisar los datos enviados al realizar el timbrado.
- Verifica que el certificado de sello digital (CSD) esté vigente, que los archivos .cer y .key sean correctos y que la contraseña esté bien.
- Obtener un nuevo CSD si el actual está caducado o no es válido.
- Utilizar el CSD correcto o corregir el RFC registrado para el contribuyente.
Cómo Prevenir el Error 301
Para evitar la aparición del error 301, considera las siguientes prácticas:
- No alteres manualmente el XML firmado o sellado después de generarlo.
- Asegura que certificados, fecha, estructura y cadena original se calculen con la misma configuración.
- Valida el XML en un ambiente previo antes de enviarlo al PAC productivo.
Regulación SAT Aplicable
La validación se apoya en el Anexo 20 CFDI 4.0, esquema XSD, cadena original, validaciones del PAC y matriz de errores de CFDI 4.0.
Lea también: Entendiendo los Errores en Auditoría
Lea también: Arreglar error entrada SAT