> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Laudus

> Cómo conectar tu ERP Laudus a un agente de ChatNorris para responder precio y stock en vivo, atender a tus clientes con sus documentos (saldo, pagos, despachos y detalle), reenviarles facturas y boletas, importar el catálogo a la base de conocimiento y crear clientes desde tus leads.

# Laudus

Con la integración de Laudus, tu agente de ChatNorris atiende con los datos reales de tu ERP. Según lo que actives, el agente:

* busca productos por nombre o SKU y responde el precio de venta y el stock de tus bodegas en ese momento;
* atiende a tus clientes sobre sus documentos: saldo pendiente, si una factura está pagada, el despacho y el detalle de lo que compraron, siempre después de verificar que es el cliente;
* les reenvía una factura o boleta a su correo de documentos registrado en Laudus;
* usa tu catálogo de productos como fuente de conocimiento;
* crea en Laudus los clientes que llegan como leads por el chat.

Funciona en el widget web, WhatsApp, Instagram, Messenger, Telegram, Email y la API.

## Requisitos

* Una cuenta de ChatNorris con plan **Premium**. Laudus, como los demás ERP (Odoo y Bsale), es exclusivo de Premium. Puedes ver los planes en [chatnorris.ai/pricing](https://chatnorris.ai/pricing).
* Al menos un agente creado en ChatNorris. Si todavía no tienes uno, sigue [Crear un agente](https://docs.chatnorris.ai/guias/crear-agente-wizard.md).
* Una empresa en Laudus ERP (Chile) y un **usuario de API** de Laudus.
* Rol **Owner** o **Admin** en tu organización de ChatNorris.

> [!NOTE]
>
> Laudus aparece en el hub con la etiqueta **Beta**. Si la tarjeta muestra **Solicitar acceso**, pídelo desde ahí y te avisamos cuando quede habilitada para tu organización (ver [Integraciones en beta](https://docs.chatnorris.ai/guias/integraciones.md#integraciones-en-beta)).

## Conectar Laudus

Cada agente se conecta a una empresa de Laudus.

**1. Crea un usuario de API en Laudus**

Te recomendamos un usuario dedicado (por ejemplo, «ChatNorris») con los permisos justos: lectura de productos, stock, precios, clientes y documentos de venta. Suma el envío de documentos por correo y la creación de clientes solo si vas a activar esas capacidades.

**2. Abre el hub de Integraciones del agente**

En ChatNorris, entra a `Agentes → [tu agente] → Integraciones` y elige **Laudus**.

**3. Ingresa los datos y conecta**

Escribe el **RUT de la empresa** (con guion y dígito verificador), el **usuario** y la **contraseña** del usuario de API, y haz clic en **Conectar**. ChatNorris prueba los datos con Laudus antes de guardarlos: si no sirven, te lo dice y no guarda nada.

La contraseña se guarda cifrada y nunca se muestra en el dashboard. Con **Probar conexión** la vuelves a verificar cuando quieras. Si cambias la contraseña del usuario en Laudus, escribe la nueva y guarda.

## Configurar la Acción

Conectar Laudus no activa nada todavía. Para elegir qué hace el agente:

**1. Crea la Acción Laudus**

Entra a `Agentes → [tu agente] → Acciones`, haz clic en **Nueva acción** y elige **Laudus**.

**2. Elige las capacidades**

Activa las que quieras (ver la tabla de abajo).

**3. Activa la Acción y guarda**

Desde ese momento, el agente usa Laudus en todas sus conversaciones.

| Capacidad | Qué hace |
| - | - |
| **Stock y precio en vivo** | Busca productos por nombre o SKU y responde el precio de venta que calcula Laudus (de la lista de precios que elijas, o el precio base del producto) y el stock de las bodegas que elijas. |
| **Deuda pendiente** | Responde cuánto debe el cliente según sus documentos pendientes: vencido, por vencer y total. |
| **Estado de pago** | Responde si un documento está pagado, con los cobros registrados y el saldo. |
| **Estado de despacho** | Responde los datos de despacho de un documento: fecha, transportista, comuna y guías de despacho. |
| **Detalle del documento** | Muestra los productos y cantidades de un documento, con su total. |
| **Reenviar documento** | Laudus reenvía la factura o boleta al correo de documentos del cliente, después de un «sí» explícito. |
| **Crear clientes desde leads** | Cuando un lead confirma su correo en el chat, lo enlaza con el cliente de Laudus que tenga ese correo o lo crea. Nunca modifica un cliente existente. |

### Stock y precio

Elige la **lista de precios** que usa el agente (si no eliges ninguna, responde el precio base del producto en Laudus) y las **bodegas** cuyo stock suma (si no eliges ninguna, informa el stock total). El precio y el stock se consultan en Laudus en cada pregunta: nunca se responde un dato viejo. Los impuestos y descuentos los calcula Laudus.

> [!NOTE]
>
> Un agente responde precios y stock desde una sola integración. Si ya los responde otra (WooCommerce, Shopify, Jumpseller, Odoo o Bsale), apágala antes de activar esta. La consulta de pedidos de WooCommerce sí puede quedar activa: los precios y el stock salen de Laudus y los pedidos, de WooCommerce.

### Consultas de clientes

Antes de compartir cualquier dato de un cliente, el agente lo verifica una vez con su **RUT** y un **segundo dato** que eliges en **Verificación**:

* el folio y el monto total de un documento suyo (por defecto);
* un correo registrado en Laudus (el de contacto o el de documentos);
* cualquiera de los dos.

Verificado, durante 30 minutos el cliente puede hacer todas las consultas activadas sin volver a dar sus datos. Para proteger a tus clientes:

* si algo no coincide, el agente responde siempre lo mismo, sin decir qué dato falló, para que nadie pueda adivinar RUTs ni folios;
* tras 5 intentos fallidos en la misma conversación, las consultas se bloquean;
* solo se consultan documentos vigentes (nunca anulados) de los tipos que elijas en **Documentos que se pueden consultar** (facturas, boletas, notas de crédito y notas de débito) y dentro de la **antigüedad máxima** que configures.

> [!WARNING]
>
> Para estas capacidades recomendamos **Claude Sonnet o superior** como modelo del agente (`Configuración → IA`): revelan datos de tus clientes y reenvían documentos reales después de una confirmación.

### Reenviar documentos

Cuando el cliente verificado pide una factura o boleta, el agente le muestra el correo de documentos registrado en Laudus, enmascarado (por ejemplo, `f***@empresa.cl`), y le pregunta si se la reenvía ahí. Solo con un «sí» explícito Laudus envía el documento con su PDF.

* El documento va siempre al correo registrado en Laudus, nunca a otro. Si el cliente necesita cambiarlo, el agente le ofrece hablar con una persona del equipo.
* En **Límites de reenvío** eliges cuántos reenvíos se permiten por conversación y por día en todo el agente.
* En el Playground el reenvío se simula: no se envía ningún correo.

### Crear clientes desde leads

Con esta capacidad, cada lead que confirma su correo en el chat (por ejemplo, en el Lead Form) queda como cliente en Laudus: si ya existe uno con ese correo, se enlaza; si no, se crea con su nombre, correo y teléfono. ChatNorris nunca modifica un cliente que ya existe.

## Importar el catálogo a la base de conocimiento

Con Laudus conectado, puedes sumar tu catálogo como fuente de conocimiento para que el agente encuentre el producto correcto cuando el visitante lo describe con sus palabras.

**1. Agrega la fuente**

Entra a `Agentes → [tu agente] → Conocimiento → Agregar fuente` y elige **Laudus**.

**2. Importa el catálogo**

Haz clic en **Importar catálogo**. Se importan los productos vigentes y vendibles de tu empresa.

* Cada producto queda como un documento con su nombre, SKU, categoría y unidad de venta.
* **No se guardan precios, stock ni costos**: el agente los consulta en vivo con la Acción Laudus.
* La fuente se vuelve a sincronizar sola cada día (sincronización automática de Premium). Con **Volver a importar** la actualizas cuando quieras.

Con la Acción activa, la lista de fuentes muestra además la fila **Catálogo de Laudus en vivo**. No es una fuente: indica que el agente consulta precio y stock directo en Laudus.

## Créditos

Conectar Laudus no consume créditos. Cada respuesta del agente que consulta precio y stock en vivo suma **0,5 crédito de IA** al costo normal de la respuesta. El catálogo importado ocupa caracteres de tu base de conocimiento como cualquier otra fuente.

## Desconectar

En `Agentes → [tu agente] → Integraciones → Laudus`, haz clic en **Desconectar**. La Acción Laudus se apaga y conserva su configuración. Si ya no vas a usar el usuario de API, desactívalo en Laudus.

## Preguntas frecuentes

> [accordion] El agente no encuentra un producto que sí existe
>
> El agente solo ve los productos **vigentes y vendibles** de Laudus. Revisa que el producto no esté descontinuado ni marcado como no vendible. Si buscas por SKU, revisa que esté cargado en el producto.

> [accordion] El agente no logra verificar a un cliente
>
> Revisa que el RUT del cliente esté cargado en Laudus y que el segundo dato coincida: el folio y monto total de un documento vigente de un tipo habilitado, o un correo registrado en su ficha. Si la conversación acumuló 5 intentos fallidos, queda bloqueada: el cliente puede escribir de nuevo en otra conversación.

> [accordion] El cliente no recibió el documento reenviado
>
> Laudus lo envía al correo de documentos registrado en la ficha del cliente. Pídele que revise la carpeta de spam y confirma en Laudus que ese correo esté al día.

> [accordion] La integración aparece como vencida
>
> Laudus rechazó los datos guardados, por ejemplo porque cambió la contraseña del usuario de API. Escribe la contraseña nueva en la integración y guarda.

> [accordion] ¿Puedo usar Laudus y WooCommerce en el mismo agente?
>
> Sí, con una condición: precios y stock salen de una sola de las dos. Lo habitual es dejar en Laudus el stock y precio, y en WooCommerce la consulta de pedidos. Si importas los dos catálogos a la base de conocimiento, el agente ve los productos dos veces: deja activo solo uno.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.