Ir al contenido
Boost

Cartera: grupos, leads y contactos

Códigos de error · 13 códigos · catálogo del 2026-10-21

Grupos, leads, contactos, datos fiscales y vínculo con Zauru.

Para toda la familia

Lo que un código no dice lo hereda de aquí.

Cómo se detecta
La respuesta (code).
Qué hacer
El mensaje dice qué dato falta o qué no se puede cambiar.
13 códigos

Códigos

CONTACT_INACTIVE

HTTPHTTP 409

Se intentó editar un contacto inactivo. Borrar un contacto no lo elimina: lo inactiva, y un contacto inactivo no se edita.

Causa típica
El contacto se inactivó (contacts.deactivated_at no es NULL) y alguien tenía su ficha abierta, o un enlace viejo lo editó.
Cómo detectarlo
La respuesta (code, con contact_id). En la base: contacts.deactivated_at / deactivated_by.
Qué hacer
Para volver a usarlo, créalo de nuevo con su número o correo (también sirve el alta rápida de cliente): se reactiva ese mismo contacto, sin vendedor y con su historial, en el lead donde se crea. También se reactiva solo si el cliente escribe.

GROUP_ALREADY_HAS_SELLER

HTTPHTTP 409

También sale si otra persona se lo está asignando en ese mismo instante.

Causa típica
La ficha se abrió cuando el grupo no tenía vendedor y alguien más lo tomó (o lo asignó un admin o un workflow) antes de pulsar "Asignar"; o dos personas lo pulsaron a la vez y ganó la otra.
Cómo detectarlo
La respuesta (code, con group_id). En la base: group_assignments y lead_assignments activas con employee_id del grupo.
Qué hacer
Recargar la ficha: ya muestra quién lo atiende. Si hay que cambiar de vendedor, lo hace un admin o el vendedor con "Reasignar".

lead_fiscal_data_required

detalle

Para promover un lead a cliente de Zauru hacen falta nombre, NIT y dirección fiscal: un payee sin eso queda incompleto en Zauru.

no_leads_in_group

detalle

Este grupo no tiene leads o clientes visibles para la sesion actual.

SELF_ASSIGN_REQUIRES_EMPLOYEE

HTTPHTTP 422

"Asignar" en la ficha de un grupo sin vendedor, pedido por un usuario que no es empleado de la entidad (422): una asignación de vendedor es de empleado.

Causa típica
Un usuario de plataforma o una cuenta sin empleado vinculado en esa entidad abrió un grupo sin vendedor. La ficha no le ofrece "Asignar" (can_self_assign: false); llega por la API directa o con una pantalla vieja.
Cómo detectarlo
La respuesta (code). En la base: el usuario no tiene employee_id en su suscripción de la entidad.
Qué hacer
Vincular a la persona con su empleado en Configuraciones → Personas, o que la asigne quien sí es empleado (un admin con "Reasignar").

seller_goals_duplicate_cell

HTTPHTTP 400

Configuraciones > Dashboard > Metas: el guardado trae la misma celda (vendedor y categoría) dos veces. Es un error de la pantalla, no de la persona.

seller_goals_invalid_amount

HTTPHTTP 400

Metas: una o más metas no son un monto válido (negativo, con coma decimal o con letras). problems trae cada una.

seller_goals_unknown_category

HTTPHTTP 400

Metas: se intentó guardar una meta para una categoría que no existe en Zauru para la entidad. item_category_ids dice cuáles.

seller_goals_unknown_seller

HTTPHTTP 400

Metas: se intentó guardar una meta para un vendedor que no existe en Zauru para la entidad. seller_zauru_ids dice cuáles.

seller_goals_zauru_unavailable

HTTPHTTP 503

Metas: Zauru no respondió al leer las categorías y los vendedores de la entidad. Sin sus nombres la pantalla y el importador no muestran metas.

Qué hacer
Reintentar en un momento; si persiste, revisar la sesión de Zauru de la persona.

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.