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

# Cómo funcionan las reglas de resolución de facturas

> Configurá reglas para convertir líneas de compra en ingredientes de inventario o gastos, con una vista previa antes de usarlas.

Las reglas determinísticas de facturas le indican a Kairos cómo convertir una línea impresa por un proveedor en un único resultado para stock o un gasto sin inventario. Así podés evitar correcciones repetidas cuando un proveedor usa una descripción o una unidad distinta a la de tu catálogo.

## Cuándo se aplica una regla

Una regla no se aplica mientras subís una factura ni durante la lectura OCR. En ese momento, Kairos solo prepara la factura y la deja **a revisar**.

Antes de confirmar o ejecutar la factura, Kairos hace una verificación previa con sus líneas actuales. Ahí evalúa las reglas, prepara el resultado final y comprueba que cada línea pueda continuar. Una línea que queda sin resolver, ambigua o inválida necesita una corrección antes de ejecutar la factura.

<Note>
  La **Vista previa** prueba únicamente la regla que estás completando contra facturas recientes del mismo proveedor y local. No activa la regla, no modifica facturas ni compara la propuesta con otras reglas activas.
</Note>

## Qué contiene una regla

<CardGroup cols={2}>
  <Card title="Proveedor y alcance">
    Elegí un **Proveedor** y dónde aplica: **Este local** o **Toda la organización**. La regla nunca se aplica a otro proveedor.
  </Card>

  <Card title="Descripción y coincidencia">
    Definí qué texto busca Kairos y el **Tipo de coincidencia**: **Exactamente**, **Contiene** o **Comienza con**.
  </Card>

  <Card title="Línea y unidad de origen">
    Kairos usa la descripción impresa y la **Unidad de compra/origen** de la factura para encontrar líneas compatibles.
  </Card>

  <Card title="Resultado y conversión">
    Elegí el **Tipo de resultado**, el destino, la **Unidad final de stock** y el factor de conversión. Cada unidad impresa se convierte según ese factor.
  </Card>
</CardGroup>

Para un **Ingrediente de inventario**, elegí el **Ingrediente destino**. Para un **Gasto sin inventario**, elegí ese tipo de resultado; la pantalla no pide una categoría adicional.

El factor debe producir una cantidad final positiva y válida. Si la conversión no puede producir ese resultado, la línea queda **Inválida** y no continúa automáticamente.

## Cómo se decide entre reglas

Kairos busca reglas activas del mismo proveedor que coincidan con la descripción y la **Unidad de compra/origen** de la línea.

Si coinciden reglas de los dos alcances, gana **Este local** sobre **Toda la organización**. La regla de organización solo puede resolver un ingrediente si tiene una equivalencia explícita para ese local.

Si coinciden dos o más reglas activas en el alcance ganador, Kairos no elige una al azar. Durante la verificación previa, la línea queda **Ambigua** y la ejecución se bloquea.

<Tip>
  Si la verificación previa marca una línea como ambigua, revisá las reglas activas del proveedor. Ajustá la descripción o el **Tipo de coincidencia**, o pausá la regla que sobra.
</Tip>

## Cómo leer la vista previa

En **Facturas → Reglas**, hacé clic en **Vista previa** después de completar una regla. Solo los administradores pueden completar la regla y ejecutar esta vista previa. Kairos muestra cuántas facturas y líneas recientes revisó, junto con estos resultados:

| Resultado        | Qué significa                                                                                        | Qué podés hacer                                                                                                                                          |
| ---------------- | ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Resueltas**    | La línea encontró una única regla válida y tiene un destino y una conversión utilizables.            | Revisá el resultado y activá la regla si coincide con tu catálogo.                                                                                       |
| **Sin resolver** | No hubo una regla que coincidiera, o falta la equivalencia del local para una regla de organización. | Revisá el proveedor, la descripción, la unidad de compra/origen y el alcance. Para un ingrediente de organización, agregá la equivalencia de cada local. |
| **Inválidas**    | Falta un dato necesario o la regla no puede producir una cantidad final válida.                      | Revisá el tipo de resultado, el destino, la unidad, la cantidad y el factor de conversión.                                                               |

La **Vista previa** no compara la regla propuesta con otras reglas activas. Por eso, una línea **Resuelta** no garantiza que la factura pueda ejecutarse. En la verificación previa a confirmar o ejecutar, Kairos reevalúa la factura con las reglas activas; si hay un conflicto entre reglas del mismo alcance ganador, deja la línea **Ambigua** y bloquea la ejecución.

La vista previa muestra el resumen completo de las líneas revisadas. El detalle puede estar limitado cuando hay muchas líneas; si el resumen y el detalle no tienen la misma cantidad, tomá el resumen como total y corregí la regla antes de activarla.

## Si una regla no da el resultado esperado

1. Confirmá que el **Proveedor** sea el que figura en la factura.
2. Compará la descripción y la **Unidad de compra/origen** con la línea impresa.
3. Revisá el **Tipo de resultado**.
4. Verificá el destino, la **Unidad final de stock** y el factor.
5. Usá **Vista previa** otra vez. Si devuelve **Sin resolver** o **Inválida**, corregí la regla o resolvé la línea manualmente antes de ejecutar.
6. Si la verificación previa marca **Ambigua**, editá o pausá la regla que sobra antes de ejecutar.

Los responsables pueden revisar las reglas y las sugerencias. No pueden completar ni ejecutar una vista previa. Solo los administradores pueden crear, editar, pausar o activar reglas.


## Related topics

- [Cómo cargar tus facturas de compra](/features/invoices.md)
- [Cómo funciona el puntaje de proveedores](/features/vendor.md)
- [WhatsApp: alertas y facturas por chat](/features/whatsapp.md)
- [Salud de los datos](/features/data-health.md)
- [Notificaciones](/features/notifications.md)
