API para Integração com Financeiro

Introdução

API para integração com o Granatum Financeiro

Configuração

Seguem regras de configuração para o uso da API:

Header "User-Agent"

O header User-Agent deve ser enviado em todas as requisições. Muitas bibliotecas de integração já adicionam esse header automaticamente. Caso a sua implementação não faça isso, inclua manualmente um identificador, substituindo MeuAplicativo pelo nome do seu sistema:
- User-Agent: MeuAplicativo/1.0
Header "Content-Type"

O header Content-Type é obrigatório em todas as requisições que enviam dados, como POST e PUT. Para os demais métodos (como GET e DELETE), o uso desse header é opcional.
- Content-Type: application/x-www-form-urlencoded
Limites de Requisições (Rate Limiting)

Para garantir a segurança e a disponibilidade do serviço para todos os usuários, aplicamos limites de requisições à API. Recomendamos implementar regras de throttling na sua aplicação para evitar bloqueios automáticos.

Os limites são:
- 100 requisições por minuto
- 200 requisições a cada 5 minutos

Autenticação

Para ocorrer a comunicação com a API será necessário utilizar o Access Token.

Esse token está disponível no Granatum dentro de Configurações -> Minha Empresa -> Sidebar(API). Apenas usuários com o perfil Super admin possuem acesso a essa tela.

Todas as requisições devem ter obrigatoriamente o Access Token na Query String para funcionar.

Lançamentos

Criar um lançamento

Cria um lançamento que pode ser uma Conta a Pagar (despesa) ou uma Conta a Receber (receita).

Método e URL

POST https://api.granatum.com.br/v1/lancamentos

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Descrição do lançamento	String	Requerido
conta_id	ID da conta bancária	Integer	Requerido
categoria_id	ID da categoria	Integer	Requerido
valor	Use negativo para despesa e positivo para receita. Ex.: -10.00 e 10.00	Decimal	Requerido
data_vencimento	Data de vencimento do lançamento	String	Requerido
data_pagamento	Data do pagamento. Indica que o lançamento está pago	String	Opcional
data_competencia	Data da competência. Data que indica a prestação do serviço ou a venda do produto.	String	Opcional
centro_custo_lucro_id	ID do centro de custo e lucro	Integer	Opcional
forma_pagamento_id	ID da forma de pagamento	Integer	Opcional
pessoa_id	ID do cliente no caso de Receita e ID do fornecedor no caso de Despesa	Integer	Opcional
tipo_documento_id	ID do tipo de documento	Integer	Opcional
documento	Número do documento	String	Opcional
tipo_custo_nivel_producao_id	Envia a ID de um tipo custo nivel produção	Integer	Opcional
tipo_custo_apropriacao_produto_id	Envia a ID de um tipo custo apropriação produto	Integer	Opcional
tags[][id]	ID da tag, pode ser passado uma lista de tags	Array[{id:Integer}]	Opcional
periodicidade	Periodicidade da repetição: D7 - Semanal D15 - Quinzenal M1 - Mensal M2 - Bimestral M3 - Trimestral M6 - Semestral M12 - Anual	String	Opcional
total_repeticoes	Número de vezes que o lançamento será repetido *O valor deve ser sempre NULL se o campo infinito estiver definido como TRUE	Integer	Opcional
infinito	Caso a repetição não tenha data para acabar, valor padrão é FALSE *O valor deve ser sempre FALSE se o campo total_repeticoes estiver definido	Boolean	Opcional
observacao	Observação do lançamento	String	Opcional
pagamento_automatico	Dar baixa automática do lançamento na data de vencimento, valor padrão é FALSE	Boolean	Opcional
identificador_externo	Identificador do lançamento em outro sistema	String	Opcional
itens_adicionais[]	Itens adicionais para criar lançamento composto *Ver parâmetros na tabela abaixo	Array	Opcional

Paramêtros dos itens_adicionais

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Descrição do item	String	Requerido
categoria_id	ID da categoria	Integer	Requerido
valor	Use negativo para despesa e positivo para receita. Ex.: -10.00 e 10.00	Decimal	Requerido
centro_custo_lucro_id	ID do centro de custo e lucro	Integer	Opcional
forma_pagamento_id	ID da forma de pagamento	Integer	Opcional
pessoa_id	ID do cliente no caso de Receita e ID do fornecedor no caso de Despesa	Integer	Opcional
tipo_custo_nivel_producao_id	Envia a ID de um tipo custo nivel produção	Integer	Opcional
tipo_custo_apropriacao_produto_id	Envia a ID de um tipo custo apropriação produto	Integer	Opcional
identificador_externo	Identificador do lançamento em outro sistema	String	Opcional
tags[][id]	ID da tag, pode ser passado uma lista de tags	Array[{id:Integer}]	Opcional

Exemplo de chamada

curl -i -X POST \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'descricao=Conta de luz' \
  -d 'valor=123.92' \
  -d 'data_vencimento=2015-10-10' \
  -d 'tipo_lancamento_id=1' \
  -d 'conta_id=8' \
  -d 'categoria_id=98' \
  -d 'tags[][id]=12' \
  -d 'tags[][id]=34' \
  -d 'itens_adicionais[][descricao]=Conta de água' \
  -d 'itens_adicionais[][valor]=321.00' \
  -d 'itens_adicionais[][categoria_id]=50' \
  -d 'itens_adicionais[][tags][][id]=25' \
  'https://api.granatum.com.br/v1/lancamentos?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 91,
  "grupo_id": null,
  "lancamento_transferencia_id": null,
  "categoria_id": 98,
  "centro_custo_lucro_id": null,
  "tipo_custo_nivel_producao_id": null,
  "tipo_custo_apropriacao_produto_id": null,
  "conta_id": 8,
  "forma_pagamento_id": null,
  "pessoa_id": null,
  "tipo_lancamento_id": 2,
  "descricao": "Conta de luz",
  "tipo_documento_id": null,
  "documento": "",
  "data_vencimento": "2015-10-10",
  "valor": "123.92",
  "data_pagamento": null,
  "data_competencia": "2015-10-10",
  "observacao": "",
  "pagamento_automatico": false,
  "numero_repeticao": 1,
  "total_repeticoes": 1,
  "periodicidade": null,
  "pedido_id": null,
  "lancamento_composto_id": 21,
  "modified": "2016-04-29 04:53:25",
  "anexos": [
    {"id": 3},
    {"id": 4}
  ],
  "tags": [
    {"id": 12},
    {"id": 34}
  ],
  "itens_adicionais": [
    {"id": 92, "descricao": "Conta de água", "valor": "321.00", "categoria_id": 50, "lancamento_composto_id": 21 ...
      "tags": [
        {"id": 25}
      ]
    }
  ]
}

Editar um lançamento

Altera os dados do lançamento informado pelo ID.

Método e URL

PUT https://api.granatum.com.br/v1/lancamentos/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Descrição do lançamento	String	Opcional
conta_id	ID da conta bancária	Integer	Opcional
categoria_id	ID da categoria	Integer	Opcional
valor	Use negativo para despesa e positivo para receita. Ex.: -10.00 e 10.00	Decimal	Opcional
data_vencimento	Data de vencimento do lançamento	String	Opcional
data_pagamento	Data do pagamento. Indica que o lançamento está pago	String	Opcional
data_competencia	Data da competência. Data que indica a prestação/contratação do serviço ou a venda/compra do produto.	String	Opcional
centro_custo_lucro_id	ID do centro de custo e lucro	Integer	Opcional
forma_pagamento_id	ID da forma de pagamento	Integer	Opcional
pessoa_id	ID do cliente no caso de Receita e ID do fornecedor no caso de Despesa	Integer	Opcional
tipo_documento_id	ID do tipo de documento	Integer	Opcional
documento	Número do documento	String	Opcional
tipo_custo_nivel_producao_id	Envia a ID de um tipo custo nivel produção	Integer	Opcional
tipo_custo_apropriacao_produto_id	Envia a ID de um tipo custo apropriação produto	Integer	Opcional
tags[][id]	ID da tag, pode ser passado uma lista de tags	Array[{id:Integer}]	Opcional
periodicidade	Periodicidade da repetição: D7 - Semanal D15 - Quinzenal M1 - Mensal M2 - Bimestral M3 - Trimestral M6 - Semestral M12 - Anual	String	Opcional
total_repeticoes	Número de vezes que o lançamento será repetido *O valor deve ser sempre NULL se o campo infinito estiver definido como TRUE	Integer	Opcional
infinito	Caso a repetição não tenha data para acabar, valor padrão é FALSE *O valor deve ser sempre FALSE se o campo total_repeticoes estiver definido	Boolean	Opcional
observacao	Observação do lançamento	String	Opcional
pagamento_automatico	Dar baixa automática do lançamento na data de vencimento, valor padrão é FALSE	Boolean	Opcional
identificador_externo	Identificador do lançamento em outro sistema	String	Opcional
propagar_alteracao	Propagar as alterações para as próximas parcelas, valor padrão é FALSE	Boolean	Opcional
itens_adicionais[]	Itens adicionais para criar lançamento composto Ver parâmetros na tabela abaixo Caso você esteja editando um lançamento composto, é necessário sempre passar todos os itens	Array	Opcional*
itens_excluir[][id]	IDs dos itens a excluir	Array[{id:Integer}]	Opcional*

*Caso você esteja editando um lançamento composto, é necessário sempre passar todos os itens considerando os campo itens_adicionais e itens_excluir

Paramêtros dos itens_adicionais

Campo	Descrição	Tipo	Obrigatoriedade
id	ID do item	Integer	Requerido
descricao	Descrição do item	String	Requerido
categoria_id	ID da categoria	Integer	Requerido
valor	Use negativo para despesa e positivo para receita. Ex.: -10.00 e 10.00	Decimal	Requerido
centro_custo_lucro_id	ID do centro de custo e lucro	Integer	Opcional
forma_pagamento_id	ID da forma de pagamento	Integer	Opcional
pessoa_id	ID do cliente no caso de Receita e ID do fornecedor no caso de Despesa	Integer	Opcional
tipo_custo_nivel_producao_id	Envia a ID de um tipo custo nivel produção	Integer	Opcional
tipo_custo_apropriacao_produto_id	Envia a ID de um tipo custo apropriação produto	Integer	Opcional
identificador_externo	Identificador do lançamento em outro sistema	String	Opcional
tags[][id]	ID da tag, pode ser passado uma lista de tags	Array[{id:Integer}]	Opcional

Exemplo de chamada

curl -i -X PUT \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'data_vencimento=2015-10-18' \
  -d 'itens_adicionais[][id]=92' \
  -d 'itens_adicionais[][descricao]=Tarifa extra' \
  'https://api.granatum.com.br/v1/lancamentos/91?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 91,
  "grupo_id": null,
  "lancamento_transferencia_id": null,
  "categoria_id": 98,
  "centro_custo_lucro_id": null,
  "tipo_custo_nivel_producao_id": null,
  "tipo_custo_apropriacao_produto_id": null,
  "conta_id": 8,
  "forma_pagamento_id": null,
  "pessoa_id": null,
  "tipo_lancamento_id": 2,
  "descricao": "Conta de luz",
  "tipo_documento_id": null,
  "documento": "",
  "data_vencimento": "2015-10-18",
  "valor": "123.92",
  "data_pagamento": null,
  "data_competencia": "2015-10-10",
  "observacao": "",
  "pagamento_automatico": false,
  "numero_repeticao": 1,
  "total_repeticoes": 1,
  "periodicidade": null,
  "pedido_id": null,
  "lancamento_composto_id": 21,
  "modified": "2016-04-29 04:53:25",
  "anexos": [],
  "tags": [],
  "itens_adicionais": [
    {"id": 92, "descricao": "Tarifa extra", "valor": "321.00", "categoria_id": 50, "lancamento_composto_id": 21 ...}
  ]
}

Listar lançamentos

Lista todos lançamentos

Método e URL

GET https://api.granatum.com.br/v1/lancamentos

Substitua inclusive os colchetes

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
conta_id	ID da Conta Bancária	Integer	Requerido
pessoa_id	ID do cliente no caso de Receita e ID do fornecedor no caso de Despesa *Caso o campo pessoa_id seja informado, não é necessário passar a conta_id	Integer	Opcional
classificacao_id	ID da classificação de clientes ou de fornecedores *Caso o campo classificacao_id seja informado, não é necessário passar a conta_id	Integer	Opcional
grupo_id	ID de agrupamento da repetição dos Lançamentos	Integer	Opcional
numero_repeticao	Filtra pelo número da parcela no grupo de repetição informado. *Obrigatório informar grupo_id	Integer	Opcional
lancamento_composto_id	ID de agrupamento dos itens de um lançamento	Integer	Opcional
categoria_id	ID da categoria	Integer	Opcional
centro_custo_lucro_id	ID do centro de custo e lucro	Integer	Opcional
forma_pagamento_id	ID da Forma de Pagamento	Integer	Opcional
tipo_documento_id	ID do tipo de documento	Integer	Opcional
documento	Busca exata no campo documento	String	Opcional
tag_id	ID da tag. Para filtrar as tags, é possível utilizar operadores lógicos na consulta: Para operador "OU": informar os ids de tags separados por "\|", ficando "1\|2\|3" Para operador "E": informar os ids de tags separados por "&", ficando "1&2&3"	String	Opcional
data_inicio	Data de início para filtro da data conforme o regime	String	Opcional
data_fim	Data de fim para filtro da data conforme o regime *Sempre informar as duas datas para o filtro funcionar	String	Opcional
modificado_apos	Busca lançamentos criados e/ou modificados após a data informada *Aceita no formato AAAA-MM-DD ou AAAA-MM-DD HH:MM:SS	String	Opcional
excluido_apos	Retorna apenas lançamentos excluídos após a data/hora especificada. *Formato: YYYY-MM-DD HH:MM:SS (ex: 2026-01-01 00:00:00)	String	Opcional
regime	Define qual data considerar nos filtros de data_inicio e data_fim, o valor padrão é caixa: caixa: Considerara a data de vencimento para lançamentos em aberto ou data de pagamento para lançamentos consolidados competencia: Considera a data de competência	String	Opcional
busca	Realiza busca aproximada no valor, descrição, observação e nome de cliente/fornecedor	String	Opcional
identificador_externo	Identificador do lançamento em outro sistema	String	Opcional
tipo	Filtra o tipo de lançamento: P: Lancamentos a pagar R: Lançamentos a receber LP: Lancamentos pagos LR: Lançamentos recebidos PA: Lancamentos a pagar atrasados RA: Lançamentos a receber atrasados DT: Desconsiderar transferências ST: Transferências	String	Opcional
tipo_view	Formato do retorno dos dados: list: lista simples com o ID e descrição de cada lançamento count: número de lançamentos encontrados com base nos filtros detail: lista completa dos lancamentos as informação relacionadas (conta, categoria, cliente, fornecedor, etc.) detalhadas, ideal para integração com BI Se não enviar esse parâmetro, a lista de lançamentos será completa com todos os dados	String	Opcional
group_by	Agrupamento de dados grupo_id: retorna a listagem com todos os lançamentos simples e apenas a menor parcela de cada grupo de repetição, considerando sempre a menor repetição encontrada dentro do período filtrado	String	Opcional
limit	Indica o número de registros por página. o padrão é 50 registros e limite máximo é 500.	Integer	Opcional
created_wgi_usuario_id	Filtro pelo ID do usuário que criou o lançamento.	Integer	Opcional
start	Indica o offset da paginação. Ex.: Para pegar o registros de 151 à 200 use: start=150&limit=50	Integer	Opcional

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/lancamentos?access_token=token_cliente_granatum&conta_id=[conta_bancaria_id]'

