Catálogo de códigos de error y notificación

Catálogo de códigos de error y notificación

Estado: Vigente · Compatibilidad: Plataforma MYSuite, todas las modalidades (servicios de integración) · Última revisión: 07/08/2026 · Próxima revisión: 07/11/2026 · Responsable: Jan Martínez


De un vistazo


Qué es: la relación de los códigos y mensajes de error que puede devolverte la plataforma MYSuite, sea cual sea la modalidad y el transporte que uses. Sirve para traducir un número a una causa y a una acción.


Cuándo se usa: cuando una transacción te devuelve Result = false y necesitas saber qué significó el código; cuando el mensaje que ve un usuario final no es suficiente para entender qué corregir; y cuando vas a programar la lógica de manejo de errores de tu ERP.


Cuándo no te sirve: este catálogo no explica cómo se arma cada transacción. Para el contrato técnico de una transacción concreta, ve a su artículo.


En una misma respuesta pueden convivir dos numeraciones distintas. El elemento Code —o codeField en API REST— lleva un código de MYSuite, y algunas transacciones devuelven además un código del SAT dentro de las cargas de respuesta. Son catálogos independientes y no deben mezclarse: un error de MYSuite significa que la autoridad nunca se enteró; un código del SAT significa que la solicitud llegó y se obtuvo una respuesta.
El código 1 es éxito. En toda la plataforma, Code = 1 con Result = true indica que la operación se ejecutó. Ten presente que en algunas transacciones eso no equivale a un resultado favorable: en las validaciones el veredicto va aparte, y en las búsquedas el conteo también.


Cómo saber qué código tienes en la mano


Si lo que ves es… Es de la familia… Apártado
Un número de cuatro dígitos que empieza en 3, con una etiqueta en mayúsculas y guión bajo Excepciones de MYSuite. Es el caso más frecuente 2
Un número de cuatro dígitos entre 3134 y 3164 Un error del SAT encapsulado por MYSuite 3
Un número de cuatro dígitos que empieza en 4 o en 5 Error crítico o de sistema de la plataforma 4
Un número de cuatro dígitos que empieza en 6, 7 u 8 Advertencia, no error 5
Un número de cuatro dígitos que empieza en 9 Validación de Anexos sobre el XML 6
Un número de cinco dígitos que empieza en 10 Validación propia de MYSuite sobre el comprobante 7
Un texto que empieza con SAT: seguido de un número Respuesta directa del SAT 8
Un mensaje largo en español que menciona nodos y atributos del CFDI Mensaje ciudadano de validación de complementos 9


Requisitos previos

  • Tener a la mano la respuesta completa de la transacción, no solo el código: la etiqueta, la descripción, la sugerencia y el bloque de diagnóstico aportan contexto que el número por sí solo no da.
  • Saber qué transacción lanzaste y en qué ambiente, porque el mismo código puede tener causas distintas según el contexto.
  • Para reportar a Soporte: el identificador de la operación y el nodo que la atendió, que vienen en la misma respuesta.


Cómo hacerlo


Para diagnosticar una respuesta con error:

  1. Confirma primero que el error es de negocio y no de transporte. La plataforma devuelve HTTP 200 con Result = false; si tu cliente recibió un 4xx o un 5xx, el problema es de red, de credenciales de suscripción o de formato de la petición, y no hay código que buscar aquí.
    Resultado: sabes si el catálogo aplica a tu caso.
  2. Localiza el número en el elemento Code del bloque Response, o en codeField si consumes API REST.
    Resultado: el código que vas a buscar.
  3. Identifica la familia con la tabla que se encuentra en la parte de arriba y ve al apartado que corresponda.
    Resultado: la sección del catálogo donde está tu código.
  4. Contrasta con Description y Hint de la respuesta, que añaden el detalle del caso concreto: qué campo, qué valor, qué comprobante.
    Resultado: la causa en términos de tu operación.
  5. Revisa el elemento Data si existe. En las transacciones de cancelación trae un bloque de diagnóstico con fechas y contexto que no aparece en ningún otro lado.
    Resultado: evidencia para decidir o para escalar.
  6. Distingue si el código es de MYSuite o del SAT. Si está entre 3134 y 3164, MYSuite está encapsulando una respuesta de la autoridad y la causa real es la del código SAT equivalente.
    Resultado: sabes en qué punto del proceso se detuvo la operación.
  7. Decide si reintentar. Los errores de sistema de la familia 5xxx suelen ser transitorios; los de negocio de la familia 3xxx casi nunca lo son, porque reintentar sin corregir reproduce el mismo resultado.
    Resultado: una decisión de reintento con criterio, no por inercia.
  8. Escala a Soporte Especializado si el código no basta, incluyendo el identificador de la operación, el nodo que la atendió, la transacción, el RFC y la marca de tiempo.
    Resultado: un reporte que se puede rastrear en bitácoras sin pedirte más datos.

Si el código que buscas no aparece en este catálogo, ve a Solución de problemas.


El catálogo

1. Cómo está organizado

Los códigos no forman una sola serie. Cada familia tiene un origen distinto dentro de la plataforma y eso determina quién puede corregir el problema.

