@wondai/n8n-nodes-nucleo 0.6.3 → 0.6.5

package/README.md

@@ -66,6 +66,11 @@ alguma linha não traz `produto_id`/`alias` e `quantidade` positiva. É uma prot
 o Núcleo continua sendo a autoridade final das regras, mas o workflow não envia pedido vazio por
 erro de tool schema.
 
+A partir da v0.6.4, `Pedido Criar` e `Pedido Alterar` aceitam `Cobranças Comerciais (JSON)`.
+Use para adicionais pagos vindos de `Contexto -> commercial_rules`, por exemplo
+`[{"tipo":"paid_addon","nome":"Confetes","valor":35,"origem":"commercial_rules"}]`.
+Essas linhas entram no valor a cobrar, mas nao viram produto de catalogo nem pagamento.
+
 **Disponibilidade na Rede** ("tem na outra loja?") é exposta como **tool** do AI Agent, mas com regra
 estrita no prompt: **usar SÓ quando o cliente pedir explicitamente outra unidade**. Passe o `produto_id`
 já resolvido (ou uma `consulta` curta). A loja que pergunta vem do **vínculo do token** (a IA não
@@ -75,6 +80,11 @@ telefone/endereço (allowlist) e distância opcional. **Disponibilidade NÃO é
 declarou e oferece o contato para o cliente confirmar. Este endpoint **não** entra no contexto fixo do
 gate; é chamado sob demanda. Tenant/unidade vêm do token — nunca do prompt.
 
+A partir da v0.6.5, `Pedido Detalhar` aceita `Telefone do Cliente` opcional. Quando preenchido, o
+Nucleo so devolve o pedido se o telefone do cliente do pedido bater com esse valor. Use este campo no
+WhatsApp para perguntas como "meu pedido 61", evitando que o agente consulte pedido de outro cliente
+por numero curto.
+
 **Contexto -> Consultar por Escopo** deve ser usado como **AI Tool** dentro do agente, sob demanda.
 Passe `escopos` para buscar apenas o necessario:
 

package/dist/nodes/Nucleo/Nucleo.node.js

@@ -502,6 +502,15 @@ class Nucleo {
                     description: "Número curto (ex: 64) ou UUID do pedido. Devolve o pedido com itens e seus IDs. Pedido de outra padaria → 404.",
                     displayOptions: { show: { resource: ["pedido"], operation: ["detalhar"] } },
                 },
+                {
+                    displayName: "Telefone do Cliente",
+                    name: "pedidoTelefoneCliente",
+                    type: "string",
+                    default: "",
+                    placeholder: "555199999999",
+                    description: "Opcional. Quando informado, o Nucleo so devolve o pedido se ele pertencer ao cliente desse telefone. Use no WhatsApp para perguntas como 'meu pedido 61'.",
+                    displayOptions: { show: { resource: ["pedido"], operation: ["detalhar"] } },
+                },
                 // ----------------------------------------------------------------- pedido:criar
                 {
                     displayName: "Telefone",
@@ -603,6 +612,14 @@ class Nucleo {
                     description: "Opcional. Desconto concedido em reais (ex.: 5). Abate do valor a cobrar e do troco. 0/vazio = sem desconto.",
                     displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
                 },
+                {
+                    displayName: "Cobranças Comerciais (JSON)",
+                    name: "cobrancas",
+                    type: "json",
+                    default: "[]",
+                    description: 'Opcional. Array de cobranças comerciais que entram no valor a cobrar sem virar produto: [{"tipo":"paid_addon","nome":"Confetes","valor":35,"origem":"commercial_rules","operational_config_revision_id":"...","snapshot":{"label":"Confetes - R$35,00"}}]. Use quando vier de Contexto Loja/commercial_rules.',
+                    displayOptions: { show: { resource: ["pedido"], operation: ["criar"] } },
+                },
                 {
                     displayName: "Loja (unit_id)",
                     name: "unitId",
@@ -754,6 +771,14 @@ class Nucleo {
                     description: "Redefine o desconto (recalcula o valor a cobrar e o pagamento pendente). Ex.: 5. Vazio = não altera o desconto. Use 0 para zerar.",
                     displayOptions: { show: { resource: ["pedido"], operation: ["alterar"] } },
                 },
+                {
+                    displayName: "Cobranças Comerciais (JSON)",
+                    name: "cobrancasNovo",
+                    type: "json",
+                    default: "[]",
+                    description: 'Opcional. Substitui as cobranças comerciais do pedido. Envie [] para limpar. Ex.: [{"tipo":"paid_addon","nome":"Confetes","valor":35,"origem":"commercial_rules"}].',
+                    displayOptions: { show: { resource: ["pedido"], operation: ["alterar"] } },
+                },
                 {
                     displayName: "Motivo",
                     name: "motivo",
@@ -1278,8 +1303,12 @@ class Nucleo {
                 }
                 else if (resource === "pedido" && operation === "detalhar") {
                     const ref = this.getNodeParameter("ref", i).trim();
+                    const telefoneCliente = this.getNodeParameter("pedidoTelefoneCliente", i, "").trim();
                     method = "GET";
                     path = `/api/v1/agent/pedido/${encodeURIComponent(ref)}`;
+                    if (telefoneCliente) {
+                        path += `?telefone_cliente=${encodeURIComponent(telefoneCliente)}`;
+                    }
                 }
                 else if (resource === "pedido" && operation === "criar") {
                     const telefone = this.getNodeParameter("telefone", i).trim();
@@ -1294,6 +1323,7 @@ class Nucleo {
                     const trocoPara = Number(this.getNodeParameter("trocoPara", i, 0));
                     const taxaEntrega = Number(this.getNodeParameter("taxaEntrega", i, 0));
                     const desconto = Number(this.getNodeParameter("desconto", i, 0));
+                    const cobrancas = asArray(this.getNodeParameter("cobrancas", i, "[]"));
                     const unitId = this.getNodeParameter("unitId", i, "").trim();
                     idempotencyKey =
                         this.getNodeParameter("idempotencyKey", i, "").trim() || (0, node_crypto_1.randomUUID)();
@@ -1320,6 +1350,8 @@ class Nucleo {
                         b.taxa_entrega = taxaEntrega;
                     if (Number.isFinite(desconto) && desconto > 0)
                         b.desconto = desconto;
+                    if (cobrancas.length)
+                        b.cobrancas = cobrancas;
                     if (unitId)
                         b.unit_id = unitId;
                     method = "POST";
@@ -1342,6 +1374,7 @@ class Nucleo {
                     const trocoParaNovo = Number(this.getNodeParameter("trocoParaNovo", i, 0));
                     const taxaEntregaNova = this.getNodeParameter("taxaEntregaNova", i, "").trim();
                     const descontoNovo = this.getNodeParameter("descontoNovo", i, "").trim();
+                    const cobrancasNovo = asArray(this.getNodeParameter("cobrancasNovo", i, "[]"));
                     const b = {};
                     if (observacoes.trim())
                         b.observacoes = observacoes.trim();
@@ -1377,6 +1410,8 @@ class Nucleo {
                     if (descontoNovo !== "" && Number.isFinite(Number(descontoNovo))) {
                         b.desconto = Number(descontoNovo);
                     }
+                    if (cobrancasNovo.length)
+                        b.cobrancas = cobrancasNovo;
                     // Idempotência (opcional): mesma chave num retry → backend não reaplica a alteração.
                     idempotencyKey =
                         this.getNodeParameter("idempotencyKey", i, "").trim() || undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wondai/n8n-nodes-nucleo",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "description": "Node n8n para o Núcleo Wondai — atendimento de IA multi-vertical (gate liga/desliga, cliente/paciente, catálogo fuzzy, pedidos [padaria], procedimento/agenda/agendamento [odonto], contexto operacional, telemetria) com assinatura HMAC v1. Tenant e vertical vêm do token (a parede, ADR-013/038).",
   "keywords": [
     "n8n-community-node-package",