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

# Semana del 29 de mayo, 2026

> Bitácora de Actividad, cálculo correcto del DESGLOSE DE VENTA en Corte Z, y guía de integración para Restaurant Controller POS.

## Nuevo

**Bitácora de Actividad**
Módulo de auditoría que registra cada acción de cada usuario — POS y dashboard — en un solo lugar. El dueño ve cancelaciones, descuentos, cambios de precio, aperturas y cierres de caja en tiempo real. Restaurantero Pro detecta automáticamente anomalías (3+ cancelaciones del mismo mesero en 2 horas, precios fuera del rango histórico ±20%, logins desde dispositivos nuevos) y alerta al dueño.

Disponible vía `POST /api/v1/ingest/activity`. Ver la [guía de la Bitácora](/bitacora-rc) y el [endpoint en la referencia API](/api-v1#3-8-bitacora-de-actividad).

**Integración automática con Restaurant Controller POS**
Nueva guía paso a paso para conectar Restaurant Controller (Full Dining y Express) con Restaurantero Pro. La integración corre en segundo plano al cerrar el Corte Z — sin pasos extra para el operador — y envía órdenes, descuentos, cancelaciones, pagos y resumen de ventas a la API. Ver la [guía de integración RC](/integracion-rc).

## Actualizaciones

**API v1**
Referencia completa de la API publicada en [api-v1](/api-v1), incluyendo:

* Autenticación con API Keys y OAuth2, con rate limits por plan.
* Endpoints de ingesta para Corte Z, ventas, pagos, líneas de orden, catálogo, descuentos, cancelaciones y bitácora.
* Endpoints de inteligencia: resumen de ventas, ventas por hora, ventas por empleado, reconciliación de caja, Cash Flow y P\&L.
* Idempotencia obligatoria en todos los POST de ingesta.

## Correcciones

**DESGLOSE DE VENTA en Corte Z**
El DESGLOSE DE VENTA (`#ORDER_SUBTOTAL#`, `#ORDER_TAXES#`, `#ORDER_TOTAL#`) ahora se calcula desde las órdenes reales del sistema en lugar de los pagos capturados en caja. Esto corrige varios problemas que afectaban el P\&L, Food Cost y EBITDA del dashboard:

* Errores de captura del cajero ya no distorsionan las ventas reportadas.
* Cancelaciones y voids quedan excluidos correctamente.
* Descuentos se reflejan en el total reportado.
* IVA respeta tasas por producto (incluye productos con IVA 0%).

Detalles del fix en la [guía Fix: DESGLOSE DE VENTA](/fix-corte-z).