Exemplo de resposta

[{
  "id": 91,
  "grupo_id": null,
  "lancamento_transferencia_id": null,
  "categoria_id": 98,
  "centro_custo_lucro_id": null,
  "tipo_custo_nivel_producao_id": null,
  "tipo_custo_apropriacao_produto_id": null,
  "conta_id": 8,
  "forma_pagamento_id": null,
  "pessoa_id": null,
  "descricao": "Conta de luz",
  "tipo_documento_id": null,
  "documento": "",
  "data_vencimento": "2015-10-10",
  "valor": "-123.92",
  "data_pagamento": null,
  "data_competencia": "2015-10-10",
  "observacao": "",
  "pagamento_automatico": false,
  "numero_repeticao": 1,
  "total_repeticoes": 1,
  "periodicidade": null,
  "pedido_id": null,
  "lancamento_composto_id": null,
  "modified": "2016-04-29 04:53:25",
  "anexos": [
    {"id": 3},
    {"id": 4}
  ],
  "tags": [
    {"id": 12},
    {"id": 34}
  ],
  "itens_adicionais": [
    {"id": 92, "descricao": "Tarifa extra", "valor": "321.00", "categoria_id": 50, "lancamento_composto_id": 21 ...}
  ]
}]

Consultar um lançamento

Retorna os dados do lançamento informado pelo ID.

Método e URL

GET https://api.granatum.com.br/v1/lancamentos/:id

Substitua inclusive os colchetes

Query String

access_token=[token_cliente_granatum]

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/lancamentos/91?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 91,
  "grupo_id": null,
  "lancamento_transferencia_id": null,
  "categoria_id": 98,
  "centro_custo_lucro_id": null,
  "tipo_custo_nivel_producao_id": null,
  "tipo_custo_apropriacao_produto_id": null,
  "conta_id": 8,
  "forma_pagamento_id": null,
  "pessoa_id": null,
  "descricao": "Conta de luz",
  "tipo_documento_id": null,
  "documento": "",
  "data_vencimento": "2015-10-18",
  "valor": "-123.92",
  "data_pagamento": null,
  "data_competencia": "2015-10-10",
  "observacao": "",
  "pagamento_automatico": false,
  "numero_repeticao": 1,
  "total_repeticoes": 1,
  "periodicidade": null,
  "pedido_id": null,
  "lancamento_composto_id": null,
  "modified": "2016-04-29 04:53:25",
  "anexos": [
    {"id": 3},
    {"id": 4}
  ],
  "tags": [
    {"id": 12},
    {"id": 34}
  ],
  "itens_adicionais": [
    {"id": 92, "descricao": "Tarifa extra", "valor": "321.00", "categoria_id": 50, "lancamento_composto_id": 21 ...}
  ]
}

Excluir um lançamento

Remove do sistema o lançamento informado pelo ID.

Método e URL

DELETE https://api.granatum.com.br/v1/lancamentos/:id

Substitua inclusive os colchetes

Query String

access_token=[token_cliente_granatum]

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
excluir_proximos	Excluir este lançamento e os próximos da repetição	Boolean	Opcional
excluir_pagos	Excluir também os lançamentos futuros já pagos da repetição *Funciona apenas com o campo excluir_proximos=true	Boolean	Opcional

Exemplo de chamada

curl -i -X DELETE \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/lancamentos/91?access_token=token_cliente_granatum'

Exemplo de chamada com exclusão de próximas parcelas

curl -i -X DELETE \
-H "Content-Type:application/x-www-form-urlencoded" \
'https://api.granatum.com.br/v1/lancamentos/91?excluir_proximos=true&excluir_pagos=true&access_token=token_cliente_granatum'

Exemplo de resposta

true

Transferências

Criar uma transferência

Cria dois lançamentos relacionados entre si através do campo lancamento_transferencia_id, indicando a transferência de uma conta para a outra.

Método e URL

POST https://api.granatum.com.br/v1/transferencias

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Descrição da transferência	String	Requerido
valor	Use no formato 10.00, o valor sempre deve ser positivo	Decimal	Requerido
data	Data da transferência, caso a data seja no futuro, ela ficará agendada e com a baixa automática no dia do vencimento	String	Requerido
conta_origem_id	ID da conta bancária de origem do dinheiro	Integer	Requerido
conta_destino_id	ID da conta bancária de destino do dinheiro	Integer	Requerido
identificador_externo_origem	Identificador do lançamento em outro sistema	String	Opcional
identificador_externo_destino	Identificador do lançamento em outro sistema	String	Opcional

Exemplo de chamada

curl -i -X POST \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'descricao=Transferência entre contas' \
  -d 'valor=123.92' \
  -d 'data=2018-06-12' \
  -d 'conta_origem_id=8' \
  -d 'conta_destino_id=9' \
  'https://api.granatum.com.br/v1/transferencias?access_token=token_cliente_granatum'

Exemplo de resposta

[{
  "id": 91,
  "lancamento_transferencia_id": 92,
  "categoria_id": 98,
  "conta_id": 8,
  "tipo_lancamento_id": 2,
  "descricao": "Transferência entre contas",
  "data_vencimento": "2018-06-12",
  "valor": "123.92",
  "anexos":[],
  "data_pagamento": "2018-06-12",
  "data_competencia": "2018-06-12",
},{
  "id": 92,
  "lancamento_transferencia_id": 91,
  "categoria_id": 98,
  "conta_id": 9,
  "tipo_lancamento_id": 1,
  "descricao": "Transferência entre contas",
  "data_vencimento": "2018-06-12",
  "valor": "-123.92",
  "anexos":[],
  "data_pagamento": "2018-06-12",
  "data_competencia": "2018-06-12",
}]

Editar uma transferência

Altera os dados da transferência informada pelo ID, o ID pode ser qualquer um dos dois lançamentos relacionados.

Método e URL

PUT https://api.granatum.com.br/v1/transferencias/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Descrição da transferência	String	Requerido
valor	Use no formato 10.00, o valor sempre deve ser positivo	Decimal	Requerido
data	Data da transferência, caso a data seja no futuro, ela ficará agendada e com a baixa automática no dia do vencimento	String	Requerido
conta_origem_id	ID da conta bancária de origem do dinheiro	Integer	Requerido
conta_destino_id	ID da conta bancária de destino do dinheiro	Integer	Requerido
identificador_externo_origem	Identificador do lançamento em outro sistema	String	Opcional
identificador_externo_destino	Identificador do lançamento em outro sistema	String	Opcional

Exemplo de chamada

curl -i -X PUT \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'descricao=Transferência de valores' \
  -d 'data=2018-06-10' \
  'https://api.granatum.com.br/v1/transferencias/91?access_token=token_cliente_granatum'

Exemplo de resposta

[{
  "id": 91,
  "lancamento_transferencia_id": 92,
  "categoria_id": 98,
  "conta_id": 8,
  "tipo_lancamento_id": 2,
  "descricao": "Transferência de valores",
  "data_vencimento": "2018-06-10",
  "valor": "123.92",
  "anexos":[
    {
      "id": 86
    }
  ],
  "data_pagamento": "2018-06-10",
  "data_competencia": "2018-06-10",
},{
  "id": 92,
  "lancamento_transferencia_id": 91,
  "categoria_id": 98,
  "conta_id": 9,
  "tipo_lancamento_id": 1,
  "descricao": "Transferência de valores",
  "data_vencimento": "2018-06-10",
  "valor": "-123.92",
  "anexos":[
    {
      "id": 86
    }
  ],
  "data_pagamento": "2018-06-10",
  "data_competencia": "2018-06-10",
}]

Consultar uma transferência

Retorna os lançamentos da transferência informada pelo ID, o ID pode ser qualquer um dos dois lançamentos relacionados.

Método e URL

GET https://api.granatum.com.br/v1/transferencias/:id

Substitua inclusive os colchetes

Query String

access_token=[token_cliente_granatum]

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/transferencias/91?access_token=token_cliente_granatum'

Exemplo de resposta

[{
  "id": 91,
  "lancamento_transferencia_id": 92,
  "categoria_id": 98,
  "conta_id": 8,
  "tipo_lancamento_id": 2,
  "descricao": "Transferência entre contas",
  "data_vencimento": "2018-06-12",
  "valor": "123.92",
  "anexos":[
    {
      "id": 86
    }
  ],
  "data_pagamento": "2018-06-12",
  "data_competencia": "2018-06-12",
},{
  "id": 92,
  "lancamento_transferencia_id": 91,
  "categoria_id": 98,
  "conta_id": 9,
  "tipo_lancamento_id": 1,
  "descricao": "Transferência entre contas",
  "data_vencimento": "2018-06-12",
  "valor": "-123.92",
  "anexos":[
    {
      "id": 86
    }
  ],
  "data_pagamento": "2018-06-12",
  "data_competencia": "2018-06-12",
}]

Excluir uma transferência

Remove do sistema a transferência informada pelo ID, o ID pode ser qualquer um dos dois lançamentos relacionados.

Método e URL

DELETE https://api.granatum.com.br/v1/transferencias/:id

Substitua inclusive os colchetes

Query String

access_token=[token_cliente_granatum]

Exemplo de chamada

curl -i -X DELETE \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/transferencias/91?access_token=token_cliente_granatum'

Exemplo de resposta

true

Fazer upload de um anexo em uma transferência

Cria um anexo na transferência informado pelo ID. O ID informado deve ser o do lançamento de despesa/origem da transferência

Método e URL

POST https://api.granatum.com.br/v1/transferencias/:id/anexos

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
file	A requisição precisa ter o cabeçalho 'content-type: multipart/form-data;' para aceitar o envio de arquivos.	File	Requerido
filename	Nome do anexo	String	Requerido

Exemplo de chamada

curl -i -X POST \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/transferencias/18/anexos/?access_token=token_cliente_granatum'

Exemplo de resposta

        {
          "id": 91,
          "filename": "comprovante.pdf",
          "content_type": "application/pdf", 
          "size": 53421, 
          "transferencia_id": 18, 
          "model_id": 2
        }

Consultar anexo de uma transferência

Retorna anexo de uma transferência informado pelo ID.

Método e URL

GET https://api.granatum.com.br/v1/transferencias/:id/anexos/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
with_file	Enviar true para receber o conteúdo do arquivo	Boolean	Opcional
with_url	Enviar true para receber a url do arquivo	Boolean	Opcional

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/transferencias/18/anexos/91?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 91,
  "filename": "comprovante.pdf",
  "content_type": "application/pdf",
  "size": 53421,
  "transferencia_id": 18,
  "model_id": 7844358,
  "file": "[Arquivo em Base64]"
}

Excluir anexo de uma transferência

Apaga o anexo informado pelo ID.

Método e URL

DELETE https://api.granatum.com.br/v1/transferencias/:id/anexos/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

curl -i -X DELETE \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/transferencias/18/anexos/91?access_token=token_cliente_granatum'

Exemplo de resposta

True

Cobranças - Granatum Pagamentos

Criar uma cobrança

Cria uma cobrança que pode ser via boleto, cartão de crédito ou pix, com envio por e-mail.

Método e URL

POST https://api.granatum.com.br/v1/cobrancas

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
conta_id	ID da conta bancária	Integer	Requerido
cliente_id	ID do cliente	Integer	Requerido
data_vencimento	Data de vencimento da cobrança	String	Requerido
tipo_cobranca	Escolha a foma de pagamento ('boleto', 'cartao_credito' ou 'pix')	String	Requerido
itens[]	Itens da cobrança *Ver parâmetros na tabela abaixo	Array	Requerido
data_competencia	Data de competência do lançamento	String	Opcional
email	Email do cliente caso deseje enviar a cobrança por e-mail automaticamente	String	Opcional
percentual_multa	O percentual de multa padrão é %2 para boletos atrasados	Integer	Opcional
cobrar_juros	O padrão é cobrar juros de 1% para boletos atrasados	Boolean	Opcional
instrucoes_boleto	Especificar um texto que será inserido nas instruções do boleto	String	Opcional
permitir_segunda_via	O padrão é permitir a emissão da 2ª via do boleto	Boolean	Opcional
dias_para_emissao	O número de dias antes do vencimento que a cobrança deve ser emitida, se não informado será usada a configuração padrão de 5 dias	Integer	Opcional
tipo_emissao	1 - Emitir a cobrança agora independente da data de vencimento e dos dias para emissão 2 - Agendar ou emitir a cobrança de acordo com a data de vencimento e os dias para emissão *Caso não seja informado, será usado o tipo 2	Integer	Opcional
periodicidade	Use uma das opções caso queira gerar uma cobrança com repetição: D7 - Semanal D15 - Quinzenal M1 - Mensal M2 - Bimestral M3 - Trimestral M6 - Semestral M12 - Anual	String	Opcional
parcelas	Informe o número de parcelas que deseja gerar. Caso não seja informado, a repetição será para sempre.	Integer	Opcional
tags_lancamento_taxa[][id]	ID da tag a ser aplicada no lançamento da taxa da cobrança, pode ser passado uma lista de tags	Array[{id:Integer}]	Opcional

Paramêtros dos itens

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Descrição do item	String	Requerido
categoria_id	ID da categoria	Integer	Requerido
valor	Somente é permitido valores positivos	Decimal	Requerido
centro_custo_lucro_id	ID do centro de custo e lucro	Integer	Opcional
identificador_externo	Identificador do lançamento em outro sistema	String	Opcional
tags[][id]	ID da tag, pode ser passado uma lista de tags	Array[{id:Integer}]	Opcional

Exemplo de chamada

curl -i -X POST \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'conta_id=8' \
  -d 'cliente_id=10' \
  -d 'data_vencimento=2016-08-12' \
  -d 'tipo_cobranca=boleto' \
  -d 'itens[][descricao]=Criação de site' \
  -d 'itens[][valor]=123.92' \
  -d 'itens[][categoria_id]=98' \
  -d 'itens[][tags][][id]=12' \
  -d 'tags_lancamento_taxa[][id]=34' \
  'https://api.granatum.com.br/v1/cobrancas?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id":1245,
  "valor":"123.92",
  "valor_taxa":"-4.9",
  "percentual_multa":"2.0",
  "cobrar_juros":1,
  "valor_multa_juros":"0.0",
  "valor_pago":null,
  "instrucoes_boleto":null,
  "permitir_segunda_via":1,
  "lancamento_ids":"7835741,7835742",
  "forma_pagamento_id":123096,
  "cliente_id":10,
  "conta_id":8,
  "email":null,
  "data_vencimento":"2016-08-12",
  "data_a_transferir":null,
  "data_transferindo":null,
  "data_transferido":null,
  "data_cancelamento":null,
  "status_id":1,
  "status_descricao":"Pendente",
  "cobranca_hash":"A0SD0S0DSA00DAS0DS0AD0SA"
  "link_publico":"https://secure.granatum.com.br/pagar/A0SD0S0DSA00DAS0DS0AD0SA"
}

Listar cobranças