Familia Qué es Quién corrige Códigos
3xxx Excepciones de negocio de MYSuite Casi siempre tú, en tu ERP o en tus datos 205
4xxx Errores críticos, ligados a certificados y firma del proveedor MYSuite, salvo el formato de RFC 11
5xxx Errores de sistema de la plataforma MYSuite 37
6xxx 7xxx 8xxx Advertencias, no errores Aviso preventivo 6
9xxx Validaciones de Anexos sobre la estructura del XML Tú, en el generador del comprobante 24
10xxx Validaciones propias de MYSuite sobre el contenido Tú, en los datos del comprobante 4
SAT: 2xx a SAT: 1xxx Respuestas de la autoridad fiscal Tú o la autoridad, según el caso 81
Mensajes ciudadanos Validación detallada de complementos Tú, en el complemento Más de 3,000
Los códigos terminados en 000 son marcadores de inicio de familia, no errores reales: 3000 ERRORS_BASE, 4000 CRITICAL_ERRORS_BASE, 5000 SYSTEM_ERRORS_BASE, 6000 ADMIN_WARNINGS_BASE, 7000 USER_WARNINGS_BASE, 8000 PROCESS_WARNINGS_BASE y 9000 ANEXOS_BASE. Si recibes uno de ellos como resultado real, repórtalo: no debería ocurrir.


2. Excepciones de MYSuite · familia 3xxx

Es la familia que verás casi siempre. Agrupa las reglas de negocio de la plataforma: parámetros rechazados, validaciones de emisor y receptor, reglas de timbrado y de cancelación.

3001–3009 · Rechazo de parámetros del sobre

Alguno de los campos de la petición fue rechazado. El nombre de la etiqueta te dice cuál.

Código Etiqueta (LastResult)
3001 TRANSACTION_ID_REJECTED
3002 REQUESTOR_ID_REJECTED
3003 REQUESTOR_REJECTED
3004 COUNTRY_REJECTED
3005 ENTITY_REJECTED
3006 USER_REJECTED
3007 DATA1_REJECTED
3008 DATA2_REJECTED
3009 DATA3_REJECTED

3010–3033 · Estructura, certificados y fechas

Problemas con el XML recibido, con los certificados o con los valores de fecha y hora.

Código Etiqueta (LastResult)
3010 XML_INVALID
3011 ASSIGNMENT_INVALID
3012 PROVIDER_CERT_NOT_FOUND_IN_SAT
3013 ISSUER_CERT_NOT_FOUND_IN_SAT
3014 SSL_CER_KEY_MISMATCH
3015 SSL_CERT_NOT_LISTED
3016 SSL_KEY_LOCKED
3017 SSL_COULD_NOT_SIGN
3018 ENTITY_MISMATCH
3019 USERNAME_REJECTED
3020 REQUESTOR_NOT_FOUND
3021 ENTITY_SIGNATURE_FAILED
3022 SIGNED_XML_NOT_FOUND
3023 CANNOT_CONVERT_TO_INTEGER
3024 DATETIME_INVALID
3025 DATETIME_OUT_OF_RANGE
3026 DATETIME_METAPHYSICAL
3027 DOCUMENT_ALREADY_CANCELLED
3028 DOCUMENT_DOES_NOT_EXIST
3029 DATABASE_ERROR
3030 NO_ERROR
3031 DATETIME_FUTURE
3032 DESERIALIZATION_FAILED
3033 DATETIME_TOO_OLD

3034–3064 · Reglas de emisor, receptor y asignación

Validaciones de negocio sobre quién emite, quién recibe y la asignación de folios.

Código Etiqueta (LastResult)
3034 ISSUER_GENERIC
3035 ISSUER_SAME_AS_RECEIVER
3036 RECEIVER_GENERIC_MISPLACED
3037 ISSUER_NAME_MISMATCH
3038 ISSUER_RFC_MISMATCH
3039 ISSUER_HAS_NOT_INVOICED
3040 DATA_OUT_OF_RANGE
3041 IMF_VOID
3042 DOCUMENT_NON_CONSECUTIVE
3043 PROVIDER_HAS_NOT_INVOICED
3044 IMFP_VOID
3045 MONTHLY_REPORT_FORBIDDEN
3046 PROVIDER_UNKNOWN
3047 TARGET_MATH_FAILED
3048 RECEIVER_TAXID_BAD_FORMAT
3049 OUT_OF_ASSIGNMENT
3050 ASSIGNMENT_NOT_FOUND
3051 ASSIGNMENT_DOES_NOT_EXIST
3052 DATA_MISMATCH
3053 MORE_THAN_ONE_DOCUMENT_EXISTS
3054 COUNTRY_UNSUPPORTED
3055 ASSIGNMENT_COULD_NOT_BE_ACTIVATED
3056 XML_VERSION_INCORRECT
3057 USER_DOES_NOT_EXIST
3058 ACCESS_DENIED
3059 ASSIGNMENT_MODE_MISMATCH
3060 DOCUMENT_ALREADY_EXISTS
3061 ASSIGNMENT_INCONSISTENT
3062 DISTRIBUTION_FAILED
3063 COMMERCIAL_RELATION_MISSING
3064 DOCUMENT_NOT_CANCELLED

3065–3099 · Esquemas, firma y addendas

Validación contra esquemas, firmado digital, certificados y contenido de addendas.

