Zauru (sesión, GraphQL, app)

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

Boost habla con Zauru por la sesión web, por GraphQL (solo lectura) y por la app. Casi todo lo que lee o escribe de ventas depende de que la sesión de la persona en Zauru esté viva.

Para toda la familia

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

Cómo se detecta: La respuesta trae el code. Los 503 (zauru_timeout, zauru_unreachable, zauru_error) suelen venir en ráfaga en varias pantallas a la vez (inbox y catálogo fallan juntos). Render: filtrar peticiones 503 por path.
Qué hacer: Timeout o caída: reintentar; si persiste, confirmar que Zauru responde. Sesión vencida o sin configuración: la persona vuelve a iniciar sesión; si Zauru la manda a /apps/index, le falta configuración en Zauru.

13 códigos

Códigos

`zauru_app_credentials_invalid`

HTTPHTTP 401

Faltan las credenciales de la app de Zauru (usuario y apikey) para abrir la sesión.

`zauru_attachment_request_failed`

detalle

Zauru no aceptó subir un adjunto (PDF o imagen) a una orden o cotización. Viene como renglón de errors[]; lo demás de la operación puede haberse hecho.

`zauru_config_missing`

HTTPHTTP 403

La persona tiene credenciales válidas pero a su usuario de Zauru le falta una habilitación para usar Boost: Zauru la redirige a /apps/index.

Causa típica: El usuario no tiene la app de Boost (o su configuración) habilitada en Zauru. No es un problema del CRM.
Cómo detectarlo: Render: Zauru config missing for … respondio 302 -> …/apps/index. La persona ve el mensaje «Tu usuario no tiene todas las configuraciones necesarias…».
Qué hacer: Habilitarle la configuración en Zauru (lo hace el administrador de Zauru). No hay que tocar nada en Boost.

`zauru_entity_mismatch`

HTTPHTTP 409

La entidad de Zauru elegida no corresponde a la entidad activa del CRM.

`zauru_entity_switch_failed`

HTTPHTTP 503

Zauru respondió con error al pedido de cambiar de entidad.

`zauru_entity_switch_not_applied`

HTTPHTTP 409

Zauru aceptó el cambio de entidad pero la entidad activa no cambió.

`zauru_error`

HTTPHTTP 503

Zauru respondió con error a una consulta de GraphQL. El mensaje pide reintentar en unos segundos.

`zauru_identity_mismatch`

HTTPHTTP 401HTTP 409

Las credenciales de la app de Zauru son de otro usuario de Zauru que el de la sesión.

`zauru_session_expired`

HTTPHTTP 401

La sesión de la persona en Zauru venció.

Qué hacer: Volver a iniciar sesión en Boost (renueva la sesión de Zauru).

`zauru_session_missing`

HTTPHTTP 428

La sesión no tiene guardada la URL de GraphQL de Zauru (428): hay que volver a iniciar sesión.

`zauru_timeout`

detalleHTTPHTTP 503

Zauru tardó demasiado en responder y Boost cortó la espera (503).

Causa típica: Zauru lento o una consulta pesada (catálogo grande, facturas de muchos meses). El tope de la app es ZAURU_APP_FETCH_TIMEOUT_MS (10 s por defecto).
Cómo detectarlo: Varias pantallas fallan a la vez con 503 (catálogo, compositor de cotizaciones, dashboard). En Render, peticiones 503 en las rutas del catálogo, del compositor de cotizaciones y del catálogo del chat.
Qué hacer: Reintentar en unos segundos. Si una pantalla falla siempre, la consulta es demasiado grande: acotar la ventana o paginar (no subir el tope a ciegas).

`zauru_unreachable`

detalleHTTPHTTP 503

No se pudo conectar con Zauru (red, DNS o Zauru caído) (503).

Cómo detectarlo: Como zauru_timeout, pero el mensaje dice «No se pudo conectar con Zauru».
Qué hacer: Confirmar que Zauru responde; reintentar cuando vuelva.

`zauru_upstream_error`

HTTPHTTP 503

Zauru respondió con un status de error a un pedido de la sesión web (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.