Nó Granatum

O nó de workflow Granatum chama a Granatum API — plataforma brasileira de gestão financeira para fluxo de caixa, lançamentos, centros de custo e contas bancárias. Ideal quando workflows precisam ler ou gravar dados financeiros junto com automação de vendas e CRM.

Node ID no editor: granatum_request
Base URL: https://api.granatum.com.br/v1/
Auth: Authorization: Bearer {{granatum_access_token}}

O que faz

• Envia requisições REST para Granatum API v1
• Suporta GET, POST, PUT e DELETE
• Retorna status, data e headers
• Inclui templates de operação para lançamentos, centros de custo e contas

Pré-requisitos

1. Conta Granatum com acesso à API
2. Access token das configurações Granatum API (OAuth ou personal access token — conforme seu plano Granatum)
3. Integration key granatum_access_token em Configurações → API Keys

O Granatum foca em gestão financeira, não fluxos completos de pedido/NF-e de ERP. Combine com Tiny, Bling ou Omie quando precisar de automação operacional e financeira.

Como configurar

Passo 1 — Definir credenciais

1. Gere ou copie seu Granatum API access token
2. Em Configurações → API Keys, adicione:
   • Name: granatum_access_token
   • Value: seu Granatum bearer token

O template de header padrão envia Authorization: Bearer {{granatum_access_token}}.

Passo 2 — Adicionar o nó

Arraste Granatum da paleta ERP para o canvas e escolha operação ou configure endpoint customizado.

Passo 3 — Configurar a requisição

Operações pré-construídas

Exemplo — listar lançamentos (GET)

• URL: https://api.granatum.com.br/v1/lancamentos
• Method: GET
• Body: deixe vazio

Adicione query parameters na URL para filtragem (confirme params suportados na documentação Granatum), ex.:

https://api.granatum.com.br/v1/lancamentos?data_inicio=2026-01-01&data_fim=2026-01-31

Exemplo — criar lançamento (POST)

• URL: https://api.granatum.com.br/v1/lancamentos
• Method: POST
• Body:

{
  "data_vencimento": "2026-02-15",
  "valor": {{variables.invoice_amount}},
  "centro_custo_lucro_id": {{variables.cost_center_id}},
  "descricao": "Order {{variables.order_id}} — {{contact.name}}",
  "conta_id": {{variables.granatum_account_id}}
}

Ajuste campos conforme requisitos Granatum API — execute Buscar centros de custo e Buscar contas primeiro para resolver IDs válidos.

Passo 4 — Usar dados da resposta

{{granatum_1.data}}
{{granatum_1.status}}

Inspecione saída de execução para estrutura array vs. object — endpoints de listagem retornam coleções processáveis com Loop.

Saídas do nó

Dicas e boas práticas

• Resolva IDs antes de criar lançamentos — execute Buscar contas e Buscar centros de custo uma vez, armazene IDs em workflow variables ou configurações da company
• Use descrições com refs externas — inclua order ID ou CRM card ID em descricao para conciliação
• Formato de data — use YYYY-MM-DD para data_vencimento a menos que docs Granatum especifiquem outro formato
• Combine com nós de pagamento — após Asaas ou Stripe confirmar pagamento, crie lançamento Granatum para contabilidade
• Conciliação agendada — GET /lancamentos diário comparado com recebíveis ERP detecta divergências cedo
• Segurança do token — rotacione tokens Granatum periodicamente e atualize granatum_access_token em API Keys
• Não substitui nós ERP de pedidos — use Tiny, Bling ou Omie para pedidos e NF-e; Granatum para financeiro

Exemplos de uso

Registrar recebível quando pedido é faturado

1. Webhook — evento ERP NF-e emitida com valor e cliente
2. Granatum — Buscar centros de custo (cache ID em variable se estático)
3. Granatum — Criar lançamento com vencimento e valor
4. Send WhatsApp — instruções de pagamento ao cliente

Resumo diário de fluxo de caixa ao gerente

1. Schedule — 8h em dias úteis
2. Granatum — Buscar lançamentos com filtro de data de hoje na URL
3. JavaScript — somar entradas/saídas
4. Send WhatsApp — resumo ao gerente financeiro

Sincronizar centros de custo para relatórios

1. Schedule — semanal
2. Granatum — Buscar centros de custo
3. Set variable ou atualizar tabela de lookup interna para outros workflows

Marcar pago após webhook do gateway

1. Webhook — confirmação do gateway de pagamento
2. Granatum — GET lançamento por referência (URL/filtro customizado)
3. Granatum — PUT para atualizar status (conforme Granatum API)
4. CRM update — marcar negócio como pago

FAQ

Por que 401 Unauthorized?
granatum_access_token inválido ou expirado. Regenere no Granatum e atualize API Keys.

O Granatum emite NF-e ou gerencia estoque?
Não — Granatum é gestão financeira. Use Tiny, Bling ou Omie para tarefas operacionais de ERP.

Como encontro centro_custo_lucro_id e conta_id válidos?
Execute operações Buscar centros de custo e Buscar contas e leia IDs de data.

Posso filtrar lançamentos por status?
Adicione query parameters na URL GET conforme documentação Granatum API.

Isso difere do nó HTTP?
Mesmo executor, com base URL Granatum, template Bearer auth e agrupamento na paleta ERP.

O Granatum suporta webhooks?
Consulte recursos atuais da API Granatum. Se disponível, aponte webhooks para workflow Webhook WhatsWave.

Referência da API

Endpoints (dos templates de operação)

Relacionado

• Visão geral de ERP
• Nós de pagamentos — criação de cobranças
• Nó HTTP
• Variáveis no workflow
• Como testar e depurar um workflow