SANE-COMPRAS

Buscar producto por referencia interna

Proveedores disponibles

Proveedor	Cod. Proveedor	Ud/Caja	PVP	Dto.1 (%)	Dto.2 (%)	Dto.3 (%)	Precio Final	Cantidad	Accion

Ultimas compras de este producto

Carrito de compras 0 productos

Pedidos creados en Odoo

Preparar pedidos de compra

Referencia	Producto	Cantidad	Ud/Caja	Proveedor	PVP	Dto.1	Dto.2	Dto.3	Precio Final	Importe

Análisis de reabastecimiento

Calcula qué productos conviene reponer, cuánto y con qué urgencia, a partir de las ventas, el stock de cada almacén, lo que ya está pedido y los plazos reales de cada proveedor.

Almacén

Categoría (opcional)

Ventana de ventas (días)

Cada cuántos días pedís

Nivel de servicio

Margen extra de entrega (días)

Ajustar por estacionalidad

	Prioridad	Producto	DemandaUnidades por día previstas (no la media histórica: usa el patrón de ventas y la estacionalidad si está activada). El gráfico muestra las ventas semanales de la ventana.	CoberturaDías que dura el stock libre (disponible − comprometido) al ritmo de demanda. La barra se pone roja si se acaba antes de que pueda llegar un pedido nuevo (plazo de entrega).	Posición de stockPronosticado de Odoo (disponible + entrante − comprometido) + cantidades ya incluidas en solicitudes de presupuesto en borrador. Es lo que se compara con el punto de pedido.	Pto. pedido / ObjetivoPunto de pedido: cuando la posición cae por debajo hay que pedir. Objetivo: nivel al que se repone. Ambos incluyen el stock de seguridad.	Cant. sugerida	Proveedor (mejor precio)

Guia de usuario

SANE-COMPRAS es la herramienta de compras de SANE RIEGO, S.A. Conecta directamente con Odoo 18 para consultar productos, comparar proveedores, calcular qué hay que reponer y generar solicitudes de presupuesto en borrador.

Iniciar sesion

Entra en compras.saneriego.com con tu usuario y contraseña de Odoo (las mismas con las que entras en Odoo). Solo pueden acceder usuarios cuyo usuario de Odoo sea un correo @saneriego.com. La sesión dura 12 horas; si el servidor se reinicia tendrás que volver a entrar. Tras 6 intentos fallidos con el mismo usuario en 10 minutos, el acceso a ese usuario se bloquea 10 minutos.

Buscar un producto

1Escribe en el buscador la referencia interna (por ejemplo, 2M280EL), parte del nombre, el código de barras o el código del proveedor. El autocompletado te sugerirá productos a medida que escribas. La búsqueda por referencia no distingue mayúsculas de minúsculas y trata los guiones bajos literalmente.

2Pulsa Buscar o selecciona una sugerencia. La app mostrara los proveedores disponibles con su PVP, descuentos (Dto.1, Dto.2, Dto.3) y precio final.

3Debajo del nombre del producto se muestra el stock libre por almacén (SANE1, SANE2): cantidad en mano menos la reservada. El total incluye todas las ubicaciones del almacén; si un almacén tiene varias, se detalla cuánto hay en cada una.

4Mas abajo aparece el historial de compras anteriores de ese producto: fecha, proveedor, precio real y si ha subido o bajado respecto a la compra anterior.

Seleccionar proveedor y cantidad

En la tabla de proveedores, el primero es siempre el de mejor precio final, marcado en verde. La columna Ud/Caja indica cuantas unidades vienen en cada caja del proveedor. Si el proveedor tiene unidades por caja configuradas, la cantidad se redondea automáticamente hacia arriba a cajas completas. Ajusta la cantidad y pulsa Seleccionar para anadirlo al carrito.

El proveedor con mejor precio se marca automaticamente como "Mejor precio". Las cantidades se ajustan a cajas completas cuando aplica.

Importar una lista de productos

Si tienes una lista larga de referencias (por ejemplo, desde un Excel o un papel), puedes importarla de golpe:

1Pulsa Importar lista junto al buscador.

