Códigos De Error

Los servicios de SW devuelven un código de error cuando una solicitud falla. Aquí encuentras qué significa cada uno, cuándo se genera y una herramienta para buscarlo al instante, incluidas las matrices de errores del SAT.

Buscador de códigos de error

¿Recibiste un código y no sabes qué significa?Escríbelo y lo buscamos en este listado y en las matrices de errores del SAT.

Prueba con:

Cómo leer una respuesta de error

{
  "message": "AU2000 - El usuario y/o contraseña son inválidos…",
  "messageDetail": null,
  "data": null,
  "status": "error"
}

1El código de error aparece en message, al inicio, seguido del texto del error. Para buscarlo, escribe solo el código, sin el texto que lo acompaña.
2messageDetail trae información más detallada del error, cuando aplica.
3Los errores de token inválido o caducado pueden llegar sin código, solo con el texto del error (por ejemplo, El token debe contener 3 partes). En ese caso, genera un token nuevo.

Matrices de errores consultadas

El buscador consulta estas matrices del SAT y los códigos de este listado. La lista se mantiene al día automáticamente cuando el SAT publica matrices nuevas.

Cargando…

Catálogo de códigos

Estos son los códigos de respuesta de los servicios de SW, organizados por proceso. Si buscas un código en particular, o uno de las matrices del SAT, usa el buscador de arriba.

💡 Haz clicToca en un código para copiarlo.

Autenticación5 códigos

Código	Mensaje	Cuándo se genera
AU1000	Error No Controlado. No se pudo generar el token de autenticación.	Falla no prevista al generar el token durante la autenticación. Si persiste, contacte a soporte.
AU2000	El usuario y/o contraseña son inválidos, no se puede autenticar el servicio.	La contraseña no coincide con la registrada, o el usuario no existe.
AU2002	El usuario se encuentra inactivo. Favor de contactar a su administrador.	La cuenta fue desactivada por un administrador.
AU4000	No fue posible validar el token.	El token tiene el formato de un JWT (tres partes) pero su contenido no se pudo procesar.
AU4101	El token proporcionado viene vacío.	La petición no incluye la cabecera `Authorization`.

💡 Haz clicToca en un código para copiarlo.

Saldo5 códigos

Código	Mensaje	Cuándo se genera
AU2001	El usuario no tiene saldo en timbres.	La cuenta no tiene timbres disponibles. Puede aparecer en lugar de `S2000` cuando el resultado de saldo de una consulta reciente sigue vigente.
S2000	El saldo del cliente se ha agotado por favor contacte a soporte técnico para más información al respecto.	El saldo de la cuenta, o el de su distribuidor cuando la cuenta es de saldo ilimitado, llegó a cero.
S2101	El cliente o el distribuidor se encuentra inactivo por favor contacte a soporte técnico para más información al respecto.	La cuenta, o su distribuidor, está inactiva o fue eliminada al validar el saldo.
S2102	El token se encuentra inactivo o revocado.	El token con el que se hace la petición está inactivo o fue revocado al validar el saldo.
S1000	Error No Controlado. No se pudo validar el saldo del cliente.	La validación de saldo devolvió un resultado que el servicio no reconoce. Si persiste, contacte a soporte.

💡 Haz clicToca en un código para copiarlo.

Comunes

Aplican a CFDI y a Retenciones cuando el comprobante incluye un complemento.

Código	Mensaje	Cuándo se genera
CO1001	Nombre de Complemento no declarado correctamente.	El prefijo o el nombre del complemento en el XML no corresponde a ninguno de los complementos soportados.
CO1002	Un atributo xmlns:{complemento} de un complemento no se encuentra a nivel Comprobante.	El namespace del complemento (por ejemplo `xmlns:pago20`) se declaró dentro del propio nodo del complemento en vez de declararse en `cfdi:Comprobante`. En Retenciones se refiere al namespace de `retenciones`.
CO1003	Un namespace y/o URL de esquema publico de un complemento no se encuentra a nivel Comprobante.	Falta, en `xsi:schemaLocation` del nodo Comprobante, el par namespace/URL correspondiente al complemento utilizado. En Retenciones se refiere al par namespace/URL de `retenciones`.
CC3001	Un namespace y/o URL de esquema publico (xsi:schemaLocation) del cfdi no se encuentra a nivel Comprobante o no es válido.	Falta, en `xsi:schemaLocation`, el par namespace/URL correspondiente a la versión del CFDI (por ejemplo, el de `http://www.sat.gob.mx/cfd/4`).

