| Inicio | GET /api/public/seguimiento/years → 200 { data: [2026] } (60 por minuto por IP). Si falla, ver «Años no cargados». | Texto de estado: «Escriba el número y elija el año.» |
| Ayuda: ¿Dónde encuentro el número? | Ninguna. | «¿Dónde encuentro el número?» · «Ejemplo ilustrativo: los datos de la hoja no corresponden a un documento real.» |
| Constancia incompleta | Ninguna: es una validación del navegador. Si el servicio rechaza el formato responde 400 (ver «Número no válido»). | «La constancia está incompleta. Escríbala completa, como MP-000031-2026.» |
| Caracteres no admitidos | Ninguna. | «El número de emisión solo lleva dígitos. Si es una constancia, escríbala como MP-000031-2026.» · «El número de emisión tiene como máximo 7 dígitos.» · «La constancia solo lleva las letras MP, dígitos y guiones: MP-000031-2026.» |
| Verificación de seguridad pendiente | Ninguna hasta el envío; el token viaja en POST …/access y el servicio lo valida con Cloudflare. | «Complete la verificación de seguridad para continuar.» |
| Verificación de seguridad vencida | Ninguna (ocurre en el navegador). | «La verificación de seguridad venció. Complétela de nuevo para continuar.» |
| Verificación de seguridad fallida | POST /api/public/seguimiento/:number/access con { turnstileToken } (20 por minuto por IP). → 403 («No se pudo validar el captcha») cuando Cloudflare rechaza el token. Si el servicio de Cloudflare no responde, el servicio devuelve 502 y la interfaz lo trata como «Servicio no disponible». | «No se pudo completar la verificación de seguridad» · «Inténtelo otra vez. Si usa un bloqueador de contenido, desactívelo para este sitio.» |
| Consulta en proceso y prevención de duplicados | POST /api/public/seguimiento/:number/access con { turnstileToken } (20 por minuto por IP). y luego GET /api/public/seguimiento/:number?access=… (60 por minuto por IP). Tiempo máximo: 20 s en el navegador y 15 s en el proxy de la aplicación. | «Estamos buscando el recorrido. No cierre esta página.» |
| Consulta repetida con el resultado en pantalla | Ninguna. La protección real contra abuso es el límite del servicio (ver «Límite de consultas»). | «Ya está viendo el seguimiento de este número. Podrá consultarlo de nuevo en unos segundos.» |
| Documento no encontrado | POST /api/public/seguimiento/:number/access con { turnstileToken } (20 por minuto por IP). → 404 «Documento no encontrado». | «No encontramos un documento con ese número» · «Revise estos datos e inténtelo otra vez:» · «Que el año elegido sea el del cargo de Mesa de Partes.» · «Que escribió el número de emisión (por ejemplo 0000014) o la constancia completa (MP-000031-2026).» · «Solo se pueden consultar los documentos presentados en Mesa de Partes.» |
| Número no válido (respuesta del servicio) | POST /api/public/seguimiento/:number/access con { turnstileToken } (20 por minuto por IP). → 400 «Número de emisión o constancia no válido». | «El número no es válido» · «Use el número de emisión (0000014) con su año o una constancia como MP-000031-2026.» |
| Acceso vencido | GET /api/public/seguimiento/:number?access=… (60 por minuto por IP). → 403 «Acceso no autorizado o vencido». | «La consulta venció» · «Por seguridad, el acceso al seguimiento dura poco tiempo. Su número sigue escrito: vuelva a consultar.» |
| Límite de consultas | 429 con cuerpo de texto «Too Many Requests» y Retry-After: N (comprobado el 30/10/2026). La aplicación reenvía Retry-After al navegador. | «Hay muchas consultas desde su conexión» · «Espere un momento e inténtelo de nuevo. Su número sigue escrito.» · «Podrá consultar de nuevo en N s.» · estado: «Podrá consultar de nuevo cuando termine la espera.» y luego «Ya puede consultar de nuevo.» |
| Servicio no disponible | Cualquier 5xx. La aplicación responde 503 con { error: { message } } si el servicio no contesta. | «El servicio de seguimiento no está disponible por ahora» · «Esto no depende del número que ingresó, que sigue escrito. Inténtelo de nuevo en unos minutos.» |
| Tiempo agotado | 504 del proxy o corte de la conexión. | «La consulta tardó más de lo esperado» · «No pudimos obtener la respuesta a tiempo. Su número sigue escrito: puede reintentar.» |
| Sin conexión a internet | Ninguna (la petición no sale del navegador). | «No hay conexión a internet» · «Revise su conexión. Cuando vuelva, podrá reintentar; su número sigue escrito.» · al volver: «Se restableció la conexión. Puede volver a consultar.» |
| Reintento en curso | Ver «Consulta en proceso». | «Reintentando en cuanto termine la verificación de seguridad.» |
| Años no cargados | GET /api/public/seguimiento/years → 200 { data: [2026] } (60 por minuto por IP). → 5xx. | «No se pudieron cargar los años. Reintentar» |