2Pega las lineas con referencia y cantidad separadas por tabulador, espacio o punto y coma. Si copias dos columnas desde Excel (referencia + cantidad), funciona directamente.

3Pulsa Buscar productos. La app buscara todas las referencias en Odoo de una sola vez y te mostrara cuales se encontraron y cuales no.

4Pulsa Seleccionar proveedores y la app te ira mostrando cada producto uno por uno para que elijas proveedor. La cantidad de la lista se prerrellena automaticamente.

El carrito de compras

El carrito agrupa automaticamente los productos por proveedor. Para cada proveedor se muestra:

•Los productos seleccionados con su PVP, descuentos y subtotal.

•El total del proveedor y si se alcanza el minimo para portes gratuitos (si el proveedor lo tiene configurado). Si no se alcanza, muestra cuanto falta.

Puedes modificar cantidades directamente en el carrito y eliminar productos con la X.

Junto al total hay un desplegable Recibir en: elige el almacén (SANE1 o SANE2) donde llegará la mercancía. Si vienes del análisis, se rellena con el almacén analizado. Con «Almacén por defecto de Odoo» no se indica ninguno y Odoo usa el suyo.

Generar pedidos en Odoo

1Cuando el carrito este listo, puedes generar pedidos de dos formas:

•Por proveedor individual: Cada grupo de proveedor tiene su propio boton Generar pedido para crear solo ese pedido en Odoo sin afectar al resto del carrito.

•Todos a la vez: Pulsa Generar pedidos en Odoo para crear todos los pedidos del carrito de una sola vez.

2Se creara una solicitud de presupuesto en borrador por cada proveedor, con el PVP y los 3 niveles de descuento en cada linea. La descripcion de cada linea usa el formato [codigo_proveedor] Nombre producto, igual que al crear pedidos manualmente en Odoo.

3Cada pedido incluye una nota en el chatter ("Compra generada desde SANE-COMPRAS"), tiene SANE-COMPRAS como documento origen y, si lo elegiste, la recepción asignada al almacén de destino.

Los pedidos se crean en borrador. Debes confirmarlos manualmente en Odoo cuando estés listo para enviarlos al proveedor. Mientras estén en borrador, el análisis los tiene en cuenta como mercancía ya pedida para no volver a proponerla; si ya no los quieres, bórralos o cancélalos en Odoo.

Si pulsas dos veces el botón o se repite el envío, la app lo detecta y no crea pedidos duplicados.

Análisis de reabastecimiento

La pestaña Análisis de reabastecimiento te dice qué productos hay que reponer, cuánto y con qué urgencia. No se limita a comparar el stock con un mínimo: tiene en cuenta cuánto se vende, cuánto tarda de verdad cada proveedor, lo que ya está pedido (incluidas las solicitudes en borrador) y la importancia de cada producto.

1Elige el almacén (SANE1, SANE2 o todos). Con un almacén concreto se usan solo las ventas servidas desde ese almacén y el stock de ese almacén, ubicaciones incluidas. Opcionalmente filtra por categoría.

2Ajusta los parámetros si hace falta: ventana de ventas (90 días por defecto), cada cuántos días pedís (14), nivel de servicio (cuánto stock de seguridad mantener), margen extra de entrega y estacionalidad (ver abajo).

3Pulsa Ejecutar análisis. La app obtiene de Odoo ventas, stock, solicitudes en borrador, proveedores y recepciones, mostrando el progreso.

4Arriba verás tarjetas resumen (urgentes, a pedir, con solicitud en borrador, exceso, sin proveedor, sin movimiento). Al pulsarlas se filtra la tabla. Debajo, la tabla de Reposición con filtros por prioridad, clase ABC y avisos, y ordenación por urgencia, cobertura, importe, demanda o referencia.

5Pulsa una fila para abrir el panel de detalle: explica paso a paso cómo se ha calculado la sugerencia (demanda, plazo, stock de seguridad, punto de pedido, posición de stock) y muestra los proveedores.

