n8n-nodes-leodelivery-catalog

Node community do n8n (utilizável como Tool de IA) para o cadastro de cardápio (catálogo) do Léo Delivery: categorias, complementos/adicionais (modifiers), opções e produtos — com imagens. Mesmo estilo do pacote n8n-nodes-leodelivery-attendance.

Node: Léo Delivery Catalog (leoDeliveryCatalog)

usableAsTool: true — pode ser conectado direto no node AI Agent como ferramenta.

Operações

| Operation | Método/Endpoint (base: /v1/{merchantId}/catalog/management) | |---|---| | Get Full Catalog | GET / | | List Categories | GET /categories | | List Products | GET /products | | List Modifiers | GET /modifiers | | Create Category | POST /categories | | Create Modifier (Complemento) | POST /modifiers | | Create Modifier Option | POST /modifiers/{modifierId}/options | | Create Product | POST /products | | Update Product (Imagem) | PATCH /products/{productId} | | Update Modifier Option (Imagem) | PATCH /options/{optionId} | | Delete Product | DELETE /products/{productId} |

Cada operação recebe merchantId e, quando aplicável, modifierId / productId / optionId e um Payload (JSON) com o corpo conforme o schema do backend.

Reaproveitamento de complementos

Crie o complemento uma vez com Create Modifier e reutilize o modifierId em vários produtos via modifiers: [{ modifierId, required, minQuantity, maxQuantity, sequence }] no Create Product.

Imagens

ImageDto aceita base64 (não URL): { base64, contentType, extension }. Use Update Product / Update Modifier Option (ou o campo image no create) para anexar a foto.

Credencial: Léo Delivery System Auth API (leoDeliverySystemAuthApi)

Igual ao n8n-nodes-leodelivery-attendance: não pede login de usuário. O node reutiliza a credencial de sistema já existente (você seleciona a mesma "Léo Delivery System Auth account"). Ela guarda:

• Token — segredo HS256 usado para assinar o JWT de sistema
• Merchant API Base URL — ex.: https://api.leodelivery.com.br/app/merchant

O node assina um JWT user-type=SYSTEM (subject SYSTEM, validade 24h) e envia como Bearer.

Roles do token: o catálogo do merchant exige ROLE_EMPLOYEE. Como o backend monta as authorities a partir do claim roles e aceita o token quando user-type=SYSTEM, este node assina o token de sistema com roles: ['ROLE_SYSTEM', 'ROLE_EMPLOYEE']. Assim funciona sem login e sem alterar o backend. Se preferir manter só ROLE_SYSTEM, ajuste SYSTEM_TOKEN_ROLES em LeoDeliveryCatalog.helpers.ts e libere ROLE_SYSTEM nos endpoints de catálogo no core.

Este pacote não declara um novo tipo de credencial — ele referencia a credencial leoDeliverySystemAuthApi fornecida pelo pacote n8n-nodes-leodelivery-attendance. Mantenha os dois pacotes instalados.

Instalação (n8n self-hosted)

cd n8n-nodes-leodelivery-catalog
npm install        # já roda o build via prepare
npm run build      # opcional (rebuild)

Publicar/instalar como os demais nodes custom do Léo:

• Via npm privado/local: aponte o n8n para o pacote (N8N_CUSTOM_EXTENSIONS ou ~/.n8n/custom), ou
• npm publish e instalar em Settings → Community nodes no n8n.

Após instalar, reinicie o n8n. O node aparece como Léo Delivery Catalog e pode ser arrastado para o campo Tool do AI Agent.

Uso no agente (substituindo os HTTP Request Tools)

No workflow "Léo Delivery - Cadastro de Cardápio por IA (Visão)", troque os 6 HTTP Request Tools por instâncias do Léo Delivery Catalog (uma por operação), todas selecionando a credencial Léo Delivery System Auth API já existente. Assim o agente cria todo o catálogo com um único node de ferramentas, sem montar URLs/headers e sem login de usuário.

Estrutura

nodes/LeoDeliveryCatalog/LeoDeliveryCatalog.node.ts
nodes/LeoDeliveryCatalog/LeoDeliveryCatalog.helpers.ts
nodes/LeoDeliveryCatalog/leo-delivery.svg
index.ts

A credencial leoDeliverySystemAuthApi vem do pacote n8n-nodes-leodelivery-attendance.