Lista todas cobranças

Método e URL

GET https://api.granatum.com.br/v1/cobrancas

Substitua inclusive os colchetes

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
conta_id	ID da conta bancária	String	Opcional*
cliente_id	ID do cliente	String	Opcional*
cobranca_hash	Hash de identificação da cobrança	String	Opcional*
lancamento_composto_id	ID do lançamento composto para buscar a cobrança	String	Opcional*
data_inicio	Data de vencimento maior ou igual a data_inicio	String	Opcional*
data_fim	Data de vencimento menor ou igual a data_fim	String	Opcional*
start	Indica o offset da paginação. 50 registros por listagem.	String	Opcional
tipo_view	Opções: all ou count	String	Opcional
status	Opções: agendado, pendente, cliente_pagou, transferindo ou transferido	String	Opcional

*Informe pelo menos 1 dos campos opcionais

access_token=[token_cliente_granatum]&data_inicio=[data_inicio]

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/cobrancas?access_token=token_cliente_granatum&data_inicio=2015-01-01'

Exemplo de resposta

[{
  "id":1245,
  "valor":"123.92",
  "valor_taxa":"-4.9",
  "percentual_multa":"2.0",
  "cobrar_juros":1,
  "valor_multa_juros":"0.0",
  "valor_pago":null,
  "instrucoes_boleto":null,
  "permitir_segunda_via":1,
  "lancamento_ids":"7835741,7835742",
  "forma_pagamento_id":123096,
  "cliente_id":10,
  "conta_id":8,
  "email":null,
  "data_vencimento":"2016-08-12",
  "data_a_transferir":null,
  "data_transferindo":null,
  "data_transferido":null,
  "data_cancelamento":null,
  "status_id":1,
  "status_descricao":"Pendente",
  "cobranca_hash":"A0SD0S0DSA00DAS0DS0AD0SA"
  "link_publico":"https://secure.granatum.com.br/pagar/A0SD0S0DSA00DAS0DS0AD0SA"
}]

Consultar uma cobrança

Retorna os dados da cobrança informada pelo ID.

Método e URL

GET https://api.granatum.com.br/v1/cobrancas/:id

Substitua inclusive os colchetes

Query String

access_token=[token_cliente_granatum]

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/cobrancas/1245?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id":1245,
  "valor":"123.92",
  "valor_taxa":"-4.9",
  "percentual_multa":"2.0",
  "cobrar_juros":1,
  "valor_multa_juros":"0.0",
  "valor_pago":null,
  "instrucoes_boleto":null,
  "permitir_segunda_via":1,
  "lancamento_ids":"7835741,7835742",
  "forma_pagamento_id":123096,
  "cliente_id":10,
  "conta_id":8,
  "email":null,
  "data_vencimento":"2016-08-12",
  "data_a_transferir":null,
  "data_transferindo":null,
  "data_transferido":null,
  "data_cancelamento":null,
  "status_id":1,
  "status_descricao":"Pendente",
  "cobranca_hash":"A0SD0S0DSA00DAS0DS0AD0SA"
  "link_publico":"https://secure.granatum.com.br/pagar/A0SD0S0DSA00DAS0DS0AD0SA"
}

Cancelar uma cobrança

Cancalar uma cobrança informada pelo ID.

Método e URL

DELETE https://api.granatum.com.br/v1/cobrancas/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
excluir_lancamentos	Excluir os lançamentos associados a cobrança, valor padrão é FALSE	Boolean	Opcional
enviar_email_aviso	Enviar aviso ao cliente que a cobrança foi cancelada, valor padrão é FALSE	Boolean	Opcional

Exemplo de chamada

$ curl -i -X DELETE \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/cobrancas/143?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "success": "Cobrança cancelada com sucesso."
}

Anexos

Fazer upload de um arquivo

Permite fazer upload de uma arquivo a um Lançamento existente.

Método e URL

POST https://api.granatum.com.br/v1/anexos

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
file	A requisição precisa ter o cabeçalho 'content-type: multipart/form-data;' para aceitar o envio de arquivos.	File	Requerido
filename	Nome do anexo	String	Requerido
lancamento_id	ID do lançamento	Integer	Requerido

Exemplo de chamada

curl -i -X POST \
  -H 'content-type: multipart/form-data;' \
  --form lancamento_id=123 \
  --form file=[arquivo] \
  --form filename=comprovante.pdf \
  'https://api.granatum.com.br/v1/anexos.json?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 91,
  "filename": "comprovante.pdf",
  "content_type": "application/pdf", 
  "size": 53421, 
  "lancamento_id": 123, 
  "lancamento_compost_id": 2
}

Consultar um anexo

Retorna os dados do anexo informado pelo ID.

Método e URL

GET https://api.granatum.com.br/v1/anexos/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
with_file	Enviar true para receber o conteúdo do arquivo	Boolean	Opcional

Exemplo de chamada

$ curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d with_file=true \
  'https://api.granatum.com.br/v1/anexos/91?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 91,
  "filename": "comprovante.pdf",
  "content_type": "application/pdf", 
  "size": 53421, 
  "lancamento_id": 123, 
  "lancamento_compost_id": 2,
  "file": "[Arquivo em Base64]"
}

Excluir um anexo

Apaga o anexo informado pelo ID.

Método e URL

DELETE https://api.granatum.com.br/v1/anexos/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

$ curl -i -X DELETE \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/anexos/43?access_token=token_cliente_granatum'

Exemplo de resposta

true

Categorias

Criar uma categoria

Cria uma categoria que pode ser utilizada como complemento ao criar um Lançamento.

Método e URL

POST https://api.granatum.com.br/v1/categorias

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Nome da categoria	String	Requerido
cor	Em formato hexadecimal	String	Opcional
parent_id	Identifica a categoria pai desta categoria que está sendo criada	Integer	Opcional
tipo_categoria_id	Tipo da categoria: 0 - Mista 1 - Despesa 2 - Receita Não é obrigatório, caso não seja informado será cadastrado como mista Caso seja informado o parent_id, indicando que a categoria é filha, ela sempre herdará o tipo da categoria pai	Integer	Opcional

Exemplo de chamada

curl -i -X POST \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'descricao=Automotivo' \
  -d 'cor=#123123' \
  -d 'parent_id=90' \
  'https://api.granatum.com.br/v1/categorias?access_token=token_cliente_granatum'

Exemplo de resposta

Como foi informado um parent_id, o tipo_categoria_id foi herdado da categoria pai (90), mesmo sem ter sido enviado na chamada.

{
  "id": 91,
  "descricao": "Automotivo",
  "cor": "#232323",
  "parent_id": 90,
  "ativo": true,
  "tipo_categoria_id": 1,
  "categorias_filhas":[]
}

Exemplo de chamada informando o tipo (categoria sem categoria pai)

curl -i -X POST \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'descricao=Salário' \
  -d 'cor=#123123' \
  -d 'tipo_categoria_id=2' \
  'https://api.granatum.com.br/v1/categorias?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 92,
  "descricao": "Salário",
  "cor": "#123123",
  "parent_id": 0,
  "ativo": true,
  "tipo_categoria_id": 2,
  "categorias_filhas":[]
}

Editar uma categoria

Altera os dados da categoria informada pelo ID.

Método e URL

PUT https://api.granatum.com.br/v1/categorias/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Nome da categoria	String
cor	Em formato hexadecimal	String	Opcional
parent_id	Identifica a categoria pai desta categoria que está sendo editada	Integer	Opcional
ativo	Ao inativar uma categoria ela não poderá mais ser usada no registro de um lançamento	Boolean	Opcional
tipo_categoria_id	Tipo da categoria: 0 - Mista 1 - Despesa 2 - Receita Caso a categoria tenha um parent_id, indicando que ela é filha, ela sempre herdará o tipo da categoria pai, independente do valor informado aqui Ao alterar o tipo de uma categoria que possui categorias filhas, todas as categorias filhas são atualizadas para o mesmo tipo	Integer	Opcional

Exemplo de chamada

Categoria 92 (Salário) não tem categoria pai, por isso o tipo_categoria_id enviado é respeitado. Se ela tivesse categorias filhas, elas seriam atualizadas para o mesmo tipo.

curl -i -X PUT \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'descricao=Salário' \
  -d 'tipo_categoria_id=1' \
  'https://api.granatum.com.br/v1/categorias/92?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 92,
  "descricao": "Salário",
  "cor": "#123123",
  "parent_id": 0,
  "ativo": true,
  "tipo_categoria_id": 1,
  "categorias_filhas":[]
}

Listar categorias

Retorna a lista as categorias. O campo tipo_categoria_id representar o tipo da categoria (0 - Mista, 1 - Despesa, 2 - Receita).

Método e URL

GET https://api.granatum.com.br/v1/categorias

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros de busca

Campo	Descrição	Tipo	Obrigatoriedade
considerar_inativos	Listar também as categorias inativas, por padrão é FALSE	Boolean	Opcional
tipo_view	Enviar com o valor children, para que a lista retorne somente as categorias filhas da hierarquia	String	Opcional

Exemplo de chamada

$ curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/categorias?access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "id": 43,
    "descricao": "Alimentos",
    "cor": "#114477",
    "parent_id": 29, 
    "ativo": true,
    "tipo_categoria_id": 1,
    "categorias_filhas": []
  },
  {
    "id": 90,
    "descricao": "Automotivo",
    "cor": "#232323",
    "parent_id": 29, 
    "ativo": true,
    "tipo_categoria_id": 2,
    "categorias_filhas": []
  },
  ...
]

Consultar uma categoria

Retorna os dados da categoria informada pelo ID.

Método e URL

GET https://api.granatum.com.br/v1/categorias/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

$ curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/categorias/43?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 43,
  "descricao": "Alimentos",
  "cor": "#114477",
  "parent_id": 29, 
  "ativo": true,
  "tipo_categoria_id": 1,
  "categorias_filhas": []
}

Excluir uma categoria

Remove do sistema a categoria informada pelo ID.

Método e URL

DELETE https://api.granatum.com.br/v1/categorias/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
acao	Tipo de exclusão, informe uma das opções: remove_lancamentos: para excluir todos lançamentos junto com a categoria migra_lancamentos: para migrar os lançametos para outra categoria	String	Requerido
migracao_id	Informar o ID da outra categoria caso deseje migrar os lançamentos que estão na categoria a ser excluída *Obrigatório se a ação for migra_lancamentos	Integer	Opcional

Exemplo de chamada

$ curl -i -X DELETE \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/categorias/43?access_token=token_cliente_granatum'

Exemplo de resposta

true

Clientes

Criar um cliente

Cria um Cliente que pode ser utilizado como complemento ao criar um Lançamento.

Método e URL

POST https://api.granatum.com.br/v1/clientes

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
nome	Nome/Razão Social do cliente	String	Requerido
nome_fantasia	Nome fantasia do cliente	String	Opcional
documento	CPF/CNPJ do cliente	String	Opcional
inscricao_estadual	Inscrição Estadual do cliente	String	Opcional
inscricao_municipal	Inscrição Municipal do cliente	String	Opcional
telefone	Telefone do cliente	String	Opcional
email	Email do cliente	String	Opcional
endereco	Apenas logradouro. Ex: Rua 13 de maio.	String	Opcional
endereco_numero	Número do endereço	String	Opcional
endereco_complemento	Complemento do endereço	String	Opcional
bairro	Bairro do endereço	String	Opcional
cep	Código postal do endereço	String	Opcional
cidade_id	ID da cidade do endereço	Integer	Opcional
estado_id	ID do estado do endereço	Integer	Opcional
banco_id	ID do banco	Integer	Opcional
agencia	Número da agência	String	Opcional
numero_conta	Número da conta	String	Opcional
observacao	Campo aberto para informação adicionais sobre o cliente	String	Opcional
fornecedor	Indica se o cliente cadastro é também um fornecedor, por padrão é FALSE	Boolean	Opcional
classificacao_cliente_id	ID da classificação de clientes	Integer	Opcional
classificacao_fornecedor_id	ID da classificação de fornecedores	Integer	Opcional
estrangeiro	Indica se o cliente é estrangeiro ou não, por padrão é FALSE.	Boolean	Opcional
chave_pix	Chave PIX do cliente	String	Opcional
identificador_externo	Campo para identificação externa do cliente	String	Opcional

Exemplo de chamada

curl -i -X POST \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'nome=Granatum Financeiro' \
  -d 'nome_fantasia=Granatum Financeiro Online' \
  -d 'documento=26328240000103' \
  'https://api.granatum.com.br/v1/clientes?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 1,
  "nome": "Granatum Financeiro",
  "nome_fantasia": "Granatum Financeiro Online",
  "documento": "26328240000103",
  "inscricao_estadual": null,
  "inscricao_municipal": null,
  "telefone": null,
  "endereco": null,
  "endereco_numero": null,
  "endereco_complemento": null,
  "bairro": null,
  "cep": null,
  "cidade_id": null,
  "estado_id": null,
  "email": null,
  "observacao": null,
  "fornecedor": false,
  "cliente": true,
  "banco_id": null,
  "agencia": null,
  "numero_conta", null,
  "ativo": true,
  "estado": null,
  "cidade": null,
  "classificacao_cliente_id": null,
  "classificacao_fornecedor_id": null,
  "estrangeiro": false,
  "chave_pix": null,
  "identificador_externo": null
}

Editar um cliente

Altera os dados do Cliente informado pelo ID.

Método e URL

PUT https://api.granatum.com.br/v1/clientes/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
nome	Nome/Razão Social do cliente	String	Requerido
nome_fantasia	Nome fantasia do cliente	String	Opcional
documento	CPF/CNPJ do cliente	String	Opcional
inscricao_estadual	Inscrição Estadual do cliente	String	Opcional
inscricao_municipal	Inscrição Municipal do cliente	String	Opcional
telefone	Telefone do cliente	String	Opcional
email	Email do cliente	String	Opcional
endereco	Apenas logradouro. Ex: Rua 13 de maio.	String	Opcional
endereco_numero	Número do endereço	String	Opcional
endereco_complemento	Complemento do endereço	String	Opcional
bairro	Bairro do endereço	String	Opcional
cep	Código postal do endereço	String	Opcional
cidade_id	ID da cidade do endereço	Integer	Opcional
estado_id	ID do estado do endereço	Integer	Opcional
banco_id	ID do banco	Integer	Opcional
agencia	Número da agência	String	Opcional
numero_conta	Número da conta	String	Opcional
observacao	Campo aberto para informação adicionais sobre o cliente	String	Opcional
fornecedor	Indica se o cliente cadastro é também um fornecedor, por padrão é FALSE	Boolean	Opcional
ativo	Ao inativar um cliente ele não poderá mais ser usado no registro de um lançamento	Boolean	Opcional
classificacao_cliente_id	ID da classificação de clientes	Integer	Opcional
classificacao_fornecedor_id	ID da classificação de fornecedores	Integer	Opcional
estrangeiro	Indica se o cliente é estrangeiro ou não, por padrão é FALSE.	Boolean	Opcional
chave_pix	Chave PIX do cliente	String	Opcional
identificador_externo	Campo para identificação externa do cliente	String	Opcional

Exemplo de chamada