Código Etiqueta (LastResult)
3065 UNRESOLVED_SCHEMA_URI
3066 XML_ILL_FORMED
3067 XML_INLINE_VALIDATION_FAILED
3068 XML_REPOSITORY_VALIDATION_FAILED
3069 XML_ARBITRARY_VALIDATION_FAILED
3070 INTERNET_UNAVALIABLE
3071 ISSUER_CERT_NOT_EMBEDDED
3072 CANNOT_LOAD_CERT
3073 ISSUER_SIGNATURE_INVALID
3074 CERT_SUBJECT_DOES_NOT_MATCH_AUTHORITY
3075 CERT_REVOKED
3076 CERT_NOT_LISTED
3077 CERT_EXPIRED
3078 DOCUMENT_DATE_PREVIOUS_TO_CERT
3079 MISSING_SCHEMA_LOCATION
3080 COULD_NOT_ENROLL_DOCUMENT
3081 BATCH_QUEUE_EMPTY
3082 ISSUER_TAXID_BAD_FORMAT
3083 MATCH_KEY_PAIR
3084 INCORRECT_EXECUTION_TYPE
3085 DOCUMENT_ALREADY_DELETED
3086 AUTHENTICATION_FAILED
3087 STORED_OBJECT_NOT_FOUND
3088 STORE_NOT_SPECIFIED
3089 DOCUMENT_OWNER_MISMATCH
3090 TAX_UNKNOWN
3091 CHILKAT_SENDQ_ERROR
3092 CANNOT_APPEND_CHILD
3093 COUNTRY_MISMATCH
3094 INSUFFICIENT_RIGHTS
3095 BUNDLE_EXCEEDED
3096 CONTENT_MODEL_NOT_FOUND
3097 SUBADDENDA1_UNRECOGNIZED
3098 SUBADDENDA2_UNRECOGNIZED
3099 BUNDLE_INSUFFICIENT

3100–3133 · Timbrado, cancelación y control de acceso

Reglas del ciclo de vida del comprobante y del acceso de usuarios.

Código Etiqueta (LastResult)
3100 DOCUMENT_CAN_NOT_BE_CANCELLED
3101 INPUT_INCONSISTENT
3102 FISCAL_FORMAT_EXPECTED
3103 INCOMING_XML_UNRECOGNIZED
3104 COULD_NOT_SIGN_DIGITALLY
3105 TIMBRE_MISSING_OR_REDUNDANT
3106 BUSINESS_RULE_VIOLATION
3107 TIMBRE_ALREADY_EXISTS
3108 TIMBRE_OUT_OF_TIME_LIMIT
3109 TIMBRE_ALREADY_APPLIED
3110 PASS_WRONG
3111 PASS_MISMATCH
3112 PASS_TOO_SIMPLE
3113 USER_LOCKED
3114 PASS_SECRET_RESPONSE_MISSING
3115 ISSUER_BLOCKED_BY_FISCAL_AUTHORITY
3116 CERT_NOT_CSD
3117 CERT_INVALID
3118 ADDENDA_NOT_ACCEPTED
3119 TOO_MANY_DOCUMENTS_TO_BE_CANCELED
3120 MORE_THAN_ONE_STORED_OBJECT_FOUND
3121 TRANSFORM_FILENAME_INVALID
3122 UNEXPECTED_XML_PREFIX
3123 UNEXPECTED_DEFINING_ELEMENT
3124 RECEIVER_NIT_BAD_FORMAT
3125 SENDER_NIT_BAD_FORMAT
3126 TEMPLATE_INVALID
3127 ACUSE_NOT_FOUND
3128 TIMBRE_MISMATCH
3129 NAMESPACE_WITHOUT_SCHEMA
3130 ACUSE_SIN_FOLIOS
3131 BUSINESS_PROCESS_EXCEPTION
3132 UUID_COUNT_NOT_ONE
3133 UUID_COUNT_OUT_OF_LIMIT

3134–3164 · Errores del SAT encapsulados

Cada uno corresponde a un código del SAT. Ver el apartado 3.

Código Etiqueta Equivale a
3134 SAT_MX_202 SAT 202 — UUID Previamente admitido al proceso de cancelación.
3135 SAT_MX_203 SAT 203 — UUID No corresponde al emisor.
3136 SAT_MX_204 SAT 204 — UUID No aplicable para cancelación.
3137 SAT_MX_205 SAT 205 — UUID No existe.
3138 SAT_MX_301 SAT 301 — XML mal formado.
3139 SAT_MX_302 SAT 302 — Sello mal formado o inválido.
3140 SAT_MX_303 SAT 303 — Sello no corresponde a emisor o caduco.
3141 SAT_MX_304 SAT 304 — Certificado revocado o caduco.
3142 SAT_MX_305 SAT 305 — La fecha de emisión no esta dentro de la vigencia del CSD del Emisor.
3143 SAT_MX_306 SAT 306 — EL certificado no es de tipo CSD.
3144 SAT_MX_307 SAT 307 — El CFDI contiene un timbre previo.
3145 SAT_MX_308 SAT 308 — Certificado no expedido por el SAT.
3146 SAT_MX_401 SAT 401 — Fecha y hora de generación fuera de rango.
3147 SAT_MX_402 SAT 402 — RFC del emisor no se encuentra en el régimen de contribuyentes.
3148 SAT_MX_403 SAT 403 — La fecha de emisión es anterior a 2011.
3149 SAT_MX_501 SAT 501 — Autenticación no válida.
3150 SAT_MX_502 SAT 502 — Comprobante no encontrado en la ruta especificada.
3151 SAT_MX_503 SAT 503 — Metadatos no válidos.
3152 SAT_MX_504 SAT 504 — La estructura del comprobante recibido no es válida.
3153 SAT_MX_505 SAT 505 — Metadatos no correspondientes al CFDI.
3154 SAT_MX_506 SAT 506 — El Timbre proporcionado ya existe.
3155 SAT_MX_507 SAT 507 — El comprobante recibido fue previamente cancelado.
3156 SAT_MX_508 SAT 508 — El PAC que envía es diferente al PAC que certificó.
3157 SAT_MX_509 SAT 509 — El CFDI no cuenta con los datos mínimos.
3158 SAT_MX_510 SAT 510 — Sello de certificación inválido.
3159 SAT_MX_511 SAT 511 — Sello del comprobante inválido.
3160 SAT_MX_512 SAT 512 — TFD no válido.
3161 SAT_MX_513 SAT 513 — Versión del estándar no vigente.
3162 SAT_MX_514 SAT 514 — Comprobante con envío extemporáneo por vigencia de versión.
3163 SAT_MX_601 SAT 601 — La expresión impresa proporcionada no es válida.
3164 SAT_MX_602 SAT 602 — Comprobante no encontrado.