6Marca los productos (la selección se mantiene al filtrar o ordenar), ajusta la cantidad sugerida si quieres y pulsa Preparar compra. Se abre un panel donde eliges el proveedor de cada producto (por defecto el de mejor precio final). La cantidad se sube a cajas completas según las unidades por caja del proveedor elegido y se recalcula si cambias de proveedor. Verás un resumen por proveedor con el importe y si se alcanza el mínimo de portes gratuitos.

7Pulsa Añadir al carrito y genera los pedidos desde la pestaña Compras.

8Exportar a Excel (CSV): exporta lo seleccionado; si no hay selección, lo que se ve con los filtros actuales.

Prioridades

Prioridad	Significado
ALTA	La posición de stock está por debajo del punto de pedido y el stock libre se agotará antes de que pueda llegar un pedido nuevo (cobertura menor que el plazo de entrega). Hay que pedir ya y aun así puede haber rotura.
MEDIA	La posición está por debajo del punto de pedido, pero el stock libre aguanta hasta que llegue un pedido. Conviene pedir ahora.
ANTICIPAR	Todavía no se ha llegado al punto de pedido, pero se alcanzará antes del próximo pedido (dentro de los «cada cuántos días pedís»). Útil para completar un pedido al mismo proveedor y llegar al mínimo de portes.
SIN NECESIDAD	Stock suficiente. Oculto por defecto; puedes mostrarlo con el filtro «Sin necesidad».

Qué muestra la tabla

Columna	Qué significa
Clase ABC	A = los productos que suman el 80 % del valor vendido en la ventana, B = hasta el 95 %, C = el resto. Los A reciben más stock de seguridad.
Demanda	Unidades por día previstas. No es la media simple: se calcula según el patrón de ventas del producto (ver «Cómo se calcula»). El gráfico son las ventas por semana; la flecha, la tendencia (↑ las últimas 4 semanas venden más que la media, ↓ menos).
Cobertura	Días que dura el stock libre (disponible menos comprometido) al ritmo de demanda. La barra es roja si se acaba antes del plazo de entrega, naranja si aguanta el plazo pero no hasta el siguiente pedido, verde si cubre ambos. Debajo, el plazo de entrega (* = teórico, aún no hay recepciones previas de ese producto).
Posición de stock	Stock pronosticado de Odoo (disponible + entrante − comprometido) más las cantidades de solicitudes de presupuesto en borrador. Debajo se desglosa: disponible, entrante («entr.»), en borrador («borr.») y comprometido («comp.»). Al pasar el ratón se ve el stock por almacén.
Pto. pedido / Objetivo	Punto de pedido: si la posición cae por debajo, hay que pedir. Objetivo: nivel al que se repone. Ambos incluyen el stock de seguridad.
Cant. sugerida	Objetivo menos posición, subida a cajas completas del proveedor de mejor precio. Es editable. Debajo, número de cajas e importe estimado.
Proveedor	El de menor precio final, con su precio y unidades por caja.

Avisos

Aviso	Qué significa
En borrador	Ya hay cantidad de ese producto en una solicitud de presupuesto sin confirmar. Se ha sumado a la posición de stock.
Exceso	El stock cubre mucho más tiempo del necesario (más de 120 días y más del doble de plazo + frecuencia de pedido).
Sin proveedor	El producto no tiene proveedor en su ficha de Odoo.
Plazo teórico	No hay recepciones previas: se usa el plazo de la ficha del proveedor, o 7 días si tampoco lo tiene.
Sin stock	Con stock cero es probable que se hayan perdido ventas; la demanda real puede ser mayor que la calculada.
Pocas ventas	Menos de 3 líneas de venta en la ventana: la previsión es poco fiable.
Atípicos	Había pedidos extraordinariamente grandes y se han limitado para que no distorsionen la demanda.
Stock negativo	Odoo tiene existencias físicas negativas: conviene regularizar el inventario.

Cómo se calcula

Resumen en lenguaje llano (el detalle matemático está en la documentación técnica):

