Winerim Help

Guía operativa Winerim

Versión 2026.09.0 · Español verificado · 31 recorridos transversales.

Editor Vigente

Configurar copas por botella y revisar merma

Resultado: Usar una capacidad realista para calcular coste y rentabilidad por copa.

Cuándo usarla

Cuando cambia el servicio por copa o el número real de copas servidas por botella.

Requisitos

Pasos

  1. Abre Ajustes de copas.
  2. Comprueba la capacidad de botella y la medida de servicio.
  3. Define cuántas copas reales salen de una botella.
  4. Guarda una sola vez.
  5. Revisa el coste de copa y Copa vs botella en Márgenes.
  6. Comprueba un vino testigo antes de extender decisiones.

Readback

Abre Márgenes > Copa vs botella y confirma el vino testigo, su coste y el número de copas.

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-09-02 · Responsable: Equipo Producto Winerim

Editor Vigente

Solicitar un cambio de etiqueta con identidad verificada

Resultado: Corregir la imagen de botella sin cambiar la identidad del vino.

Cuándo usarla

Cuando la etiqueta visible no corresponde a la referencia o está desactualizada.

Requisitos

Pasos

  1. Abre Solicitar cambio de etiqueta.
  2. Busca y selecciona la referencia exacta.
  3. Compara nombre, bodega, añada y formato.
  4. Adjunta la etiqueta frontal y, si aporta identidad, la trasera.
  5. Envía una sola solicitud.
  6. Tras el procesamiento, abre Mi carta y la carta pública para confirmar la imagen.

Readback

Comprueba la tarjeta Editor y la ficha pública; la imagen debe coincidir con nombre, bodega, añada y formato.

Recuperación

Cancela la solicitud si la referencia es incorrecta. Si ya se procesó una imagen errónea, registra IDs y capturas antes de abrir una nueva incidencia.

ID: ops-label-change · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim

Editor Vigente

Añadir un vino existente o solicitar un alta

Resultado: Incorporar la referencia correcta a Mi carta sin duplicar identidad.

Cuándo usarla

Cuando un vino debe entrar en la carta y hay que decidir entre catálogo existente, solicitud o importación.

Requisitos

Pasos

  1. Busca primero la referencia en Mi carta y en Añadir vino.
  2. Si existe, selecciona la identidad y variante exactas; revisa precio y stock.
  3. Si no existe, abre Solicitar vino y conserva los campos aportados por el cliente sin reinterpretarlos.
  4. Adjunta imágenes completas y legibles cuando proceda.
  5. Envía o guarda una sola vez.
  6. Vuelve a Mi carta y confirma identidad, variante, precio, stock y visibilidad.

Readback

Busca de nuevo por nombre y bodega; confirma que no hay duplicado y abre la tarjeta para revisar sus datos.

Recuperación

Cancela antes de guardar si la identidad no coincide. Si ya se creó un duplicado, no lo reasignes: conserva IDs y escala a soporte para reconciliación.

ID: ops-catalog-add-or-request · Verificado: 2026-09-02 · 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

Pasos

  1. Identifica si el flujo visible admite Excel de actualización, importación automática o catálogo de distribuidor.
  2. Conserva una copia del documento original.
  3. Valida columnas e IDs antes de subir un XLSX.
  4. No afirmes que un PDF/foto actualizará stock o costes hasta ver el resumen previo y su alcance.
  5. Ejecuta una muestra controlada si el producto ofrece previsualización.
  6. 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

Pasos

  1. Comprueba si existe superficie real en App, Editor, ERP o Integraciones.
  2. Busca evidencia y última verificación.
  3. Etiqueta current, beta, pending_validation o retired.
  4. Para Carta Architect conserva su estado staging/beta hasta readback productivo.
  5. No presentes Cellaria, FoodRIM, SpiritsRIM, Matchrim, CRM o voz como Winerim operativo.
  6. 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