curl -i -X PUT \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'telefone=11 99653-5631' \
  'https://api.granatum.com.br/v1/clientes/1?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 1,
  "nome": "Granatum Financeiro",
  "nome_fantasia": "Granatum Financeiro Online",
  "documento": "26328240000103",
  "inscricao_estadual": null,
  "inscricao_municipal": null,
  "telefone": null,
  "endereco": "11 99653-5631",
  "endereco_numero": null,
  "endereco_complemento": null,
  "bairro": null,
  "cep": null,
  "cidade_id": null,
  "estado_id": null,
  "email": null,
  "observacao": null,
  "fornecedor": false,
  "cliente": true,
  "banco_id": null,
  "agencia": null,
  "numero_conta", null,
  "ativo": true,
  "classificacao_cliente_id": null,
  "classificacao_fornecedor_id": null,
  "estrangeiro": false,
  "estado": null,
  "cidade": null,
  "chave_pix": null,
  "identificador_externo": null,
  "anexos": [
    {
      "id": 53
    },
    {
      "id": 59
    }
  ]
}

Listar clientes

Retorna a lista de clientes.

Método e URL

GET https://api.granatum.com.br/v1/clientes

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros de busca

Campo	Descrição	Tipo	Obrigatoriedade
considerar_inativos	Listar também os clientes inativos, por padrão é FALSE	Boolean	Opcional
documento	CNPJ/CPF sem máscara	String	Opcional
term	Busca aproximada na razão social, e-mail, endereço e telefone	String	Opcional
identificador_externo	Busca pelo identificador externo do cliente	String	Opcional

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'considerar_inativos=true' \
  'https://api.granatum.com.br/v1/clientes?access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "id": 1,
    "nome": "Granatum Financeiro",
    "nome_fantasia": "Granatum Financeiro Online",
    "documento": "26328240000103",
    "inscricao_estadual": null,
    "inscricao_municipal": null,
    "telefone": null,
    "endereco": "11 99653-5631",
    "endereco_numero": null,
    "endereco_complemento": null,
    "bairro": null,
    "cep": null,
    "cidade_id": null,
    "estado_id": null,
    "email": null,
    "observacao": null,
    "fornecedor": false,
    "cliente": true,
    "banco_id": null,
    "agencia": null,
    "numero_conta", null,
    "ativo": true,
    "classificacao_cliente_id": null,
    "classificacao_fornecedor_id": null,
    "estrangeiro": false,
    "chave_pix": null,
    "identificador_externo": null,
    "estado": null,
    "cidade": null,
    "anexos": [
      {
        "id": 53
      },
      {
        "id": 59
      }
    ]
  },
  {
    "id": 23,
    "nome": "Agencia WEB LTDA",
    "nome_fantasia": "Agencia Max",
    "documento": "34725187000165",
    "inscricao_estadual": null,
    "inscricao_municipal": null,
    "telefone": null,
    "endereco": null,
    "endereco_numero": null,
    "endereco_complemento": null,
    "bairro": null,
    "cep": null,
    "cidade_id": 234,
    "estado_id": 23,
    "email": null,
    "observacao": null,
    "fornecedor": false,
    "fornecedor": true,
    "banco_id": null,
    "agencia": null,
    "numero_conta", null,
    "ativo": false,
    "classificacao_cliente_id": null,
    "classificacao_fornecedor_id": null,
    "estrangeiro": false,
    "chave_pix": null,
    "identificador_externo": null,
    "estado": null,
    "cidade": null,
    "anexos": [
      {
        "id": 53
      },
      {
        "id": 59
      }
    ]
  },
  ...
]

Consultar cliente

Retorna os dados do cliente informado pelo ID.

Método e URL

GET https://api.granatum.com.br/v1/clientes/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/clientes/18?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 18,
  "nome": "Granatum Financeiro",
  "nome_fantasia": "Granatum Financeiro Online",
  "documento": "26328240000103",
  "inscricao_estadual": null,
  "inscricao_municipal": null,
  "telefone": null,
  "endereco": "11 99653-5631",
  "endereco_numero": null,
  "endereco_complemento": null,
  "bairro": null,
  "cep": null,
  "cidade_id": null,
  "estado_id": null,
  "email": null,
  "observacao": null,
  "fornecedor": false,
  "cliente": true,
  "banco_id": null,
  "agencia": null,
  "numero_conta", null,
  "ativo": true,
  "classificacao_cliente_id": null,
  "classificacao_fornecedor_id": null,
  "estrangeiro": false,
  "chave_pix": null,
  "identificador_externo": null,
  "estado": null,
  "cidade": null
}

Excluir um cliente

Remove um cliente informado pelo ID.

Método e URL

DELETE https://api.granatum.com.br/v1/clientes/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
migracao_id	Informar o ID do outro cliente caso deseje migrar os lançamentos que estão no cliente a ser excluído ou não envie nada caso deseje apenas excluir	Integer	Opcional

Exemplo de chamada

curl -i -X DELETE \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/clientes/18?access_token=token_cliente_granatum'

Exemplo de resposta

true

Fazer upload de um anexo em um cliente

Cria um anexo no cliente informado pelo ID.

Método e URL

POST https://api.granatum.com.br/v1/clientes/:id/anexos

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
file	A requisição precisa ter o cabeçalho 'content-type: multipart/form-data;' para aceitar o envio de arquivos.	File	Requerido
filename	Nome do anexo	String	Requerido

Exemplo de chamada

curl -i -X POST \
  -H 'content-type: multipart/form-data;' \
  --form file=[arquivo] \
  --form filename=comprovante.pdf \
  'https://api.granatum.com.br/v1/clientes/18/anexos.json?access_token=token_cliente_granatum'

Exemplo de resposta

        {
          "id": 91,
          "filename": "comprovante.pdf",
          "content_type": "application/pdf", 
          "size": 53421, 
          "cliente_id": 18, 
          "model_id": 18
        }

Consultar anexo de um cliente

Retorna anexo de um cliente informado pelo ID.

Método e URL

GET https://api.granatum.com.br/v1/clientes/:id/anexos/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
with_file	Enviar true para receber o conteúdo do arquivo	Boolean	Opcional
with_url	Enviar true para receber a url do arquivo	Boolean	Opcional

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/clientes/18/anexos/91?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 91,
  "filename": "comprovante.pdf",
  "content_type": "application/pdf",
  "size": 53421,
  "cliente_id": 18,
  "model_id": 18,
  "file": "[Arquivo em Base64]"
}

Excluir anexo de um cliente

Apaga o anexo informado pelo ID.

Método e URL

DELETE https://api.granatum.com.br/v1/clientes/:id/anexos/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

curl -i -X DELETE \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/clientes/18/anexos/91?access_token=token_cliente_granatum'

Exemplo de resposta

True

Fornecedores

Criar um fornecedor

Cria um Fornecedor que pode ser utilizado como complemento ao criar um Lançamento.

Método e URL

POST https://api.granatum.com.br/v1/fornecedores

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
nome	Nome/Razão Social do fornecedor	String	Requerido
nome_fantasia	Nome fantasia do fornecedor	String	Opcional
documento	CPF/CNPJ do fornecedor	String	Opcional
inscricao_estadual	Inscrição Estadual do fornecedor	String	Opcional
inscricao_municipal	Inscrição Municipal do fornecedor	String	Opcional
telefone	Telefone do fornecedor	String	Opcional
email	Email do fornecedor	String	Opcional
endereco	Apenas logradouro. Ex: Rua 13 de maio.	String	Opcional
endereco_numero	Número do endereço	String	Opcional
endereco_complemento	Complemento do endereço	String	Opcional
bairro	Bairro do endereço	String	Opcional
cep	Código postal do endereço	String	Opcional
cidade_id	ID da cidade do endereço	Integer	Opcional
estado_id	ID do estado do endereço	Integer	Opcional
banco_id	ID do banco	Integer	Opcional
agencia	Número da agência	String	Opcional
numero_conta	Número da conta	String	Opcional
observacao	Campo aberto para informação adicionais sobre o fornecedor	String	Opcional
cliente	Indica se o fornecedor cadastro é também um cliente, por padrão é FALSE	Boolean	Opcional
classificacao_cliente_id	ID da classificação de clientes	Integer	Opcional
classificacao_fornecedor_id	ID da classificação de fornecedores	Integer	Opcional
estrangeiro	Indica se o fornecedor é estrangeiro ou não, por padrão é FALSE.	Boolean	Opcional
chave_pix	Chave PIX do fornecedor	String	Opcional
identificador_externo	Campo para identificação externa do fornecedor	String	Opcional

Exemplo de chamada

curl -i -X POST \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'nome=Granatum Financeiro' \
  -d 'nome_fantasia=Granatum Financeiro Online' \
  -d 'documento=26328240000103' \
  'https://api.granatum.com.br/v1/fornecedores?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 1,
  "nome": "Granatum Financeiro",
  "nome_fantasia": "Granatum Financeiro Online",
  "documento": "26328240000103",
  "inscricao_estadual": null,
  "inscricao_municipal": null,
  "telefone": null,
  "endereco": null,
  "endereco_numero": null,
  "endereco_complemento": null,
  "bairro": null,
  "cep": null,
  "cidade_id": null,
  "estado_id": null,
  "email": null,
  "observacao": null,
  "fornecedor": true,
  "cliente": false,
  "banco_id": null,
  "agencia": null,
  "numero_conta", null,
  "ativo": true,
  "estado": null,
  "cidade": null,
  "classificacao_cliente_id": null,
  "classificacao_fornecedor_id": null,
  "estrangeiro": false,
  "chave_pix": null,
  "identificador_externo": null
}

Editar um fornecedor

Altera os dados do Fornecedor informado pelo ID.

Método e URL

PUT https://api.granatum.com.br/v1/fornecedores/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
nome	Nome/Razão Social do fornecedor	String	Requerido
nome_fantasia	Nome fantasia do fornecedor	String	Opcional
documento	CPF/CNPJ do fornecedor	String	Opcional
inscricao_estadual	Inscrição Estadual do fornecedor	String	Opcional
inscricao_municipal	Inscrição Municipal do fornecedor	String	Opcional
telefone	Telefone do fornecedor	String	Opcional
email	Email do fornecedor	String	Opcional
endereco	Apenas logradouro. Ex: Rua 13 de maio.	String	Opcional
endereco_numero	Número do endereço	String	Opcional
endereco_complemento	Complemento do endereço	String	Opcional
bairro	Bairro do endereço	String	Opcional
cep	Código postal do endereço	String	Opcional
cidade_id	ID da cidade do endereço	Integer	Opcional
estado_id	ID do estado do endereço	Integer	Opcional
banco_id	ID do banco	Integer	Opcional
agencia	Número da agência	String	Opcional
numero_conta	Número da conta	String	Opcional
observacao	Campo aberto para informação adicionais sobre o fornecedor	String	Opcional
cliente	Indica se o fornecedor cadastro é também um cliente, por padrão é FALSE	Boolean	Opcional
ativo	Ao inativar um fornecedor ele não poderá mais ser usado no registro de um lançamento	Boolean	Opcional
classificacao_cliente_id	ID da classificação de clientes	Integer	Opcional
classificacao_fornecedor_id	ID da classificação de fornecedores	Integer	Opcional
estrangeiro	Indica se o fornecedor é estrangeiro ou não, por padrão é FALSE.	Boolean	Opcional
chave_pix	Chave PIX do fornecedor	String	Opcional
identificador_externo	Campo para identificação externa do fornecedor	String	Opcional

Exemplo de chamada

curl -i -X PUT \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'telefone=11 99653-5631' \
  'https://api.granatum.com.br/v1/fornecedores/1?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 1,
  "nome": "Granatum Financeiro",
  "nome_fantasia": "Granatum Financeiro Online",
  "documento": "26328240000103",
  "inscricao_estadual": null,
  "inscricao_municipal": null,
  "telefone": null,
  "endereco": "11 99653-5631",
  "endereco_numero": null,
  "endereco_complemento": null,
  "bairro": null,
  "cep": null,
  "cidade_id": null,
  "estado_id": null,
  "email": null,
  "observacao": null,
  "fornecedor": true,
  "cliente": false,
  "banco_id": null,
  "agencia": null,
  "numero_conta", null,
  "ativo": true,
  "estado": null,
  "cidade": null,
  "classificacao_cliente_id": null,
  "classificacao_fornecedor_id": null,
  "estrangeiro": false,
  "chave_pix": null,
  "identificador_externo": null,
  "estado": null,
  "cidade": null,
  "anexos": [
    {
      "id": 53
    },
    {
      "id": 59
    }
  ]
}

Listar fornecedores

Retorna a lista de fornecedores.

Método e URL

GET https://api.granatum.com.br/v1/fornecedores

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros de busca

Campo	Descrição	Tipo	Obrigatoriedade
considerar_inativos	Listar também os fornecedores inativos, por padrão é FALSE	Boolean	Opcional
documento	CNPJ/CPF sem máscara	String	Opcional
term	Busca aproximada na razão social, e-mail, endereço e telefone	String	Opcional
identificador_externo	Busca pelo identificador externo do fornecedor	String	Opcional

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'considerar_inativos=true' \
  'https://api.granatum.com.br/v1/fornecedores?access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "id": 1,
    "nome": "Granatum Financeiro",
    "nome_fantasia": "Granatum Financeiro Online",
    "documento": "26328240000103",
    "inscricao_estadual": null,
    "inscricao_municipal": null,
    "telefone": null,
    "endereco": "11 99653-5631",
    "endereco_numero": null,
    "endereco_complemento": null,
    "bairro": null,
    "cep": null,
    "cidade_id": null,
    "estado_id": null,
    "email": null,
    "observacao": null,
    "fornecedor": true,
    "cliente": false,
    "banco_id": null,
    "agencia": null,
    "numero_conta", null,
    "ativo": true,
    "classificacao_cliente_id": null,
    "classificacao_fornecedor_id": null,
    "estrangeiro": false,
    "chave_pix": null,
    "identificador_externo": null,
    "estado": null,
    "cidade": null,
    "anexos": [
      {
        "id": 53
      },
      {
        "id": 59
      }
    ]
  },
  {
    "id": 23,
    "nome": "Agencia WEB LTDA",
    "nome_fantasia": "Agencia Max",
    "documento": "34725187000165",
    "inscricao_estadual": null,
    "inscricao_municipal": null,
    "telefone": null,
    "endereco": null,
    "endereco_numero": null,
    "endereco_complemento": null,
    "bairro": null,
    "cep": null,
    "cidade_id": 234,
    "estado_id": 23,
    "email": null,
    "observacao": null,
    "fornecedor": true,
    "cliente": true,
    "banco_id": null,
    "agencia": null,
    "numero_conta", null,
    "ativo": false,
    "classificacao_cliente_id": null,
    "classificacao_fornecedor_id": null,
    "estrangeiro": false,
    "chave_pix": null,
    "identificador_externo": null,
    "estado": null,
    "cidade": null,
    "anexos": [
      {
        "id": 53
      },
      {
        "id": 59
      }
    ]
  },
  ...
]

Consultar fornecedor

Retorna os dados do fornecedor informado pelo ID.

Método e URL