1Demanda. Se agrupan las ventas por semana. Los pedidos extremadamente grandes (muy por encima de lo habitual del producto) se limitan. Si el producto se vende de forma continua, la demanda es una media que da más peso a las semanas recientes. Si se vende a golpes (intermitente), se usa un método específico para ese tipo de producto, que evita sobreestimar en las semanas con venta y subestimar en las vacías.

2Plazo de entrega. Media real de días entre la confirmación del pedido de compra y la recepción, en los últimos 8 pedidos, mirando primero los del proveedor principal. Sin histórico, el plazo teórico del proveedor. Se suma el «margen extra» si lo has puesto. También se mide cuánto varía el plazo: un proveedor irregular exige más seguridad.

3Stock de seguridad. Cubre la variación de la demanda y del plazo durante la espera, con más protección para la clase A que para la C. El nivel de servicio sube o baja esa protección: Económico (A 95 % · B 90 % · C 80 %), Estándar (98 · 95 · 90) o Alto (99 · 98 · 95).

4Punto de pedido y objetivo. Punto de pedido = demanda durante el plazo + seguridad. Objetivo = demanda durante (plazo + días entre pedidos) + seguridad.

5Decisión. Se compara la posición de stock con el punto de pedido (ver prioridades). Solo se sugiere cantidad si hay necesidad o se va a alcanzar el punto de pedido antes del próximo pedido; ya no se sugieren pedidos pequeños para productos con stock de sobra.

Estacionalidad. Si la activas, para cada producto con ventas del año pasado se compara la demanda del periodo que ahora toca cubrir con la del periodo equivalente a la ventana, y la demanda se corrige entre ×0,5 y ×2. Si el producto no tiene histórico del año anterior, se ignora (por eso en 2026 casi nada se verá afectado; empezará a servir a lo largo de 2027). Siempre se muestra, en el detalle, el factor aplicado.

Si hay ventas de un producto en un almacén pero su stock está en otro, el análisis por almacén lo mostrará como necesidad en el primero: es útil para decidir un traslado interno antes de comprar. Consulta también la pestaña Stock sin movimiento.

Stock sin movimiento

Segunda pestaña del análisis: productos con stock físico positivo y ninguna venta en la ventana analizada (del almacén elegido), ordenados por valor a coste. Sirve para detectar capital inmovilizado antes de comprar más.

Sublocalizaciones de almacén

Si en Odoo activáis Ubicaciones de almacenamiento (Inventario → Configuración → Ajustes) y creáis ubicaciones dentro de un almacén (por ejemplo SANE1/Stock/Pasillo-A), SANE-COMPRAS suma automáticamente el stock de todas ellas al de su almacén y detalla cada ubicación al buscar un producto. No hay que configurar nada en la app.

Documentacion tecnica

Referencia tecnica de SANE-COMPRAS para administradores y desarrolladores.

Arquitectura general

Servidor web Flask (Python 3.12) servido con gunicorn dentro de un contenedor Docker, detrás del proxy Caddy que aporta HTTPS (compras.saneriego.com). Se comunica con Odoo 18 por XML-RPC. El frontend es una página única en HTML/CSS/JS puro, servida por Flask. No hay base de datos ni ficheros propios: Odoo es la única fuente de verdad. El contenedor no publica puertos; solo es accesible desde Caddy por la red Docker web.

Navegador ←HTTPS→ Caddy ←red docker "web"→ gunicorn (1 proceso, 8 hilos) + Flask ←XML-RPC→ Odoo 18
                

Se ejecuta con un solo proceso porque las sesiones y los resultados del análisis viven en memoria. Si en el futuro hiciera falta escalar a varios procesos, habría que mover ese estado a un almacén compartido (por ejemplo Redis).

Estructura de archivos