Pasos

  1. Clasifica el caso: incidencia, funcionalidad o facturación.
  2. Para incidencia, reproduce sin escrituras y anota módulo, pasos y readback.
  3. Para funcionalidad, explica necesidad y resultado, no una solución inventada.
  4. Para facturación, identifica periodo y documento sin publicar datos sensibles.
  5. Usa el canal visible/autorizado.
  6. 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

Pasos

  1. Abre la vista y confirma restaurante y periodo.
  2. Identifica la métrica y su unidad.
  3. Abre el detalle de referencias cuando exista.
  4. Contrasta señales de uso con ventas y stock cuando la decisión sea económica.
  5. Separa cero, sin datos y dato no actualizado.
  6. 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

Pasos

  1. Confirma restaurante, periodo y moneda.
  2. Revisa si costes, PVP, stock y ventas tienen datos suficientes.
  3. Usa la vista específica: What If, ABC, capital dormido, ticket, rotación u obsolescencia.
  4. Abre las referencias que explican el agregado.
  5. Simula antes de aplicar un cambio masivo.
  6. 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 Vigente

Crear o corregir una armonía y verificarla en App

Resultado: Relacionar platos y vinos de forma visible en la carta pública.

Cuándo usarla

Cuando se añade un plato, cambia un menú o una recomendación de maridaje no es adecuada.

Requisitos

Pasos

  1. Abre Gestionar Pairing y localiza el plato o categoría.
  2. Crea o edita el texto sin duplicar el plato.
  3. Regenera el maridaje solo cuando proceda y revisa la propuesta.
  4. Guarda y revisa el orden.
  5. Abre la App y filtra por el plato o armonía.
  6. Confirma que aparecen vinos pertinentes y el texto correcto.

Readback

Busca el plato desde el filtro de maridaje de la App y abre al menos un vino resultado.

Recuperación

Vuelve al Editor, corrige o elimina solo el elemento identificado y repite el readback público.

ID: ops-pairing-harmonies · Verificado: 2026-09-02 · Responsable: Equipo Producto Winerim

Editor Vigente

Cambiar precio de botella o copa y verificar la propagación

Resultado: Actualizar el PVP del formato correcto y confirmar dónde se ha aplicado.

Cuándo usarla

Cuando cambia el precio de venta de botella, copa, media copa, magnum u otro formato.

Requisitos

Pasos

  1. Busca el vino en Mi carta y abre su edición.
  2. Localiza la variante exacta: botella, copa, media copa, magnum u otra.
  3. Anota el PVP anterior y cambia solo el formato previsto.
  4. Guarda una vez y vuelve a la tarjeta.
  5. Abre la carta pública y comprueba el mismo formato.
  6. Si existe integración TPV/ERP, verifica su readback por separado; no asumas propagación por haber guardado en Editor.

Readback

Compara vino, variante y precio en Mi carta y App; registra también el readback TPV/ERP cuando aplique.

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-09-02 · Responsable: Equipo Producto Winerim

Editor Vigente

Publicar QR, idioma o PDF y verificar la carta visible

Resultado: Compartir una versión de carta que abre el restaurante, idioma y precios correctos.

Cuándo usarla

Después de cambiar carta, precios, idioma, secciones, QR o PDF.

Requisitos

Pasos

  1. Termina primero los cambios de carta.
  2. Configura idioma o contenido del PDF si aplica.
  3. Genera un QR/PDF nuevo cuando la carta haya cambiado.
  4. Abre el QR o enlace en una sesión sin editar.
  5. Comprueba restaurante, idioma, secciones, vinos y formatos/precios.
  6. Marca la versión anterior como obsoleta para el equipo.

Readback

Escanea el QR y revisa una referencia testigo; en PDF confirma fecha/opciones y en App idioma/precio.

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-09-02 · Responsable: Equipo Producto Winerim

Editor Vigente

Revisar una sugerencia RIM con historial y aprobación

Resultado: Aceptar o descartar una sugerencia con contexto y trazabilidad.

Cuándo usarla

Cuando RIM propone un cambio, una probabilidad de venta o una acción sobre obsolescencia.

Requisitos

