assignment_unchanged
detalle
Aviso: el grupo ya está asignado solo a ese vendedor; la fila no cambia nada.
Importador de entidades (Excel)
Códigos de error · 71 códigos · catálogo del 2026-10-21
Previsualizar, aplicar y deshacer importaciones de grupos, leads, contactos, reasignaciones, campos personalizados y metas de venta desde Excel. La validación devuelve un renglón por celda con problema.
Para toda la familia
Lo que un código no dice lo hereda de aquí.
- Cómo se detecta
- La previsualización trae cada problema con hoja, fila, columna y
code. El lote queda enentity_import_batches. - Qué hacer
- Corregir el Excel en las celdas que dice la previsualización y volver a previsualizar. Nunca aplicar con errores.
Códigos
category_inactive
detalle
Aviso del importador de metas: la categoría no tiene ningún producto (item ni paquete) activo en Zauru. La meta se carga igual.
category_not_found
detalle
Importador de metas: el item_category_id no es una categoría de esta entidad en Zauru: de producto o, si la entidad agrupa su dashboard por categoría de cliente, de cliente (se usa el id de Zauru; la plantilla trae la lista en la hoja _Categorias).
channel_type_unavailable
detalleHTTPHTTP 400
El canal de una columna (teléfono, WhatsApp, correo…) no existe en la entidad al aplicar.
contact_without_channel
detalle
Aviso: el contacto de la fila no trae ningún canal (teléfono, WhatsApp, correo).
custom_field_already_exists
detalle
El campo personalizado ya existe: hay que usar el modo «editar», no «crear».
custom_field_not_found
detalle
El campo personalizado no existe: revisar el nombre exacto en la hoja «_Campos existentes» o usar el modo «crear».
custom_field_not_resolved
HTTPHTTP 400
Un campo personalizado no quedó resuelto al escribir los valores (al aplicar).
custom_field_type_missing
HTTPHTTP 400
El tipo de campo confirmado no existe en custom_field_types.
custom_field_type_not_resolved
HTTPHTTP 400
No se pudo resolver el tipo de un campo personalizado al aplicar.
custom_field_unresolved
detalle
No se pudo resolver un campo personalizado de la hoja.
duplicate_column
detalle
Importador de metas: la misma columna viene con dos nombres (por ejemplo goal y amount); no se adivina cuál vale. Deja una sola.
duplicate_goal
detalle
Importador de metas: la misma meta (mes, vendedor y categoría) viene dos veces en el archivo; no se adivina cuál gana.
duplicate_group_id
detalle
El mismo grupo aparece más de una vez; va una sola fila por grupo.
duplicate_import_column
HTTPHTTP 400
Dos columnas de la hoja se mapearon a la misma columna destino.
duplicate_record_field
detalle
El mismo registro trae dos filas para el mismo campo.
duplicate_ref_key
detalle
La clave de referencia está repetida en la hoja.
duplicate_zauru_id
detalle
El zauru_id está repetido en la hoja Leads.
employee_not_found
detalle
El employee_id no es un vendedor de la entidad (se usa el id de empleado de Zauru).
empty_sheet
detalle
Importador de metas: la hoja de datos no tiene ninguna fila con metas.
file_required
HTTPHTTP 400
Adjunta el archivo .xlsx en el campo "file"
goal_rounded
detalle
Aviso del importador de metas: la meta traía más de dos decimales y se guarda redondeada a centavos.
group_not_found
detalle
El grupo no existe en esta entidad.
import_already_running
HTTPHTTP 409
Ya hay una importacion aplicandose en esta entidad. Espera a que termine y revisa "Importaciones recientes" antes de volver a intentar.
import_batch_already_undone
HTTPHTTP 400
Esa importación ya se había deshecho.
import_batch_is_draft
HTTPHTTP 400
Esta importacion nunca se aplico: descartala desde la pantalla del importador en vez de deshacerla.
import_batch_not_editable
HTTPHTTP 400
La importación ya no se puede editar (ya se aplicó o se descartó).
import_batch_not_found
HTTPHTTP 400HTTP 404
La importación no existe en esta entidad.
import_batch_not_undoable
HTTPHTTP 400
La importación no guardó el estado previo: no se puede deshacer.
import_batch_rows_without_number
HTTPHTTP 400
El borrador se guardó sin el número de fila de Excel (bug corregido el 05/10/2026): no se revalida ni se lista. Descartalo y volvé a subir el archivo.
import_batch_still_running
HTTPHTTP 400
Esta importacion todavia se esta aplicando. Espera a que termine para poder deshacerla.
import_batch_wrong_kind
HTTPHTTP 400
La importación es de otro tipo que el que se quiso aplicar o deshacer.
import_file_already_applied
HTTPHTTP 409
Ese mismo archivo ya se aplicó en la entidad (misma huella).
import_not_applicable
HTTPHTTP 400
La importación no se puede aplicar en su estado actual.
import_row_not_found
HTTPHTTP 404
La fila no pertenece a esa importación.
import_validation_failed
HTTPHTTP 400
El Excel tiene errores; corregilos y volve a previsualizar antes de aplicar
invalid_boolean
detalle
La celda de un campo personalizado Sí/No no se puede leer como Sí o No (acepta Sí/No, Verdadero/Falso, True/False, 1/0 y X).
invalid_boolean_value
HTTPHTTP 400
Al escribir, la celda de un campo personalizado Sí/No no se pudo leer como Sí o No.
invalid_date
detalle
La celda no es una fecha válida (DD/MM/AAAA o AAAA-MM-DD).
invalid_date_value
HTTPHTTP 400
Al aplicar, el valor no es una fecha válida para el campo.
invalid_email
detalle
La celda no es un correo válido.
invalid_employee_id
detalle
El employee_id no es un entero.
invalid_goal
detalle
Importador de metas: la meta no es un número válido (negativo, con coma decimal o con letras). Se usa punto para los decimales.
invalid_group_id
detalle
El id de grupo no es un entero válido.
invalid_item_category_id
detalle
Importador de metas: el item_category_id no es un entero válido.
invalid_mode
detalle
El modo de la fila no es «crear» ni «editar».
invalid_month
detalle
Importador de metas: el month no es un mes (se acepta 2026-10 o una fecha de ese mes).
invalid_multi_select_value
HTTPHTTP 400
Al aplicar, el valor no tiene ninguna opción válida del campo (las opciones se separan con «;»).
invalid_number
detalle
La celda no es numérica para el campo.
invalid_number_value
HTTPHTTP 400
Al aplicar, el valor no es numérico para el campo.
invalid_phone
detalle
El teléfono no tiene suficientes dígitos para el canal.
invalid_record_id
detalle
El id del registro no es un entero válido.
invalid_seller_id
detalle
Importador de metas: el seller_id no es un entero válido.
invalid_zauru_id
detalle
El zauru_id no es un entero.
known_field_absent
detalle
Aviso: un campo personalizado de la entidad no viene en el Excel (no se toca).
lead_without_contacts
detalle
Aviso: el lead no tiene contactos.
missing_required_column
detalle
Falta una columna obligatoria en la hoja.
missing_required_value
detalle
Falta un valor obligatorio en la fila.
missing_sheet
detalle
El archivo no trae las hojas que espera el importador.
missing_target_column
HTTPHTTP 400
Falta decir a qué columna se mapea una columna del Excel.
record_not_found
detalle
El registro (grupo, lead o contacto) no existe en esta entidad.
seller_not_found
detalle
Importador de metas: el seller_id no es un empleado de esta entidad en Zauru (se usa el id de empleado de Zauru; la plantilla trae la lista en la hoja _Vendedores).
seller_not_marked_as_seller
detalle
Aviso del importador de metas: el empleado existe en Zauru pero no está marcado como vendedor, así que no tendrá venta contra la cual medir la meta.
unconfirmed_custom_field
HTTPHTTP 400
Hay un campo personalizado nuevo sin confirmar su tipo: se confirma antes de aplicar.
unknown_column
detalle
La hoja trae una columna que el importador no conoce.
unknown_import_column
HTTPHTTP 400
La columna no existe en esa hoja de la importación.
unknown_import_sheet
HTTPHTTP 400
La importación no tiene esa hoja.
unresolved_ref
detalleHTTPHTTP 400
Una referencia (p. ej. cliente_ref) no resolvió a un registro.
unsupported_custom_field_type
detalleHTTPHTTP 400
El importador no escribe valores de ese tipo de campo: quitar la columna o cargarlo a mano.
value_not_in_options
detalle
El valor no es una de las opciones del campo, ni siquiera comparando sin tildes, mayúsculas ni puntuación.
wrong_entity
detalle
Importador de metas: la columna entity_id de la fila no es la entidad en la que se está importando. Evita cargar el archivo de otra empresa por error.
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.