Archivo	Función
`app.py`	Servidor Flask: rutas API, sesiones, límite de intentos de login, protección contra pedidos duplicados y orquestación de los pasos del análisis.
`odoo_client.py`	Cliente XML-RPC de Odoo (`OdooClient`): productos, proveedores, stock, ventas, recepciones, solicitudes en borrador y creación de pedidos. Jerarquía de excepciones propias.
`analysis.py`	Motor de cálculo del análisis (`analyze_replenishment()`, `summarize()`). Procesamiento local, sin llamadas a Odoo; se puede probar con datos sintéticos.
`config.py`	Configuración desde variables de entorno / `.env`: ODOO_URL, ODOO_DB, SECRET_KEY, ALLOWED_EMAIL_DOMAIN, SESSION_HOURS (y APP_HOST, APP_PORT, APP_DEBUG para desarrollo).
`templates/index.html`	Frontend completo: HTML + CSS + JavaScript (Compras, Análisis, Documentación).
`Dockerfile`, `docker-compose.yml`	Imagen y servicio. Usuario no root, healthcheck en `/healthz`, sin puertos publicados.
`.env`	Solo en el servidor (no está en Git). ODOO_URL, ODOO_DB, SECRET_KEY, ALLOWED_EMAIL_DOMAIN, SESSION_HOURS.

Autenticación y sesiones

1POST /api/login: se comprueba que el usuario es del dominio permitido (ALLOWED_EMAIL_DOMAIN, por defecto saneriego.com) y se autentica contra Odoo (xmlrpc/2/common.authenticate).

2Si es válido, se guarda en memoria del servidor usuario, contraseña y uid de Odoo bajo un identificador aleatorio. La cookie de sesión (firmada con SECRET_KEY, Secure, HttpOnly, SameSite=Lax) solo lleva ese identificador, nunca la contraseña.

3Cada petición (@login_required) construye un OdooClient con las credenciales de esa sesión reutilizando el uid, sin volver a autenticar.

4Límite de intentos: 6 fallos por usuario y 40 por IP en 10 minutos devuelven HTTP 429.

Las sesiones caducan a las SESSION_HOURS (12) y se pierden al reiniciar el contenedor. Con SECRET_KEY fija en el .env, un reinicio no invalida las cookies válidas pero sí el estado en memoria, así que se pide login de nuevo.

Endpoints API

Método	Ruta	Descripción
GET	`/healthz`	Comprobación de salud (sin autenticación)
POST	`/api/login`	Autenticar usuario (dominio permitido + Odoo)
POST	`/api/logout`	Cerrar sesión
GET	`/api/session`	Comprobar si hay sesión activa
GET	`/api/test`	Verificar conexión con Odoo
POST	`/api/reconnect`	Forzar reconexión
GET	`/api/product/search?ref=XXX`	Buscar producto por referencia exacta (sin distinguir mayúsculas)
GET	`/api/product/autocomplete?q=XXX`	Autocompletado por referencia, nombre, código de barras o código de proveedor
POST	`/api/product/search-bulk`	Buscar varias referencias (importación)
GET	`/api/stock/<product_id>`	Stock libre por almacén, con desglose por ubicación
GET	`/api/suppliers/<tmpl_id>`	Proveedores, precios, descuentos y mínimo de portes
GET	`/api/history/<product_id>`	Últimas compras de un producto
POST	`/api/orders/create`	Crear solicitudes de presupuesto por proveedor. Admite `warehouse_id` (destino) y `token` (anti-duplicado, 10 min)
POST	`/api/analysis/step/sales`	Paso 1: ventas (filtros: almacén, categoría). Fija la configuración del análisis
POST	`/api/analysis/step/stock`	Paso 2: stock, pronóstico de Odoo y solicitudes en borrador
POST	`/api/analysis/step/suppliers`	Paso 3: datos de producto y proveedores
POST	`/api/analysis/step/receipts`	Paso 4: recepciones para plazos reales
POST	`/api/analysis/step/seasonal`	Paso 5 (opcional): ventas del año anterior
POST	`/api/analysis/calculate`	Paso final: calcula, devuelve resultados, KPIs y stock sin movimiento
GET	`/api/analysis/results`	Último análisis de la sesión (en memoria, caduca a las 2 h)
GET	`/api/analysis/warehouses`	Almacenes (id, nombre)
GET	`/api/analysis/categories`	Categorías de producto

Modelos de Odoo utilizados