Pasos

  1. Abre Sugerencias RIM y lee la recomendación completa.
  2. Comprueba referencia, señal, impacto y datos de soporte visibles.
  3. Contrasta con Mi carta, Stock y periodo de ventas.
  4. Acepta, descarta o deja pendiente según la autoridad disponible.
  5. Abre Historial RIM.
  6. Confirma qué cambió, cuándo y quién lo aprobó.

Readback

Historial RIM muestra la acción esperada y el dato afectado coincide con Mi carta o Stock.

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-09-02 · 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

Pasos

  1. No describas funciones por asociación con RIM.
  2. Solicita nombre oficial, alcance, estado y owner.
  3. Obtén una pantalla o contrato vigente.
  4. Ejecuta un flujo de lectura y, si aplica, un canary autorizado.
  5. Registra resultado y rollback.
  6. 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 Vigente

Reconciliar stock, movimiento y origen

Resultado: Explicar una diferencia de inventario antes de corregir unidades.

Cuándo usarla

Cuando el stock visible no coincide con el recuento físico o una venta/importación.

Requisitos

Pasos

  1. Busca la referencia exacta en Stock y anota unidades y umbral.
  2. Abre Historial y filtra el periodo de la discrepancia.
  3. Clasifica cada movimiento como venta, ajuste o importación/integración.
  4. Contrasta con recuento físico y con la fuente de ventas o compras.
  5. Corrige solo la diferencia confirmada y con un único escritor activo.
  6. Vuelve a Stock e Historial y verifica el saldo y el nuevo movimiento.

Readback

La referencia y variante muestran el saldo esperado y un único movimiento trazable con origen y fecha correctos.

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-09-02 · 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

Pasos

  1. No infieras permisos por el nombre del puesto.
  2. Confirma persona, email, tenant y alcance.
  3. Obtén el rol vigente y su matriz de privilegios.
  4. Solicita aprobación del responsable.
  5. Aplica el mínimo privilegio en un canary si la superficie existe.
  6. 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 Vigente

Gestionar un Wine Locker con identidad y cantidad verificadas

Resultado: Crear o actualizar un locker del cliente sin mezclar personas, vinos ni formatos.

Cuándo usarla

Para buscar cliente, crear locker, añadir/editar vino o gestionar un pedido pendiente.

Requisitos

Pasos

  1. Busca primero al cliente y abre Ver locker.
  2. Confirma identidad antes de crear un registro nuevo.
  3. Añade o edita el vino con variante y cantidad exactas.
  4. Guarda una vez.
  5. Vuelve a la ficha y revisa contador, tarjeta e historial.
  6. Para pedidos, registra solo el estado real: pagado, añadido o cancelado.

Readback

Abre de nuevo el locker por búsqueda y confirma contador, tarjeta e historial.

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-09-02 · Responsable: Equipo Producto Winerim

ERP 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

Pasos

  1. No repitas la acción.
  2. Captura pantalla, hora, IDs, archivo y mensaje de error.
  3. Lee origen, destino e historial para saber si se aplicó.
  4. Aísla el escritor o flujo si existe riesgo de duplicación.
  5. Aplica solo una recuperación reversible y autorizada.
  6. 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

ERP 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

Pasos

  1. No reutilices nombres del Editor como si fueran ERP v4.
  2. Obtén inventario de rutas y acciones visibles.
  3. Relaciona cada acción con su dato origen y destino.
  4. Ejecuta lecturas y un canary reversible autorizado.
  5. Captura estado inicial, resultado y rollback.
  6. 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

ERP 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

Pasos

  1. Confirma si la petición es una operación Winerim vigente o un proyecto Carta Architect.
  2. Valida primero el catálogo/bodega maestra y sus identidades.
  3. Define qué hereda cada centro y qué puede sobrescribir.
  4. No publiques listas hijas sin stock, PVP, ventas y aprobadores confirmados.
  5. Ejecuta un piloto local o staging.
  6. 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

ERP 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

