Códigos de error

Toda respuesta de error de la API tiene este shape:

{
  "status": "failed",
  "code": "ASSET_NOT_FOUND",
  "message": "Activo no encontrado",
  "requestId": "b2f8c9e0-…"
}

code: código estable — es el campo para hacer branching en el cliente.
message: mensaje legible, seguro para mostrar al usuario final.
requestId: identificador de la request. Incluilo si reportás un problema al soporte.
Los errores de validación agregan errors: [{ path, message }] con el detalle por campo.

Algunos endpoints todavía devuelven códigos con la forma ERR_<status> (por ejemplo ERR_409). Esos no son estables: no hagas branching sobre ellos. Los códigos del catálogo de abajo sí lo son.

Errores de servicios externos

Cuando falla un proveedor externo, la API responde un código de la familia <PROVEEDOR>_HTTP_<status> / NAVIXY_STATUS_<n> con un mensaje traducido y el status real del fallo (400/404/409/429 se conservan; fallos de infraestructura o de credenciales de la integración responden 502). Estos códigos son dinámicos y no aparecen como entradas de este catálogo; el prefijo identifica la integración.

Catálogo

Transversales

Código	HTTP	Mensaje al cliente
`INTERNAL_ERROR`	500	Error interno del servidor
`VALIDATION_ERROR`	400	Error de validacion
`ROUTE_NOT_FOUND`	404	Ruta no encontrada
`NAVIXY_REQUEST_FAILED`	502	El servicio externo no devolvió una respuesta válida. Intenta nuevamente.
`RATE_LIMITED`	429	Demasiadas solicitudes. Intente nuevamente mas tarde.
`DATABASE_ERROR`	500	Error interno del servidor
`DB_NOT_READY`	500	Base de datos no disponible
`NOT_READY`	503	El servicio no está listo para recibir tráfico
`NOT_FOUND`	404	Recurso no encontrado
`UNAUTHORIZED`	401	No autorizado
`FORBIDDEN`	403	Acceso denegado
`PERMISSION_DENIED`	403	No tienes permiso para realizar esta acción
`PERMISSION_CHECK_FAILED`	500	Error al verificar permisos
`PANEL_ACCESS_UNAVAILABLE`	503	No fue posible verificar el acceso UGPS. Intenta nuevamente en unos minutos
`INVALID_OBJECT_ID`	400	Identificador invalido
`INVALID_EXPORT_FORMAT`	400	Formato de exportacion no soportado
`INVALID_CLIENT`	400	Cliente inválido
`FILE_UPLOAD_ERROR`	400	Archivo inválido o no permitido

Autenticación y sesión

Código	HTTP	Mensaje al cliente
`SESSION_REQUIRED`	401	No hay sesion activa
`SESSION_CREDENTIAL_REQUIRED`	403	Esta accion requiere una sesion de usuario
`AUTH_BAD_REQUEST`	400	Solicitud de autenticacion invalida
`AUTH_UNAUTHORIZED`	401	Credenciales invalidas o sesion expirada
`AUTH_FORBIDDEN`	403	No tiene permisos para realizar esta accion
`MCP_CONSENT_OPERATION`	403	Esta conexion no incluye permiso para esa consulta
`ONE_TIME_LINK_NOT_FOUND`	404	El enlace no existe o ya venció. Pedile al asistente uno nuevo.
`ONE_TIME_LINK_EXPIRED`	410	El enlace venció. Pedile al asistente uno nuevo.
`ONE_TIME_LINK_USED`	410	El enlace ya se usó. Pedile al asistente uno nuevo.
`ONE_TIME_LINK_OTHER_COMPANY`	403	El enlace es de otro usuario. Abrilo con la cuenta de la persona que lo pidió.
`ONE_TIME_LINK_WEB_SESSION_REQUIRED`	403	El enlace se abre en Atlas, con tu sesión iniciada.
`ONE_TIME_LINK_PURPOSE_UNAVAILABLE`	400	Ese tipo de enlace todavía no está disponible.
`AUTH_PORTAL_SESSION_SCOPE`	403	Este ingreso solo da acceso al portal de reservas. Para usar Atlas, inicia sesión con tu contraseña.
`AUTH_NOT_FOUND`	404	Cuenta no encontrada
`AUTH_SERVICE_UNAVAILABLE`	503	Servicio de autenticacion no disponible
`USER_INACTIVE`	403	Usuario inactivo
`CLIENT_INACTIVE`	403	Cliente inactivo
`API_TOKEN_INVALID`	401	API token invalido, expirado o revocado
`API_TOKEN_USER_NOT_FOUND`	401	Usuario asociado al API token no encontrado
`API_TOKEN_USER_INACTIVE`	403	Usuario asociado al API token inactivo
`API_TOKEN_CLIENT_INACTIVE`	403	Cliente asociado al API token inactivo
`API_TOKEN_VALIDATION_ERROR`	401	No se pudo validar el API token
`INVALID_CODE`	401	Código de verificación incorrecto
`OTP_HAS_EXPIRED`	401	El código expiró. Solicita uno nuevo.
`TOO_MANY_ATTEMPTS_REQUEST_NEW_CODE`	401	Demasiados intentos. Solicita un código nuevo.
`INVALID_TWO_FACTOR_COOKIE`	401	La verificación expiró. Vuelve a iniciar sesión.
`MOBILE_TWO_FACTOR_OTP_SEND_FAILED`	502	No se pudo enviar el código de verificación. Intenta nuevamente.
`MOBILE_TWO_FACTOR_NOT_SUPPORTED`	403	La verificación en dos pasos requiere una versión más reciente de la aplicación. Actualízala para ingresar.
`MOBILE_SIGN_IN_NO_TOKEN`	500	No se pudo iniciar sesión. Intenta nuevamente en unos momentos.
`AUTH_OPERATION_FAILED`	500	No se pudo completar la operación de autenticación