CFDI

Código	Mensaje	Cuándo se genera
301	La estructura del comprobante es incorrecta.	El XML no está bien formado, no cumple el esquema XSD de su versión, o su prefijo raíz no es `cfdi`.
303	El RFC del CSD del Emisor no corresponde al RFC que viene como Emisor en el Comprobante.	El RFC registrado en el certificado (CSD) usado para sellar no coincide con `cfdi:Emisor/@Rfc`.
304	El CSD del Emisor ha sido revocado.	El certificado del emisor no tiene estatus activo en la lista de contribuyentes a la fecha de generación del comprobante.
305	La fecha de emisión no está dentro de la vigencia del CSD del Emisor.	La fecha de emisión cae fuera del rango de vigencia del certificado, o el certificado no aparece en la lista de contribuyentes.
306	La llave utilizada para sellar debe ser un CSD.	El comprobante se selló con una FIEL (e.firma) en lugar de un Certificado de Sello Digital.
307	El comprobante contiene un timbre previo.	El XML enviado a timbrar ya incluye un nodo `tfd:TimbreFiscalDigital`. Es el resultado habitual de reenviar un CFDI que ya fue timbrado; en ese caso, el timbre previo viene en `data`.
308	El CSD del Emisor no ha sido firmado por uno de los Certificados de Autoridad de SAT.	La cadena de certificación del CSD no corresponde a ninguna autoridad certificadora del SAT.
401	El rango de la fecha de generación no debe de ser mayor a 72 horas para la emisión del timbre.	La fecha de emisión tiene más de 72 horas de antigüedad, o es posterior a la hora actual más un margen de tolerancia de minutos. El rango se calcula con la zona horaria del código postal declarado en `LugarExpedicion`, no con una hora fija de servidor.
402	RFC del emisor no se encuentra en el régimen de contribuyentes (Lista de validación de régimen) LCO.	El RFC emisor no aparece en la lista de contribuyentes, o no tiene una validez de obligaciones vigente para timbrar.
CFDI3307	Timbre duplicado. El customId proporcionado está duplicado.	Se reutilizó el mismo `customId` con un comprobante distinto, dentro de la ventana de control de duplicados.
CO1005	El namespace y/o URL de esquema publico de un complemento se encuentra a nivel Comprobante.	Solo aparece al validar el comprobante (no al timbrar). Se genera cuando `xmlns:tfd` se declaró a nivel `cfdi:Comprobante` en lugar de dentro del nodo `tfd:TimbreFiscalDigital`.
CC3002	El valor del atributo xmlns:cfdi no es válido según la versión del cfdi.	El namespace declarado en `xmlns:cfdi` no corresponde a la versión indicada en `Version` (por ejemplo, un namespace de la versión 3.3 en un comprobante `Version="4.0"`).
404	La fecha de emisión del comprobante debe de ser anterior al 01 de Abril 2023, correspondiente al periodo de vigencia de CFDI 3.3.	Se conserva por compatibilidad. Se envió un CFDI 3.3 con fecha de emisión posterior al 1 de abril de 2023.
405	La fecha de emisión del comprobante debe de ser anterior al 30 de Junio 2023, correspondiente al periodo de vigencia de CFDI 3.3 con complemento Nomina 1.2	Se conserva por compatibilidad. Se envió un CFDI 3.3 con complemento de Nómina 1.2 y fecha de emisión posterior al 30 de junio de 2023.

Retenciones

