Granatum

Adicionando a fonte de dados

O Granatum é um software de gestão financeira para pequenas e médias empresas. A integração de dados do Granatum para o Data Warehouse criada pela Kondado possibilita que você tenha acesso aos seus dados financeiros na sua nuvem analítica.

Adicionando o conector

Para automatizar o ETL do Granatum com a Kondado para o seu banco de dados, siga os passos abaixo:

1) Faça login na sua conta do Granatum, vá em Configurações -> Minha Empresa -> Sidebar(API) e obtenha o "Access Token"

2) Na plataforma da Kondado, vá para a página de adicionar conectores e selecione o conector do Granatum

3) Dê um nome para o seu conector e, em "Token da API" cole a chave gerada no passo (1)

Agora basta salvar o conector e começar a integrar os seus dados do Granatum no Data Lake ou Data Warehouse.

Pipelines

Diagrama de relacionamento

Clique para expandir

Categorias

Tipo de replicacao: Integral

[pt] Categorias (plano de contas) usadas para classificar os lancamentos financeiros, organizadas de forma hierarquica (categorias e subcategorias). Grao: uma categoria.

Campo	Tipo
id	text	[pt] Identificador unico da categoria no Granatum.
descricao	text	[pt] Nome/descricao da categoria (plano de contas).
cor	text	[pt] Cor associada a categoria, em codigo hexadecimal (ex.: #232323), usada para identificacao visual.
wgi_usuario_id	text	[pt] Identificador do usuario Granatum associado a categoria.
parent_id	text	[pt] Identificador da categoria pai, quando a categoria e uma subcategoria. Vazio para categorias de primeiro nivel.

Centros de custo e lucro

Tipo de replicacao: Integral

[pt] Centros de custo e lucro usados para classificar lancamentos por area/departamento, organizados de forma hierarquica. Grao: um centro de custo/lucro.

Campo	Tipo
id	text	[pt] Identificador unico do centro de custo/lucro no Granatum.
descricao	text	[pt] Nome/descricao do centro de custo/lucro (ex.: area ou departamento).
parent_id	text	[pt] Identificador do centro de custo/lucro pai, quando este e um subcentro. Vazio para centros de primeiro nivel.

Clientes

Tipo de replicacao: Integral

[pt] Clientes cadastrados na conta Granatum, vinculados aos lancamentos de recebimento. Grao: um cliente.

Campo	Tipo
estado_id	text	[pt] Identificador do estado (UF) do endereco do cliente.
cidade_id	text	[pt] Identificador da cidade do endereco do cliente.
nome	text	[pt] Nome ou razao social do cliente.
nome_fantasia	text	[pt] Nome fantasia (nome comercial) do cliente.
bairro	text	[pt] Bairro do endereco do cliente.
cidade__nome	text	[pt] Nome da cidade do endereco do cliente.
observacao	text	[pt] Observacoes livres registradas sobre o cliente.
endereco_complemento	text	[pt] Complemento do endereco do cliente (ex.: sala, andar).
email	text	[pt] E-mail de contato do cliente.
endereco_numero	text	[pt] Numero do endereco do cliente.
telefone	text	[pt] Telefone de contato do cliente.
cep	text	[pt] CEP (codigo postal) do endereco do cliente.
endereco	text	[pt] Logradouro (rua/avenida) do endereco do cliente.
estado__sigla	text	[pt] Sigla (UF) do estado do endereco do cliente (ex.: SP, RJ).
estado__nome	text	[pt] Nome do estado do endereco do cliente.
id	text	[pt] Identificador unico do cliente no Granatum.
documento	text	[pt] Documento do cliente (CPF ou CNPJ).

Contas Bancárias

Tipo de replicacao: Integral

[pt] Contas financeiras (bancarias, caixa, aplicacoes) cadastradas na conta Granatum, usadas para registrar entradas e saidas. Grao: uma conta financeira.

Campo	Tipo
id	text	[pt] Identificador unico da conta financeira no Granatum.
descricao	text	[pt] Nome/descricao da conta financeira (ex.: nome do banco, caixa ou aplicacao).
saldo	float	[pt] Saldo atual da conta financeira, em reais (R$). Valor calculado a partir dos lancamentos.

Formas de pagamento

Tipo de replicacao: Integral

[pt] Formas de pagamento cadastradas e utilizadas nos lancamentos (ex.: dinheiro, boleto, transferencia). Grao: uma forma de pagamento.

Campo	Tipo
id	text	[pt] Identificador unico da forma de pagamento no Granatum.
descricao	text	[pt] Nome/descricao da forma de pagamento (ex.: Dinheiro, Boleto, Transferencia, Cartao).

Fornecedores

Tipo de replicacao: Integral

[pt] Fornecedores cadastrados na conta Granatum, vinculados aos lancamentos de pagamento. Grao: um fornecedor.

Campo	Tipo
estado_id	text	[pt] Identificador do estado (UF) do endereco do fornecedor.
cidade_id	text	[pt] Identificador da cidade do endereco do fornecedor.
nome	text	[pt] Nome ou razao social do fornecedor.
nome_fantasia	text	[pt] Nome fantasia (nome comercial) do fornecedor.
bairro	text	[pt] Bairro do endereco do fornecedor.
cidade__nome	text	[pt] Nome da cidade do endereco do fornecedor.
observacao	text	[pt] Observacoes livres registradas sobre o fornecedor.
endereco_complemento	text	[pt] Complemento do endereco do fornecedor (ex.: sala, andar).
email	text	[pt] E-mail de contato do fornecedor.
endereco_numero	text	[pt] Numero do endereco do fornecedor.
telefone	text	[pt] Telefone de contato do fornecedor.
cep	text	[pt] CEP (codigo postal) do endereco do fornecedor.
endereco	text	[pt] Logradouro (rua/avenida) do endereco do fornecedor.
estado__sigla	text	[pt] Sigla (UF) do estado do endereco do fornecedor (ex.: SP, RJ).
estado__nome	text	[pt] Nome do estado do endereco do fornecedor.
id	text	[pt] Identificador unico do fornecedor no Granatum.
documento	text	[pt] Documento do fornecedor (CPF ou CNPJ).

Lançamentos

Tipo de replicacao: Integral

Objeto principal

[pt] Lancamentos financeiros (contas a pagar e a receber) da conta Granatum. Cada linha e um lancamento individual de entrada ou saida. Grao: um lancamento.

Campo	Tipo
id	text	[pt] Identificador unico do lancamento financeiro no Granatum.
grupo_id	text	[pt] Identificador do grupo que reune lancamentos repetidos/parcelados gerados em conjunto (ex.: as parcelas de uma mesma operacao).
lancamento_transferencia_id	text	[pt] Identificador que vincula o par de lancamentos de uma transferencia entre contas financeiras (a saida em uma conta e a entrada na outra).
categoria_id	text	[pt] Identificador da categoria (plano de contas) em que o lancamento foi classificado. Referencia a tabela de categorias. Categorias > > id
centro_custo_lucro_id	text	[pt] Identificador do centro de custo/lucro associado ao lancamento. Referencia a tabela de centros de custo/lucro. Centros de custo e lucro > > id
tipo_custo_nivel_producao_id	text	[pt] Identificador do tipo de custo quanto ao nivel de producao (ex.: fixo ou variavel) atribuido ao lancamento. Tipos custo nível de produção > > id
tipo_custo_apropriacao_produto_id	text	[pt] Identificador do tipo de custo quanto a apropriacao ao produto (ex.: direto ou indireto) atribuido ao lancamento. Tipos custo apropriação de produto > > id
conta_id	text	[pt] Identificador da conta financeira em que o lancamento e movimentado. Referencia a tabela de contas. Contas Bancárias > > id
forma_pagamento_id	text	[pt] Identificador da forma de pagamento utilizada no lancamento. Referencia a tabela de formas de pagamento. Formas de pagamento > > id
pessoa_id	text	[pt] Identificador da pessoa vinculada ao lancamento: o cliente (em recebimentos) ou o fornecedor (em pagamentos). Clientes > > id Fornecedores > > id
tipo_lancamento_id	text	[pt] Tipo do lancamento: 1 = pagamento/despesa (conta a pagar); 2 = recebimento/receita (conta a receber).
descricao	text	[pt] Descricao do lancamento.
tipo_documento_id	text	[pt] Identificador do tipo de documento fiscal associado ao lancamento. Referencia a tabela de tipos de documento fiscal. Tipos documento fiscal > > id
documento	text	[pt] Numero/identificacao do documento (ex.: nota fiscal, boleto) vinculado ao lancamento.
data_vencimento	date	[pt] Data de vencimento do lancamento.
valor	float	[pt] Valor do lancamento, em reais (R$). Positivo para receitas/entradas e negativo para despesas/saidas.
data_pagamento	date	[pt] Data em que o lancamento foi efetivamente pago/recebido. Quando preenchida, indica que o lancamento esta quitado.
data_competencia	date	[pt] Data de competencia do lancamento (regime de competencia), correspondente a entrega do produto/servico.
observacao	text	[pt] Observacoes livres registradas no lancamento.
pagamento_automatico	boolean	[pt] Indica se o lancamento e marcado como pago automaticamente na data de vencimento (verdadeiro/falso).
numero_repeticao	float	[pt] Numero da repeticao/parcela do lancamento dentro do grupo de lancamentos repetidos.
total_repeticoes	float	[pt] Quantidade total de repeticoes/parcelas previstas para o grupo de lancamentos repetidos.
periodicidade	text	[pt] Periodicidade da repeticao do lancamento (ex.: D7 = semanal, D15 = quinzenal, M1 = mensal, M3 = trimestral, M6 = semestral, M12 = anual).
pedido_id	text	[pt] Identificador do pedido vinculado ao lancamento, quando originado de um pedido.
lancamento_composto_id	text	[pt] Identificador do lancamento composto que agrega varios itens/rateios em uma unica operacao.

Campo	Tipo
lancamento_id	text	[pt] Identificador do lancamento ao qual a tag esta associada. Referencia o lancamento na tabela de lancamentos.
tags__id	text	[pt] Identificador da tag (etiqueta) associada ao lancamento. Referencia a tabela de tags. Tags > > id

Campo	Tipo
id	text	[pt] Identificador unico da tag (etiqueta) no Granatum.
descricao	text	[pt] Nome/descricao da tag (etiqueta).
ativo	boolean	[pt] Indica se a tag esta ativa e disponivel para uso (verdadeiro/falso).

Tipos custo apropriação de produto

Tipo de replicacao: Integral

[pt] Tipos de custo quanto a apropriacao ao produto (ex.: custo direto ou indireto), usados para classificar lancamentos. Grao: um tipo de custo por apropriacao ao produto.

Campo	Tipo
id	text	[pt] Identificador unico do tipo de custo por apropriacao ao produto no Granatum.
descricao	text	[pt] Nome/descricao do tipo de custo quanto a apropriacao ao produto (ex.: Direto, Indireto).

Tipos custo nível de produção

Tipo de replicacao: Integral

[pt] Tipos de custo quanto ao nivel de producao (ex.: custo fixo ou variavel), usados para classificar lancamentos. Grao: um tipo de custo por nivel de producao.

Campo	Tipo
id	text	[pt] Identificador unico do tipo de custo por nivel de producao no Granatum.
descricao	text	[pt] Nome/descricao do tipo de custo quanto ao nivel de producao (ex.: Fixo, Variavel).

Tipos documento fiscal

Tipo de replicacao: Integral

[pt] Tipos de documento fiscal (ex.: nota fiscal, boleto, recibo) usados para classificar os lancamentos. Grao: um tipo de documento fiscal.

Campo	Tipo
id	text	[pt] Identificador unico do tipo de documento fiscal no Granatum.
descricao	text	[pt] Nome/descricao do tipo de documento fiscal (ex.: Nota Fiscal, Boleto, Recibo).

Notas

Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas

Integrar dados do Granatum via Kondado

Configure o conector do Granatum na Kondado para enviar dados financeiros ao seu Data Warehouse ou Data Lake.

Obter Access Token no Granatum

Faça login no Granatum, acesse Configurações → Minha Empresa → Sidebar(API) e copie o Access Token gerado para autenticação.

Adicionar conector na Kondado

Na plataforma Kondado, vá para a página de conectores, selecione o Granatum e dê um nome ao conector.

Configurar token e salvar

Cole o Token da API obtido no passo 1 no campo correspondente, salve o conector e inicie a integração de dados para o seu destino.

Definir frequência de sincronização

Ajuste a frequência das integrações para evitar execuções simultâneas e garantir a consistência dos dados financeiros no seu Data Warehouse.

Perguntas frequentes

O que é o Granatum e para que serve a integração com a Kondado?▼

O Granatum é um software de gestão financeira para pequenas e médias empresas. A integração com a Kondado permite centralizar seus dados financeiros em um Data Warehouse ou Data Lake, facilitando análises avançadas.

Quais dados do Granatum posso integrar pela Kondado?▼

Você pode integrar tabelas como Lançamentos (objeto principal), Contas Bancárias, Categorias, Clientes, Fornecedores, Centros de Custo e Lucro, Formas de Pagamento, Tags e outras entidades financeiras.

Como obtenho o Access Token para configurar o conector?▼

Acesse sua conta do Granatum, navegue até Configurações → Minha Empresa → Sidebar(API) e copie o Access Token disponível na seção. Este token será usado no campo "Token da API" na Kondado.

Posso usar os dados do Granatum em ferramentas de BI?▼

Sim. Após a integração, os dados podem ser consumidos em ferramentas de visualização e BI conectadas ao seu Data Warehouse, como opções disponíveis na Kondado.

Qual a recomendação sobre a frequência das integrações?▼

A Kondado recomenda definir a frequência de modo a evitar execuções de mais de uma integração ao mesmo tempo, garantindo performance e integridade dos dados sincronizados.

Escrito por

Thassyo Pereira·Publicado em 2020-06-12·Atualizado em 2026-06-01