Error SAT 302 en la descarga masiva de CFDI: el sello de la petición está mal formado
El código 302 aparece en el servicio de descarga masiva del SAT cuando la petición lleva una firma o sello que no tiene la forma esperada: está incompleta, mal codificada o fue calculada sobre un contenido distinto. No dice que tu e.firma esté vencida ni que sea de otra persona; dice que el sello, tal como llegó, no se puede interpretar. Aquí verás cómo se compone, qué errores de integración lo provocan y por qué no debes enviar tu e.firma ni su contraseña a nadie para resolverlo.
Resumen rápido del error
- Código: 302 (servicio de descarga masiva del SAT)
- Campo: Sello mal formado
- Dónde se presenta: servicio web de descarga masiva del SAT, al autenticar o firmar la petición con la e.firma del contribuyente
- Regla del servicio: La firma de la petición debe tener la estructura y codificación que define el servicio; si no la tiene, el SAT responde 302.
- Mensaje de rechazo: Sello mal formado.
- Cuándo aparece: al firmar la petición con un sello que no tiene la forma o la codificación esperadas.
¿Qué significa el código 302?
Las peticiones al servicio de descarga masiva se autentican con la e.firma del contribuyente: el sistema firma el contenido y adjunta la firma y el certificado. Si esa firma llega en un formato que el servicio no entiende, responde 302.
Es un error de forma. El código 303 ya habla de que el sello no corresponde, y el 304 y el 305 de que el certificado esté revocado o no sea válido. Aquí el servicio ni siquiera pudo leer la firma, por lo que la causa casi siempre está en el software que la genera: una codificación incorrecta, una cadena truncada o un cálculo sobre el contenido equivocado.
Dónde aparece: la firma de la petición
La firma viaja dentro de la petición junto con el certificado de la e.firma y un resumen del contenido firmado. Cada uno debe tener la codificación y el orden definidos.
- Codificación: la firma debe estar en la codificación que pide el servicio; una cadena sin completar se rechaza.
- Contenido firmado: debe ser exactamente el contenido de la petición, sin cambios posteriores.
- Certificado: debe acompañar a la firma en el formato esperado.
- Longitud: una firma truncada por un límite de campo se vuelve ilegible.
Causas más comunes del código 302
- La firma se truncó. Un campo de base de datos o un límite de longitud la cortó.
- Mala codificación. Se envió en un formato distinto al esperado.
- Se modificó la petición después de firmar. Un espacio o una etiqueta cambiaron tras el cálculo.
- Se usó una biblioteca desactualizada. Genera la firma con un algoritmo que el servicio ya no acepta.
- Se confundió el certificado. Se usó el CSD, de facturación, en lugar de la e.firma.
- Hubo un error de integración. El sistema envió el sello vacío o con caracteres especiales.
Cómo resolver el código 302 paso a paso
- Confirma que sea 302. Distínguelo del 303 (sello no corresponde) y del 305 (certificado inválido).
- Revisa el origen de la firma. Confirma que se genere con la e.firma y no con el CSD.
- Verifica la longitud y codificación. Comprueba que no se haya cortado ni cambiado de formato.
- Firma al final. Calcula la firma después de armar la petición completa.
- Actualiza la biblioteca de firma. Usa la versión vigente que indique tu proveedor.
- Si persiste, contacta a soporte. Comparte el RFC, la hora del intento y la petición sin llaves ni contraseñas; nunca envíes tu e.firma, su llave privada ni su contraseña.
Ejemplo de la respuesta del servicio
Ejemplo esquemático de una firma truncada y de una completa; los datos son ficticios y los nombres de atributos pueden variar según la versión del servicio:
Incorrecto:
<Signature><SignatureValue>MIIB...</SignatureValue></Signature> → CodEstatus="302" Mensaje="Sello mal formado"
Correcto:
<Signature><SignatureValue>MIIB...(valor completo)...</SignatureValue></Signature> → CodEstatus="5000" Mensaje="Solicitud aceptada"
La firma del ejemplo es ficticia y abreviada. No compartas valores reales de tu e.firma.
Custodia de la e.firma: qué compartir y qué no
Quien integra tu sistema con el servicio necesita el RFC, las fechas y la petición, pero nunca tu contraseña, tu llave privada ni tus archivos de e.firma. Si tu integración requiere firmar en nombre tuyo, hazlo en un entorno que controles y guarda esos archivos con acceso restringido. Una buena práctica es registrar quién tiene acceso, cuándo cambiar la contraseña y cómo revocar el acceso si alguien deja la empresa. No confundas la e.firma con el CSD: el CSD sirve para sellar facturas y la e.firma para identificarte ante el SAT, por ejemplo, en la descarga masiva. Para repasar el flujo completo, consulta la guía de descarga masiva de CFDI.
Cómo evitar este error con Soicont
Soicont cuenta con un módulo de descarga masiva de CFDI para trabajar con los comprobantes de tus RFC desde la misma plataforma de facturación electrónica. Además, tus folios no caducan y puedes facturar para varias empresas (multi-RFC) desde una sola cuenta.
Conoce la facturación electrónica CFDI 4.0, la plataforma y los paquetes de folios.
Errores relacionados
- Error SAT 303: el sello no corresponde con el solicitante.
- Error SAT 305: el certificado no es válido.
- Error SAT 304: el certificado está revocado o caducó.
- Error SAT 301: el XML de la petición está mal formado.
- Error SAT 300: el usuario no es válido para el servicio.
Consulta también el Centro de Soluciones con todos los errores del SAT.
Preguntas frecuentes
¿Qué significa el error 302?
Que el sello o firma de la petición no tiene la forma esperada.
¿Mi e.firma está vencida?
No necesariamente. Ese caso tiene códigos propios, como el 304.
¿Es lo mismo que el 303?
No. El 303 dice que el sello no corresponde; el 302, que no se puede leer.
¿Puedo mandar mi e.firma a soporte?
No. Nunca compartas la e.firma, su llave privada ni su contraseña.
¿Cuál es la diferencia entre CSD y e.firma?
El CSD sella las facturas; la e.firma te identifica ante el SAT.
¿Qué reviso primero?
La longitud y codificación de la firma y que se calcule al final.
¿Todavía no se resuelve?
Si después de revisar estos puntos el error continúa, escríbenos desde la página de contacto con el código del error, el rango de fechas y el tipo de descarga que solicitaste (nunca envíes contraseñas, la llave privada ni tu e.firma). Si aún no tienes cuenta, crea la tuya y empieza a facturar con validaciones previas.