Modelo	Campos clave	Uso
`product.product`	name, default_code, barcode, product_tmpl_id, is_storable, standard_price, virtual_available, qty_available, incoming_qty, outgoing_qty	Búsqueda y pronóstico de stock (con `warehouse_id` en el contexto para limitar a un almacén)
`product.supplierinfo`	partner_id, price, discount, discount2, discount3, final_price, delay, min_qty, product_code, units_per_box	Proveedores y precios (campos de descuento y `final_price` son personalizados)
`res.partner`	x_studio_mn_portes_gratuitos	Mínimo para portes gratis
`purchase.order`	partner_id, origin, picking_type_id, order_line, state, date_approve	Crear borradores; plazos reales
`purchase.order.line`	product_id, product_qty, price_unit, discount1/2/3	Líneas de pedido; cantidades en borrador
`stock.quant`	product_id, location_id, quantity, reserved_quantity	Stock libre por almacén (ubicaciones internas, incluidas las hijas)
`stock.location`	warehouse_id	Asignar cada ubicación a su almacén
`stock.warehouse`, `stock.picking.type`	name; code=incoming, warehouse_id	Almacenes y tipo de recepción de destino
`sale.order.line`	product_id, product_qty (o product_uom_qty), order_id	Ventas históricas (UdM del producto; filtro por almacén de la venta)
`stock.move`	product_id, date, purchase_line_id	Recepciones (plazo real)

Creación de pedidos — Detalle

El carrito se agrupa por partner_id; por cada proveedor se crea un purchase.order en borrador con origin = "SANE-COMPRAS" y, si se indicó, picking_type_id = recepción del almacén de destino. Cada línea lleva:

{
    "product_id": id,
    "name": "[COD_PROVEEDOR] Nombre del producto",
    "product_qty": cantidad,
    "price_unit": PVP del proveedor (campo price de supplierinfo),
    "discount1": descuento 1 (%),
    "discount2": descuento 2 (%),
    "discount3": descuento 3 (%)
}
                

El name usa el código del proveedor (product_code) o, si no existe, la referencia interna. Odoo calcula el subtotal aplicando los tres descuentos. Después se registra una nota en el chatter (message_post, subtipo mail.mt_note).

Protección anti-duplicados: el frontend envía un token único por clic. El servidor lo recuerda 10 minutos: un reenvío con el mismo token devuelve el resultado anterior (duplicate: true) sin crear nada; si el primero falla, se libera para poder reintentar.

Análisis de reabastecimiento — Fórmulas

Política de reposición con revisión periódica (R, s, S) y stock de seguridad estadístico. Implementada en analysis.py.

1. DEMANDA SEMANAL
   Se agrupan las líneas de venta de la ventana en semanas (hacia atrás desde hoy).
   Atípicos: con >= 8 líneas, se limita cada línea a Q3 + 3*IQR (cuartiles interpolados).
   Si IQR = 0 (pedidos casi iguales) el límite es 10 x Q3. No se eliminan, se limitan.

2. PATRÓN DE DEMANDA (Syntetos-Boylan)
   ADI = semanas / semanas con venta ;  CV2 = (desv/media)^2 de las semanas con venta
   ADI < 1,32 y CV2 < 0,49 -> regular        ADI < 1,32 y CV2 >= 0,49 -> errática
   ADI >= 1,32 y CV2 < 0,49 -> intermitente  ADI >= 1,32 y CV2 >= 0,49 -> irregular

3. PREVISIÓN (tasa semanal)
   regular / errática      : suavizado exponencial simple, alfa = 0,25
   intermitente / irregular: Croston con corrección SBA, alfa = 0,10
   La tasa se acota a [0,4 ; 2,5] x media de la ventana.
   d = tasa / 7 x factor_estacional           (unidades por día)

4. PLAZO DE ENTREGA
   Real: media de (fecha recepción - date_approve) de las últimas 8 líneas de pedido
         (solo del proveedor principal si hay >= 2; si no, de cualquiera); sigma = desv.
         típica (si hay >= 3 muestras; si no, 25 % del plazo).
   Teórico: supplierinfo.delay del proveedor de mejor precio, o 7 días.
   LT = plazo + margen extra.   Horizonte H = min(180, LT + frecuencia de pedido R).

