Floid Developers Contáctanos

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

HTTPSignificado¿Reintentar?
400La 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.
401Falta el token Floid o Floid lo rechazó.No.
403Tu token no tiene contratado ese servicio o el contrato no está activo.No: contacta a Floid.
404La herramienta no existe.No.
413La solicitud es demasiado grande.No.
422La institución respondió con un error definitivo (clave errada, sin datos, empresa sin acceso…).No: sigue la sugerencia.
502 · 503 · 504La 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ódigoQué pasó
SIN_TOKENFalta Authorization: Bearer.
MCP_NO_HABILITADOTu empresa no tiene activado el MCP. Habla con tu ejecutivo comercial de Floid.
VERIFICACION_NO_DISPONIBLENo se pudo verificar la activación del MCP. Reintenta en unos minutos.
HERRAMIENTA_DESCONOCIDAEl nombre no existe en el catálogo.
PARAMETRO_DESCONOCIDOSe envió un parámetro que la herramienta no acepta. La sugerencia lista los válidos.
PARAMETRO_REQUERIDOFalta un parámetro obligatorio.
PARAMETRO_INVALIDOUn valor no tiene el tipo o formato esperado.
PARAMETRO_NO_SOPORTADOEl parámetro existe, pero no para ese banco.
BANCO_NO_SOPORTADOFalta banco o la herramienta no lo soporta.
CREDENCIAL_REQUERIDAFaltan los datos de acceso del titular.
CREDENCIAL_NO_PERMITIDASe intentó enviar una clave o certificado por MCP.
CREDENCIALES_MEZCLADASSe enviaron credencial_token y datos de acceso a la vez.
FLOID_NO_RESPONDEFloid 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ódigoSugerenciaReintentable
BANK_COMPANY_NOT_FOUNDEl usuario no tiene acceso a esa empresa. Revisa rut_empresa.No
BANK_DOWNEl banco está fuera de servicio o deshabilitado en Floid. Reintenta más tarde.Sí
BANK_ERRORLa institución o Floid no respondieron bien. Reintenta en unos minutos.Sí
CHANGE_PASSWORDLa institución exige cambiar la clave. El titular debe hacerlo allí.No
CLAVE_BLOQUEADALa clave está bloqueada en el SII. El titular debe desbloquearla allí.No
CLAVE_INVALIDARevisa 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_INACTIVALa clave tributaria está inactiva. Floid repite esta respuesta por 5 horas sin consultar.No
COMPANY_NOT_FOUNDEl usuario no tiene acceso a esa empresa. Revisa rut_empresa.No
COMPANY_PERMISSION_ERROREl usuario no tiene permisos sobre esa empresa en el SII.No
CONTRACT_REQUEST_LIMIT_EXCEEDEDSe alcanzó el límite de consultas del contrato. Contacta a Floid.No
CREDENTIAL_VALUE_WITH_TOKEN_PASSWORDUsa credencial_token o rut + clave, no ambos.No
DOCUMENT_NOT_FOUNDEl documento no existe o no fue recibido. Revisa folio, tipo y emisor.No
ERROR_INTERNOLa institución o Floid no respondieron bien. Reintenta en unos minutos.Sí
ERROR_SIILa institución o Floid no respondieron bien. Reintenta en unos minutos.Sí
EXPIRED_CREDENTIALSLa clave venció. El titular debe cambiarla en la institución.No
INACTIVE_COMPANYTu cuenta Floid está inactiva. Contacta a Floid.No
INEXISTENT_USEREl usuario no existe en la institución. Floid repite esta respuesta por 5 horas sin consultar.No
INTERNAL_ERRORLa institución o Floid no respondieron bien. Reintenta en unos minutos.Sí
INVALID_ACCOUNT_NUMBERLa cuenta no existe para este usuario. Consulta productos para ver las cuentas válidas.No
INVALID_ACCOUNT_TYPETipo de cuenta no soportado. Consulta productos para ver las cuentas válidas.No
INVALID_CONTRACTTu cuenta Floid no tiene un contrato activo. Contacta a Floid.No
INVALID_CREDENTIALSRevisa 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_TRYQueda un solo intento antes del bloqueo. No reintentes sin confirmar la clave.No
INVALID_DATESRevisa el rango de fechas.No
INVALID_RANGERevisa el rango de fechas.No
INVALID_REQUESTFaltan datos o tienen un formato inválido. Revisa el mensaje y la ficha de la herramienta.No
INVALID_TOKENEl credencial_token no existe para tu cuenta Floid o fue revocado.No
LOCKED_CREDENTIALSLa clave está bloqueada en la institución. El titular debe desbloquearla allí.No
MAX_FAILED_ATTEMPTSLa credencial está bloqueada en Floid por intentos fallidos. Personas: espera 1 hora. Empresas: no se libera sola; valida con la clave correcta.No
MAX_SESSIONSEl SII tiene demasiadas sesiones abiertas para este RUT. Reintenta en unos minutos.Sí
METHOD_NOT_AUTHTu token Floid no tiene contratado este servicio. Contacta a Floid.No
MISSING_CONTRACTTu cuenta Floid no tiene un contrato activo. Contacta a Floid.No
MONTHLY_LIMIT_REACHEDSe alcanzó el límite mensual. Contacta a Floid.No
NON_EXISTENTNo existe registro para lo consultado.No
NO_DATA_AVAILABLELa institución no tiene datos para lo pedido.No
NO_DATA_FOUNDLa institución no tiene datos para lo pedido.No
SECURITY_QUESTION_CONFIGURATIONEl titular debe configurar sus preguntas de seguridad en el banco.No
SERVICE_UNAVAILABLELa institución o Floid no respondieron bien. Reintenta en unos minutos.Sí
SESSION_OPENEl titular tiene una sesión abierta en el banco. Pídele cerrarla y reintenta en unos minutos.Sí
SIN_DATOSLa institución no tiene datos para lo pedido.No
TERMS_AND_CONDITIONSEl titular debe aceptar términos y condiciones en el sitio del banco.No
TIME_OUTLa institución o Floid no respondieron bien. Reintenta en unos minutos.Sí
TOO_MANY_REQUESTSDemasiadas consultas seguidas. Espera un momento y reintenta.Sí
TWO_FACTOR_AUTHENTICATION_REQUIREDLa institución pide segundo factor; esta herramienta no lo soporta.No
USUARIO_NO_ACTIVADOLa Clave Única no está activada. El titular debe activarla.No
WEBSITE_DOWNLa institución o Floid no respondieron bien. Reintenta en unos minutos.Sí
WEBSITE_ERRORLa institución o Floid no respondieron bien. Reintenta en unos minutos.Sí