GET https://api.granatum.com.br/v1/fornecedores/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/fornecedores/18?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 18,
  "nome": "Granatum Financeiro",
  "nome_fantasia": "Granatum Financeiro Online",
  "documento": "26328240000103",
  "inscricao_estadual": null,
  "inscricao_municipal": null,
  "telefone": null,
  "endereco": "11 99653-5631",
  "endereco_numero": null,
  "endereco_complemento": null,
  "bairro": null,
  "cep": null,
  "cidade_id": null,
  "estado_id": null,
  "email": null,
  "observacao": null,
  "fornecedor": true,
  "cliente": false,
  "banco_id": null,
  "agencia": null,
  "numero_conta", null,
  "ativo": true,
  "estrangeiro": false,
  "classificacao_cliente_id": null,
  "classificacao_fornecedor_id": null,
  "chave_pix": null,
  "identificador_externo": null,
  "estado": null,
  "cidade": null
}

Excluir um fornecedor

Remove um fornecedor informado pelo ID.

Método e URL

DELETE https://api.granatum.com.br/v1/fornecedores/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
migracao_id	Informar o ID do outro fornecedor caso deseje migrar os lançamentos que estão no fornecedor a ser excluído ou não envie nada caso deseje apenas excluir	Integer	Opcional

Exemplo de chamada

curl -i -X DELETE \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/fornecedores/18?access_token=token_cliente_granatum'

Exemplo de resposta

true

Fazer upload de um anexo em um fornecedor

Cria um anexo no fornecedor informado pelo ID.

Método e URL

POST https://api.granatum.com.br/v1/fornecedores/:id/anexos

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
file	A requisição precisa ter o cabeçalho 'content-type: multipart/form-data;' para aceitar o envio de arquivos.	File	Requerido
filename	Nome do anexo	String	Requerido

Exemplo de chamada

curl -i -X POST \
  -H 'content-type: multipart/form-data;' \
  --form file=[arquivo] \
  --form filename=comprovante.pdf \
  'https://api.granatum.com.br/v1/fornecedores/18/anexos.json?access_token=token_cliente_granatum'

curl -i -X POST \

      Exemplo de resposta
              {
          "id": 91,
          "filename": "comprovante.pdf",
          "content_type": "application/pdf", 
          "size": 53421, 
          "fornecedor_id": 18, 
          "model_id": 18
        }

Consultar anexo de um fornecedor

Retorna anexo de um fornecedor informado pelo ID.

Método e URL

GET https://api.granatum.com.br/v1/fornecedores/:id/anexos/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
with_file	Enviar true para receber o conteúdo do arquivo	Boolean	Opcional
with_url	Enviar true para receber a url do arquivo	Boolean	Opcional

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/fornecedores/18/anexos/91?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 91,
  "filename": "comprovante.pdf",
  "content_type": "application/pdf",
  "size": 53421,
  "fornecedor_id": 18,
  "model_id": 18,
  "file": "[Arquivo em Base64]"
}

Excluir anexo de um fornecedor

Apaga o anexo informado pelo ID.

Método e URL

DELETE https://api.granatum.com.br/v1/fornecedores/:id/anexos/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

curl -i -X DELETE \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/fornecedores/18/anexos/91?access_token=token_cliente_granatum'

Exemplo de resposta

True

Classificações

Criar uma classificação

Cria uma classificação que pode organizar melhor os cadastros de clientes e fornecedores.

Método e URL

POST https://api.granatum.com.br/v1/classificacoes

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
nome	Nome da classificação	String	Requerido
tipo_classificacao_id	Tipo da classificação: 0 - Mista 1 - Cliente 2 - Fornecedor	Integer	Requerido

Exemplo de chamada

curl -i -X POST \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'nome=Granatum Financeiro' \
  -d 'nome_fantasia=Granatum Financeiro Online' \
  -d 'documento=26328240000103' \
  'https://api.granatum.com.br/v1/classificacoes?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 1,
  "nome": "Granatum Financeiro",
  "tipo_classificacao_id": 0,
  "ativo": true
}

Editar uma classificação

Altera os dados de uma classificação informada pelo ID.

Método e URL

PUT https://api.granatum.com.br/v1/classificacoes/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
nome	Nome da classificação	String	Requerido
tipo_classificacao_id	Tipo da classificação: 0 - Mista 1 - Cliente 2 - Fornecedor	Integer	Requerido
ativo	Ao desativar uma classificação você não poderá mais atrelar a um cliente / fornecedor	Boolean	Opcional

Exemplo de chamada

curl -i -X PUT \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'telefone=11 99653-5631' \
  'https://api.granatum.com.br/v1/classificacoes/1?access_token=token_cliente_granatum'

Exemplo de resposta

{
        "id": 1,
        "nome": "Granatum Financeiro",
        "tipo_classificacao_id": 0,
        "ativo": true
}

Listar classificações

Retorna a lista de classificações.

Método e URL

GET https://api.granatum.com.br/v1/classificacoes

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros de busca

Campo	Descrição	Tipo	Obrigatoriedade
considerar_inativos	Listar também os classificações inativos, por padrão é FALSE	Boolean	Opcional
tipo_classificacao	Qual o tipo de classificação deseja listar. O padrão é Cliente, as Mistas são incluidas automaticamente em ambas as listagens: 1 - Cliente 2 - Fornecedor	Integer	Opcional

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'considerar_inativos=true' \
  'https://api.granatum.com.br/v1/classificacoes?access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "id": 1,
    "nome": "Granatum Financeiro",
    "tipo_classificacao_id": 0,
    "ativo": true
  },
  {
    "id": 23,
    "nome": "Granatum Financeiro",
    "tipo_classificacao_id": 0,
    "ativo": true
  },
  ...
]

Consultar classificação

Retorna os dados de uma classificação informada pelo ID.

Método e URL

GET https://api.granatum.com.br/v1/classificacoes/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/classificacoes/18?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 18,
  "nome": "Granatum Financeiro",
  "tipo_classificacao_id": 0,
  "ativo": true
}

Excluir uma classificação

Remove uma classificação informada pelo ID.

Método e URL

DELETE https://api.granatum.com.br/v1/classificacoes/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
migracao_id	Informar o ID do outra classificação caso deseje migrar as pessoas que estão nessa classificação ou não envie nada caso deseje apenas excluir	Integer	Opcional

Exemplo de chamada

curl -i -X DELETE \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/classificacacoes/18?access_token=token_cliente_granatum'

Exemplo de resposta

true

Contas bancárias

Criar uma conta bancária

Cria uma conta bancária que deve ser utilizada como complemento ao criar um Lançamento.

Método e URL

POST https://api.granatum.com.br/v1/contas

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Nome da conta	String	Requerido
banco_id	ID do banco	Integer	Opcional
agencia	Número da agência	String	Opcional
numero	Número da conta	String	Opcional
nome_gerente	Gerente responsável pela conta no banco	String	Opcional
telefone_gerente	Telefone do gerente	String	Opcional
permite_lancamento	O padrão é TRUE, a conta que NÃO permite lançamentos, podem apenas receber movimentações através de Transferências	Boolean	Opcional
data_saldo_inicial	Data do saldo da conta de quando irá iniciar o controle dentro do sistema	Date	Opcional
valor_saldo_inicial	Valor do saldo da conta de quando irá iniciar o controle dentro do sistema	Decimal	Opcional

Exemplo de chamada

curl -i -X POST \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'descricao=Conta Santander' \
  -d 'banco_id=10' \
  -d 'agencia=123-0' \
  -d 'numero=32423-3' \
  -d 'nome_gerente=Marcio Almeida' \
  -d 'telefone_gerente=11 2332-3455' \
  -d 'permite_lancamento=true' \
  -d 'data_saldo_inicial=2020-01-23' \
  -d 'valor_saldo_inicial=11 1500.80' \
  'https://api.granatum.com.br/v1/contas?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 1,
  "descricao": "Conta Santander",
  "banco_id": "10",
  "agencia": "123-0",
  "numero": "32423-3",
  "nome_gerente": "Marcio Almeida",
  "telefone_gerente": "11 2332-3455",
  "permite_lancamento": true,
  "ativo": true,
  "lancamentos": [
    {
      "id": 133,
      "valor": "1500.80",
      "data_pagamento": "2020-01-23"
    }
  ]
}

Editar uma conta bancária

Altera os dados da conta bancária informada pelo ID.

Método e URL

PUT https://api.granatum.com.br/v1/contas/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Nome da conta	String	Opcional
banco_id	ID do banco	Integer	Opcional
agencia	Número da agência	String	Opcional
numero	Número da conta	String	Opcional
nome_gerente	Gerente responsável pela conta no banco	String	Opcional
telefone_gerente	Telefone do gerente	String	Opcional
permite_lancamento	O padrão é TRUE, a conta que NÃO permite lançamentos, podem apenas receber movimentações através de Transferências	Boolean	Opcional
data_saldo_inicial	Data do saldo da conta de quando irá iniciar o controle dentro do sistema	Date	Opcional
valor_saldo_inicial	Valor do saldo da conta de quando irá iniciar o controle dentro do sistema	Decimal	Opcional
ativo	Ao inativar uma conta ela não poderá mais ser usada no registro de um lançamento	Boolean	Opcional

Exemplo de chamada

curl -i -X POST \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'descricao=C/C Santander' \
  'https://api.granatum.com.br/v1/contas/1?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 1,
  "descricao": "C/C Santander",
  "banco_id": "10",
  "agencia": "123-0",
  "numero": "32423-3",
  "nome_gerente": "Marcio Almeida",
  "telefone_gerente": "11 2332-3455",
  "permite_lancamento": true,
  "ativo": true,
  "lancamentos": [
    {
      "id": 133,
      "valor": "1500.80",
      "data_pagamento": "2020-01-23"
    }
  ]
}

Listar contas bancárias

Retorna a lista as contas.

Método e URL

GET https://api.granatum.com.br/v1/contas

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros de busca

Campo	Descrição	Tipo	Obrigatoriedade
considerar_inativos	Listar também as contas inativas, por padrão é FALSE	Boolean	Opcional

Exemplo de chamada

$ curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/contas?access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "id": 1,
    "descricao": "Conta Santander",
    "permite_lancamento": true,
    "ativo": true,
    "saldo": "0.0"
  },
  {
    "id": 2,
    "descricao": "Conta Nubank",
    "permite_lancamento": true,
    "ativo": true,
    "saldo": "2890.0"
  },
  {
    "id": 3,
    "descricao": "XP Investimentos",
    "permite_lancamento": false,
    "ativo": true,
    "saldo": "35876.0"
  },
  ...
]

Consultar uma conta bancária

Retorna os dados da conta informada pelo ID.

Método e URL

GET https://api.granatum.com.br/v1/contas/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

$ curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/contas/1?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 1,
  "descricao": "C/C Santander",
  "banco_id": "10",
  "agencia": "123-0",
  "numero": "32423-3",
  "nome_gerente": "Marcio Almeida",
  "telefone_gerente": "11 2332-3455",
  "permite_lancamento": true,
  "ativo": true,
  "lancamentos": [
    {
      "id": 133,
      "valor": "1500.80",
      "data_pagamento": "2020-01-23"
    }
  ]
}

Excluir uma conta bancária

Remove do sistema a conta informada pelo ID.

Método e URL

DELETE https://api.granatum.com.br/v1/contas/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
acao	Tipo de exclusão, informe uma das opções: remove_lancamentos: para excluir todos lançamentos junto com a conta migra_lancamentos: para migrar os lançametos para outra conta	String	Requerido
migracao_id	Informar o ID da outra conta caso deseje migrar os lançamentos que estão na conta a ser excluída *Obrigatório se a ação for migra_lancamentos	Integer	Opcional

Exemplo de chamada

$ curl -i -X DELETE \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'acao=remove_lancamentos' \
  'https://api.granatum.com.br/v1/contas/1?access_token=token_cliente_granatum'

Exemplo de resposta

true

Centros de Custo e Lucro

Criar um centro de custo e lucro

Cria um Centro de Custo/Lucro que pode ser utilizado como complemento ao criar um Lançamento.

Método e URL

POST https://api.granatum.com.br/v1/centros_custo_lucro

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Nome do centro de custo e lucro	String	Requerido
parent_id	Identifica o centro ce custo e lucro pai deste centro ce custo e lucro que está sendo criado	Integer	Opcional

Exemplo de chamada

curl -i -X POST \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'descricao=Setor de Compras' \
  -d 'parent_id=2' \
  'https://api.granatum.com.br/v1/centros_custo_lucro?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 3, 
  "descricao": "Setor Compras",
  "parent_id": 2,
  "ativo": true,
  "centros_custo_lucro_filhos":[]
}

Editar um centro de custo e lucro

Altera os dados do Centro de Custo/Lucro informado pelo ID.

Método e URL

PUT https://api.granatum.com.br/v1/centros_custo_lucro/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Nome do centro de custo e lucro	String	Requerido
parent_id	Identifica o centro ce custo e lucro pai deste centro ce custo e lucro que está sendo editado	Integer	Opcional
ativo	Ao inativar um centro de custo e lucro ele não poderá mais ser usado no registro de um lançamento	Boolean	Opcional

Exemplo de chamada

curl -i -X PUT \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'descricao=Recursos Humanos' \
  -d 'parent_id=2' \
  'https://api.granatum.com.br/v1/centros_custo_lucro/3?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 3, 
  "descricao": "Recursos Humanos",
  "parent_id": 2,
  "ativo": true,
  "centros_custo_lucro_filhos":[]
}

Listar centros de custo e lucro

Retorna a lista todos os centros de custo e lucro.

Método e URL

GET https://api.granatum.com.br/v1/centros_custo_lucro

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros de busca

Campo	Descrição	Tipo	Obrigatoriedade
considerar_inativos	Listar também os centros de custo e lucro inativos, por padrão é FALSE	Boolean	Opcional
tipo_view	Enviar com o valor children, para que a lista retorne somente centros de custo e lucro filhos da hierarquia	Boolean	Opcional

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/centros_custo_lucro?access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "id": 1,
    "descricao": "Prédio",
    "ativo": true,
    "centros_custo_lucro_filhos":[]
  },
  {
    "id": 2,
    "descricao": "Automóvel",
    "ativo": true,
    "centros_custo_lucro_filhos":[]
  },
  {
    "id": 3,
    "descricao": "Setor Compras",
    "ativo": true,
    "centros_custo_lucro_filhos":[]
  }
]

Consultar um centro de custo e lucro

Retorna os dados do Centro de Custo/Lucro informado pelo ID.

Método e URL

GET https://api.granatum.com.br/v1/centros_custo_lucro/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/centros_custo_lucro/2?access_token=token_cliente_granatum'

Exemplo de resposta

{ 
  "id": 2, 
  "descricao": "Automóvel",
  "ativo": true,
  "centros_custo_lucro_filhos":[
    {
      "id": 3, 
      "descricao": "Recursos Humanos",
      "ativo": true,
      "centros_custo_lucro_filhos":[]
    }
  ]
}

Excluir um centro de custo e lucro

Remove do sistema o Centro de Custo/Lucro informado pelo ID.

Método e URL

DELETE https://api.granatum.com.br/v1/centros_custo_lucro/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
migracao_id	Informar o ID do outro centro de custo e lucro caso deseje migrar os lançamentos que estão no centro de custo e lucro a ser excluído ou não envie nada caso deseje apenas excluir	Integer	Opcional

Exemplo de chamada

curl -i -X DELETE \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/centros_custo_lucro/2?access_token=token_cliente_granatum'

Exemplo de resposta

true

