CHEFMANAGER IA 3.6.1 · CLICKDELIVERY
====================================

ACTIVACIÓN SEGURA

Configura en Integraciones > ClickDelivery:

- URL base HTTPS.
- Token Bearer.
- Secreto HMAC SHA-256 del webhook.
- Sucursal predeterminada activa.
- Rutas oficiales de prueba, catálogo y estados.

Mantén desactivadas durante homologación:

- Confirmación automática de pedidos.
- Fallback de sucursales externas sin mapear.
- Aceptación del estado de pago enviado por el proveedor.

CATÁLOGO

La sincronización entrega sucursales, productos, disponibilidad y precios por local,
variantes, grupos de opciones y valores. ClickDelivery debe devolver los identificadores
sin alterar precios. ChefManager IA vuelve a consultar el catálogo local antes de crear
cada pedido.

SUCURSALES

Si el evento incluye una sucursal externa, esta debe tener mapeo. Solo cuando el operador
activa conscientemente el fallback puede vincularse a la sucursal predeterminada. Nunca
se selecciona silenciosamente la primera sucursal del negocio.

VARIANTES Y OPCIONES

- Las variantes se resuelven por mapeo, ID sincronizado, SKU o nombre exacto.
- Las opciones se resuelven por mapeo, ID sincronizado o nombre exacto no ambiguo.
- Se validan grupos obligatorios, mínimos y máximos.
- Los precios externos se ignoran; el total se calcula con precios locales vigentes.
- Una variante u opción inválida detiene el pedido completo para evitar comandas erróneas.

PAGOS

El estado externo solo puede marcar el pedido como pagado cuando la opción correspondiente
está activada después de homologar firma y contrato. El sistema no degrada un pedido pagado
a no pagado y no permite cancelarlo automáticamente sin devolución.

REINTENTOS

Un event_id procesado no se duplica. Un evento fallido puede reenviarse con el mismo ID y
se intenta nuevamente. Un procesamiento interrumpido puede recuperarse después de cinco
minutos. Los intentos y errores quedan auditados.

RETENCIÓN

cron/cleanup.php elimina comprobantes procesados, ignorados o fallidos con más de 30 días,
reduciendo la retención innecesaria de nombres, teléfonos y direcciones.

HOMOLOGACIÓN

No actives el conector contra producción hasta comparar estas reglas con la documentación
oficial del proveedor y completar pruebas de creación, variantes, opciones, pago, cocina,
estado, entrega, cancelación, devolución, duplicados y reintentos.
