Códigos de error de Cuenta

Códigos de error que emite Cuenta. Cada code enlaza a su propia página con la causa y la acción a tomar.

Code	Type	HTTP	Descripción
`access_level_raise_forbidden`	`invalid_request_error`	422	Se intentó subir el nivel de acceso sobre una cuenta gestionada cuyo titular ya la reclamó. Desde la reclamación solo el titular puede subir ese nivel; el proveedor solo puede bajarlo.
`account_not_found`	`not_found_error`	404	No se pudo resolver la cuenta asociada a la clave, lo que suele significar que la clave ya no apunta a una empresa viva.
`administrator_key_not_grantable`	`invalid_request_error`	422	Una de las secciones de `grants` es una llave del Administrador (gestión de usuarios, plan y suscripción, API y desarrolladores o certificado digital) y esas secciones no se conceden a un miembro.
`api_key_already_revoked`	`invalid_request_error`	422	La clave ya estaba revocada, y una clave revocada no admite más operaciones: la revocación es terminal.
`api_key_not_found`	`not_found_error`	404	El identificador no corresponde a ninguna API key de la empresa autenticada.
`enterprise_contract_transition_required`	`invalid_request_error`	422	La cuenta gestionada tiene un contrato enterprise y, al terminar la gestión, su pago pasaría al titular sin que Factuarea haya fijado todavía el plan con el que continúa. Nunca se crea una suscripción sin precio, así que no se ha cambiado nada.
`external_advisor_already_assigned`	`invalid_request_error`	422	La cuenta ya tiene un asesor externo marcado: solo puede haber uno por cuenta.
`grant_company_not_in_account`	`invalid_request_error`	422	El NIF del grant no es un NIF real de la cuenta o queda fuera del ámbito de NIF de la credencial. La respuesta es la misma en los dos casos, sin revelar cuál.
`grants_only_for_member`	`invalid_request_error`	422	Solo un miembro con rol `member` puede tener permisos por NIF (grants). El titular (`owner`) y los administradores (`admin`) alcanzan todos los NIF de la cuenta, así que un grant sobre ellos no significaría nada.
`import_file_invalid`	`invalid_request_error`	422	Uno de los ficheros de la importación no se puede leer con el formato de la plantilla: no es un CSV legible, su cabecera no aparece en las 20 primeras líneas, le falta una columna obligatoria o tiene una línea rota. `param` indica qué fichero falla (`accounts_file` o `customers_file`) y el mensaje, la columna o la línea. No se ha escrito nada.
`import_file_too_large`	`invalid_request_error`	413	Uno de los ficheros de la importación supera los 5 MB. El tamaño se comprueba antes de leer ninguna fila, así que no se ha procesado ni escrito nada. `param` indica qué fichero falla (`accounts_file` o `customers_file`).
`import_in_progress`	`conflict_error`	409	Ya hay una importación masiva de esta cuenta proveedora en curso. Las importaciones de una misma cuenta se aplican de una en una para no crear cuentas, cargos ni NIF por duplicado, así que esta no se ha aplicado ni ha escrito nada.
`import_row_limit_exceeded`	`invalid_request_error`	422	Uno de los ficheros de la importación trae más filas de las que admite una importación: 100 en el fichero de cuentas (`accounts_file`) y 1.000 en el de clientes (`customers_file`). Las filas se cuentan antes de leerlas, así que no se ha procesado ni escrito nada. `param` indica qué fichero falla.
`invitation_expired`	`invalid_request_error`	422	La invitación existe y es de esta empresa, pero su ventana de aceptación ya se cerró, así que quien la recibió no puede canjearla.
`invitation_not_found`	`not_found_error`	404	El identificador no corresponde a ninguna invitación pendiente de la empresa autenticada: puede haberse cancelado, haberse aceptado ya o pertenecer a otra empresa.
`live_credential_required`	`authorization_error`	403	Una clave de pruebas intentó modificar una cuenta de producción. Solo ocurre en las operaciones que cambian la cuenta —miembros, invitaciones, titularidad, traspasos de NIF, cartera de NIF, claves y asientos—: una clave de pruebas no puede alterar datos reales.
`managed_account_external_ref_in_other_environment`	`conflict_error`	409	La referencia externa ya la usa una cuenta gestionada del otro entorno (real o de pruebas). La referencia es única entre los dos entornos, y la respuesta no nombra esa cuenta porque este entorno no la lista. No se ha escrito nada.
`managed_account_not_claimable`	`invalid_request_error`	422	La cuenta gestionada es de pruebas, y una cuenta de pruebas nunca se reclama: no tiene vale de reclamación que emitir ni que reemitir.
`managed_account_plan_not_self_serve`	`invalid_request_error`	422	Se pidió el plan `enterprise` para una cuenta gestionada. Una cuenta gestionada se crea o se cambia en emprendedor o empresario; enterprise solo lo asigna Factuarea por contrato.
`managed_account_provider_in_trial`	`invalid_request_error`	422	La cuenta proveedora está en periodo de prueba y pidió una cuenta gestionada real, que se cobra. Durante la prueba solo se pueden crear cuentas gestionadas de pruebas.
`managed_accounts_limit_reached`	`invalid_request_error`	422	La cuenta proveedora ya tiene tantas cuentas gestionadas reales con la gestión vigente como admite su tope. Las cuentas gestionadas de pruebas no cuentan para ese tope.
`member_is_last_owner`	`invalid_request_error`	422	La operación dejaría el NIF sin ninguna persona que lo administre: el miembro que se da de baja, o que se degrada a un rol sin administración, es el último con rol `owner` o `admin` en ese NIF.
`member_not_found`	`not_found_error`	404	El identificador no corresponde a ningún miembro del equipo de la cuenta: o esa persona nunca perteneció a la empresa autenticada, o es de otra. La superficie de cuenta responde igual en ambos casos.
`module_not_grantable`	`invalid_request_error`	422	Una de las secciones de `grants` no se puede conceder: no es una sección exclusiva de administradores (un miembro ya accede a ella con permisos normales) o la empresa no la tiene por su plan.
`nif_transfer_expired`	`invalid_request_error`	422	El traspaso de NIF se emitió de verdad, pero su plazo de validez venció. A diferencia de un traspaso no reconocido, esta respuesta solo le llega a quien ya tenía uno real, así que no revela nada nuevo.
`nif_transfer_invalid`	`invalid_request_error`	422	El traspaso de NIF presentado no autoriza nada: su secreto está mal copiado, truncado, ya consumido o nunca se emitió. Todos esos casos responden igual a propósito, para que la operación no sirva para sondear qué traspasos existen.
`owner_transfer_forbidden`	`authorization_error`	403	Quien hace la petición no está autorizado a transferir la titularidad de la cuenta: o no es el titular actual, o el destinatario propuesto no puede recibirla. Es cuestión de permiso, no de payload mal formado.
`permissions_not_applicable_to_administrator`	`invalid_request_error`	422	El miembro es `owner` o `admin` de la cuenta: tiene todos los permisos de su plan y no admite restricciones ni concesiones de secciones.
`permissions_not_applicable_to_employee`	`invalid_request_error`	422	La persona es un empleado del portal del empleado: su acceso lo gobierna el portal y no la matriz de secciones, así que no admite restricciones ni concesiones.
`plan_limit_exceeded`	`payment_required_error`	402	Se alcanzó un límite de recursos del plan de la empresa.
`privileged_scope_required`	`authorization_error`	403	La operación exige el privilegio de proveedor de cuentas (`accounts:read` o `accounts:write`) y no se cumple: o la cuenta de la clave no lo tiene concedido, o la persona que emitió la clave ya no es propietaria ni administradora de la cuenta. Las dos causas responden igual.
`provisioning_account_claimed`	`conflict_error`	409	El titular ya reclamó esta cuenta gestionada y la administra por su cuenta: ya no se puede reclamar otra vez, reemitir su vale de reclamación ni volver a provisionarla con la misma referencia externa.
`relation_already_exists`	`invalid_request_error`	422	Ya hay un acceso pendiente o vigente entre estas dos cuentas, y solo puede haber uno abierto por cada pareja de cuentas.
`relation_company_not_in_grantor`	`invalid_request_error`	422	La lista de NIF del acceso no es válida: o nombra un NIF que no pertenece a la cuenta que cede el acceso, o viene vacía. El error señala el campo `company_ids` y no dice cuál de los NIF falla.
`relation_invitation_expired`	`invalid_request_error`	422	La invitación de acceso existe y sigue pendiente, pero su plazo de aceptación venció, así que ya no se puede aceptar.
`relation_invitation_invalid`	`invalid_request_error`	422	La invitación de acceso presentada no sirve: su secreto no existe, ya se usó, se revocó o va dirigida a otra cuenta. Todos esos casos responden igual a propósito, para que la operación no sirva para sondear invitaciones ajenas.
`relation_self_grant_not_allowed`	`invalid_request_error`	422	La cuenta indicada no puede recibir el acceso: o es la misma cuenta que lo cede, o el identificador no corresponde a una cuenta válida. Los dos casos responden igual.
`relation_transition_not_allowed`	`invalid_request_error`	422	El acceso entre cuentas está en un estado que no admite el cambio pedido: por ejemplo, aceptar uno que ya está vigente o reenviar la invitación de uno que ya terminó.
`sender_identity_not_verified`	`invalid_request_error`	422	La empresa emisora todavía no ha acreditado su identidad, y sin eso no puede escribir a destinatarios externos desde el dominio remitente compartido. No es un cupo agotado ni un problema de permisos: la credencial tiene el scope, y esperar no lo resuelve.

Relacionado

Códigos de error por categoría

Localiza un error por la categoría que lo emite.

Tabla de referencia completa

Todos los códigos, estados HTTP, tipos y descripciones en una referencia.

Modelo de errores

Interpreta la respuesta de error y gestiona los errores por código.

Códigos de error de Cuenta

Relacionado

En esta página