Guía operativa Winerim
Versión 2026.09.0 · Español verificado · 33 recorridos transversales.
Editor Pendiente de validación
Configurar copas por botella y revisar merma
Resultado: La operación y su resultado entre Editor y App están pendientes de validar.
Cuándo usarla
Cuando cambia el servicio por copa o el número real de copas servidas por botella.
Requisitos
- Acceso a Mi cuenta > Ajustes de copas.
- Medida de servicio y merma real acordadas.
Pasos
- Identifica la entidad y el control en la pantalla de referencia.
- No interpretes el control o la captura histórica como una operación completada.
- Comprueba una prueba autorizada y la lectura posterior de la misma entidad antes de usar esta guía.
Readback
Falta confirmar el ajuste guardado de copas por botella y su efecto sobre el mismo vino en Márgenes.
Recuperación
Restaura el número anterior si el vino testigo no cuadra y registra la medida real antes de volver a cambiarlo.
ID: ops-glass-settings · Verificado: 2026-10-17 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Solicitar un cambio de etiqueta con identidad verificada
Resultado: Verifica la referencia y la añada de la botella antes de preparar un cambio de etiqueta.
Cuándo usarla
Cuando la etiqueta visible no corresponde a la referencia o está desactualizada.
Requisitos
- Sesión iniciada en el Editor.
- Referencia exacta localizada.
- Fotografías vigentes y completas de la botella.
Pasos
- Selecciona el vino exacto y compara su identidad con la botella física.
- Comprueba Añada de la botella que estás enviando; marca Sin añada solo si la botella no indica año. El ejemplo Ossian Viñas Viejas (2023) muestra 2023 al seleccionarlo.
- Prepara ambas fotos obligatorias siguiendo las instrucciones. Envía solo una petición autorizada y comprueba después el acuse y la etiqueta del mismo vino en Editor y App.
Readback
La selección del ejemplo autocompleta 2023 en el formulario sin enviar. El año no se editó, Sin añada no se marcó y no se probaron reglas de validación. Se canceló y se volvió a Mi carta.
Recuperación
Si la identidad o el resultado no están claros, detente y revisa el caso antes de adjuntar archivos, enviar o repetir una operación.
ID: ops-label-change · Verificado: 2026-10-19 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Añadir un vino existente o solicitar un alta
Resultado: Elegir entre preparar una referencia del catálogo y consultar la ruta de solicitud, evitando duplicados.
Cuándo usarla
Cuando quieres incorporar un vino y necesitas comprobar primero si su identidad ya está disponible.
Requisitos
- Sesión iniciada en el Editor.
- Nombre, bodega, añada y formato comprobados; fotos frontal/trasera cuando se solicita un alta.
Pasos
- Busca primero la referencia en Mi carta para evitar duplicados.
- En Añadir vino, busca el nombre y comprueba la identidad de los resultados.
- Si existe la referencia exacta, pulsa + y revisa añada, formato, precio de venta, precio de compra y stock.
- Si no coincide ninguna referencia, vuelve a Mi carta y consulta la guía de Solicitar vino.
- Para confirmar un alta preparada, sigue la guía de Guardar; si decides guardar, comprueba después su resultado en Mi carta antes de repetir la operación.
Readback
Distingue la ficha de preparación de la referencia persistida en Mi carta. Verifica la identidad antes de cualquier confirmación.
Recuperación
Cancela antes de guardar si la identidad no coincide. Si detectas un duplicado previo, conserva sus identificadores y consulta a soporte antes de modificarlo.
ID: ops-catalog-add-or-request · Verificado: 2026-10-08 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Importar compras o cambios de proveedor sin asumir automatismos
Resultado: Actualizar datos soportados por el flujo disponible y separar lo verificado de lo que requiere validación.
Cuándo usarla
Cuando llega un Excel, albarán, factura o catálogo de proveedor.
Requisitos
- Documento original conservado.
- Plantilla o flujo visible en la cuenta.
- Identidad, formato, unidades, coste, moneda e impuestos revisados.
Pasos
- Identifica si el flujo visible admite Excel de actualización, importación automática o catálogo de distribuidor.
- Conserva una copia del documento original.
- Valida columnas e IDs antes de subir un XLSX.
- No afirmes que un PDF/foto actualizará stock o costes hasta ver el resumen previo y su alcance.
- Ejecuta una muestra controlada si el producto ofrece previsualización.
- Comprueba por separado Mi carta, Stock, precio de compra y Márgenes.
Readback
Compara una muestra de referencias contra el documento original y revisa Stock, Mi carta e Historial.
Recuperación
Detén la importación si la previsualización no cuadra. Conserva el archivo original y el resumen; no lances una segunda importación hasta saber si la primera terminó.
ID: ops-purchases-suppliers-imports · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Vigente
Distinguir Winerim vigente, beta y productos adyacentes
Resultado: Responder sin convertir propuestas o productos separados en funciones Winerim productivas.
Cuándo usarla
En soporte, comercial, documentación o roadmap cuando aparezcan nombres de otros productos.
Requisitos
- Fuente de Producto Winerim y estado fechado.
Pasos
- Comprueba si existe superficie real en App, Editor, ERP o Integraciones.
- Busca evidencia y última verificación.
- Etiqueta current, beta, pending_validation o retired.
- Para Carta Architect conserva su estado staging/beta hasta readback productivo.
- No presentes Cellaria, FoodRIM, SpiritsRIM, Matchrim, CRM o voz como Winerim operativo.
- Enlaza al producto separado o al owner cuando proceda.
Readback
El artículo y el changelog muestran la misma etiqueta de lifecycle y fecha.
Recuperación
Corrige la etiqueta y el texto, añade una entrada de changelog y revisa búsquedas/sinónimos que podían inducir a error.
ID: product-boundaries · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Separar incidencia, solicitud de producto y consulta de facturación
Resultado: Enviar cada caso con el contexto mínimo al responsable correcto.
Cuándo usarla
Cuando hay un fallo, una mejora solicitada o una duda contractual/factura.
Requisitos
- Cuenta/restaurante e interlocutor confirmados.
- Captura, módulo, acción y resultado esperado para incidencias.
- Factura/periodo/contrato para consultas administrativas.
Pasos
- Clasifica el caso: incidencia, funcionalidad o facturación.
- Para incidencia, reproduce sin escrituras y anota módulo, pasos y readback.
- Para funcionalidad, explica necesidad y resultado, no una solución inventada.
- Para facturación, identifica periodo y documento sin publicar datos sensibles.
- Usa el canal visible/autorizado.
- Registra referencia y responsable de seguimiento.
Readback
Existe confirmación o referencia de recepción con categoría, cuenta y responsable correctos.
Recuperación
Si se clasificó mal, no dupliques solicitudes: referencia el caso original y solicita reasignación.
ID: ops-billing-and-support · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Vigente
Leer Insights y Analítica con periodo y fuente
Resultado: Interpretar composición, uso, demanda y rendimiento sin confundir ausencia de datos con cero.
Cuándo usarla
Para revisar composición de carta, búsquedas, filtros, idiomas, favoritos, rendimiento o comparativas.
Requisitos
- Acceso a Insights/Analítica.
- Restaurante y periodo de análisis confirmados.
Pasos
- Abre la vista y confirma restaurante y periodo.
- Identifica la métrica y su unidad.
- Abre el detalle de referencias cuando exista.
- Contrasta señales de uso con ventas y stock cuando la decisión sea económica.
- Separa cero, sin datos y dato no actualizado.
- Registra la conclusión con fecha y fuente.
Readback
Una referencia testigo explica el agregado y coincide con los datos operativos disponibles.
Recuperación
Si la métrica no cuadra, no corrijas datos desde Analítica; verifica fuente, periodo e integración y escala con capturas.
ID: ops-insights-analytics · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Vigente
Analizar márgenes, What If, ABC y capital dormido sin ejecutar a ciegas
Resultado: Priorizar decisiones de precio, compra o rotación con periodo y fuente claros.
Cuándo usarla
Para revisar beneficio, Bev. Cost, What If, ABC/Pareto, capital dormido, ticket, rotación u obsolescencia.
Requisitos
- Acceso a Márgenes e Insights.
- Precio de compra, PVP, stock y periodo de ventas revisados.
Pasos
- Confirma restaurante, periodo y moneda.
- Revisa si costes, PVP, stock y ventas tienen datos suficientes.
- Usa la vista específica: What If, ABC, capital dormido, ticket, rotación u obsolescencia.
- Abre las referencias que explican el agregado.
- Simula antes de aplicar un cambio masivo.
- Tras cualquier cambio, vuelve a Mi carta, Stock y la métrica para confirmar impacto.
Readback
El vino testigo conserva identidad, coste, PVP y stock correctos; la métrica recalculada usa el periodo esperado.
Recuperación
No apliques cambios masivos sin export o valores previos. Si ya se aplicaron, restaura por referencia validada y revisa el impacto de nuevo.
ID: ops-margin-analysis · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Crear o corregir una armonía y verificarla en App
Resultado: La operación y su resultado entre Editor y App están pendientes de validar.
Cuándo usarla
Cuando se añade un plato, cambia un menú o una recomendación de maridaje no es adecuada.
Requisitos
- Acceso a Gestionar Pairing.
- Plato, categoría e idioma confirmados.
Pasos
- Identifica la entidad y el control en la pantalla de referencia.
- No interpretes el control o la captura histórica como una operación completada.
- Comprueba una prueba autorizada y la lectura posterior de la misma entidad antes de usar esta guía.
Readback
Faltan el guardado del mismo plato o armonía y su lectura posterior en la App; el filtro histórico no es prueba actual.
Recuperación
Vuelve al Editor, corrige o elimina solo el elemento identificado y repite el readback público.
ID: ops-pairing-harmonies · Verificado: 2026-10-17 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Cambiar precio de botella o copa y verificar la propagación
Resultado: La botella Ossian de 750 ml está comprobada en Editor y App; la validación de copa y otros formatos sigue pendiente.
Cuándo usarla
Cuando cambia el precio de venta de botella, copa, media copa, magnum u otro formato.
Requisitos
- Sesión iniciada y permiso para editar la carta.
- Restaurante, vino y variante exactos confirmados.
- Valor anterior anotado para rollback.
Pasos
- Identifica el vino, la añada y el formato exactos antes de revisar o cambiar un precio.
- Para el ejemplo ya comprobado de Botella 750 ml, consulta Cambiar precio a un vino: el precio se guardó y se comprobó en Editor y App, y volvió al valor original.
- No atribuyas esa prueba a copa ni a otros formatos. Para completar esos casos faltan una operación específicamente autorizada y la lectura posterior del mismo formato; no los demuestra la captura de contexto.
Readback
Ossian Viñas Viejas 2023, Botella 750 ml: venta 59 € → 60 € → 59 €. El formulario reabierto confirmó 60 € y después 59 €; la App mostró los mismos importes. Compra 24 € y Stock 6 permanecieron intactos. No se han probado cambios de precio por copa, media copa, magnum ni la propagación a un TPV.
Recuperación
Si Editor o App no coinciden, restaura el valor anterior en la misma variante y verifica. Si el TPV difiere, detén nuevas escrituras y sigue el runbook de integración.
ID: ops-price-bottle-glass-readback · Verificado: 2026-10-19 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Publicar QR, idioma o PDF y verificar la carta visible
Resultado: La operación y su resultado entre Editor y App están pendientes de validar.
Cuándo usarla
Después de cambiar carta, precios, idioma, secciones, QR o PDF.
Requisitos
- Acceso a Códigos QR, Idiomas o Imprimir PDF.
- Carta e idioma objetivo confirmados.
Pasos
- Identifica la entidad y el control en la pantalla de referencia.
- No interpretes el control o la captura histórica como una operación completada.
- Comprueba una prueba autorizada y la lectura posterior de la misma entidad antes de usar esta guía.
Readback
Faltan el QR o PDF resultante y una prueba actual del enlace, idioma y precios de la misma carta.
Recuperación
Deja de compartir el artefacto incorrecto, regenera desde la configuración anterior válida y vuelve a escanear antes de distribuir.
ID: ops-qr-languages-pdf-readback · Verificado: 2026-10-17 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Revisar una sugerencia RIM con historial y aprobación
Resultado: La operación y su resultado entre Editor y App están pendientes de validar.
Cuándo usarla
Cuando RIM propone un cambio, una probabilidad de venta o una acción sobre obsolescencia.
Requisitos
- Acceso a Sugerencias RIM e Historial RIM.
- Criterio de aprobación acordado con gerencia.
Pasos
- Identifica la entidad y el control en la pantalla de referencia.
- No interpretes el control o la captura histórica como una operación completada.
- Comprueba una prueba autorizada y la lectura posterior de la misma entidad antes de usar esta guía.
Readback
Faltan una sugerencia RIM accionada y su lectura posterior en Historial RIM y en el dato afectado.
Recuperación
Si el cambio no era correcto, no borres el historial; restaura el dato desde su módulo con autorización y documenta la corrección.
ID: ops-rim · Verificado: 2026-10-17 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Validar disponibilidad de SAVia o CloudRIM antes de documentar
Resultado: Evitar presentar nombres o capacidades no verificadas como producto operativo.
Cuándo usarla
Cuando un cliente, soporte o comercial pregunta por SAVia o CloudRIM.
Requisitos
- Confirmación de Producto Winerim.
- URL o pantalla real y cuenta donde la función esté habilitada.
- Estado de lifecycle y audiencia.
Pasos
- No describas funciones por asociación con RIM.
- Solicita nombre oficial, alcance, estado y owner.
- Obtén una pantalla o contrato vigente.
- Ejecuta un flujo de lectura y, si aplica, un canary autorizado.
- Registra resultado y rollback.
- Solo entonces convierte este gate en artículos operativos.
Readback
Existe evidencia fechada que vincula nombre, superficie, resultado y responsable.
Recuperación
Retira o corrige cualquier afirmación publicada que no tenga evidencia; conserva el cambio en el changelog.
ID: ops-savia-cloudrim · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Reconciliar stock, movimiento y origen
Resultado: La operación y su resultado entre Editor y App están pendientes de validar.
Cuándo usarla
Cuando el stock visible no coincide con el recuento físico o una venta/importación.
Requisitos
- Sesión iniciada con acceso a Stock e Historial.
- Vino, variante, ubicación y momento del recuento confirmados.
Pasos
- Identifica la entidad y el control en la pantalla de referencia.
- No interpretes el control o la captura histórica como una operación completada.
- Comprueba una prueba autorizada y la lectura posterior de la misma entidad antes de usar esta guía.
Readback
Faltan un ajuste de stock autorizado y el saldo e historial posteriores de la misma referencia y variante.
Recuperación
No borres historial. Si el ajuste fue incorrecto, registra el valor previo y aplica una corrección compensatoria autorizada o escala con los IDs del movimiento.
ID: ops-stock-reconcile · Verificado: 2026-10-17 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Validar usuarios, roles y permisos antes de conceder acceso
Resultado: Evitar accesos excesivos o identidades ambiguas.
Cuándo usarla
Cuando se necesita alta, cambio de rol, restricción o baja de acceso.
Requisitos
- Identidad y email corporativo confirmados.
- Tenant/restaurante exacto.
- Matriz RBAC vigente y aprobador.
Pasos
- No infieras permisos por el nombre del puesto.
- Confirma persona, email, tenant y alcance.
- Obtén el rol vigente y su matriz de privilegios.
- Solicita aprobación del responsable.
- Aplica el mínimo privilegio en un canary si la superficie existe.
- Haz readback con la cuenta afectada y registra auditoría.
Readback
La cuenta muestra el rol esperado y no puede abrir ni modificar módulos fuera de alcance.
Recuperación
Revoca el cambio y conserva el evento de auditoría; si la identidad es dudosa, bloquea el alta hasta confirmación.
ID: ops-users-roles-permissions · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Gestionar un Wine Locker con identidad y cantidad verificadas
Resultado: La operación y su resultado entre Editor y App están pendientes de validar.
Cuándo usarla
Para buscar cliente, crear locker, añadir/editar vino o gestionar un pedido pendiente.
Requisitos
- Módulo Wine Lockers habilitado.
- Cliente y código confirmados.
- Vino, variante y cantidad comprobados.
Pasos
- Identifica la entidad y el control en la pantalla de referencia.
- No interpretes el control o la captura histórica como una operación completada.
- Comprueba una prueba autorizada y la lectura posterior de la misma entidad antes de usar esta guía.
Readback
La carta 1484 no muestra Wine Lockers; falta una sesión autorizada con alta y lectura posterior del mismo locker.
Recuperación
No borres historial. Corrige cantidad/estado solo con evidencia y escala si la identidad del cliente o vino no es inequívoca.
ID: ops-wine-lockers · Verificado: 2026-10-17 · Responsable: Equipo Producto Winerim
Editor Vigente
Detener, conservar evidencia y recuperar una operación dudosa
Resultado: Reducir daño cuando no se sabe si una escritura, importación o sincronización terminó.
Cuándo usarla
Ante timeout, resultado parcial, duplicación, identidad dudosa o readback incoherente.
Requisitos
- Acceso de lectura al origen y destino.
- Identidad, hora y acción original.
Pasos
- No repitas la acción.
- Captura pantalla, hora, IDs, archivo y mensaje de error.
- Lee origen, destino e historial para saber si se aplicó.
- Aísla el escritor o flujo si existe riesgo de duplicación.
- Aplica solo una recuperación reversible y autorizada.
- Repite el readback y registra resultado/owner.
Readback
Origen, destino e historial cuentan una única historia y no aparece un efecto adicional.
Recuperación
La recuperación depende del módulo; si no existe rollback probado, mantén el flujo detenido y escala con evidencia.
ID: ops-contingency-workflow · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Validar ERP v4 antes de operar
Resultado: Definir superficie, alcance y readbacks de ERP v4 sin inventar rutas.
Cuándo usarla
Cuando se solicita una acción o explicación específica de ERP v4.
Requisitos
- URL/pantalla ERP v4 vigente.
- Cuenta de prueba autorizada.
- Matriz de permisos y contrato de datos.
- Owner de producto.
Pasos
- No reutilices nombres del Editor como si fueran ERP v4.
- Obtén inventario de rutas y acciones visibles.
- Relaciona cada acción con su dato origen y destino.
- Ejecuta lecturas y un canary reversible autorizado.
- Captura estado inicial, resultado y rollback.
- Publica artículos solo después del readback.
Readback
Cada capacidad tiene pantalla/contrato, responsable, fecha y prueba reproducible.
Recuperación
Retira instrucciones no verificadas y vuelve a la última guía marcada current.
ID: erp-v4-operational-overview · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Beta
Distinguir grupo, bodega central y Carta Architect
Resultado: Evitar ejecutar una arquitectura multicentro no validada como si fuera producción general.
Cuándo usarla
Cuando se plantea una carta maestra, bodega central, grupo hotelero o Carta Architect.
Requisitos
- Versión autorizada del catálogo maestro.
- Jerarquía grupo > centro > outlet confirmada.
- RACI, precios, stock y permisos validados.
Pasos
- Confirma si la petición es una operación Winerim vigente o un proyecto Carta Architect.
- Valida primero el catálogo/bodega maestra y sus identidades.
- Define qué hereda cada centro y qué puede sobrescribir.
- No publiques listas hijas sin stock, PVP, ventas y aprobadores confirmados.
- Ejecuta un piloto local o staging.
- Promueve solo tras readback de aislamiento y aprobación.
Readback
Cada lista hija referencia identidades maestras y muestra solo overrides autorizados.
Recuperación
Detén publicación y vuelve a la última versión maestra aprobada; no reasignes identidades por similitud.
ID: ops-groups-central-cellar-carta-architect · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Validar y registrar mermas con motivo y trazabilidad
Resultado: Definir una merma como evento separado de venta o ajuste.
Cuándo usarla
Cuando una pérdida física no debe clasificarse como venta ni corrección sin causa.
Requisitos
- Módulo/evento de merma confirmado.
- Cantidad, formato, valor, motivo, fase y responsable definidos.
Pasos
- Confirma que existe una superficie de merma y no solo un ajuste de Stock.
- Selecciona referencia y formato exactos.
- Registra cantidad, motivo, fase y responsable.
- Guarda una vez.
- Comprueba historial, saldo y valoración.
- Valida el método de corrección o anulación.
Readback
Historial identifica el evento como merma, con motivo y saldo reproducible.
Recuperación
No borres el evento; usa la reversión definida por producto cuando esté validada.
ID: erp-waste · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Validar productos derivados, recetas y escandallos
Resultado: Evitar atribuir a Winerim una gestión de recetas no demostrada.
Cuándo usarla
Cuando se pregunta por recetas, escandallos, subrecetas o productos derivados.
Requisitos
- Superficie Winerim real.
- Modelo de receta, unidades, rendimiento, coste y versionado.
- Integración POS y stock validadas.
Pasos
- No uses FoodRIM como evidencia de Winerim productivo.
- Obtén pantalla y contrato del módulo Winerim.
- Valida unidades, rendimientos y versiones.
- Traza una venta hasta consumo teórico y stock.
- Prueba reversión/anulación.
- Publica solo después del readback.
Readback
Una receta versionada reproduce coste y consumo desde sus componentes.
Recuperación
Retira afirmaciones no verificadas; no migres ni conviertas datos sin aprobación de producto.
ID: erp-derived-products-recipes · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Validar valoración de stock y movimientos ERP
Resultado: Distinguir saldo, valoración y evento de movimiento con una fecha común.
Cuándo usarla
Para explicar valoración económica o movimientos fuera del historial básico de Stock.
Requisitos
- Definición de coste y moneda.
- Timestamp común de inventario.
- Tipos de movimiento y reglas de devolución/anulación.
Pasos
- Confirma si la vista es Editor Stock o ERP.
- Define cantidad, coste unitario, moneda y momento de valoración.
- Lista tipos de movimiento admitidos.
- Comprueba una referencia desde evento hasta saldo.
- Valida una reversión autorizada.
- Registra fórmula, redondeo y responsable.
Readback
Una referencia testigo reconcilia cantidad por coste con la valoración mostrada.
Recuperación
No edites movimientos históricos; usa una corrección trazable solo cuando el contrato ERP esté validado.
ID: erp-valuation-movements · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Validar ventas del día y análisis de servicio
Resultado: Cerrar un servicio con ventas reconciliadas por origen, periodo y estado.
Cuándo usarla
Para consultar ventas del día, ticket, rotación o rendimiento por servicio.
Requisitos
- Zona horaria y ventana de servicio.
- Ventas, anulaciones, devoluciones, invitaciones y descuentos definidos.
- Mapeo de outlet/canal.
Pasos
- Fija inicio, fin y zona horaria del servicio.
- Identifica la fuente: manual, archivo o TPV.
- Separa ventas válidas de anulaciones, devoluciones e invitaciones.
- Reconcilia una línea mapeada con historial y stock.
- Compara agregados solo después del detalle.
- Registra gaps y hora de última sincronización.
Readback
Una venta testigo aparece una vez, con importe/formato correctos y un único efecto de stock.
Recuperación
No repares historia ni cursores manualmente; pausa el escritor afectado y sigue el runbook de integración.
ID: erp-sales-day-service-analysis · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Vigente
Auditar catálogo Agora con export y readback exactos
Resultado: Distinguir discrepancia real, error de publicación y conexión no activa.
Cuándo usarla
Cuando faltan productos, formatos o precios en Agora.
Requisitos
- Conexión Agora identificada.
- Acceso autorizado al catálogo origen/destino.
- Runbook de publicación y rollback.
Pasos
- Confirma que la conexión está activa y cuál es el escritor.
- Obtén un export fresco; acepta JSON o XML solo tras parseo y validación no vacía.
- Compara identidades, variantes, precios y mappings canónicos.
- Separa cola, error de publicación, conectividad y discrepancia real.
- Publica solo mediante canary autorizado cuando haga falta.
- Lee Agora de nuevo y exige coincidencia exacta antes de cerrar.
Readback
Dos lecturas independientes del destino devuelven los mismos IDs, formatos y precios esperados.
Recuperación
Restaura el deployment/publicación anterior según runbook; preserva IDs legacy y no reordena semánticamente sin aprobación.
ID: integration-agora-catalog · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Vigente
Cerrar una auditoría de integración con readback
Resultado: Convertir configuración y logs en una conclusión reproducible.
Cuándo usarla
Después de una sincronización, corrección o activación.
Requisitos
- Acceso read-only a configuración, telemetría y destino.
- Ventana temporal y criterio de éxito definidos.
Pasos
- Fija conexión, lane, ventana y criterio.
- Lee configuración activa y escritor.
- Revisa ciclos, errores, breaker y cola.
- Compara origen canónico y destino real.
- Ejecuta una segunda lectura independiente.
- Registra OK, degradado, no activo o pendiente con evidencia.
Readback
Origen, destino, mapping y telemetría coinciden dentro de la ventana definida.
Recuperación
Si el readback falla, revierte la promoción, conserva evidencia y abre incidencia por lane; no corrige datos a mano.
ID: integration-audit-readback · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Vigente
Identificar conexión, lane y escritor activo
Resultado: Saber qué runtime y flujo controla catálogo, ventas o stock antes de intervenir.
Cuándo usarla
Al revisar cualquier conexión Agora, Revo, Odoo, legacy o middleware propio.
Requisitos
- Acceso autorizado a configuración y observabilidad.
- Restaurante y sistema externo exactos.
Pasos
- Identifica conexión, restaurante y entorno.
- Confirma si está activa, deshabilitada o en canary.
- Determina el único escritor vigente.
- Clasifica el lane: catálogo, ventas, stock u outbound.
- Lee breaker, cola, último ciclo y error sin ejecutar escrituras.
- Escala al runbook específico con esa evidencia.
Readback
La configuración y la telemetría coinciden en escritor activo y última ejecución.
Recuperación
Si hay más de un escritor o estado ambiguo, deja ambos sin nuevas mutaciones y escala; no repares cursores manualmente.
ID: integration-overview · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Validar el contrato Odoo antes de operar
Resultado: Definir objetos, claves, dirección y ownership de la sincronización Odoo.
Cuándo usarla
Para alta, auditoría o incidencia de una conexión Odoo.
Requisitos
- Versión/tenant Odoo autorizado.
- Objetos y claves de negocio definidos.
- Dirección de cada lane e idempotencia.
Pasos
- Confirma versión, tenant y módulos Odoo.
- Lista objetos y claves canónicas sin exponer credenciales.
- Define qué sistema es writer por campo.
- Prueba lecturas y mappings con una muestra.
- Ejecuta canary reversible autorizado.
- Cierra con readback y plan de rollback.
Readback
Una entidad testigo coincide por clave de negocio, versión y estado en ambos sistemas.
Recuperación
Desactiva el lane nuevo y vuelve al writer anterior; no corrijas historia manualmente.
ID: integration-odoo · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Vigente
Triage de incidencia de catálogo, venta o stock
Resultado: Aislar la capa fallida sin provocar duplicados ni pérdida de evidencia.
Cuándo usarla
Cuando una integración no sincroniza, duplica o muestra datos distintos.
Requisitos
- Restaurante, conexión, entorno, hora y ejemplo exactos.
- Acceso read-only antes de cualquier mutación.
Pasos
- Captura síntoma, IDs y hora sin reintentar.
- Clasifica lane y sistema origen/destino.
- Confirma conexión, escritor, breaker, cola y último ciclo.
- Comprueba mapping e idempotency key del ejemplo.
- Determina si es conectividad, publicación, mapping, datos o UI.
- Aplica solo el runbook específico y cierra con readback.
Readback
El ejemplo afectado coincide en origen/destino y no se duplicó durante el diagnóstico.
Recuperación
Pausa el escritor afectado cuando exista riesgo de duplicación; restaura por el runbook aprobado y conserva logs/IDs.
ID: integration-incident-triage · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Validar el contrato Revo antes de operar
Resultado: Evitar aplicar el runbook de Agora a Revo sin equivalencia demostrada.
Cuándo usarla
Para alta, auditoría o incidencia de una conexión Revo.
Requisitos
- Conexión Revo real autorizada.
- Contrato de catálogo/ventas/stock y mappings.
- Owner y rollback.
Pasos
- Identifica versión y tenant Revo.
- Inventaría objetos, IDs y lanes soportados.
- Verifica autenticación sin registrar secretos.
- Prueba lectura de catálogo y mapping.
- Ejecuta canary reversible autorizado para cada lane.
- Documenta readback e idempotencia antes de activar.
Readback
Origen, destino y mapping de un ejemplo coinciden y el canary no duplica efectos.
Recuperación
Mantén la conexión no activa y vuelve al escritor anterior hasta certificar el contrato.
ID: integration-revo · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Auditar o retirar un runtime legacy sin doble escritura
Resultado: Mantener continuidad mientras se migra cada lane a infraestructura propia.
Cuándo usarla
Cuando una conexión todavía depende total o parcialmente del runtime legacy.
Requisitos
- Inventario de lanes legacy y nuevos.
- Plan de canary, promoción y rollback por conexión.
Pasos
- Lista writer legacy y nuevo por lane.
- Confirma que solo uno puede mutar cada recurso.
- Compara outputs en modo sombra/read-only.
- Promueve una conexión/lane mediante canary autorizado.
- Verifica catálogo, venta e impacto de stock.
- Mantén rollback hasta cerrar la ventana de observación.
Readback
Configuración, telemetría y destino muestran solo el writer promovido.
Recuperación
Desactiva el writer nuevo y reactiva el anterior solo mediante el runbook de conexión; verifica cola y cursores antes de reanudar.
ID: integration-legacy-runtime · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Certificar una venta integrada y su único descuento de stock
Resultado: Probar catálogo, venta, idempotencia e impacto de stock antes de declarar una integración operativa.
Cuándo usarla
Durante activación, canary o incidencia de ventas/stock TPV.
Requisitos
- Línea de venta real autorizada y mapeada.
- Idempotency key y trazas.
- Readback de historial y stock Winerim.
Pasos
- Confirma mapping exacto de producto y formato.
- Registra el estado de stock inicial.
- Observa una línea real de venta sin reinyectarla manualmente.
- Verifica que se procesa una sola vez.
- Comprueba historial Winerim y un único decremento de stock.
- Repite el readback después de otro ciclo para descartar duplicación.
Readback
Invoice/line, mapping, idempotency key, historial y delta de stock coinciden.
Recuperación
Mantén el canary sin promoción; no repares historial, cola o cursor manualmente. Desactiva el escritor según runbook si hay doble efecto.
ID: integration-sales-stock · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Distinguir vinos asignados de catálogo del distribuidor
Resultado: Reconocer por qué un distribuidor puede tener vinos asociados y seguir sin catálogo importado.
Cuándo usarla
Al consultar proveedores o encontrar vacío el comparador.
Requisitos
- Acceso al ERP de la carta seleccionada.
Pasos
- Abre Stock desde el Editor y entra en Distribuidores.
- En Mis distribuidores, compara el contador Vinos con el estado del Catálogo.
- Abre la ficha del distribuidor y distingue Vinos que le has asignado de De su catálogo.
- Si aparece Sin catálogo subido o 0 de 0 vinos, conserva ese estado como ausencia de catálogo, no como ausencia de vinos asignados.
- Vuelve a la subnavegación y localiza Comparador, Oportunidades y Tendencias para sus respectivas consultas.
Readback
El distribuidor y la carta son los previstos. Un contador de vinos asignados no demuestra que existan precios comparables de catálogo.
Recuperación
Comprueba el distribuidor y la carta y distingue Vinos que le has asignado de De su catálogo. Si falta catálogo, consulta los vinos asignados por separado y confirma precios y disponibilidad con el distribuidor antes de decidir una compra.
ID: erp-distribuidores-asignados-catalogo · Verificado: 2026-10-08 · Responsable: Equipo Producto Winerim
Editor Pendiente de validación
Consultar el análisis del servicio y su cobertura horaria
Resultado: Leer las ventas por periodo, origen y disponibilidad de hora real sin confundir consulta con reconciliación de stock.
Cuándo usarla
Para revisar el ritmo del servicio y conocer la procedencia de los registros.
Requisitos
- Acceso a ERP > Historial.
- Carta e intervalo identificados.
Pasos
- En el ERP, abre Historial.
- Selecciona Análisis del servicio junto a Ventas del día.
- Comprueba las fechas y los días con ventas indicados en la cabecera.
- Revisa botellas, copas, facturación y ritmo del servicio.
- Lee la cobertura de Franja horaria: solo incorpora las líneas que tienen hora real.
- Consulta Trazabilidad del registro para distinguir TPV, Importada, Manual y Copeo.
- Revisa Vinos más servidos como unidades de botella y copa; para rentabilidad, la pantalla remite a Wine Analytics.
Readback
Conserva fechas y cobertura horaria junto al resultado. La consulta no certifica un único descuento de stock por venta.
Recuperación
Comprueba las fechas, el origen de los registros y la cobertura horaria. Si dos indicadores se contradicen, conserva ambos valores y consulta la discrepancia antes de utilizarlos; confirma los movimientos de stock en sus registros, no en este resumen.
ID: erp-analisis-servicio-consulta · Verificado: 2026-10-08 · Responsable: Equipo Producto Winerim