Código	Mensaje	Cuándo se genera
303	El RFC del CSD del Emisor no corresponde al RFC que viene como Emisor en el Comprobante.	El RFC registrado en el certificado no coincide con el emisor declarado en la Retención.
304	El CSD del Emisor ha sido revocado.	El certificado del emisor no tiene estatus activo en la lista de contribuyentes.
305	La fecha de emisión no está dentro de la vigencia del CSD del Emisor.	La fecha de la Retención cae fuera del rango de vigencia del certificado, o el certificado no aparece en la lista de contribuyentes.
306	La llave utilizada para sellar debe ser un CSD.	La Retención se selló con una FIEL en lugar de un CSD.
401	El rango de la fecha de generación no debe de ser mayor a 72 horas para la emisión del timbre.	La fecha de la Retención tiene más de 72 horas de antigüedad.
402	RFC del emisor no se encuentra en el régimen de contribuyentes (Lista de validación de régimen) LCO.	El RFC emisor no aparece en la lista de contribuyentes, o no tiene validez de obligaciones vigente.
Reten20101	El resultado de la digestión debe ser igual al resultado de la desencripción del sello.	El sello de la Retención es incorrecto: no coincide con la cadena original firmada con el certificado.
CO1000	Error No Controlado. Si el problema persiste, por favor contacte a soporte técnico para recibir ayuda al respecto.	Falla no prevista durante la validación de la Retención (por ejemplo, al validar el RFC emisor, el certificado o el sello). Si persiste, contacte a soporte.

💡 Haz clicToca en un código para copiarlo.

Cancelación CFDI

Estos códigos corresponden al estatus (CodEstatus) de la solicitud de cancelación. Para más información, consulta Códigos de respuesta de folios de cancelación.

Código	Mensaje	Cuándo se genera
CACFDI33	Problemas con los campos. / Problemas con el xml.	Falta el UUID, el RFC, la contraseña o alguno de los certificados en la solicitud, o el XML de cancelación no se pudo interpretar. Es el mensaje principal cuando alguno de los códigos siguientes ocurre durante la cancelación; revise `messageDetail` para la causa específica.
CASD	Acuse sin descripción específica.	La autoridad certificadora respondió con un estatus que no está contemplado en este catálogo.

Cancelación de Retenciones

Estos códigos aparecen en messageDetail, bajo el mensaje CACFDI33 - Problemas con el xml.

Código	Mensaje	Cuándo se genera
CR1203	UUID no corresponde con el emisor	El UUID solicitado no corresponde al emisor de la petición.
CR1205	UUID No existe	El UUID tiene formato válido pero no corresponde a ninguna Retención existente.
CR1300	Autenticación no válida	Lo determina la respuesta del servicio de certificación de Retenciones sobre los datos de autenticación enviados.
CR1301	XML mal formado	El XML de la solicitud de cancelación no está bien formado.
CR1302	Estructura de folios no válida	La estructura del folio (UUID) enviado no es válida.
CR1303	Estructura de RFC no válida	La estructura de un RFC de la solicitud no es válida.
CR1304	Estructura de fecha no válida	La estructura de la fecha de la solicitud no es válida.
CR1305	Certificado no corresponde al emisor	El certificado enviado no corresponde al RFC del emisor.
CR1306	Certificado no vigente	El certificado de la solicitud no está vigente.
CR1307	Uso de FIEL no permitido	Se intentó firmar la cancelación con una FIEL en lugar de un CSD.
CR1308	Certificado revocado o caduco	El certificado de la solicitud está fuera de vigencia o fue revocado.
CR1309	Firma mal formada o inválida	La firma de la solicitud no se pudo validar.
CR1310	Clave de motivo de cancelación no válida	La clave de motivo de cancelación enviada no es válida.
CR1311	UUID no relacionado de acuerdo a la clave de motivo de cancelación	El motivo de cancelación requiere un UUID relacionado y este no corresponde a la clave de motivo enviada.

¿Tu integración recibió un código que no aparece aquí? Contacta a soporte técnico para que lo agreguemos a este catálogo.

En SW® somos mejores para TI, es por ello que tu opinión es muy importante, por favor ayúdanos calificando este artículo y dejando tus comentarios.

Updated on octubre 23, 2026

Buscador de códigos de error

Catálogo de códigos

Autenticación5 códigos

Saldo5 códigos

Related Articles