3165–3204 · Recepción, validación, filtros y asíncrono

Errores de las transacciones de recepción y validación, de los filtros del portal y del servicio asíncrono.

Código Etiqueta (LastResult)
3165 INCORRECT_ENCODING
3166 RECEPTION_ERROR
3167 INTERNAL_EXCEPTION
3168 EXTERNAL_EXCEPTION
3169 ECB_DISABLED
3170 INVALID_SCHEMA
3171 REQUESTOR_MISMATCH
3172 RECEIVE_EX_FAILED
3173 VALIDATE_DOCUMENT_EX_FAILED
3174 GENERIC_EXCEPTION
3175 DUPLICATE_ON_RECEPTION
3176 CANNOT_CONVERT_NATIVE_HTML
3177 COMPLEMENTO_INCONSISTENTE
3178 FILTRO_SIN_SUCURSALES
3179 FILTRO_SIN_EMPLEADOS
3180 FILTRO_SIN_CUENTAS
3181 FILTRO_SIN_CLIENTES
3182 FILTRO_SIN_PRODUCTOS
3183 FILTRO_SIN_DESTINOS
3184 CONTRACT_ALREADY_EXISTS
3185 RFC_UNAUTHORIZED
3186 FALLA_DE_VALIDACION
3187 FALLA_DE_VALIDACION_SAT
3188 RFC_DOES_NOT_EXIST_IN_LRFC
3189 CANNOT_CANCEL_CFD
3190 CANCELACION_ANTERIOR_VENCIDA
3191 CANCELACION_NUEVA_NO_VIGENTE
3192 DOCUMENT_ON_CANCEL_PROCESS
3193 UNHANDLE_FOR_ASYNC_CONVERT
3194 TRANSACCION_NO_ASINCRONA_NO_PERMITIDA
3195 TRANSACCION_ASINCRONA_NO_PERMITIDA
3196 TRANSACCION_ASINCRONA_YA_EXISTE
3197 FIEL_NOT_FOUND
3198 FILE_NOT_FOUND
3199 EMISOR_RECHAZADO
3200 EMISION_HORA_INVALIDA
3201 CFDI_NOT_FOUND
3202 ZOHO_API_EXCEPTION
3203 PROCESS_INVOCATION_FAILED
3204 PHYTON_API_EXCEPTION

3. Errores del SAT encapsulados · 3134 a 3164

Estos treinta y un códigos merecen atención aparte porque explican algo que no es evidente: cómo un error de la autoridad llega a tu ERP con un número de MYSuite. Cuando la plataforma envía algo al SAT y la autoridad lo rechaza, MYSuite traduce ese rechazo a un código propio de este rango. La etiqueta conserva el número original del SAT, así que puedes reconstruir la equivalencia leyendo la etiqueta.

La tabla completa está en el apartado anterior, en el bloque 3134–3164, con la descripción del SAT al lado de cada código. Para el texto oficial del mensaje, ve al apartado 8.

Que exista este rango no significa que todos los errores del SAT pasen por él. Algunas transacciones devuelven el código del SAT directamente en las cargas de respuesta, con el prefijo SAT: y en texto plano. Revisa ambos lugares antes de concluir que la autoridad no respondió.


4. Errores críticos y de sistema · familias 4xxx y 5xxx

Estos códigos indican que el problema está del lado de la plataforma, no de tu petición. La acción razonable casi siempre es reintentar con espera y, si persiste, escalar a Soporte con el identificador de la operación.

4xxx · Errores críticos

Ligados a los certificados y a la firma del proveedor de certificación. La única excepción que puedes corregir tú es 4010 ENTITY_TAXID_BAD_FORMAT, que señala un RFC mal formado en tu petición.

Código Etiqueta
4000 CRITICAL_ERRORS_BASE
4001 PROVIDER_SIGNATURE_INVALID
4002 PROVIDER_CERT_NOT_FOUND_IN_DB
4003 ISSUER_CERT_NOT_FOUND_IN_DB
4004 PROVIDER_SIGNATURE_FAILED
4005 COMPONENT_LOCKED
4006 COULD_NOT_INITIALIZE_DSA_KEYS
4007 COULD_NOT_VERIFY_DSA_KEYS
4008 COULD_NOT_CREATE_DSA_KEYS
4009 DSA_BUNDLE_INVALID
4010 ENTITY_TAXID_BAD_FORMAT

5xxx · Errores de sistema

Fallos internos: acceso a base de datos, transformaciones, colas, lectura de archivos y configuración. Conviene tratarlos como transitorios en una primera instancia.