Formas de pagamento

Criar uma forma de pagamento

Cria uma Forma de Pagamento que pode ser utilizado como complemento ao criar um Lançamento.

Método e URL

POST https://api.granatum.com.br/v1/formas_pagamento

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Nome da forma de pagamento	String	Requerido

Exemplo de chamada

curl -i -X POST \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'descricao=Transferência' \
   'https://api.granatum.com.br/v1/formas_pagamento?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 2, 
  "descricao": "Transferência",
  "ativo": true
}

Editar uma forma de pagamento

Altera os dados de uma Forma de Pagamento informada pelo ID.

Método e URL

PUT https://api.granatum.com.br/v1/formas_pagamento/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Nome da forma de pagamento	String	Requerido
ativo	Ao inativar uma forma de pagamento ela não poderá mais ser usada no registro de um lançamento	Boolean	Opcional

Exemplo de chamada

curl -i -X PUT \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'descricao=Boleto' \
   'https://api.granatum.com.br/v1/formas_pagamento/2?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 2, 
  "descricao": "Boleto",
  "ativo": true
}

Listar formas de pagamento

Lista todos os formas de pagamento

Método e URL

GET https://api.granatum.com.br/v1/formas_pagamento

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros de busca

Campo	Descrição	Tipo	Obrigatoriedade
considerar_inativos	Listar também as formas de pagamento inativas, por padrão é FALSE	Boolean	Opcional

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/formas_pagamento?access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "id":1,
    "descricao":"Dinheiro",
    "ativo": true
  },
  {
    "id":2,
    "descricao":"Boleto",
    "ativo": true
  },
  ...
]

Consultar uma forma de pagamento

Retorna os dados de uma forma de pagamento informada pelo ID.

Método e URL

GET https://api.granatum.com.br/v1/formas_pagamento/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/formas_pagamento/1?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id":1,
  "descricao":"Dinheiro",
  "ativo": true
}

Excluir uma forma de pagamento

Remove do sistema a forma de pagamento informada pelo ID.

Método e URL

DELETE https://api.granatum.com.br/v1/formas_pagamento/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
migracao_id	Informar o ID da outra forma de pagamento caso deseje migrar os lançamentos que estão na forma de pagamento a ser excluída ou não envie nada caso deseje apenas excluir	Integer	Opcional

Exemplo de chamada

curl -i -X DELETE \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/formas_pagamento/1?access_token=token_cliente_granatum'

Exemplo de resposta

true

Tipos documento fiscal

Criar um tipo documento fiscal

Cria um tipo documento fiscal que pode ser utilizado como complemento ao criar um Lançamento.

Método e URL

POST https://api.granatum.com.br/v1/tipos_documento_fiscal

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Nome do tipo documento fiscal	String	Requerido

Exemplo de chamada

curl -i -X POST \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'descricao=Nota fiscal' \
  'https://api.granatum.com.br/v1/tipos_documento_fiscal?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 1,
  "descricao": "Nota fiscal",
  "ativo": true
}

Editar um tipo documento fiscal

Altera os dados do tipo documento fiscal informado pelo ID.

Método e URL

PUT https://api.granatum.com.br/v1/tipos_documento_fiscal/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Nome do tipo documento fiscal	String	Requerido
ativo	Ao inativar um tipo documento fiscal ele não poderá mais ser usado no registro de um lançamento	Boolean	Opcional

Exemplo de chamada

curl -i -X PUT \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'descricao=Nota fiscal' \
  'https://api.granatum.com.br/v1/tipos_documento_fiscal/1?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 1,
  "descricao": "Nota fiscal",
  "ativo": true
}

Listar tipos documento fiscal

Retorna a lista os tipos documento fiscal.

Método e URL

GET https://api.granatum.com.br/v1/tipos_documento_fiscal

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros de busca

Campo	Descrição	Tipo	Obrigatoriedade
considerar_inativos	Listar também os tipos documento fiscal inativos, por padrão é FALSE	Boolean	Opcional

Exemplo de chamada

$ curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/tipos_documento_fiscal?access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "id": 1,
    "descricao": "Nota fiscal",
    "ativo": true
  },
  {
    "id": 2,
    "descricao": "Recibo",
    "ativo": true
  },
  {
    ...
  }
]

Consultar um tipo documento fiscal

Retorna os dados do tipo documento fiscal informado pelo ID.

Método e URL

GET https://api.granatum.com.br/v1/tipos_documento_fiscal/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

$ curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/tipos_documento_fiscal/2?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "id": 2,
  "descricao": "Recibo",
  "ativo": true
}

Excluir um tipo documento fiscal

Remove do sistema o tipo documento fiscal informado pelo ID.

Método e URL

DELETE https://api.granatum.com.br/v1/tipos_documento_fiscal/:id

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
migracao_id	Informar o ID do outro tipo documento fiscal caso deseje migrar os lançamentos que estão no tipo documento fiscal a ser excluído ou não envie nada caso deseje apenas excluir	Integer	Opcional

Exemplo de chamada

$ curl -i -X DELETE \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/tipos_documento_fiscal/43?access_token=token_cliente_granatum'

Exemplo de resposta

true

Tipos custo nível de produção

Listar tipos custo nível de produção

Retorna a lista de tipos custo nível de produção

Método e URL

GET https://api.granatum.com.br/v1/tipos_custo_nivel_producao

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/tipos_custo_nivel_producao?access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "id": 1,
    "descricao": "Fixo"
  },
  {
    "id": 2,
    "descricao": "Variável"
  }
]

Tipos custo apropriação de produto

Listar tipos custo apropriação de produto

Retorna a lista de tipos custo apropriação de produto

Método e URL

GET https://api.granatum.com.br/v1/tipos_custo_apropriacao_produto

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/tipos_custo_apropriacao_produto?access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "id": 1,
    "descricao": "Direto"
  },
  {
    "id": 2,
    "descricao": "Indireto"
  }
]

Cidades

Listar cidades

Retorna a lista de cidades referente ao estado informado na requisição.

Método e URL

GET https://api.granatum.com.br/v1/cidades

Query String

access_token=[token_cliente_granatum]&estado_id=[id_do_estado]

Substitua inclusive os colchetes

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/cidades?access_token=token_cliente_granatum&estado_id=26'

Exemplo de resposta

[
  {
    "id": 492,
    "nome": "Água Branca",
    "estado_id": 26
  },{
    "id": 493,
    "nome": "Anadia",
    "estado_id": 26
  },{
    "id": 494,
    "nome": "Arapiraca",
    "estado_id": 26
  },
  ...
]

Estados

Listar estados

Retorna a lista as estados.

Método e URL

GET https://api.granatum.com.br/v1/estados

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/estados?access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "id": 1,
    "sigla": "AC",
    "nome": "Acre"
  },{
    "id": 2,
    "sigla": "AL",
    "nome": "Alagoas"
  },{
    "id": 3,
    "sigla": "AM",
    "nome": "Amazonas"
  },
  ... 
]

Bancos

Listar bancos

Retorna a lista de bancos

Método e URL

GET https://api.granatum.com.br/v1/bancos

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/bancos?access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "id": 1,
    "nome": "Banco do Brasil S/A"
  },
  {
    "id": 2,
    "nome": "Banco da Amazônia S/A"
  },
  {
    "id": 3,
    "nome": "Banco do Nordeste do Brasil S/A"
  },
  {
    "id": 4,
    "nome": "Banco do Estado de São Paulo S/A"
  },
  ...
]

Logs de auditoria

Consultar logs de auditoria

Retorna os logs de auditoria da conta (ações realizadas no sistema), com filtros opcionais. O acesso é restrito a usuários com perfil de administrador.

Quando o filtro lancamento_id é informado, a API também considera os lançamentos relacionados por repetição (grupo) e por lançamento composto, de forma equivalente à tela de histórico do lançamento no sistema.

Método e URL

GET https://api.granatum.com.br/v1/logs

Query String

access_token=[token_cliente_granatum]
account_id=[id_conta_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
data_inicio	Data/hora inicial no formato `yyyy-MM-dd HH:mm:ss`	String	Opcional
data_fim	Data/hora final no formato `yyyy-MM-dd HH:mm:ss`	String	Opcional
lancamento_id	ID de um lançamento para filtrar os logs relacionados	Integer	Opcional
usuario_id	ID do usuário que realizou a ação	Integer	Opcional
acao	Tipo da ação: `add`, `edit` ou `delete`	String	Opcional
limit	Quantidade de registros por página. O padrão é 50 e o limite máximo é 500.	Integer	Opcional
start	Offset da paginação. Ex.: Para pegar os registros de 151 à 200 use: start=150&limit=50	Integer	Opcional

Exemplo de chamada

curl -i -X GET \
  -H "Accept: application/vnd.granatum-v2+json" \
  'https://api.granatum.com.br/v1/logs?access_token=token_cliente_granatum&account_id=85548&lancamento_id=123218979&limit=50&start=0'

Exemplo de resposta

[
  {
    "id": 471566184,
    "action": "add",
    "model": "Lancamento",
    "title": "Transferência enviada - Renan",
    "usuario_id": 95236,
    "usuario_nome": "Lorelei Lourenço",
    "data_hora": "2026-06-04 19:36:08",
    "acao_tipo": "add",
    "acao_descricao": "adicionou",
    "lancamento_id": 163790810,
    "conta_id": "95616",
    "cliente_id": "3148710",
    "alteracoes": {
      "descricao": { "old": "", "value": "Transferência enviada - Renan" },
      "valor": { "old": "", "value": "-850.00" }
    },
    "alteracoes_formatadas": {
      "descricao": { "label": "Descrição", "old": null, "value": "Transferência enviada - Renan" },
      "valor": { "label": "Valor", "old": null, "value": "-850.00" }
    }
  }
]

Campos da resposta

Campo	Descrição
id	ID do log
action	Ação registrada no banco (`add`, `edit`, `delete`)
model	Modelo afetado (ex.: `Lancamento`)
title	Título/descrição do registro afetado
usuario_id	ID do usuário que realizou a ação
usuario_nome	Nome do usuário que realizou a ação
data_hora	Data e hora da ação no formato `yyyy-MM-dd HH:mm:ss`
acao_tipo	Tipo da ação interpretada (ex.: `add`, `pay`, `receive`)
acao_descricao	Descrição da ação em português (ex.: adicionou, editou, excluiu, pagou, recebeu)
lancamento_id	ID do lançamento relacionado ao log
conta_id	ID da conta bancária relacionada
cliente_id	ID do cliente ou fornecedor relacionado
alteracoes	Objeto com os campos alterados e valores antigos/novos
alteracoes_formatadas	Objeto com os campos alterados e rótulos/valores formatados para exibição

Códigos de resposta

Código	Descrição
200	Sucesso
403	Acesso restrito a administradores
404	Lançamento não encontrado (quando `lancamento_id` for informado e não existir na conta)
422	Parâmetro inválido (ex.: `limit` maior que 500)

Usuários

Listar usuários

Retorna a lista de usuários

Método e URL

GET https://api.granatum.com.br/v1/usuarios

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/usuarios?access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "id": 1,
    "nome": "John Doe"
  },
  ...
]

Orçamentos

Listar orçamentos

Retorna os orçamentos configurados na conta, na mesma ordem do seletor Meus orçamentos da tela de orçamento: ano de início mais recente primeiro e, dentro do mesmo ano, pelo nome.

Método e URL

GET https://api.granatum.com.br/v1/orcamentos

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros de busca

Campo	Descrição	Tipo	Obrigatoriedade
nome	Retorna os orçamentos cujo nome contém o texto informado	String	Opcional
ano	Retorna os orçamentos cujo período passa pelo ano informado. Ex.: um orçamento de 07/2025 a 06/2026 aparece em ano=2025 e em ano=2026	Integer	Opcional
limit	Indica o número de registros por página. Sem esse campo a lista vem completa	Integer	Opcional
start	Indica o offset da paginação. Ex.: Para pegar os registros de 41 a 60 use: start=40&limit=20	Integer	Opcional

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/orcamentos?access_token=token_cliente_granatum'

Exemplo de chamada filtrando por ano

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/orcamentos?ano=2026&access_token=token_cliente_granatum'

Exemplo de chamada com busca por nome

curl -i -G \
  --data-urlencode 'nome=3º tri' \
  --data-urlencode 'access_token=token_cliente_granatum' \
  'https://api.granatum.com.br/v1/orcamentos'

O --data-urlencode codifica os acentos e espaços do nome

Exemplo de chamada paginada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/orcamentos?limit=20&start=40&access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "id": 37,
    "nome": "Orçamento 3º tri 2026",
    "regime": "caixa",
    "data_inicio": "2026-07-01",
    "data_fim": "2026-09-30"
  },
  {
    "id": 21,
    "nome": "Orçamento 2025",
    "regime": "caixa",
    "data_inicio": "2025-01-01",
    "data_fim": "2025-12-31"
  }
]

Campos da resposta

Campo	Descrição	Tipo
id	ID do orçamento, usado no comparativo	Integer
nome	Nome exibido na aba do orçamento	String
regime	Define qual data dos lançamentos entra no comparativo: caixa: Considera a data de vencimento para lançamentos em aberto ou a data de pagamento para lançamentos consolidados competencia: Considera a data de competência	String
data_inicio	Início do período configurado no orçamento	String
data_fim	Fim do período configurado no orçamento	String

Comparativo de um orçamento

Cruza, para cada categoria do orçamento e cada período, o valor orçado com o valor dos lançamentos. É a tabela da tela de orçamento: em cada período, as colunas Orçamento, Realizado/Previsto e Diferença.

As contas bancárias e os centros de custo e lucro configurados no orçamento já filtram os lançamentos. O regime do orçamento define se vale a data de caixa ou a de competência.

Método e URL

GET https://api.granatum.com.br/v1/orcamentos/:id/comparativo

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
agrupar	Define o tamanho de cada coluna, o valor padrão é M1: M1: Agrupar por mês. Ex.: chave 2026-8, rótulo 08/2026 M3: Agrupar por trimestre. Ex.: chave 2026-3, rótulo 3º Tri. 2026 M6: Agrupar por semestre. Ex.: chave 2026-2, rótulo 2º Sem. 2026 M12: Agrupar por ano. Ex.: chave 2026-1, rótulo 2026	String	Opcional
data_inicio	Início do período no formato AAAA-MM-DD. O padrão é o início do orçamento	String	Opcional
data_fim	Fim do período no formato AAAA-MM-DD. O padrão é o fim do orçamento *Não pode ser anterior à data_inicio	String	Opcional
categoria_id[]	ID das categorias do orçamento que devem aparecer. Repita o campo para cada ID	Array	Opcional
tipo[]	Restringe os lançamentos considerados: LP: Despesas pagas LR: Receitas recebidas P: Despesas a pagar, ainda não vencidas R: Receitas a receber, ainda não vencidas PA: Despesas a pagar atrasadas RA: Receitas a receber atrasadas DT: Desconsiderar transferências ST: Somente transferências *Os códigos de LP a RA se somam entre si: tipo[]=LP&tipo[]=LR traz tudo que já foi pago ou recebido. DT e ST se aplicam por cima dessa seleção	Array	Opcional

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/orcamentos/37/comparativo?access_token=token_cliente_granatum'

