Códigos de error · 30 códigos · catálogo del 2026-10-21
Login con Zauru, cambio de entidad, alta y edición de usuarios de una entidad.
Lo que un código no dice lo hereda de aquí.
code está en la respuesta (DevTools → Red) y Render solo muestra la petición con su status (type: request, filtro por path y statusCode). Los 503 de Zauru sí dejan línea de la sesión de Zauru.AGENT_ACCOUNT_INTERACTIVE_LOGIN_FORBIDDENHTTPHTTP 403
Se intentó entrar a la pantalla con la cuenta de la IA de Boost (users.kind = agent): esa cuenta solo inicia sesión como cli o agent, nunca en el navegador.
yarn -s boost …).auth_sessions_unavailableHTTPHTTP 503
No se pudo abrir o revocar la sesión en auth_sessions (la base falló): falla cerrado; en el login no se entra.
automation_user_login_forbiddenHTTPHTTP 403
Se intentó iniciar sesión con un usuario que es una identidad de automatización (el usuario API con que corren los workflows). Ese usuario no puede entrar a la pantalla.
crm_entity_access_deniedHTTPHTTP 403
El usuario no tiene acceso al CRM en la entidad pedida.
crm_entity_requiredHTTPHTTP 409
Para cambiar de entidad hace falta una entidad del CRM activa.
duplicate_user_emailHTTPHTTP 400
El mismo correo viene más de una vez en la lista de usuarios a crear.
duplicate_zauru_employee_idHTTPHTTP 400
El mismo empleado de Zauru viene más de una vez en la lista de usuarios a crear.
employee_belongs_to_other_entityHTTPHTTP 409
El empleado de Zauru ya existe en otra entidad de Boost; no se puede crear de nuevo en esta.
entity_user_name_requiredHTTPHTTP 400
Se pidió dejar vacío el nombre de una persona al corregirla.
entity_user_not_foundHTTPHTTP 404
La persona que se quiso corregir no es un empleado de la entidad activa.
entity_user_update_emptyHTTPHTTP 400
Se pidió corregir a una persona (Roles y permisos > Personas) sin mandar ni nombre ni correo.
entity_user_without_loginHTTPHTTP 400
Se quiso corregir el correo de una persona que no tiene usuario para iniciar sesión (empleado sin user_id).
PLATFORM_ENTITY_ACCESS_REQUIREDHTTPHTTP 403
El perfil demo solo entra a las entidades con acceso concedido.
PLATFORM_ONLYHTTPHTTP 403
La operación es solo para usuarios de plataforma (p. ej. consultar a otros usuarios o entidades).
platform_user_email_lockedHTTPHTTP 403
Se quiso cambiar desde Personas el correo de otra cuenta de plataforma (superadmin, soporte o demo).
PRINCIPAL_ROLE_LOCKEDHTTPHTTP 400
El rol de la identidad API (usuario de workflows) y el de un superadmin no se dan ni se cambian desde la pantalla de usuarios.
role_not_foundHTTPHTTP 400
El rol elegido no existe.
role_outside_entityHTTPHTTP 403
El rol elegido es de otra entidad.
service_identity_api_key_invalidHTTPHTTP 400
Zauru rechazó la apikey de la identidad de servicio: no es la de ese usuario o no tiene acceso a la entidad.
service_identity_api_key_requiredHTTPHTTP 400
Una identidad de servicio (usuario de workflows) necesita su apikey de Zauru; sin ella los workflows de la entidad no pueden escribir en Zauru.
SERVICE_USER_ALREADY_EXISTSHTTPHTTP 400
La entidad ya tiene su identidad API (usuario de servicio): solo puede haber una por entidad.
service_user_email_lockedHTTPHTTP 400
Se quiso cambiar desde Personas el correo de la identidad de servicio (api@) o de la cuenta de IA; sus credenciales se administran aparte.
super_admin_not_assignable_hereHTTPHTTP 403
El rol super_admin no se puede asignar desde la pantalla de usuarios de la entidad.
supervisor_not_foundHTTPHTTP 400HTTP 409
El supervisor indicado no se encontró al armar la jerarquía supervisor-vendedor.
supervisor_ref_on_non_sellerHTTPHTTP 400
Se le puso supervisor a alguien cuyo rol no es de vendedor; la jerarquía solo aplica a vendedores.
user_email_takenHTTPHTTP 409
El correo nuevo ya es de otro usuario de Boost: users.email es único y global.
user_email_zauru_id_mismatchHTTPHTTP 409
El correo ya pertenece a otro usuario con un zauru_id distinto al del pedido.
user_is_super_adminHTTPHTTP 409
Se pidió darle rol de entidad a un super admin; no lo necesita (ya tiene acceso a todas). Hay que quitarlo de la lista.
zauru_entity_switch_incompleteHTTPHTTP 503
Zauru hizo el cambio de entidad pero la sesión de la entidad destino todavía no está lista (503): reintentar.
zauru_unavailabledetalleHTTPHTTP 503
Zauru respondió con error 5xx durante el login: está caído o con problemas (503).
Texto generado desde el catálogo de errores de BoostAPI. Para corregirlo, se cambia allá y se sincroniza: verMantener esta documentación. También enMarkdown.