Pasos

  1. Confirma que existe una superficie de merma y no solo un ajuste de Stock.
  2. Selecciona referencia y formato exactos.
  3. Registra cantidad, motivo, fase y responsable.
  4. Guarda una vez.
  5. Comprueba historial, saldo y valoración.
  6. 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

ERP 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

Pasos

  1. No uses FoodRIM como evidencia de Winerim productivo.
  2. Obtén pantalla y contrato del módulo Winerim.
  3. Valida unidades, rendimientos y versiones.
  4. Traza una venta hasta consumo teórico y stock.
  5. Prueba reversión/anulación.
  6. 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

ERP 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

Pasos

  1. Confirma si la vista es Editor Stock o ERP.
  2. Define cantidad, coste unitario, moneda y momento de valoración.
  3. Lista tipos de movimiento admitidos.
  4. Comprueba una referencia desde evento hasta saldo.
  5. Valida una reversión autorizada.
  6. 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

ERP 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

Pasos

  1. Fija inicio, fin y zona horaria del servicio.
  2. Identifica la fuente: manual, archivo o TPV.
  3. Separa ventas válidas de anulaciones, devoluciones e invitaciones.
  4. Reconcilia una línea mapeada con historial y stock.
  5. Compara agregados solo después del detalle.
  6. 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

Integraciones 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

Pasos

  1. Confirma que la conexión está activa y cuál es el escritor.
  2. Obtén un export fresco; acepta JSON o XML solo tras parseo y validación no vacía.
  3. Compara identidades, variantes, precios y mappings canónicos.
  4. Separa cola, error de publicación, conectividad y discrepancia real.
  5. Publica solo mediante canary autorizado cuando haga falta.
  6. 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

Integraciones 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

Pasos

  1. Fija conexión, lane, ventana y criterio.
  2. Lee configuración activa y escritor.
  3. Revisa ciclos, errores, breaker y cola.
  4. Compara origen canónico y destino real.
  5. Ejecuta una segunda lectura independiente.
  6. 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

Integraciones 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

Pasos

  1. Identifica conexión, restaurante y entorno.
  2. Confirma si está activa, deshabilitada o en canary.
  3. Determina el único escritor vigente.
  4. Clasifica el lane: catálogo, ventas, stock u outbound.
  5. Lee breaker, cola, último ciclo y error sin ejecutar escrituras.
  6. 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

Integraciones 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

Pasos

  1. Confirma versión, tenant y módulos Odoo.
  2. Lista objetos y claves canónicas sin exponer credenciales.
  3. Define qué sistema es writer por campo.
  4. Prueba lecturas y mappings con una muestra.
  5. Ejecuta canary reversible autorizado.
  6. 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

Integraciones 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

Pasos

  1. Captura síntoma, IDs y hora sin reintentar.
  2. Clasifica lane y sistema origen/destino.
  3. Confirma conexión, escritor, breaker, cola y último ciclo.
  4. Comprueba mapping e idempotency key del ejemplo.
  5. Determina si es conectividad, publicación, mapping, datos o UI.
  6. 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

Integraciones 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

Pasos

  1. Identifica versión y tenant Revo.
  2. Inventaría objetos, IDs y lanes soportados.
  3. Verifica autenticación sin registrar secretos.
  4. Prueba lectura de catálogo y mapping.
  5. Ejecuta canary reversible autorizado para cada lane.
  6. 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

Integraciones 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

Pasos

  1. Lista writer legacy y nuevo por lane.
  2. Confirma que solo uno puede mutar cada recurso.
  3. Compara outputs en modo sombra/read-only.
  4. Promueve una conexión/lane mediante canary autorizado.
  5. Verifica catálogo, venta e impacto de stock.
  6. 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

Integraciones 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

Pasos

  1. Confirma mapping exacto de producto y formato.
  2. Registra el estado de stock inicial.
  3. Observa una línea real de venta sin reinyectarla manualmente.
  4. Verifica que se procesa una sola vez.
  5. Comprueba historial Winerim y un único decremento de stock.
  6. 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