El error 301 - XML mal formado puede presentarse al momento de timbrar un Comprobante Fiscal Digital por Internet (CFDI) de nómina, cuando los datos bancarios del colaborador no cumplen con el formato requerido. 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. Este error es una indicación general de que la estructura del XML generado no cumple con los esquemas de validación del Servicio de Administración Tributaria (SAT) o del servicio de timbrado utilizado.
Identificación de los Mensajes de Error Comunes
Para solucionar el mensaje «Error del servicio de timbrado Aspel 301 - XML mal formado» que se despliega al timbrar un CFDI, es fundamental observar los mensajes en el sistema. El sistema puede mostrar los siguientes avisos detallados que ayudan a identificar la causa raíz del problema:
- «El CFDI no tiene una estructura XML correcta. Error del servicio de timbrado ASPEL: 301-XML mal formado, XML Validation: The canonical form of the value ‘0000000052’ is not valid according to the specified type: /*: Comprobante [1]/*: Complemento [1…: CuentaBancaria Detalle: 301]».
- «La longitud del campo ‘Control de Banco’ debe tener longitud de 10, 11, 16 o 18 posiciones, verifica los datos del trabajador».
- «Error del servicio de timbrado ASPEL : 301 - XML mal formado. 301 - XML mal formado. cvc-enumeration-valid: El valor ‘000’ no es de faceta válida con respecto a la enumeración ‘[001, 002, 003, 004, 005, 006, 007, 008, 009, 010, 011, 012, 013, 014, 015, 016, 017, 018, 019, 020, 021, 022, 023, 024, 025, 026, 027, 028, 029, 030, 031, 032, 033, 034, 035, 036, 037, 038, 039, 040, 041, 042, 043, 044, 045, 046, 047, 048, 049, 050, 051, 052, 053, 054, 055, 056, 057, 058, 059, 060, 061, 062, 063, 064, 065, 066, 067, 068, 069, 070, 071, 072, 073, 074, 075, 076, 077, 078, 079, 080, 081, 082, 083, 084, 085, 086, 087, 088, 089, 090, 091, 092, 093, 094, 095, 096, 097, 098, 099, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113]’. Debe ser un valor de la enumeración.»
- «Error del servicio de timbrado ASPEL : 301 - XML mal formado. 301 - XML mal formado. cvc-enumeration-valid: El valor ‘016’ no es de faceta válida con respecto a la enumeración ‘[001, 002, 003, 004, 005, 006, 009, 010, 011, 012, 013, 014, 015, 019, 020, 021, 022, 023, 024, 025, 026, 027, 028, 029, 030, 031, 032, 033, 034, 035, 036, 037, 038, 039, 044, 045, 046, 047, 048, 049, 050, 051, 052, 053, 054, 055, 056]’. Debe ser un valor de la enumeración.»
- «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.»
Causas Comunes y Sus Soluciones para el Error 301
Los mensajes anteriores indican que la estructura del XML no es correcta, debido a la falta de un atributo obligatorio o a que algún dato no coincide con los valores permitidos por las reglas de validación del SAT. A continuación, se detallan las causas más frecuentes y cómo corregirlas:
Datos Bancarios del Colaborador (Nómina) Mal Formados
El error 301 - XML mal formado puede presentarse específicamente al timbrar un CFDI de nómina, cuando los datos bancarios del colaborador no cumplen con el formato requerido. Un mensaje común asociado a esta situación es: «La longitud del campo ‘Control de Banco’ debe tener longitud de 10, 11, 16 o 18 posiciones, verifica los datos del trabajador».
Para corregir la información bancaria, realiza lo siguiente:
Lea también: Guía para Aceptar y Cancelar CFDI
- 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 .
- Verifica el campo Control de Banco.
Haz clic en Datos generales y selecciona la pestaña Salario. Localiza la sección Depósito de nómina y revisa el campo Control de Banco.
- Asegura el formato correcto.
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.
Falta o Invalidez del Sello Digital (CSD)
En ocasiones, el error 301 se presenta porque el XML no contiene el sello digital o este no es válido. Esto es vital para la autenticidad del CFDI.
Para resolverlo, verifica lo siguiente:
Lea también: SAT y CFDI: Entendiendo la relación
- Asegúrate de que el certificado de sello digital (CSD) esté vigente.
- Confirma que los archivos .cer y .key sean correctos y que correspondan entre sí.
- Verifica que la contraseña del certificado esté bien escrita y sea la correcta.
Valores No Válidos en Campos (Violación de Enumeración del SAT)
El mensaje que indica el sistema (“XML mal formado” y código 301) a menudo se debe a que algún dato del CFDI no coincide con los valores permitidos por la enumeración del SAT. Por ejemplo, "cvc-enumeration-valid: El valor ‘000’ no es de faceta válida con respecto a la enumeración..." o "cvc-enumeration-valid: El valor ‘016’ no es de faceta válida con respecto a la enumeración..."
El error indica que el CFDI tiene un valor no permitido en alguno de sus campos. Revisa el CFDI y reemplaza ese valor por uno válido de la enumeración que el SAT establece para ese campo.
Campo 'ImporteExento' Incorrecto en Nómina (Clave 038)
Un caso particular en nómina es el mensaje 301 NOM109, que indica que el campo ImporteExento no está configurado correctamente para una percepción específica.
El mensaje indica que la percepción con clave 038 tiene un valor en ImporteExento distinto de cero. Debes revisar esa percepción en la nómina y asegurarte de que ImporteExento sea 0, ya que esa clave no permite monto exento.
Atributo Obligatorio 'ClaveProdServ' Faltante
Esto se deriva debido a la falta de un atributo obligatorio, como lo indica el sistema con un mensaje como: "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."
Lea también: Aprende a descargar CFDI en lote desde el SAT
Para resolverlo, sigue los pasos indicados a continuación para capturar la Clave SAT de producto o servicio:
- Captura la Clave SAT del producto o servicio.
Ingresa desde la ruta: menú Inventarios, das clic en el ícono Productos y servicios .
- Elige el producto o servicio a modificar.
Selecciona el producto o servicio y das clic en el ícono Modificar que se encuentra en la barra de herramientas.
- Configura la Clave SAT.
En la ventana que se despliega, pulsa en la pestaña Fiscales y elige la Clave SAT que corresponda; oprime el ícono Ayuda , para una selección más específica.
- Corrobora y guarda los datos.
Corrobora que todos los datos fiscales requeridos se encuentren capturados y al finalizar pulsas en el botón Aceptar .
- Genera nuevamente la factura.
Después de realizar los cambios, intenta generar la factura de nuevo.
Resumen de Errores 301 Comunes y Soluciones
| Causa del Error 301 | Mensaje de Error Típico | Solución Recomendada |
|---|---|---|
| Datos bancarios del colaborador con formato incorrecto (Nómina). | "La longitud del campo 'Control de Banco' debe tener longitud de 10, 11, 16 o 18 posiciones..." | Verificar y corregir el campo 'Control de Banco' en el detalle del colaborador (cuenta bancaria a 11 dígitos o CLABE a 18 posiciones). |
| XML sin sello digital o CSD inválido/vencido. | "El XML no contiene el sello digital." | Asegurar que el CSD esté vigente, que los archivos .cer y .key sean correctos y que la contraseña sea la adecuada. |
| Valores en campos que no cumplen con las enumeraciones del SAT. | "cvc-enumeration-valid: El valor '000' no es de faceta válida con respecto a la enumeración..." o "...El valor '016' no es de faceta válida..." | Revisar el CFDI y reemplazar el valor incorrecto por uno válido de la enumeración específica que exige el SAT para ese campo. |
| Campo 'ImporteExento' incorrecto para la percepción Clave 038 en nómina. | "El mensaje 301 NOM109 indica que el campo ImporteExento no está configurado correctamente." | Asegurarse de que el 'ImporteExento' para la percepción con clave 038 sea 0, ya que no permite monto exento. |
| Falta del atributo obligatorio 'ClaveProdServ' en facturas. | "Required attribute ‘ClaveProdServ’ is Missing." | Acceder al producto o servicio y capturar la 'Clave SAT' correspondiente en la pestaña Fiscales. |