iDempiere Retail Expert (A+B)

Objetivo

Implementar capacidades retail en iDempiere con riesgo controlado:

• A (Core retail): POS, inventario/stock, devoluciones/cambios, pricing/promos.
• B (Escala): e-commerce/omnichannel y analytics (KPIs, reporting, BI y/o NLQ con AI).

Sin tocar core salvo justificacion y aprobacion: preferir plugin OSGi + migraciones repetibles + contratos API.

Cuando usar

• Diseno/implementacion de POS (online/offline), checkout, pagos, devoluciones.
• Modelado de catalogo, precios, promociones, cupones, impuestos y redondeos.
• Inventario: stock on-hand/available, reservas, conteos, transferencias, mermas.
• Omnicanal: integracion con e-commerce/marketplaces, sincronizacion, webhooks.
• Retail analytics: KPIs por tienda/canal/producto, margen, rotacion, quiebres, devoluciones.

Inputs a pedir (minimo)

• Canales: POS / online / marketplace; y si hay offline-first.
• Modelo multi-tienda: como se representa cada tienda (org/warehouse), impuestos por jurisdiccion.
• Pagos: gateway externo, requerimientos PCI/PII, devoluciones (refund) y conciliacion.
• Stock: politicas de negativos, reservas, lot/serial, conteos y ajustes.
• Promos: tipos (descuento, 2×1, cupon), stacking/exclusividad y auditoria.
• Integraciones: endpoints requeridos, webhooks, idempotencia, volumen/latencia (SLO).
• Reporting: KPIs priorizados, granularidad (ticket/linea/dia), herramientas destino (BI/AI).

Workflow recomendado

1. Mapear dominio retail a iDempiere
   • Base: productos, clientes, pedidos, movimientos de stock y pagos.
   • Ver: references/idempiere-mapping.md.
2. Definir flujo POS end-to-end
   • Lifecycle (venta, cancelacion, devolucion/cambio) + offline sync + idempotencia.
   • Ver: references/pos-order-lifecycle.md.
3. Contratos de integracion
   • Diseñar OpenAPI contract-first + seguridad/scopes + webhooks.
   • Coordinar con $idempiere-openapi y ver references/ecommerce-omnichannel.md.
4. DB + Diccionario + Migraciones
   • Agregar lo minimo (EntityType del plugin), scripts repetibles y rollback.
   • Coordinar con $idempiere-db y ver references/inventory-stock.md, references/pricing-promos.md.
5. Implementacion en plugin
   • Procesos/callouts/validators/event-handlers + servicios OSGi; UI ZK si aplica.
   • Coordinar con $idempiere-plugin-development y $idempiere-zk.
6. Analytics
   • Definir KPIs y vistas semanticas; opcional: NLQ (AI->SQL) solo-lectura con guardrails.
   • Coordinar con $idempiere-ai y ver references/analytics-kpis.md.

Entregables tipicos

• Plugin OSGi (POS/retail) + setup instalable (feature/update-site si aplica).
• Contrato OpenAPI versionado + colecciones/tests (segun repo).
• Migraciones DB/diccionario + documentacion de upgrade/rollback.
• Checklist funcional (happy paths + errores) y dataset de prueba (si aplica).