Código Etiqueta
5000 SYSTEM_ERRORS_BASE
5001 TRANSACTION_NOT_IMPLEMENTED
5002 CANNOT_LOAD_FILE
5003 DATABASE_OPERATION_FAILED
5004 XSLT_TRANSFORM_FAILED
5005 CANNOT_QUEUE_BATCH
5006 CANNOT_ACCESS_QUEUED_BATCH
5007 AGENT_DATA_NOT_FOUND
5008 DATABASE_ACCESS_FAILED
5009 CANNOT_ENROLL_CERT
5010 COULD_NOT_RETRIEVE_SIGNED_XML
5011 COULD_NOT_RETRIEVE_XML_AND_HTML
5012 COULD_NOT_RETRIEVE_HTML
5013 CANNOT_SEARCH
5014 CANNOT_RETRIEVE_IMF_DATA
5015 CANNOT_RETRIEVE_IMFP_DATA
5016 USER_ID_NOT_FOUND
5017 FISCAL_DATA_NOT_FOUND
5018 CANNOT_GET_FOLIOS
5019 CANNOT_GET_ASSIGNMENT_EXISTENCE
5020 NULL_EXCEPTION
5021 NOT_IMPLEMENTED
5022 COMPONENT_ERROR
5023 CANNOT_GET_CERT_EXISTENCE
5024 STORED_PROC_EXECUTION_FAILED
5025 CONFIG_PARAM_NOT_FOUND
5026 DICTIONARY_COULD_NOT_BE_LOADED
5027 DICTIONARY_COULD_NOT_BE_SAVED
5028 POP3_READ_FAILED
5029 CANNOT_GET_HISTORY
5030 COULD_NOT_RETRIEVE_FORMATS
5031 NATIVE_BATCH_NOT_EXPECTED
5032 EXPIRED
5033 NATIVE_FORMAT_EXPECTED
5034 NAMESPACE_DOES_NOT_EXIST
5035 NAMESPACE_UNKNOWN
5036 NONAMESPACE_ALREADY_EXISTS


5. Advertencias · familias 6xxx, 7xxx y 8xxx

No son errores: son avisos. La operación puede haberse completado y aun así generar uno de estos códigos. Los dos que más importan en una integración son los de vencimiento de certificado, porque anticipan una interrupción que todavía puedes evitar.

Código Etiqueta
6000 ADMIN_WARNINGS_BASE
6001 PROVIDER_CERTIFICATE_EXPIRING
7000 USER_WARNINGS_BASE
7001 USER_CERTIFICATE_EXPIRING
8000 PROCESS_WARNINGS_BASE
8001 PROCESS_TIME_EXCEEDED
7001 USER_CERTIFICATE_EXPIRING es el aviso más valioso del catálogo. Te está diciendo que el CSD del emisor está por vencer. Si tu ERP lo ignora porque la operación fue exitosa, el día del vencimiento dejarás de poder timbrar sin previo aviso. Regístralo y escálalo a quien administre los certificados.


6. Validaciones de Anexos · familia 9xxx

Comprueban que el XML cumpla con las reglas estructurales del Anexo 20 y del estándar XML antes de procesarlo: codificación, declaración de espacios de nombres, ubicación de esquemas, complementos permitidos y convivencia de versiones. Se corrigen en el generador del comprobante.

Código Etiqueta
9000 ANEXOS_BASE
9001 ANEXOS_AutorizadoPara33
9002 ANEXOS_CfdiSchemaLocation
9003 ANEXOS_ComplementosDefinidosEnComprobante
9004 ANEXOS_Descendencia
9005 ANEXOS_NoPipe
9006 ANEXOS_RfsProhibido
9007 ANEXOS_SchemaLocation
9008 ANEXOS_UnusedNamespaces
9009 ANEXOS_Utf8
9010 ANEXOS_VersionesCfdi
9011 ANEXOS_Vigencia
9012 ANEXOS_XmlDeclaration
9013 ANEXOS_XmlnsCfdi
9014 ANEXOS_XmlnsNamespace
9015 ANEXOS_XmlnsPrefix
9016 ANEXOS_Convivencia
9017 ANEXOS_AddendaProhibida
9018 ANEXOS_TimbreProhibido
9019 ANEXOS_ComplementoSinHijos
9020 ANEXOS_ComplementoConceptoSinHijos
9021 ANEXOS_SpeiNoSeAdmite
9022 ANEXOS_RegistroFiscalNoSeAdmite
9023 ANEXOS_Repeticiones


7. Validaciones propias de MYSuite · familia 10xxx

Reglas que MYSuite aplica sobre el contenido del comprobante, más allá de lo que exige el esquema.

Código Validación Comunicado Referencia
10001 catcuv_c_clavevehiculo El valor {0} de {1} no se encuentra en la enumeración {2} del catálogo {3}.xsd —
10002 P_Sin_Pagos El Comprobante es de tipo P pero carece de complemento Pagos —
10003 N_Sin_Nomina El comprobante es de tipo N pero carece de complemento Nomina —
10004 Pago_Sin_DocRelacionados En el Comprobante tipo P se encuentra por lo menos un Pago sin ningún Docto Relacionado Guía de llenado p. 27: por cada documento que se relacione se debe generar un nodo DoctoRelacionado
Los tres últimos describen el mismo tipo de descuido: un comprobante declarado de un tipo al que le falta el complemento que ese tipo exige. Si emites comprobantes de pago o de nómina, vale la pena validarlo en tu ERP antes de enviar.


8. Errores del SAT · 2xx a 1xxx

Son las respuestas de la autoridad fiscal. Llegan con el prefijo SAT: en las cargas de respuesta de algunas transacciones, o encapsuladas en la familia 3xxx según el apartado 3. El texto es el de la autoridad, no el de MYSuite.

2xx · Proceso de cancelación