Recursos no encontrados

Código	HTTP	Mensaje al cliente
`ASSET_NOT_FOUND`	404	Activo no encontrado
`CLIENT_NOT_FOUND`	404	Cliente no encontrado
`GEOFENCE_NOT_FOUND`	404	Geocerca no encontrada
`GEOZONE_NOT_FOUND`	404	Geozona no encontrada
`EXECUTION_NOT_FOUND`	404	Ejecucion de reporte no encontrada
`SCHEDULED_REPORT_NOT_FOUND`	404	Reporte programado no encontrado
`APP_FORM_NOT_FOUND`	404	Formulario no encontrado
`FORM_TEMPLATE_NOT_FOUND`	404	Plantilla de formulario no encontrada
`KML_NOT_FOUND`	404	Archivo KML no encontrado
`ROAD_SPEED_LIMIT_NOT_FOUND`	404	Limite de velocidad de via no encontrado
`USER_NOT_FOUND`	404	Usuario no encontrado
`ROLE_NOT_FOUND`	404	Rol no encontrado
`TRACKER_NOT_FOUND`	404	Dispositivo no encontrado
`ALERT_NOT_FOUND`	404	Alerta no encontrada
`ALERT_TRIGGER_NOT_FOUND`	404	Disparador no encontrado
`MAINTENANCE_NOT_FOUND`	404	Recurso de mantenimiento no encontrado
`PEDIDO_NOT_FOUND`	404	Pedido no encontrado
`TRANSPORTISTA_NOT_FOUND`	404	Transportista no encontrado
`CARGO_UBICACION_NOT_FOUND`	404	Ubicación no encontrada
`PLACE_NOT_FOUND`	404	POI no encontrado
`TRIP_NOT_FOUND`	404	Viaje no encontrado
`STOP_NOT_FOUND`	404	Parada entre viajes no encontrada
`NOTIFICATION_NOT_FOUND`	404	Notificación no encontrada
`ASSET_GROUP_NOT_FOUND`	404	Grupo de activos no encontrado
`LAYER_NOT_FOUND`	404	Capa no encontrada
`DRIVER_NOT_FOUND`	404	Conductor no encontrado
`TASK_IMPORT_NOT_FOUND`	404	Registro de importación no encontrado

Usuarios

Código	HTTP	Mensaje al cliente
`USER_PROTECTED`	403	No se puede eliminar un usuario protegido
`USER_DELETE_FORBIDDEN`	403	No tienes permisos para eliminar este usuario
`USER_PASSWORD_CHANGE_FORBIDDEN`	403	No tienes permisos para cambiar esta contraseña
`ROLE_PROTECTED`	403	No se puede eliminar un rol protegido
`ROLE_FORBIDDEN`	403	No tienes permisos para asignar usuarios a roles protegidos o con acceso al panel de administración
`ROLE_CONFLICT`	409	No se puede eliminar el rol porque está asignado a usuarios
`ROLE_INVALID_PERMISSIONS`	400	Hay permisos bloqueados por restricciones del cliente
`ROLE_INVALID_ASSIGNMENT`	400	Uno o más usuarios asignados no pertenecen al cliente o no se pueden modificar
`ROLE_OPERATION_FAILED`	500	Error al procesar el rol

Trackers