Exemplo de chamada agrupando por trimestre

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/orcamentos/37/comparativo?agrupar=M3&access_token=token_cliente_granatum'

Exemplo de chamada com outro período

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/orcamentos/37/comparativo?data_inicio=2026-08-01&data_fim=2026-09-30&access_token=token_cliente_granatum'

Exemplo de chamada com categorias

curl -i -g -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/orcamentos/37/comparativo?categoria_id[]=1842&categoria_id[]=1904&access_token=token_cliente_granatum'

O -g impede o curl de interpretar os colchetes. Sem os colchetes a API responde 422

Exemplo de chamada só com o que já foi pago ou recebido

curl -i -g -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/orcamentos/37/comparativo?tipo[]=LP&tipo[]=LR&access_token=token_cliente_granatum'

Exemplo de resposta

{
  "orcamento": {
    "id": 37,
    "nome": "Orçamento 3º tri 2026",
    "regime": "caixa",
    "data_inicio": "2026-07-01",
    "data_fim": "2026-09-30"
  },
  "agrupar": "M1",
  "data_inicio": "2026-07-01",
  "data_fim": "2026-09-30",
  "colunas": {
    "2026-7": { "rotulo": "07/2026", "data_inicio": "2026-07-01", "data_fim": "2026-07-31", "status": "realizado" },
    "2026-8": { "rotulo": "08/2026", "data_inicio": "2026-08-01", "data_fim": "2026-08-31", "status": "realizado_previsto" },
    "2026-9": { "rotulo": "09/2026", "data_inicio": "2026-09-01", "data_fim": "2026-09-30", "status": "previsto" },
    "Total":  { "rotulo": "Total",   "data_inicio": "2026-07-01", "data_fim": "2026-09-30", "status": "realizado_previsto" }
  },
  "receitas": {
    "1841": {
      "categoria_id": 1841,
      "descricao": "Receitas de vendas",
      "cor": "#009900",
      "parent_id": 0,
      "nivel": 0,
      "tem_filhas": true,
      "valores": {
        "2026-7": { "previsto": "10000.00", "realizado": "9500.00",  "diferenca": "-500.00" },
        "2026-8": { "previsto": "10000.00", "realizado": "13000.00", "diferenca": "3000.00" },
        "2026-9": { "previsto": "10000.00", "realizado": "4000.00",  "diferenca": "-6000.00" },
        "Total":  { "previsto": "30000.00", "realizado": "26500.00", "diferenca": "-3500.00" }
      }
    },
    "1842": {
      "categoria_id": 1842,
      "descricao": "Venda de serviços",
      "cor": "#007700",
      "parent_id": 1841,
      "nivel": 1,
      "tem_filhas": false,
      "valores": {
        "2026-7": { "previsto": "10000.00", "realizado": "9500.00",  "diferenca": "-500.00" },
        "2026-8": { "previsto": "10000.00", "realizado": "13000.00", "diferenca": "3000.00" },
        "2026-9": { "previsto": "10000.00", "realizado": "4000.00",  "diferenca": "-6000.00" },
        "Total":  { "previsto": "30000.00", "realizado": "26500.00", "diferenca": "-3500.00" }
      }
    }
  },
  "despesas": {
    "1903": {
      "categoria_id": 1903,
      "descricao": "Despesas administrativas",
      "cor": "#FF6600",
      "parent_id": 0,
      "nivel": 0,
      "tem_filhas": true,
      "valores": {
        "2026-7": { "previsto": "-3000.00", "realizado": "-3000.00", "diferenca": "0.00" },
        "2026-8": { "previsto": "-3000.00", "realizado": "-3200.00", "diferenca": "-200.00" },
        "2026-9": { "previsto": "-3000.00", "realizado": "-3000.00", "diferenca": "0.00" },
        "Total":  { "previsto": "-9000.00", "realizado": "-9200.00", "diferenca": "-200.00" }
      }
    },
    "1904": {
      "categoria_id": 1904,
      "descricao": "Aluguel",
      "cor": "#CE5200",
      "parent_id": 1903,
      "nivel": 1,
      "tem_filhas": false,
      "valores": {
        "2026-7": { "previsto": "-3000.00", "realizado": "-3000.00", "diferenca": "0.00" },
        "2026-8": { "previsto": "-3000.00", "realizado": "-3200.00", "diferenca": "-200.00" },
        "2026-9": { "previsto": "-3000.00", "realizado": "-3000.00", "diferenca": "0.00" },
        "Total":  { "previsto": "-9000.00", "realizado": "-9200.00", "diferenca": "-200.00" }
      }
    }
  },
  "totais": {
    "receitas": {
      "2026-7": { "previsto": "10000.00", "realizado": "9500.00",  "diferenca": "-500.00" },
      "2026-8": { "previsto": "10000.00", "realizado": "13000.00", "diferenca": "3000.00" },
      "2026-9": { "previsto": "10000.00", "realizado": "4000.00",  "diferenca": "-6000.00" },
      "Total":  { "previsto": "30000.00", "realizado": "26500.00", "diferenca": "-3500.00" }
    },
    "despesas": {
      "2026-7": { "previsto": "-3000.00", "realizado": "-3000.00", "diferenca": "0.00" },
      "2026-8": { "previsto": "-3000.00", "realizado": "-3200.00", "diferenca": "-200.00" },
      "2026-9": { "previsto": "-3000.00", "realizado": "-3000.00", "diferenca": "0.00" },
      "Total":  { "previsto": "-9000.00", "realizado": "-9200.00", "diferenca": "-200.00" }
    },
    "saldo": {
      "2026-7": { "previsto": "7000.00",  "realizado": "6500.00",  "diferenca": "-500.00" },
      "2026-8": { "previsto": "7000.00",  "realizado": "9800.00",  "diferenca": "2800.00" },
      "2026-9": { "previsto": "7000.00",  "realizado": "1000.00",  "diferenca": "-6000.00" },
      "Total":  { "previsto": "21000.00", "realizado": "17300.00", "diferenca": "-3700.00" }
    }
  }
}

Exemplo de como utilizar os dados de resposta na construção do orçamento

A tabela abaixo reproduz a tela de orçamento com os números do exemplo de resposta, com as categorias expandidas. As marcações amarelas indicam onde cada parte está no JSON.

colunas[chave].rotulo	07/2026			08/2026			09/2026			Total
colunas[chave].status	Orçamento	Realizado	Diferença	Orçamento	Realizado e previsto	Diferença	Orçamento	Previsto	Diferença	Orçamento	Realizado e previsto	Diferença
Campo em valores[chave]	previsto	realizado	diferenca	previsto	realizado	diferenca	previsto	realizado	diferenca	previsto	realizado	diferenca
Receitas receitas[categoria_id]
▾ Receitas de vendasreceitas["1841"] · nivel 0	10.000,00	9.500,00	-500,00	10.000,00	13.000,00	3.000,00	10.000,00	4.000,00	-6.000,00	30.000,00	26.500,00	-3.500,00
Venda de serviçosreceitas["1842"] · nivel 1	10.000,00	9.500,00	-500,00	10.000,00	13.000,00	3.000,00	10.000,00	4.000,00	-6.000,00	30.000,00	26.500,00	-3.500,00
Total de receitastotais.receitas	10.000,00	9.500,00	-500,00	10.000,00	13.000,00	3.000,00	10.000,00	4.000,00	-6.000,00	30.000,00	26.500,00	-3.500,00
Despesas despesas[categoria_id]
▾ Despesas administrativasdespesas["1903"] · nivel 0	-3.000,00	-3.000,00	0,00	-3.000,00	-3.200,00	-200,00	-3.000,00	-3.000,00	0,00	-9.000,00	-9.200,00	-200,00
Alugueldespesas["1904"] · nivel 1	-3.000,00	-3.000,00	0,00	-3.000,00	-3.200,00	-200,00	-3.000,00	-3.000,00	0,00	-9.000,00	-9.200,00	-200,00
Total de despesastotais.despesas	-3.000,00	-3.000,00	0,00	-3.000,00	-3.200,00	-200,00	-3.000,00	-3.000,00	0,00	-9.000,00	-9.200,00	-200,00
Saldo final do períodototais.saldo	7.000,00	6.500,00	-500,00	7.000,00	9.800,00	2.800,00	7.000,00	1.000,00	-6.000,00	21.000,00	17.300,00	-3.700,00

Na tela, as categorias com nivel maior que 0 ficam recolhidas até clicar em Expandir categorias. Os valores em cinza são de períodos com status previsto.

Onde cada elemento da tela está no JSON

Na tela	No JSON	Como ler
Seletor Meus orçamentos	Listar orçamentos	Mesma lista e mesma ordem, agrupada por ano de início
Nome na aba	orcamento.nome	Junto vêm o regime e o período configurado
Calendário do filtro	data_inicio e data_fim	Período usado na resposta. A tela limita ao período do orçamento; a API aceita qualquer intervalo válido
Agrupar por mês/trimestre/semestre/ano	agrupar	M1, M3, M6 ou M12
Cabeçalho do período (07/2026)	colunas[chave].rotulo	Cada período fica na sua chave, como "2026-8", na ordem da tela; a coluna Total fica na chave "Total", por último. A mesma chave dá acesso direto aos valores do período, sem percorrer listas: valores["2026-8"] e totais.saldo["2026-8"]. As datas de cada coluna ficam em colunas[chave].data_inicio e colunas[chave].data_fim; as das pontas vêm cortadas no período
Coluna Orçamento	valores[chave].previsto	O valor orçado. Veja o aviso logo abaixo
Coluna Realizado, Previsto ou Realizado e previsto	valores[chave].realizado	Soma dos lançamentos do período, pagos e não pagos. O título que a tela mostra vem de colunas[chave].status: realizado, previsto ou realizado_previsto
Coluna Diferença	valores[chave].diferenca	Realizado menos previsto, já calculada
Linhas da seção Receitas	receitas[categoria_id]	Uma entrada por categoria, indexada pelo ID: receitas["1842"].valores["2026-8"] lê direto o valor de agosto de Venda de serviços. As chaves vêm na ordem da tela, com as categorias pai antes das filhas, mas em JavaScript os objetos reordenam chaves numéricas em ordem crescente; para montar a árvore, use nivel e parent_id
Linhas da seção Despesas	despesas[categoria_id]	Mesma estrutura, com valores negativos
Recuo e seta de expandir	nivel, parent_id e tem_filhas	nivel é a profundidade do recuo; tem_filhas indica a seta
Quadrado colorido	cor	Cor da categoria em hexadecimal
Total de receitas	totais.receitas	Mesmo formato de valores
Total de despesas	totais.despesas	Mesmo formato de valores
Saldo final do período	totais.saldo	Receitas somadas às despesas
Filtro de colunas visíveis	-	A API sempre devolve as três colunas; oculte as que não usar
Filtro de categorias	categoria_id[]	Limita as linhas e os totais às categorias informadas
Exportar (CSV)	Resposta inteira	O CSV traz os mesmos números, formatados com vírgula

Atenção ao nome previsto. valores[chave].previsto é o valor orçado, que a tela mostra na coluna Orçamento. Já o "previsto" dentro de colunas[chave].status indica que o período tem lançamentos ainda não pagos e é o título da coluna do meio. Os dois não têm relação.

Relatórios

Fluxo de caixa

Dados do fluxo de caixa de um período.

Método e URL

GET https://api.granatum.com.br/v1/relatorios/fluxo_caixa

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
data_inicio	Data de início para filtro da data conforme o regime	String	Requerido
data_fim	Data de fim para filtro da data conforme o regime *Sempre informar as duas datas para o filtro funcionar	String	Requerido
regime	Define qual data considerar nos filtros de data_inicio e data_fim, o valor padrão é caixa: caixa: Considerara a data de vencimento para lançamentos em aberto ou data de pagamento para lançamentos consolidados competencia: Considera a data de competência	String	Requerido
agrupar	Define a forma como os dados serão agrupados nas colunas, valor padrão é FluxoCaixaMensal. Veja a lista aqui	String	Opcional
conta_id[]	ID da Conta Bancária	Array	Opcional
cliente_id[]	ID do cliente no caso de Receitas	Array	Opcional
fornecedor_id[]	ID do Fornecedor no caso de Despesas	Array	Opcional
classificacao_cliente_id[]	ID da classificação de clientes no caso de Receitas	Array	Opcional
classificacao_fornecedor_id[]	ID da classificação de fornecedores no caso de Despesas	Array	Opcional
categoria_id[]	ID da categoria	Array	Opcional
centro_custo_lucro_id[]	ID do centro de custo e lucro	Array	Opcional
forma_pagamento_id[]	ID da Forma de Pagamento	Array	Opcional
tipo_documento_id[]	ID do tipo de documento	Array	Opcional
tag_id[]	ID da tag	Array	Opcional
busca	Realiza busca aproximada no valor, descrição, observação e nome de cliente/fornecedor	String	Opcional
tipo	Filtra o tipo de lançamento: P: Lancamentos a pagar R: Lançamentos a receber LP: Lancamentos pagos LR: Lançamentos recebidos PA: Lancamentos a pagar atrasados RA: Lançamentos a receber atrasados DT: Desconsiderar transferências ST: Transferências	String	Opcional

Exemplo de chamada