Código SAT Mensaje
201 UUID Admitido al proceso de cancelación.
202 UUID Previamente admitido al proceso de cancelación.
203 UUID No corresponde al emisor.
204 UUID No aplicable para cancelación.
205 UUID No existe.
206 UUID no corresponde a un CFDI del Sector Primario.
207 No se especificó el motivo de cancelación o el motivo no es valido.
208 Folio Sustitución invalido.
209 Folio Sustitución no requerido.
210 La fecha de solicitud de cancelación es mayor a la fecha de declaración.
211 La fecha de solicitud de cancelación límite para factura global.
212 Relación no valida o inexistente.
Dos de estos códigos son buenas noticias y conviene no tratarlos como error: 201 confirma que el UUID fue admitido al proceso de cancelación, y 202 que ya lo había sido antes. El segundo es el que ves cuando reintentas una cancelación que ya habías solicitado.

3xx, 4xx, 5xx y 6xx · Timbrado y validación de comprobantes

Código SAT Mensaje
300 Usuario No Válido.
301 XML mal formado.
302 Sello mal formado o inválido.
303 Sello no corresponde a emisor o caduco.
304 Certificado revocado o caduco.
305 La fecha de emisión no esta dentro de la vigencia del CSD del Emisor.
306 EL certificado no es de tipo CSD.
307 El CFDI contiene un timbre previo.
308 Certificado no expedido por el SAT.
309 Patrón de Folio inválido.
310 CSD inválido.
401 Fecha y hora de generación fuera de rango.
402 RFC del emisor no se encuentra en el régimen de contribuyentes.
403 La fecha de emisión es anterior a 2011.
501 Autenticación no válida.
502 Comprobante no encontrado en la ruta especificada.
503 Metadatos no válidos.
504 La estructura del comprobante recibido no es válida.
505 Metadatos no correspondientes al CFDI.
506 El Timbre proporcionado ya existe.
507 El comprobante recibido fue previamente cancelado.
508 El PAC que envía es diferente al PAC que certificó.
509 El CFDI no cuenta con los datos mínimos.
510 Sello de certificación inválido.
511 Sello del comprobante inválido.
512 TFD no válido.
513 Versión del estándar no vigente.
514 Comprobante con envío extemporáneo por vigencia de versión.
518 TFD no válido para la revisión de CFDI.
519 Complemento no vigente para la versión de CFDI.
520 Complemento no permitido para la versión de CFDI.
601 La expresión impresa proporcionada no es válida.
602 Comprobante no encontrado.

1xxx · Retenciones, consultas y cancelación

Código SAT Mensaje
1000 Error en el servicio.
1001 Autenticación no válida.
1002 El PAC envía versión del estándar no existente.
1004 La estructura del comprobante recibido no es válida.
1006 El timbre proporcionado ya existe.
1008 El PAC que envía es diferente al PAC que certificó.
1009 El documento de retenciones no cuenta con los datos minimos.
1010 Sello de certificación inválido.
1011 Sello del documento de retenciones inválido.
1012 TFD no válido.
1013 Versión de estándar no vigente.
1014 Comprobante con envío extemporáneo por vigencia de versión.
1015 Uso del complemento no vigente.
1016 Uso de complemento no permitido.
1017 Uso del certificado de FIEL no válido.
1100 Se obtuvieron las peticiones del RFC Receptor de forma exitosa.
1101 No existen peticiones para el RFC Receptor.
1201 UUID Cancelado.
1202 UUID Previamente cancelado.
1203 UUID no corresponde con el emisor.
1205 UUID no existe.
1300 Autenticación no válida.
1301 XML mal formado.
1302 Estructura de folios no válida.
1303 Estructura de RFC no válida.
1304 Estructura de fecha no válida.
1305 Certificado no corresponde al emisor.
1306 Certificado no vigente.
1307 Uso de FIEL no permitido.
1308 Certificado revocado o caduco.
1309 Firma mal formada o inválida.
1310 Motivo no válido.
1311 Folio Sustitución no válido.
1312 Folio Sustitución no requerido.
1313 Solicitud fuera de la declaración anual.
1314 Relación no válida.
El rango 1000 a 1017 corresponde al servicio de retenciones, el 1100 y 1101 a consultas de peticiones, y del 1201 en adelante al proceso de cancelación. Fíjate en que varios mensajes se repiten entre rangos con números distintos: 301 y 1301 dicen ambos que el XML está mal formado, pero pertenecen a servicios distintos del SAT.


9. Mensajes ciudadanos · validación de complementos

Son los mensajes más detallados del catálogo y también los más numerosos: superan las tres mil entradas. No se listan aquí uno por uno; lo que necesitas para leerlos es entender cómo están indexados.

Columna Qué contiene
Clave de Complemento Qué complemento o versión de CFDI se está validando
Revisión SAT Qué revisión de la matriz de errores aplica. Ver la nota siguiente
Número de Error El número dentro de esa combinación de complemento y revisión
Mensaje El texto que describe qué nodo o atributo incumple y por qué
El número de error no es único por sí solo. El mismo número significa cosas distintas según el complemento y la revisión. Para localizar un mensaje necesitas las tres coordenadas: complemento, revisión y número. Buscar solo por número te dará el mensaje equivocado.

Cómo leer la revisión del SAT

La letra de la columna Revisión indica el origen de esa entrada, y esa distinción es del propio documento fuente:

Letras Significado Entradas
A B C D E Revisiones que el SAT publicó 761
T U V X Y Z Revisiones que el SAT no publicó, mantenidas por MYSuite para conservar la convivencia entre versiones 2,301
Que dos tercios de las entradas correspondan a revisiones no publicadas explica por qué el mensaje que recibes puede no aparecer en la documentación oficial del SAT. No es un error de MYSuite: es trabajo de compatibilidad que la plataforma sostiene por su cuenta.