Código	HTTP	Mensaje al cliente
`TRACKER_ALREADY_LINKED`	409	Ese dispositivo ya está registrado
`TRACKER_IDENT_MISMATCH`	409	El IMEI no coincide con el del dispositivo registrado
`TRACKER_SENSOR_DIN_CONFLICT`	409	Esa entrada digital ya está asignada a otro sensor del dispositivo
`TRACKER_FLESPI_ID_INVALID`	500	El dispositivo tiene una configuración inválida. Contacta a soporte
`TRACKER_FLESPI_IDENT_MISSING`	400	El dispositivo no tiene IMEI configurado
`TRACKER_FLESPI_CREATE_REJECTED`	400	No se pudo dar de alta el dispositivo: revisa el IMEI y el modelo
`TRACKER_FLESPI_CREATE_FAILED`	500	No se pudo crear el dispositivo
`TRACKER_FLESPI_DELETE_FAILED`	500	No se pudo eliminar el dispositivo
`TRACKER_PROVISIONING_ENQUEUE_FAILED`	503	El dispositivo quedó registrado pero no se pudo sincronizar. Intenta de nuevo en unos minutos

Fechas y rangos

Código	HTTP	Mensaje al cliente
`DATE_RANGE_INVALID`	400	Rango de fechas invalido
`DATE_RANGE_REQUIRED`	400	El rango de fechas es requerido
`DATE_RANGE_TOO_LARGE`	400	El rango de fechas es demasiado amplio
`DATE_FROM_REQUIRED`	400	La fecha de inicio es requerida
`DATE_TO_REQUIRED`	400	La fecha de termino es requerida
`INVALID_DATE_FORMAT`	400	Formato de fecha invalido
`INVALID_DATE_RANGE`	400	Rango de fechas invalido
`INVALID_TIME_FORMAT`	400	Formato de hora invalido
`MISSING_DATE_RANGE`	400	El rango de fechas es requerido

Geozonas / KML

Código	HTTP	Mensaje al cliente
`KML_TOO_LARGE`	413	El archivo KML supera el tamano maximo permitido
`KML_PARSE_ERROR`	400	No se pudo interpretar el archivo KML
`KML_READ_ERROR`	400	Error al leer el archivo KML
`KML_PROCESSING_ERROR`	400	No se pudo procesar el archivo KML
`KMZ_DECOMPRESS_ERROR`	400	Error al descomprimir el archivo KMZ
`KMZ_WITHOUT_KML`	400	El KMZ no contiene un archivo KML
`KML_PLACEMARK_LIMIT`	400	El archivo KML supera el limite de elementos
`EMPTY_POLYGON`	400	El poligono no tiene coordenadas validas
`UNSUPPORTED_GEOZONE_GEOMETRY`	400	Geometria de geozona no soportada

Geocodificación

Código	HTTP	Mensaje al cliente
`GEOCODING_COORDINATES_INVALID`	400	Coordenadas inválidas
`GEOCODING_QUERY_INVALID`	400	La dirección debe tener al menos 4 caracteres
`GEOCODING_PROVIDER_FAILED`	500	El servicio de geocodificación no está disponible
`GEOCODING_OPERATION_FAILED`	500	Error al procesar la solicitud de geocodificación

Precios de combustible

Código	HTTP	Mensaje al cliente
`FUEL_PRICE_OPERATION_FAILED`	500	Error al procesar la solicitud de precios de combustible

Portal del cliente (Facturación y Soporte vía Raúl)

Código	HTTP	Mensaje al cliente
`PORTAL_NOT_LINKED`	404	El portal del cliente no está habilitado para esta empresa
`PORTAL_UNAVAILABLE`	503	Facturación y Soporte no están disponibles en este momento
`PORTAL_TOKEN_INVALID`	503	Facturación y Soporte no están disponibles en este momento
`PORTAL_CONTRACT_INVALID`	502	La plataforma comercial devolvió una respuesta inválida
`INVOICE_NOT_FOUND`	404	Factura no encontrada
`INVOICE_NOT_PAYABLE`	409	Esta factura no se puede pagar en línea. Puede que ya esté pagada.

