CHEFMANAGER IA 3.6.0 · GUÍA DEL CONECTOR CLICKDELIVERY

OBJETIVO

Recibir pedidos externos en ChefManager, enviarlos a la sucursal y Cocina/KDS,
sincronizar el catálogo autorizado y devolver los cambios de estado.

CONFIGURACIÓN EN CHEFMANAGER

Integraciones > ClickDelivery:

- URL base HTTPS de la API.
- Token o credencial Bearer.
- Secreto de webhook HMAC SHA-256.
- Sucursal predeterminada.
- Confirmación automática de pedidos (recomendado: desactivada en homologación).
- Rutas de prueba, catálogo y estados.

WEBHOOK

ChefManager muestra una URL con esta forma:

  https://tu-dominio/clickdelivery-webhook.php?restaurant=ID

Autenticación admitida:

- X-ClickDelivery-Signature: sha256=FIRMA_HMAC
- Authorization: Bearer TOKEN

Ejemplo mínimo de creación de pedido:

{
  "event_id": "evt-10001",
  "event_type": "order.created",
  "external_order_id": "cd-9001",
  "order": {
    "id": "cd-9001",
    "branch_id": "sucursal-externa-1",
    "type": "delivery",
    "delivery_address": "Dirección del cliente",
    "delivery_fee": 10,
    "customer": {"name": "Cliente", "phone": "70000000"},
    "items": [
      {"product_id": "producto-externo-1", "sku": "SKU-LOCAL", "quantity": 2}
    ]
  }
}

REGLAS DE SEGURIDAD

- ChefManager ignora precios externos y recalcula con el catálogo local.
- Un producto inexistente, no publicado o no disponible detiene la importación.
- Un evento repetido no duplica pedidos.
- Un pedido pagado no se cancela automáticamente desde el proveedor.
- Cada consulta exige restaurant_id y valida sucursal/producto dentro del tenant.

HOMOLOGACIÓN OBLIGATORIA

El nombre ClickDelivery identifica el adaptador solicitado, no un contrato universal.
Antes de producción se debe comparar esta forma canónica con la documentación real
del proveedor y ajustar rutas, encabezados, estados y campos si fuera necesario.