10. Mensajes complementarios

Cuando recibas un mensaje con posiciones entre llaves, no las descartes: son la diferencia entre revisar un comprobante entero e ir directo al concepto que falla.


11. Cómo reportar a Soporte Especializado

Cuando el código no baste, incluye estos datos en el reporte. Todos vienen en la misma respuesta que recibiste y permiten análizar la operación sin pedirte más información.

Dato Dónde está (SOAP) Dónde está (API REST)
Identificador de la operación Request/Id requestField.idField
Nodo que atendió la solicitud Response/Processor responseField.processorField
Marca de tiempo Response/TimeStamp responseField.timeStampField
Código y etiqueta Code y LastResult codeField y lastResultField
Transacción, RFC y ambiente Bloque Request requestField
Bloque de diagnóstico, si existe Response/Data responseField.dataField


12. Versionado y cumplimiento

  • Los códigos y etiquetas de MYSuite son estables; los textos de Description y Hint pueden reescribirse. 
  • Los códigos y mensajes del SAT los define la autoridad y cambian cuando cambia su normatividad. MYSuite los traslada, no los redacta.
  • Las revisiones de mensajes ciudadanos marcadas con letras que el SAT no publicó son mantenimiento de convivencia de MYSuite y pueden no coincidir con ninguna publicación oficial.
Solución de problemas

"Mi código no aparece en el catálogo"


Problema. El número devuelto no coincide con ninguna entrada de este artículo.

Entorno. Cualquier modalidad · cualquier transporte.

Resolución. Revisa tres cosas antes de escalar. Que no se trate de un mensaje ciudadano, que no se lista aquí por volumen y se identifica porque el texto menciona nodos y atributos del CFDI. Que no sea un código de estado HTTP, en cuyo caso el problema es de transporte y no de negocio. Si nada de eso aplica, escálalo con los datos del apartado 11.

Causa. El catálogo tiene un corte temporal y un alcance declarado. Los códigos nuevos entran a la plataforma antes de aparecer documentados.

"Me rechaza un parámetro y no sé cuál"


Problema. La respuesta trae un código entre 3001 y 3009 sin más detalle evidente.

Entorno. Cualquier transacción · integraciones nuevas.

Resolución. La etiqueta te dice exactamente cuál: REQUESTOR_REJECTED, ENTITY_REJECTED, USER_REJECTED, DATA1_REJECTED y así con cada uno. Revísala antes que la descripción. Si el rechazo es de Data1, Data2 o Data3, el contrato de esos campos cambia en cada transacción: consulta el artículo de la transacción que estás usando, porque copiar el código de otra es la causa más común.

Causa. Los tres campos de datos no tienen un significado fijo en la plataforma: cada transacción define qué pone en cada uno.

"Recibo 3192 al cancelar y no sé si insistir"


Problema. La cancelación devuelve 3192 DOCUMENT_ON_CANCEL_PROCESS.

Entorno. CFDI + Timbrado · transacciones de cancelación.

Resolución. No insistas. Ya existe una solicitud de cancelación en curso para ese comprobante, y el elemento Data de la respuesta te indica cuándo inició. Consulta el estado del comprobante y espera a que el proceso se resuelva. Es una protección contra solicitudes duplicadas, no una falla.

Causa. La plataforma bloquea las solicitudes repetidas mientras hay una cancelación en trámite.

"Recibo 3196 al encolar una solicitud asíncrona"


Problema. El servicio asíncrono devuelve 3196 TRANSACCION_ASINCRONA_YA_EXISTE.

Entorno. MYSuite Grandes Asíncrono · reenvíos tras perder la respuesta.

Resolución. Es la protección antiduplicado funcionando. Ese número interno ya estaba registrado, así que la solicitud original existe y su identificador viene en la carga de respuesta. Continúa el flujo con ese identificador. No generes un número interno nuevo para reintentar: eso sí produciría un comprobante duplicado.

Causa. El número interno obligatorio permite a la plataforma reconocer el reenvío y devolverte la solicitud original en lugar de crear otra.

"El código dice que el documento ya existe o ya fue cancelado"


Problema. Aparecen códigos como 3027 DOCUMENT_ALREADY_CANCELLED, 3060 DOCUMENT_ALREADY_EXISTS, 3107 TIMBRE_ALREADY_EXISTS o 3175 DUPLICATE_ON_RECEPTION.

Entorno. Cualquier modalidad · procesos con reintento automático.

Resolución. Todos apuntan a lo mismo: la operación que intentas ya se hizo. Antes de corregir nada, verifica el estado real del comprobante en la plataforma. En la mayoría de los casos no hay error que arreglar, sino un reintento que sobra.

Causa. Un reintento sin verificación previa. Es el patrón más caro de las integraciones, porque cuando la protección no existe el resultado es un comprobante duplicado con efectos fiscales.

"Los errores de certificado no me dejan operar"


Problema. Aparecen códigos de la serie 3012 a 3017, 3071 a 3078, 3116, 3117 o de la familia 4xxx.

Entorno. Cualquier transacción que selle o timbre.

Resolución. Distingue de quién es el certificado. Las etiquetas que contienen ISSUER se refieren al CSD del emisor y son tuyas: revísalo, recárgalo o renúevalo. Las que contienen PROVIDER se refieren al certificado del proveedor de certificación y son de MYSuite: escálalas. 3116 CERT_NOT_CSD indica que cargaste un certificado que no es de sello digital, un error frecuente al confundir el CSD con la e.firma.