Tienda de módulos (spec #3666)

Código	HTTP	Mensaje al cliente
`MODULE_REQUEST_FAILED`	503	No pudimos enviar tu solicitud, intenta de nuevo
`MODULE_REQUEST_UNAVAILABLE`	503	No pudimos enviar tu solicitud, intenta en unos minutos
`MODULE_NOT_REQUESTABLE`	409	Este módulo no se puede solicitar

Portal de clientes: canje del enlace mágico (customer_portal)

Código	HTTP	Mensaje al cliente
`CUSTOMER_PORTAL_TOKEN_INVALID`	401	El enlace ya no sirve. Pide uno nuevo.
`CUSTOMER_PORTAL_CLIENT_NOT_LINKED`	409	Tu empresa todavía no tiene portal en Atlas. Escríbenos y lo habilitamos.
`CUSTOMER_PORTAL_ACCESS_DENIED`	403	No pudimos habilitar el ingreso con este correo. Escríbenos a soporte.
`CUSTOMER_PORTAL_ROLE_UNAVAILABLE`	503	El portal no está disponible por ahora. Intenta de nuevo en unos minutos.
`INVOICE_PDF_BATCH_IN_PROGRESS`	409	Ya tienes una descarga en curso.
`INVOICE_PDF_BATCH_EMPTY`	404	No hay facturas para descargar en el período.
`INVOICE_PDF_BATCH_TOO_LARGE`	400	Máximo 100 facturas por descarga.
`INVOICE_PDF_BATCH_FAILED`	502	No se pudo descargar ningún PDF de las facturas seleccionadas.
`INVOICE_REPORT_TOO_LARGE`	400	El período tiene demasiadas facturas para un informe. Acota el período.
`TICKET_NOT_FOUND`	404	Ticket no encontrado
`TICKET_CLOSED`	409	El ticket está cerrado y no admite comentarios

Tarifas de combustible

Código	HTTP	Mensaje al cliente
`FUEL_TARIFF_NOT_FOUND`	404	Tarifa de combustible no encontrada
`FUEL_TARIFF_CONFLICT`	409	Ya existe una tarifa de combustible con ese nombre
`FUEL_TARIFF_PRICE_REQUIRED`	400	Una tarifa con precio propio requiere el precio por litro
`FUEL_TARIFF_OPERATION_FAILED`	500	Error al procesar la solicitud de tarifas de combustible

Reserva de vehículos

Código	HTTP	Mensaje al cliente
`VEHICLE_RESERVATION_NOT_FOUND`	404	Reserva no encontrada
`VEHICLE_RESERVATION_LEG_NOT_FOUND`	404	Tramo de la reserva no encontrado
`VEHICLE_RESERVATION_INVALID_TRANSITION`	409	La reserva ya no está en un estado que permita esta acción
`VEHICLE_RESERVATION_INVALID_SCHEDULE`	400	Revisa las fechas y horas del viaje
`VEHICLE_RESERVATION_INVALID_PLACE`	400	La comuna no pertenece a la región elegida
`VEHICLE_RESERVATION_INVALID_PURPOSE`	400	Revisa el motivo del viaje
`VEHICLE_RESERVATION_INVALID_APPROVER`	400	La jefatura elegida no puede aprobar esta solicitud
`VEHICLE_RESERVATION_INVALID_WAIT_ON_SITE`	400	La espera en el punto es solo para viajes de ida y vuelta con el mismo vehículo y conductor
`VEHICLE_RESERVATION_SELF_DRIVE_NOT_ALLOWED`	403	No tienes fianza vigente para conducir un vehículo institucional
`VEHICLE_RESERVATION_FORBIDDEN`	403	No puedes realizar esta acción sobre la reserva
`VEHICLE_RESERVATION_ASSET_INVALID`	400	El vehículo elegido no está disponible para reservas
`VEHICLE_RESERVATION_DRIVER_INVALID`	400	El conductor elegido no está disponible
`VEHICLE_RESERVATION_ASSET_CONFLICT`	409	El vehículo ya tiene un viaje asignado en ese horario
`VEHICLE_RESERVATION_DELETE_IN_ROUTE`	409	No se puede eliminar un viaje en ruta: espera a que termine
`VEHICLE_RESERVATION_JOB_TITLE_DUPLICATE`	409	Ese cargo ya existe
`VEHICLE_RESERVATION_JOB_TITLE_IN_USE`	409	Ese cargo lo tienen jefaturas: cámbiales el cargo antes de quitarlo
`VEHICLE_RESERVATION_JOB_TITLE_INVALID`	400	Elige un cargo de la lista de Configuración → Reservas → Cargos
`VEHICLE_RESERVATION_JOB_TITLE_NOT_FOUND`	404	El cargo no existe
`VEHICLE_RESERVATION_DRIVER_DUPLICATE`	409	Ya existe un conductor con ese RUT o correo
`VEHICLE_RESERVATION_DRIVER_CONFLICT`	409	El conductor ya tiene un viaje asignado en ese horario
`VEHICLE_RESERVATION_APPROVER_CONFLICT`	409	Ese correo pertenece a un usuario de otra empresa
`VEHICLE_RESERVATION_APPROVER_INACTIVE`	409	La cuenta está desactivada; reactívala desde Usuarios.
`VEHICLE_RESERVATION_APPROVER_LOCKED`	409	Esta persona tiene un rol con más permisos que los de una jefatura: dale el permiso de aprobar desde Roles.
`VEHICLE_RESERVATION_APPROVER_ROLE_CONFLICT`	409	Ya existe un rol «Jefatura» con otros permisos: déjale solo Solicitar y Aprobar reservas, o cámbiale el nombre.
`VEHICLE_RESERVATION_SELF_APPROVAL_FORBIDDEN`	403	No puedes aprobar tu propia solicitud.
`VEHICLE_RESERVATION_PROFILE_NAME_LOCKED`	409	Tu nombre ya quedó registrado. Si hay un error, pide a un administrador que lo corrija.
`VEHICLE_RESERVATION_PORTAL_NOT_FOUND`	404	Portal no encontrado
`VEHICLE_RESERVATION_PORTAL_NOT_CONFIGURED`	409	El portal de reservas de la empresa no está configurado
`VEHICLE_RESERVATION_OPERATION_FAILED`	500	Error al procesar la reserva de vehículo

Formularios

Código	HTTP	Mensaje al cliente
`FORM_FIELD_REQUIRED`	400	Falta un campo requerido del formulario
`FORM_FIELD_INVALID_TYPE`	400	Un campo del formulario tiene un tipo invalido
`FORM_FIELD_INVALID_OPTION`	400	Un campo del formulario tiene una opcion invalida
`FORM_FIELD_INVALID_EMAIL`	400	Un campo del formulario tiene un email invalido
`FORM_FIELD_INVALID_DATE`	400	Un campo del formulario tiene una fecha invalida
`FORM_OPERATION_FAILED`	500	Error al procesar el formulario

Reportes y alertas

Código	HTTP	Mensaje al cliente
`UNSUPPORTED_REPORT_TYPE`	400	Tipo de reporte no soportado
`UNSUPPORTED_ALERT_TYPE`	400	Tipo de alerta no soportado
`CHECKIN_REPORT_TOO_LARGE`	413	El reporte supera el tamano maximo; acote el rango
`NO_VISIBLE_TRACKERS`	403	No hay dispositivos disponibles para generar el reporte
`SPEED_LIMIT_REQUIRED`	400	El limite de velocidad es requerido para alertas de velocidad
`ALERT_LIMIT_EXCEEDED`	400	Limite de alertas alcanzado para el dispositivo
`GEOFENCE_FORBIDDEN`	403	La geocerca indicada pertenece a otro cliente
`GEOFENCE_CONFLICT`	409	La geocerca indicada es ambigua para este cliente
`GEOFENCE_SYNC_FAILED`	500	Error al sincronizar la geocerca
`GEOFENCE_NOT_SYNCED`	409	La geocerca no está sincronizada con el motor de alertas y no admite alertas
`GEOFENCE_OPERATION_FAILED`	500	Error al procesar la geocerca
`SCHEDULED_REPORT_INVALID_UPDATE`	400	No se permite modificar el tipo de reporte (reportType)
`SCHEDULED_REPORT_OPERATION_FAILED`	500	Error al procesar el reporte programado
`TRACKER_OPERATION_FAILED`	500	No se pudo completar la operación sobre el dispositivo
`TRIP_OPERATION_FAILED`	500	Error al procesar el viaje
`USER_OPERATION_FAILED`	500	Error al procesar el usuario
`USER_PROVISIONING_CONFLICT`	409	El alta entra en conflicto con una cuenta o solicitud existente. Revisa su estado.
`NOTIFICATION_OPERATION_FAILED`	500	Error al procesar la notificación
`ALERT_FORBIDDEN`	403	La alerta no se puede modificar manualmente
`ALERT_GEOFENCE_REQUIRED`	400	La geocerca es requerida para alertas de geocerca
`ALERT_ASSET_CONFLICT`	409	Los dispositivos ya están asignados a otra alerta del mismo tipo
`ALERT_CONFIGURATION_FAILED`	500	Error al configurar la alerta
`ALERT_SYNC_FAILED`	500	Error al sincronizar los dispositivos de la alerta
`ALERT_OPERATION_FAILED`	500	Error al procesar la alerta
`REPORT_OPERATION_FAILED`	500	Error al generar el reporte
`NAVIXY_PLATFORM_NOT_CONFIGURED`	400	La cuenta no tiene esa plataforma de rastreo configurada

Unicidad de recursos

Código	HTTP	Mensaje al cliente
`USER_EMAIL_ALREADY_EXISTS`	409	Ya existe un usuario con ese email
`TRACKER_IMEI_ALREADY_EXISTS`	409	Ya existe un dispositivo con ese IMEI
`ALERT_TRIGGER_ALREADY_EXISTS`	400	Ya existe un disparador con el mismo nombre
`ROLE_ALREADY_EXISTS`	409	Ya existe un rol con el mismo nombre para este cliente
`ASSET_ALREADY_EXISTS`	400	Ya existe un activo con el mismo nombre para este cliente
`DRIVER_ALREADY_EXISTS`	400	Ya existe un conductor con el mismo RUT
`DRIVER_APP_ACCESS_ALREADY_GRANTED`	409	El conductor ya tiene una cuenta vinculada
`DRIVER_PHONE_CHANGED`	409	El teléfono del conductor cambió mientras editabas. Recargá la ficha.
`INSPECTOR_ROLE_NOT_FOUND`	409	El cliente no tiene el rol Inspector; reintentá más tarde o creá el rol
`DRIVER_CODE_RUT_NOT_FOUND`	404	Tu RUT no está registrado como conductor. Consulta con tu empresa.
`DRIVER_CODE_ACCESS_BLOCKED`	403	Tu empresa no habilitó tu ingreso a la aplicación. Consulta con tu empresa.
`DRIVER_CODE_INVALID`	401	Código incorrecto o vencido. Pide uno nuevo.
`DRIVER_CODE_LOGIN_EMAIL_DUPLICATE`	403	No pudimos habilitar tu acceso: el correo de tu ficha ya tiene otra cuenta. Pide ayuda a tu empresa.
`DRIVER_CODE_SMS_LIMIT_REACHED`	503	No podemos enviar códigos en este momento. Intenta más tarde.
`ASSET_GROUP_ALREADY_EXISTS`	400	Ya existe un grupo de activos con este nombre para este cliente.

Check-ins de Navixy (Registros)

Código	HTTP	Mensaje al cliente
`CHECKIN_NOT_FOUND`	404	Check-in no encontrado
`CHECKIN_FORM_NOT_FOUND`	404	El check-in no tiene un formulario asociado.

Formularios dinámicos (DynamicForm)

Código	HTTP	Mensaje al cliente
`DYNAMIC_FORM_NOT_FOUND`	404	Formulario no encontrado
`DYNAMIC_FORM_ASSET_NOT_FOUND`	404	Algún activo elegido no existe o no tenés acceso a él
`DYNAMIC_FORM_FIELD_TYPE_CHANGED`	400	No se puede cambiar el tipo de un campo existente; crea un campo nuevo
`DYNAMIC_FORM_VALUES_INVALID`	400	Las respuestas del formulario no son válidas
`DYNAMIC_FORM_OPERATION_FAILED`	500	Error al procesar el formulario

Inspecciones

Código	HTTP	Mensaje al cliente
`INSPECTION_NOT_FOUND`	404	Inspección no encontrada
`INSPECTION_VALUES_INVALID`	400	Las respuestas del formulario no son válidas
`INSPECTION_ASSET_NOT_FOUND`	404	Activo no encontrado
`INSPECTION_UNSUPPORTED_MIME_TYPE`	400	Tipo de archivo no soportado
`INSPECTION_QR_STICKERS_NO_ASSETS`	404	No hay activos para imprimir
`INSPECTION_QR_STICKERS_TOO_MANY_ASSETS`	400	Demasiados activos para un solo PDF de stickers
`INSPECTION_QR_NOT_FOUND`	404	QR de inspección no encontrado
`INSPECTION_QR_REVOKED`	410	Este QR ya no es válido
`INSPECTION_PDF_BATCH_IN_PROGRESS`	409	Ya tienes una descarga en curso.
`INSPECTION_PDF_BATCH_NOT_FOUND`	404	Resumen de la descarga no encontrado.
`INSPECTION_PDF_BATCH_FAILED`	500	No se pudo generar ningún PDF de las inspecciones seleccionadas.
`INSPECTION_OPERATION_FAILED`	500	Error al procesar la inspección

Pedidos (cargo)

Código	HTTP	Mensaje al cliente
`PEDIDO_VEHICLE_MOVING_CONFLICT`	409	El vehículo ya tiene un pedido en movimiento (detectado por índice único).
`PEDIDO_INVALID_TRANSITION`	409	Transición de estado inválida
`PEDIDO_CONCURRENT_MODIFICATION`	409	El estado del pedido cambió concurrentemente. Recarga e intenta nuevamente.
`ETA_CALCULATION_FAILED`	503	No se pudo calcular la ETA. Ingresa la ETA manualmente.
`PEDIDO_OPERATION_FAILED`	500	Error al procesar el pedido
`CARGO_OPERATION_FAILED`	500	Error al procesar la operación de cargo

Consulta vehicular

Código	HTTP	Mensaje al cliente
`VEHICLE_LOOKUP_INVALID`	400	Consulta vehicular inválida
`VEHICLE_LOOKUP_NOT_FOUND`	404	No se encontró información para la patente consultada
`VEHICLE_LOOKUP_UNAVAILABLE`	503	El servicio de consulta vehicular no está disponible temporalmente
`VEHICLE_LOOKUP_OPERATION_FAILED`	500	Error al procesar la consulta vehicular

Mensajes de dispositivos (export a Parquet)

Código	HTTP	Mensaje al cliente
`DEVICE_MESSAGE_EXPORT_COUNT_MISMATCH`	500	Error en la exportación de mensajes de dispositivos
`DEVICE_MESSAGE_EXPORT_EMPTY_DAY`	500	Error en la exportación de mensajes de dispositivos
`DEVICE_MESSAGE_EXPORT_REGRESSION`	500	Error en la exportación de mensajes de dispositivos

Terreno (work)

Código	HTTP	Mensaje al cliente
`TASK_BULK_NOT_FOUND`	404	Operación masiva no encontrada.
`EMPLOYEE_LOCATION_NOT_FOUND`	400	No se encontró la ubicación de la dirección indicada.
`WORK_OPERATION_FAILED`	500	Error al procesar la operación de terreno
`FIELD_RECORD_PDF_BATCH_IN_PROGRESS`	409	Ya tienes una descarga en curso.
`FIELD_RECORD_PDF_BATCH_NOT_FOUND`	404	Resumen de la descarga no encontrado.
`FIELD_RECORD_PDF_BATCH_FAILED`	500	No se pudo generar ningún PDF de los registros seleccionados.
`TASK_ROUTE_CHECKPOINTS_INVALID`	400	Las paradas de la ruta no cumplen las reglas de cantidad u horario.

Administración

Código	HTTP	Mensaje al cliente
`CLIENT_CONFLICT`	409	No se puede eliminar el cliente porque tiene recursos asociados
`CLIENT_UPDATE_FAILED`	500	Error al actualizar el cliente
`ADMIN_OPERATION_FAILED`	500	Error al procesar la operación de administración

Facturación (gastos)

Código	HTTP	Mensaje al cliente
`BILLING_EXPENSE_VOIDED`	409	El gasto está anulado: no se puede editar. Si fue un error, borralo y volvé a cargarlo.
`BILLING_EXPENSE_ALREADY_VOIDED`	409	El gasto ya está anulado.

Mantenimiento

Código	HTTP	Mensaje al cliente
`MAINTENANCE_PART_CONFLICT`	400	No se puede eliminar la parte porque tiene stock asociado
`MAINTENANCE_STOCK_ALREADY_EXISTS`	409	El repuesto ya tiene stock en esa bodega: ajusta la cantidad en vez de darlo de alta.
`MAINTENANCE_LOCATION_HAS_STOCK`	409	No se puede borrar la bodega porque todavía tiene stock. Deja su stock en cero antes de borrarla.
`MAINTENANCE_PROFILE_ALREADY_EXISTS`	409	Ese activo ya tiene un perfil de mantención. Edita el perfil existente en vez de crear otro.
`MAINTENANCE_PART_CODE_ALREADY_EXISTS`	409	Ya hay un repuesto con ese código. Usa otro código o edita el repuesto existente.
`MAINTENANCE_COST_ENTRY_ALREADY_EXISTS`	409	Ese costo ya está registrado para el mismo origen.
`MAINTENANCE_SERVICE_PROVIDER_IN_USE`	409	No se puede borrar el proveedor porque tiene órdenes de trabajo. Desactívalo para que no se ofrezca en órdenes nuevas.
`MAINTENANCE_RECORD_IN_WORK_ORDER`	409	No se puede borrar porque está en una orden de trabajo. Sácalo de la orden antes de borrarlo.
`MAINTENANCE_ASSET_ACTIVATION_BLOCKED`	409	No se puede pasar el activo a «Activo» mientras tenga inspecciones no aptas, defectos críticos o fallas severas sin resolver.
`MAINTENANCE_SCHEDULE_RECIPIENTS_INVALID`	400	Uno o más destinatarios no son usuarios activos de tu empresa.
`MAINTENANCE_SCHEDULE_RECURRENCE_IMMUTABLE`	409	No se puede cambiar si la mantención se hace una vez o se repite. Crea una nueva con el tipo que necesitas.
`MAINTENANCE_SCHEDULE_CONDITIONS_INVALID`	400	Las condiciones no corresponden al tipo de la mantención: una que se hace una vez lleva fecha, km u horas absolutos.
`MAINTENANCE_SCHEDULE_LEGACY_EDIT_INVALID`	400	El cambio no corresponde a ninguna condición de la mantención: indicá la unidad de la condición que querés cambiar (días, semanas o meses; km u horas).
`MAINTENANCE_SCHEDULE_DELETE_IN_OPEN_WORK_ORDER`	409	No se puede eliminar la mantención: está en una orden de trabajo abierta. Quítala de la orden o ciérrala antes de eliminarla.
`MAINTENANCE_SCHEDULE_CHANGE_IN_OPEN_WORK_ORDER`	409	No se puede guardar el cambio: la mantención de un activo está en una orden de trabajo abierta. Quítala de la orden o ciérrala antes.
`MAINTENANCE_UPCOMING_ITEM_CONFLICT`	409	Esta mantención no se puede agregar a la orden de trabajo.
`MAINTENANCE_WORK_ORDER_CANCEL_CONFLICT`	409	No se puede cancelar una orden completada o cerrada. Reábrela primero si necesitas cancelarla.
`MAINTENANCE_WORK_ORDER_DONE_READ_ONLY`	409	No se pueden cambiar las tareas de una orden completada o cerrada. Reábrela primero si necesitas cambiarlas.
`MAINTENANCE_OPERATION_FAILED`	500	Error al procesar la operación de mantenimiento

Activos y grupos

Código	HTTP	Mensaje al cliente
`ASSET_TYPE_NOT_FOUND`	404	AssetType no encontrado
`ASSET_OPERATION_FAILED`	500	Error al procesar el activo
`ASSET_GROUP_OPERATION_FAILED`	500	Error al procesar el grupo de activos
`LAYER_OPERATION_FAILED`	500	Error al procesar la capa
`DRIVER_OPERATION_FAILED`	500	Error al procesar el conductor
`PLACE_OPERATION_FAILED`	500	Error al procesar el POI

Empezar

Fundamentos

Integración

Asistentes de IA

Errores de servicios externos

Catálogo

Transversales

Autenticación y sesión

Recursos no encontrados

Usuarios

Trackers

Fechas y rangos

Geozonas / KML

Geocodificación

Precios de combustible

Portal del cliente (Facturación y Soporte vía Raúl)

Tienda de módulos (spec #3666)

Portal de clientes: canje del enlace mágico (customer_portal)

Tarifas de combustible

Reserva de vehículos

Formularios

Reportes y alertas

Unicidad de recursos

Check-ins de Navixy (Registros)

Formularios dinámicos (DynamicForm)

Inspecciones

Pedidos (cargo)

Consulta vehicular

Mensajes de dispositivos (export a Parquet)

Terreno (work)

Administración

Facturación (gastos)

Mantenimiento

Activos y grupos

​Errores de servicios externos

​Catálogo

​Transversales

​Autenticación y sesión

​Recursos no encontrados

​Usuarios

​Trackers

​Fechas y rangos

​Geozonas / KML

​Geocodificación

​Precios de combustible

​Portal del cliente (Facturación y Soporte vía Raúl)

​Tienda de módulos (spec #3666)

​Portal de clientes: canje del enlace mágico (customer_portal)

​Tarifas de combustible

​Reserva de vehículos

​Formularios

​Reportes y alertas

​Unicidad de recursos

​Check-ins de Navixy (Registros)

​Formularios dinámicos (DynamicForm)

​Inspecciones

​Pedidos (cargo)

​Consulta vehicular

​Mensajes de dispositivos (export a Parquet)

​Terreno (work)

​Administración

​Facturación (gastos)

​Mantenimiento

​Activos y grupos

Errores de servicios externos

Catálogo

Transversales

Autenticación y sesión

Recursos no encontrados

Usuarios

Trackers

Fechas y rangos

Geozonas / KML

Geocodificación

Precios de combustible

Portal del cliente (Facturación y Soporte vía Raúl)

Tienda de módulos (spec #3666)

Portal de clientes: canje del enlace mágico (customer_portal)

Tarifas de combustible

Reserva de vehículos

Formularios

Reportes y alertas

Unicidad de recursos

Check-ins de Navixy (Registros)

Formularios dinámicos (DynamicForm)

Inspecciones

Pedidos (cargo)

Consulta vehicular

Mensajes de dispositivos (export a Parquet)

Terreno (work)

Administración

Facturación (gastos)

Mantenimiento

Activos y grupos