n8n-nodes-api-shopping-cart-comsis

Este proyecto es un nodo comunitario personalizado para n8n, diseñado para interactuar con una API de Shopping Cart & WMS (Warehouse Management System).

Su principal característica es que está optimizado para Agentes de IA. Todas las operaciones incluyen descripciones semánticas en inglés que permiten a los LLMs (como GPT-4, Claude, etc.) entender cuándo y cómo utilizar cada herramienta dentro de un flujo de n8n.

Funcionalidades

El nodo agrupa las operaciones en 4 recursos principales:

1. Catalog (Catálogo)

• Get Menu: Obtiene la estructura jerárquica del menú.
• List Products: Búsqueda plana de productos (útil para encontrar IDs).
• Get Product Details: Consulta de precios y stock específico.

2. Cart & Session (Carrito)

• Create/Get Session: Inicia una sesión de usuario (requerido para "vender").
• Add to Cart: Agrega productos al carrito activo.
• Get Cart Content: Consulta el estado actual del carrito.

3. Orders (Pedidos)

• Checkout (Create Order): Finaliza la compra, genera la orden y descuenta inventario.
• Get Order Details: Consulta información de una orden histórica.

4. Inventory (WMS)

• Check Stock: Verificación detallada de existencias.
• Procurement: Genera listas de reabastecimiento automático basadas en stock mínimo.
• Planning Calculator: Calcula insumos necesarios para producción masiva.

Requisitos

• Node.js y npm instalados.
• Una instancia de n8n (local o self-hosted).
• Acceso a la API backend del sistema de Shopping Cart.

Instalación y Desarrollo

Sigue estos pasos para instalar el nodo en tu entorno local de n8n:

1. Instalar dependencias y compilar:

   npm install
   npm run build

2. Enlazar a n8n (Local): Si tienes n8n instalado globalmente o estás desarrollando localmente:

   # En la carpeta de este proyecto
   npm link
   
   # En la carpeta donde reside tu instalación de n8n (o ~/.n8n/custom)
   npm link n8n-nodes-api-shopping-cart-comsis

3. Iniciar n8n:

   n8n start

Configuración

En el editor de n8n:

1. Busca el nodo Shopping Cart & WMS.
2. En "Credentials", selecciona Create New -> Shopping Cart API Auth.
3. Ingresa los datos de conexión:
   • Base URL: La dirección de tu API (ej. http://localhost:14420 o tu dominio en producción).
   • API Key: La clave para el header x-api-key.

Uso con Agentes de IA

Al agregar este nodo como una "Tool" en un flujo de AI Agent en n8n, el modelo leerá automáticamente las descripciones de las operaciones (definidas en inglés en el código) para decidir qué acción tomar según el input del usuario.