Causa. La distinción entre emisor y proveedor no está en el número, está en la etiqueta.

"No sé si el error vino de MYSuite o del SAT"


Problema. La operación falló y no queda claro si la autoridad llegó a enterarse.

Entorno. Transacciones de timbrado y de cancelación.

Resolución. Si el código está entre 3134 y 3164, la solicitud llegó al SAT y fue la autoridad quien la rechazó; la etiqueta conserva el número original. Si el código es de cualquier otro rango 3xxx, la plataforma detuvo la solicitud antes de enviarla. La distinción importa porque cambia a quién corresponde corregir y si tiene sentido reintentar.

Causa. MYSuite encapsula las respuestas del SAT en códigos propios, lo que hace que ambos orígenes se vean iguales en el mismo campo.

"El mensaje del complemento no lo encuentro en la documentación del SAT"


Problema. Un mensaje ciudadano no aparece en las matrices de error publicadas por la autoridad.

Entorno. Emisión con complementos.

Resolución. Revisa la letra de revisión. Si es T, U, V, X, Y o Z, corresponde a una revisión que el SAT no publicó y que MYSuite mantiene por su cuenta para conservar la convivencia entre versiones. Es esperable que no la encuentres. Dos tercios de los mensajes ciudadanos están en esa situación.

Causa. La plataforma sostiene validaciones que la autoridad aplicó sin documentar.

"Mi código de manejo de errores dejó de funcionar tras una actualización"


Problema. Las condiciones que ramificaban por el texto del mensaje ya no coinciden.

Entorno. Integraciones con lógica basada en Description.

Resolución. Reescribe esas condiciones para que comparen Code o LastResult. El primero es un número y el segundo un identificador simbólico sin espacios ni acentos: ambos están pensados para el código. Description y Hint están pensados para leerse y pueden reescribirse sin aviso.

Causa. Se usó como contrato algo que nunca lo fue.



Para entender más

Por qué hay varias numeraciones y no una sola

Cada familia de códigos nace en un punto distinto del recorrido de un comprobante. Las de la serie 3xxx las produce la lógica de negocio de MYSuite cuando revisa tu petición. Las 9xxx aparecen antes, al comprobar que el XML es estructuralmente válido. Las 5xxx vienen de la infraestructura. Las del SAT se generan fuera de la plataforma. Que convivan en una misma respuesta no es desorden: es la traza de por dónde pasó tu petición y dónde se detuvo.

La consecuencia práctica es que la familia del código te dice, antes que su descripción, quién puede corregir el problema. Un 3xxx casi siempre lo resuelves tú; un 5xxx casi nunca.

Por qué la etiqueta vale más que el mensaje

La etiqueta que viaja en LastResult es un identificador: mayúsculas, guiones bajos, sin espacios ni acentos. Está hecha para que una máquina la compare. La descripción está hecha para que una persona la lea, y eso significa que puede reescribirse para mejorarla sin que nadie lo considere un cambio de contrato. Una integración que ramifique por el texto está apoyada en algo que puede cambiar en cualquier momento; una que ramifique por la etiqueta, no.

Por qué algunos códigos son buenas noticias

No todo lo que llega con Result = false es un problema que resolver. 3196 te está evitando un comprobante duplicado. 3192 te está diciendo que la cancelación que ibas a pedir ya está en trámite. SAT: 202 confirma que el UUID ya había sido admitido a cancelación. Los tres son protecciones, y tratarlos como fallos lleva a corregir lo que funcionaba.

Vale la pena revisarlo al diseñar el manejo de errores: hay códigos ante los que la acción correcta es continuar el flujo, no abortarlo ni reintentar.

Qué significan las revisiones que el SAT no publicó

Cuando la autoridad cambia una validación sin publicar la revisión correspondiente, los PAC tienen que ajustarse igual. MYSuite marca esas entradas con letras distintas para poder distinguirlas de las publicadas, y las sostiene para que comprobantes emitidos bajo reglas anteriores sigan conviviendo con los actuales. Es trabajo invisible desde fuera y explica una pregunta frecuente: por qué un mensaje que recibes no aparece en ninguna parte de la documentación oficial.

Por qué el número de error ciudadano no basta para buscar

Los mensajes ciudadanos se indexan por tres coordenadas y no por una. El mismo número significa cosas distintas según el complemento y la revisión, porque cada matriz de validación numera desde el principio. Es una consecuencia de que el SAT publique una matriz por complemento en lugar de una serie única, y obliga a que cualquier búsqueda —manual o automatizada— use las tres coordenadas juntas.

Un aviso que conviene no ignorar

Entre los más de trescientos códigos, los de las familias 6xxx y 7xxx son los únicos que llegan antes de que exista un problema. Un certificado por vencer no impide operar hoy, y por eso es fácil que el ERP lo descarte. El día que vence, la emisión se detiene por completo y sin previo aviso. Registrar y escalar esas advertencias es de las pocas cosas de este catálogo que previenen en lugar de diagnosticar.

Cómo encaja este catálogo con los artículos de transacción

Cada artículo de transacción documenta su contrato y, en su apartado de códigos, solo aquellos que tienen un significado particular en esa transacción. Lo común vive aquí. Esa división es deliberada: repetir trescientos códigos en cada artículo haría imposible mantenerlos sincronizados, y el día que cambiara uno habría que tocar todos. La regla de la norma es explícita al respecto: el contenido transversal se enlaza, no se copia.