Guías
Errores
Cada error trae un código estable, un mensaje, una sugerencia escrita para que un agente la siga y si conviene reintentar.
{
"error": {
"codigo": "MAX_FAILED_ATTEMPTS",
"tipo": "…",
"mensaje": "…",
"sugerencia": "La credencial está bloqueada en Floid por intentos fallidos…",
"reintentable": false
},
"meta": {
"herramienta": "banco_persona.productos.consultar",
"caseid": "…"
}
}
Códigos HTTP
| HTTP | Significado | ¿Reintentar? |
|---|---|---|
| 400 | La solicitud no es válida (parámetro faltante, desconocido o con formato incorrecto). La capa lo detecta antes de llamar a Floid. | No: corrige la solicitud. |
| 401 | Falta el token Floid o Floid lo rechazó. | No. |
| 403 | Tu token no tiene contratado ese servicio o el contrato no está activo. | No: contacta a Floid. |
| 404 | La herramienta no existe. | No. |
| 413 | La solicitud es demasiado grande. | No. |
| 422 | La institución respondió con un error definitivo (clave errada, sin datos, empresa sin acceso…). | No: sigue la sugerencia. |
| 502 · 503 · 504 | La institución o Floid no respondieron bien. | Sí, en unos minutos. |
Errores de la capa
Tienen tipo: "CAPA" y nunca repiten los valores enviados, para no exponer datos sensibles.
| Código | Qué pasó |
|---|---|
| SIN_TOKEN | Falta Authorization: Bearer. |
| MCP_NO_HABILITADO | Tu empresa no tiene activado el MCP. Habla con tu ejecutivo comercial de Floid. |
| VERIFICACION_NO_DISPONIBLE | No se pudo verificar la activación del MCP. Reintenta en unos minutos. |
| HERRAMIENTA_DESCONOCIDA | El nombre no existe en el catálogo. |
| PARAMETRO_DESCONOCIDO | Se envió un parámetro que la herramienta no acepta. La sugerencia lista los válidos. |
| PARAMETRO_REQUERIDO | Falta un parámetro obligatorio. |
| PARAMETRO_INVALIDO | Un valor no tiene el tipo o formato esperado. |
| PARAMETRO_NO_SOPORTADO | El parámetro existe, pero no para ese banco. |
| BANCO_NO_SOPORTADO | Falta banco o la herramienta no lo soporta. |
| CREDENCIAL_REQUERIDA | Faltan los datos de acceso del titular. |
| CREDENCIAL_NO_PERMITIDA | Se intentó enviar una clave o certificado por MCP. |
| CREDENCIALES_MEZCLADAS | Se enviaron credencial_token y datos de acceso a la vez. |
| FLOID_NO_RESPONDE | Floid no respondió a tiempo. Reintentable. |
Errores de Floid
Vienen del banco, del SII o de Floid. La capa agrega la sugerencia y si conviene reintentar.
| Código | Sugerencia | Reintentable |
|---|---|---|
| BANK_COMPANY_NOT_FOUND | El usuario no tiene acceso a esa empresa. Revisa rut_empresa. | No |
| BANK_DOWN | El banco está fuera de servicio o deshabilitado en Floid. Reintenta más tarde. | Sí |
| BANK_ERROR | La institución o Floid no respondieron bien. Reintenta en unos minutos. | Sí |
| CHANGE_PASSWORD | La institución exige cambiar la clave. El titular debe hacerlo allí. | No |
| CLAVE_BLOQUEADA | La clave está bloqueada en el SII. El titular debe desbloquearla allí. | No |
| CLAVE_INVALIDA | Revisa la clave con el titular antes de volver a intentar: otro intento fallido bloquea la credencial (personas 1 hora; empresas hasta una validación exitosa). | No |
| CLAVE_TRIBUTARIA_INACTIVA | La clave tributaria está inactiva. Floid repite esta respuesta por 5 horas sin consultar. | No |
| COMPANY_NOT_FOUND | El usuario no tiene acceso a esa empresa. Revisa rut_empresa. | No |
| COMPANY_PERMISSION_ERROR | El usuario no tiene permisos sobre esa empresa en el SII. | No |
| CONTRACT_REQUEST_LIMIT_EXCEEDED | Se alcanzó el límite de consultas del contrato. Contacta a Floid. | No |
| CREDENTIAL_VALUE_WITH_TOKEN_PASSWORD | Usa credencial_token o rut + clave, no ambos. | No |
| DOCUMENT_NOT_FOUND | El documento no existe o no fue recibido. Revisa folio, tipo y emisor. | No |
| ERROR_INTERNO | La institución o Floid no respondieron bien. Reintenta en unos minutos. | Sí |
| ERROR_SII | La institución o Floid no respondieron bien. Reintenta en unos minutos. | Sí |
| EXPIRED_CREDENTIALS | La clave venció. El titular debe cambiarla en la institución. | No |
| INACTIVE_COMPANY | Tu cuenta Floid está inactiva. Contacta a Floid. | No |
| INEXISTENT_USER | El usuario no existe en la institución. Floid repite esta respuesta por 5 horas sin consultar. | No |
| INTERNAL_ERROR | La institución o Floid no respondieron bien. Reintenta en unos minutos. | Sí |
| INVALID_ACCOUNT_NUMBER | La cuenta no existe para este usuario. Consulta productos para ver las cuentas válidas. | No |
| INVALID_ACCOUNT_TYPE | Tipo de cuenta no soportado. Consulta productos para ver las cuentas válidas. | No |
| INVALID_CONTRACT | Tu cuenta Floid no tiene un contrato activo. Contacta a Floid. | No |
| INVALID_CREDENTIALS | Revisa la clave con el titular antes de volver a intentar: otro intento fallido bloquea la credencial (personas 1 hora; empresas hasta una validación exitosa). | No |
| INVALID_CREDENTIALS_LAST_TRY | Queda un solo intento antes del bloqueo. No reintentes sin confirmar la clave. | No |
| INVALID_DATES | Revisa el rango de fechas. | No |
| INVALID_RANGE | Revisa el rango de fechas. | No |
| INVALID_REQUEST | Faltan datos o tienen un formato inválido. Revisa el mensaje y la ficha de la herramienta. | No |
| INVALID_TOKEN | El credencial_token no existe para tu cuenta Floid o fue revocado. | No |
| LOCKED_CREDENTIALS | La clave está bloqueada en la institución. El titular debe desbloquearla allí. | No |
| MAX_FAILED_ATTEMPTS | La credencial está bloqueada en Floid por intentos fallidos. Personas: espera 1 hora. Empresas: no se libera sola; valida con la clave correcta. | No |
| MAX_SESSIONS | El SII tiene demasiadas sesiones abiertas para este RUT. Reintenta en unos minutos. | Sí |
| METHOD_NOT_AUTH | Tu token Floid no tiene contratado este servicio. Contacta a Floid. | No |
| MISSING_CONTRACT | Tu cuenta Floid no tiene un contrato activo. Contacta a Floid. | No |
| MONTHLY_LIMIT_REACHED | Se alcanzó el límite mensual. Contacta a Floid. | No |
| NON_EXISTENT | No existe registro para lo consultado. | No |
| NO_DATA_AVAILABLE | La institución no tiene datos para lo pedido. | No |
| NO_DATA_FOUND | La institución no tiene datos para lo pedido. | No |
| SECURITY_QUESTION_CONFIGURATION | El titular debe configurar sus preguntas de seguridad en el banco. | No |
| SERVICE_UNAVAILABLE | La institución o Floid no respondieron bien. Reintenta en unos minutos. | Sí |
| SESSION_OPEN | El titular tiene una sesión abierta en el banco. Pídele cerrarla y reintenta en unos minutos. | Sí |
| SIN_DATOS | La institución no tiene datos para lo pedido. | No |
| TERMS_AND_CONDITIONS | El titular debe aceptar términos y condiciones en el sitio del banco. | No |
| TIME_OUT | La institución o Floid no respondieron bien. Reintenta en unos minutos. | Sí |
| TOO_MANY_REQUESTS | Demasiadas consultas seguidas. Espera un momento y reintenta. | Sí |
| TWO_FACTOR_AUTHENTICATION_REQUIRED | La institución pide segundo factor; esta herramienta no lo soporta. | No |
| USUARIO_NO_ACTIVADO | La Clave Única no está activada. El titular debe activarla. | No |
| WEBSITE_DOWN | La institución o Floid no respondieron bien. Reintenta en unos minutos. | Sí |
| WEBSITE_ERROR | La institución o Floid no respondieron bien. Reintenta en unos minutos. | Sí |