5. STOCK DE SEGURIDAD
   SS = z x sqrt( LT x (sigma_semanal^2 / 7) + (d x sigma_LT)^2 )
   z según clase ABC y nivel de servicio:
        económico  A 1,65 | B 1,28 | C 0,84
        estándar   A 2,05 | B 1,65 | C 1,28
        alto       A 2,33 | B 2,05 | C 1,65
   ABC por valor de consumo (cantidad limitada x precio final): A hasta 80 %, B hasta 95 %.

6. PUNTO DE PEDIDO Y OBJETIVO
   s = d x LT + SS          S = d x H + SS

7. POSICIÓN DE STOCK
   P = virtual_available (Odoo, por almacén)  +  cantidad en solicitudes en borrador/enviadas/por aprobar
   Libre = max(qty_available - outgoing_qty, 0) ;  cobertura = Libre / d

8. DECISIÓN
   d = 0                                    -> sin necesidad
   P <= s  y cobertura < LT                 -> ALTA
   P <= s                                   -> MEDIA
   P <= s + d x R                           -> ANTICIPAR (baja)
   en otro caso                             -> sin necesidad
   A pedir = max(0, S - P)  (solo si hay prioridad) ; sugerida = redondeo hacia ARRIBA a cajas completas

9. ESTACIONALIDAD (opcional)
   Con ventas del año anterior (>= 5 líneas en la ventana equivalente):
   factor = (ventas_año_anterior en los próximos H días / H) / (ventas_año_anterior en la ventana / días ventana)
   acotado a [0,5 ; 2,0]. Sin datos suficientes, factor = 1 (no se aplica).
                

Se excluyen productos no almacenables (is_storable = False, solo Odoo 18). Los productos sin ventas en la ventana no entran en la reposición; los que tienen stock se listan en «Stock sin movimiento».

Llamadas a Odoo — Eficiencia

El análisis se hace en lotes (no una consulta por producto): ventas paginadas de 5.000 en 5.000; consultas por trozos de 400 ids; stock con una consulta por trozo a stock.quant; recepciones por trozos de 200 productos. Los campos opcionales (is_storable, product_qty) se detectan una vez con fields_get y se cachean. El cliente usa timeouts reales (20 s autenticación, 120 s consultas) y reutiliza el uid de la sesión. Los resultados intermedios del análisis se guardan por sesión en memoria (máx. 30 sesiones, caducan a las 2 h).

Despliegue

Carpeta /opt/apps/sane-compras en el servidor. Para aplicar cambios de código: docker compose up -d --build. Para cambiar la configuración (.env): docker compose up -d --force-recreate. El proxy (/opt/proxy/Caddyfile) enruta compras.saneriego.com al contenedor sane-compras-app-1:8000. Ver el estado: docker compose ps y docker compose logs -f app.

Dependencias

Paquete	Versión	Uso
`flask`	≥ 3.0	Servidor web y API REST
`gunicorn`	≥ 22	Servidor WSGI en el contenedor
`python-dotenv`	≥ 1.0	Carga de .env
`xmlrpc.client`	(stdlib)	Comunicación con Odoo

SANE-COMPRAS

SANE-COMPRAS

Buscar producto por referencia interna

Importar lista de productos

Proveedores disponibles

Ultimas compras de este producto

Carrito de compras 0 productos

Pedidos creados en Odoo

Preparar pedidos de compra

Análisis de reabastecimiento

Guia de usuario

Iniciar sesion

Buscar un producto

Seleccionar proveedor y cantidad

Importar una lista de productos

El carrito de compras

Generar pedidos en Odoo

Análisis de reabastecimiento

Prioridades

Qué muestra la tabla

Avisos

Cómo se calcula

Stock sin movimiento

Sublocalizaciones de almacén

Documentacion tecnica

Arquitectura general

Estructura de archivos

Autenticación y sesiones

Endpoints API

Modelos de Odoo utilizados

Creación de pedidos — Detalle

Análisis de reabastecimiento — Fórmulas

Llamadas a Odoo — Eficiencia

Despliegue

Dependencias