curl -i -X POST \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'agrupar=FluxoCaixaMensal' \
  -d 'data_inicio=2020-01-01' \
  -d 'data_fim=2020-06-30' \
  -d 'regime=caixa' \
  'https://api.granatum.com.br/v1/relatorios/fluxo_caixa?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "data": {
    "colunas": {
      "2020-1": "01/2020",
      "2020-2": "02/2020",
      "2020-3": "03/2020",
      "2020-4": "04/2020",
      "2020-5": "05/2020",
      "2020-6": "06/2020",
      "Total": "Total"
    },
    "status": {
      "2020-1": "Realizado e Previsto",
      "2020-2": "Previsto",
      "2020-3": "Previsto",
      "2020-4": "Previsto",
      "2020-5": "Previsto",
      "2020-6": "Previsto",
      "Total": "Realizado e Previsto"
    },
    "linhas": {
      "categorias_receita": {
        "280169": {
          "id": "280169","parent_id": "0","descricao": "Assinaturas","cor": "#2dbf4b","tipo_categoria_id": "2","nivel": 0,"tem_filhas": false,"filhas": []
        },
        "278723": {
          "id": "278723","parent_id": "0","descricao": "Vendas","cor": "#ffda2f","tipo_categoria_id": "2","nivel": 0,"tem_filhas": true,"filhas": ["279912"]
        },
        "279912": {
          "id": "279912","parent_id": "278723","descricao": "Projetos","cor": "#fdff0f","tipo_categoria_id": "2","nivel": 1,"tem_filhas": false,"filhas": []
        }
      },
      "categorias_despesa": {
        "278847": {
          "id": "278847","parent_id": "0","descricao": "Gastos fixos","cor": "#E70000","tipo_categoria_id": "1","nivel": 0,"tem_filhas": true,"filhas": ["278849","278850","278852","278848"]
        },
        "278849": {
          "id": "278849","parent_id": "278847","descricao": "Aluguel","cor": "#B60000","tipo_categoria_id": "1","nivel": 1,"tem_filhas": false,"filhas": []
        },
        "278850": {
          "id": "278850","parent_id": "278847","descricao": "Contabilidade","cor": "#9B0000","tipo_categoria_id": "1","nivel": 1,"tem_filhas": false,"filhas": []
        },
        "278852": {
          "id": "278852","parent_id": "278847","descricao": "Internet","cor": "#730000","tipo_categoria_id": "1","nivel": 1,"tem_filhas": false,"filhas": []
        },
        "278848": {
          "id": "278848","parent_id": "278847","descricao": "Água","cor": "#C70000","tipo_categoria_id": "1","nivel": 1,"tem_filhas": false,"filhas": []
        }
      }
    },
    "dados_lancamentos": {
      "despesas": {
        "278848": {
          "2020-1": "-56.00",
          "2020-2": "-56.00",
          "2020-3": "-56.00",
          "2020-4": "-56.00",
          "2020-5": "-56.00",
          "2020-6": "-56.00",
          "Total": "-336.00"
        },
        "278849": {
          "2020-1": "-1320.00",
          "2020-2": "-1320.00",
          "2020-3": "-1320.00",
          "2020-4": "-1320.00",
          "2020-5": "-1320.00",
          "2020-6": "-1320.00",
          "Total": "-7920.00"
        },
        "278850": {
          "2020-2": "-2232.22",
          "2020-3": "-2232.22",
          "2020-4": "-2232.22",
          "2020-5": "-2232.22",
          "2020-6": "-2232.22",
          "Total": "-11161.10"
        },
        "278852": {
          "2020-1": "-230.00",
          "2020-2": "-230.00",
          "2020-3": "-230.00",
          "2020-4": "-230.00",
          "2020-5": "-230.00",
          "2020-6": "-230.00",
          "Total": "-1380.00"
        },
        "278847": {
          "2020-1": "-1606.00",
          "2020-2": "-3838.22",
          "2020-3": "-3838.22",
          "2020-4": "-3838.22",
          "2020-5": "-3838.22",
          "2020-6": "-3838.22",
          "Total": "-20797.10"
        },
        "Total": {
          "2020-1": "-1606.00",
          "2020-2": "-3838.22",
          "2020-3": "-3838.22",
          "2020-4": "-3838.22",
          "2020-5": "-3838.22",
          "2020-6": "-3838.22",
          "Total": "-20797.10"
        }
      },
      "receitas": {
        "278723": {
          "2020-1": "3867.50",
          "2020-2": "4696.88",
          "2020-3": "4922.84",
          "2020-4": "4559.78",
          "2020-5": "4696.88",
          "2020-6": "4922.84",
          "Total": "27666.72"
        },
        "279912": {
          "2020-1": "3850.00",
          "2020-2": "3850.00",
          "2020-3": "3850.00",
          "2020-4": "3850.00",
          "2020-5": "3850.00",
          "2020-6": "3850.00",
          "Total": "23100.00"
        },
        "280169": {
          "2020-1": "1560.00",
          "2020-2": "1560.00",
          "2020-3": "1560.00",
          "2020-4": "1560.00",
          "2020-5": "1560.00",
          "2020-6": "1560.00",
          "Total": "9360.00"
        },
        "Total": {
          "2020-1": "5427.50",
          "2020-2": "6256.88",
          "2020-3": "6482.84",
          "2020-4": "6119.78",
          "2020-5": "6256.88",
          "2020-6": "6482.84",
          "Total": "37026.72"
        }
      },
      "saldo_inicial": {
        "2020-1": "-11004.53",
        "2020-2": "-7183.03",
        "2020-3": "-4764.37",
        "2020-4": "-2119.75",
        "2020-5": "161.81",
        "2020-6": "2580.47"
        "Total": "-11004.53",
      },
      "saldo_periodo": {
        "2020-1": "3821.50",
        "2020-2": "2418.66",
        "2020-3": "2644.62",
        "2020-4": "2281.56",
        "2020-5": "2418.66",
        "2020-6": "2644.62",
        "Total": "16229.62"
      },
      "saldo_final": {
        "2020-1": "-7183.03",
        "2020-2": "-4764.37",
        "2020-3": "-2119.75",
        "2020-4": "161.81",
        "2020-5": "2580.47",
        "2020-6": "5225.09",
        "Total": "5225.09"
      }
    }
  }
}

Exemplo de como utilizar os dados de resposta na construção do fluxo de caixa

Agrupamentos do fluxo de caixa

Lista de agrumanetos disponíveis para o fluxo de caixa.

Método e URL

GET https://api.granatum.com.br/v1/relatorios/agrupamentos/fluxo_caixa

Substitua inclusive os colchetes

Query String

access_token=[token_cliente_granatum]

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/relatorios/agrupamentos/fluxo_caixa?access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "texto": "Agrupar por dia",
    "valor": "FluxoCaixaDiario"
  },
  {
    "texto": "Agrupar por semana",
    "valor": "FluxoCaixaSemanal"
  },
  {
    "texto": "Agrupar por mês",
    "valor": "FluxoCaixaMensal"
  },
  {
    "texto": "Agrupar por trimestre",
    "valor": "FluxoCaixaTrimestral"
  },
  {
    "texto": "Agrupar por semestre",
    "valor": "FluxoCaixaSemestral"
  },
  {
    "texto": "Agrupar por ano",
    "valor": "FluxoCaixaAnual"
  }
]

DRE

Dados do DRE de um período.

Método e URL

GET https://api.granatum.com.br/v1/relatorios/dre

Query String

access_token=[token_cliente_granatum]

Substitua inclusive os colchetes

Paramêtros

Campo	Descrição	Tipo	Obrigatoriedade
data_inicio	Data de início para filtro da data conforme o regime	String	Requerido
data_fim	Data de fim para filtro da data conforme o regime *Sempre informar as duas datas para o filtro funcionar	String	Requerido
regime	Define qual data considerar nos filtros de data_inicio e data_fim, o valor padrão é competência: caixa: Considerara a data de vencimento para lançamentos em aberto ou data de pagamento para lançamentos consolidados competencia: Considera a data de competência	String	Requerido
agrupar	Define a forma como os dados serão agrupados nas colunas. Veja a lista aqui	String	Opcional
conta_id[]	ID da Conta Bancária	Array	Opcional
cliente_id[]	ID do cliente no caso de Receitas	Array	Opcional
fornecedor_id[]	ID do Fornecedor no caso de Despesas	Array	Opcional
classificacao_cliente_id[]	ID da classificação de clientes no caso de Receitas	Array	Opcional
classificacao_fornecedor_id[]	ID da classificação de fornecedores no caso de Despesas	Array	Opcional
categoria_id[]	ID da categoria	Array	Opcional
centro_custo_lucro_id[]	ID do centro de custo e lucro	Array	Opcional
forma_pagamento_id[]	ID da Forma de Pagamento	Array	Opcional
tipo_documento_id[]	ID do tipo de documento	Array	Opcional
tag_id[]	ID da tag	Array	Opcional
busca	Realiza busca aproximada no valor, descrição, observação e nome de cliente/fornecedor	String	Opcional
tipo	Filtra o tipo de lançamento: P: Lancamentos a pagar R: Lançamentos a receber LP: Lancamentos pagos LR: Lançamentos recebidos PA: Lancamentos a pagar atrasados RA: Lançamentos a receber atrasados DT: Desconsiderar transferências ST: Transferências	String	Opcional

Exemplo de chamada

curl -i -X POST \
  -H "Content-Type:application/x-www-form-urlencoded" \
  -d 'data_inicio=2020-01-01' \
  -d 'data_fim=2020-12-31' \
  -d 'regime=competencia' \
  'https://api.granatum.com.br/v1/relatorios/dre?access_token=token_cliente_granatum'

Exemplo de resposta

{
  "data": {
    "linhas": [
      {
        "DreTopico": {
          "id": "1",
          "dre_topico_tipo_id": "3",
          "descricao": "Receita Operacional Líquida"
        },
        "children": [
          {
            "DreTopico": {
              "id": "2",
              "dre_topico_tipo_id": "2",
              "descricao": "Receita Operacional Bruta"
            },
            "children": [
              {
                "DreTopico": {
                  "id": "11",
                  "dre_topico_tipo_id": "2",
                  "descricao": "receita Venda"
                },
                "children": []
              },
              {
                "DreTopico": {
                  "id": "26",
                  "dre_topico_tipo_id": "2",
                  "descricao": "receita Serviço"
                },
                "children": []
              },
              {
                "DreTopico": {
                  "id": "69",
                  "dre_topico_tipo_id": "2",
                  "descricao": "dsfsdfds"
                },
                "children": []
              }
            ]
          },
          {
            "DreTopico": {
              "id": "3",
              "dre_topico_tipo_id": "1",
              "descricao": "Deduções das Receitas"
            },
            "children": []
          },
          {
            "DreTopico": {
              "id": "70",
              "dre_topico_tipo_id": "2",
              "descricao": "dsdsfds"
            },
            "children": [
              {
                "DreTopico": {
                  "id": "71",
                  "dre_topico_tipo_id": "2",
                  "descricao": "sadsd"
                },
                "children": []
              }
            ]
          },
          {
            "DreTopico": {
              "id": "72",
              "dre_topico_tipo_id": "2",
              "descricao": "asdasd"
            },
            "children": [
              {
                "DreTopico": {
                  "id": "73",
                  "dre_topico_tipo_id": "2",
                  "descricao": "adasd"
                },
                "children": [
                  {
                    "DreTopico": {
                      "id": "74",
                      "dre_topico_tipo_id": "2",
                      "descricao": "asdsadsa"
                    },
                    "children": []
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "DreTopico": {
          "id": "8",
          "dre_topico_tipo_id": "3",
          "descricao": "Lucro ou Prejuízo Líquido após os tributos"
        },
        "children": [
          {
            "DreTopico": {
              "id": "12",
              "dre_topico_tipo_id": "1",
              "descricao": ""
            },
            "children": []
          },
          {
            "DreTopico": {
              "id": "9",
              "dre_topico_tipo_id": "2",
              "descricao": "Receitas e Despesas Financeiras"
            },
            "children": []
          },
          {
            "DreTopico": {
              "id": "10",
              "dre_topico_tipo_id": "1",
              "descricao": "Outras Receitas e Despesas"
            },
            "children": []
          }
        ]
      }
    ],
    "colunas": {
      "Total": "De 01/01/2020 até 31/12/2020"
    },
    "tipos": {
      "1": {
        "sinal": "(-)",
        "class": "despesa"
      },
      "2": {
        "sinal": "(+)",
        "class": "receita"
      },
      "3": {
        "sinal": "(=)",
        "class": "resultado"
      }
    },
    "dados": {
      "9": {
        "1": "-31966.00",
        "Total": "-31966.00"
      },
      "11": {
        "1": "53142.90",
        "Total": "53142.90"
      },
      "17": {
        "1": "-90080.81",
        "Total": "-90080.81"
      },
      "26": {
        "1": "-7139.60",
        "Total": "-7139.60"
      },
      "27": {
        "1": "1743.36",
        "Total": "1743.36"
      },
      "28": {
        "1": "10674.20",
        "Total": "10674.20"
      },
      "276": {
        "1": "327.50",
        "Total": "327.50"
      },
      "2": {
        "1": 46003.3,
        "Total": 46003.3
      },
      "1": {
        "1": 46003.3,
        "Total": 46003.3
      },
      "8": {
        "1": 14037.3,
        "Total": 14037.3
      },
      "4": {
        "1": 46003.3,
        "Total": 46003.3
      },
      "6": {
        "1": 46003.3,
        "Total": 46003.3
      },
      "279": {
        "1": 14037.3,
        "Total": 14037.3
      }
    }
  }
}

Agrupamentos do DRE

Lista de agrumanetos disponíveis para o DRE.

Método e URL

GET https://api.granatum.com.br/v1/relatorios/agrupamentos/dre

Substitua inclusive os colchetes

Query String

access_token=[token_cliente_granatum]

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/relatorios/agrupamentos/dre?access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "texto": "Sem agrupamento",
    "valor": "DreSemAgrupamento"
  },
  {
    "texto": "Agrupar por mês",
    "valor": "DreMensal"
  },
  {
    "texto": "Agrupar por trimestre",
    "valor": "DreTrimestral"
  },
  {
    "texto": "Agrupar por semestre",
    "valor": "DreSemestral"
  },
  {
    "texto": "Agrupar por centro de custo",
    "valor": "DreCentroCusto"
  },
  {
    "texto": "Agrupar por ano",
    "valor": "DreAnual"
  }
]

Categorias de um Tópico do DRE

Lista de categorias de um Tópico do DRE informado pelo ID.

Método e URL

GET https://api.granatum.com.br/v1/relatorios/categorias/dre/:dre_topico_id

Substitua inclusive os colchetes

Query String

access_token=[token_cliente_granatum]

Exemplo de chamada

curl -i -X GET \
  -H "Content-Type:application/x-www-form-urlencoded" \
  'https://api.granatum.com.br/v1/relatorios/categorias/dre/26?access_token=token_cliente_granatum'

Exemplo de resposta

[
  {
    "id": 278711,
    "descricao": "cccc",
    "cor": "#CC3366",
    "ativo": true,
    "tipo_categoria_id": 0
  },
  {
    "id": 278712,
    "descricao": "ccccccccc",
    "cor": "#993399",
    "ativo": true,
    "tipo_categoria_id": 0
  },
  {
    "id": 279040,
    "descricao": "companhia de Água",
    "cor": "#447AD1",
    "ativo": true,
    "tipo_categoria_id": 0
  }
]

Pluga

Integrações prontas

O Granatum está integrado a Pluga, uma plataforma que te ajuda a fazer integrações entre ferramentas sem precisar saber nada de programação. É Bem simples!

Você só precisa definir regras para ver a mágica acontecer.

Por exemplo, se você usa o PagSeguro para receber dos seus clientes você poderá definir uma regra como essa: A cada recebimento no PagSeguro, inclua um lançamento de recebimento no Granatum.

E dá para fazer muito mais, veja só alguns exemplos:

Exemplos de integrações prontas

Bibliotecas e Plugins

Veja abaixo algumas bibliotecas e plugins desenvolvidos pela comunidade que podem te ajudar na integração do seu sistema com a nossa API.

PHP >=7 https://github.com/bulldesk/granatum-php
PHP >=7 https://github.com/robmachado/apigranatum
PHP >=5.3 https://github.com/lucasnpinheiro/granatum
PHP >=7 / Laravel 5.5.* https://github.com/emanuti/granatum

Ruby >=2.2 https://github.com/eita/granatum-api

WordPress 4.0 https://br.wordpress.org/plugins/wc-granatum/

*Por serem bibliotecas e plugins deservolvidos por terceiros, não conseguimos garantir a continuidade e manutenção dos mesmos.

Outras integrações

Criamos um passo-a-passo para auxiliar nesse processo de integração da API do Granatum o PowerBI, acesse o link a seguir e qualquer dúvida entre em contato com o nosso Atendimento: Integrando API do Granatum com o PowerBI

Nós oferemos um serviço personalizado para que você consiga acessar as informações do Granatum dentro de uma planilha do Google. Entre em contato com o nosso Atendimento para consultar o custo desse serviço e entender quais são as possibilidades.

Campo	Descrição	Tipo	Obrigatoriedade
descricao	Nome da tag	String	Requerido
ativo	Ao inativar uma tag ela não poderá mais ser usada no registro de um lançamento	Boolean	Opcional