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.
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.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.| 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 |
Para diagnosticar una respuesta con error:
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í.Code del bloque Response, o en codeField si consumes API REST.Description y Hint de la respuesta, que añaden el detalle del caso concreto: qué campo, qué valor, qué comprobante.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.Si el código que buscas no aparece en este catálogo, ve a Solución de problemas.
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 |
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.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.
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 |
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 |
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 |
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 |
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 |
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. |
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 |
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.
SAT: y en texto plano. Revisa ambos lugares antes de concluir que la autoridad no respondió.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.
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 |
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 |
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.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 |
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 |
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.
| 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. |
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.| 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. |
| 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. |
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.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é |
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 |
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 |
Description y Hint pueden reescribirse. 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.