Fatura Simples

Adicionando a fonte de dados

O Fatura Simples é uma plataforma brasileira para gestão de cobranças e faturas que conta com faturamento recorrente automático (com nota fiscal e boleto bancário) e suporte aos principais bancos e prefeituras.

Adicionando o conector

Para adicionar o conector do Fatura Simples na plataforma da Kondado, siga os passos abaixo:

1) Faça login no Fatura Simples e, no menu lateral à esquerda, selecione a opção "Configurações"

2) No submenu de configurações, selecione "Chaves da API"

3) Na página de Chaves de API, clique no botão de gerar nova chave e copie a nova chave gerada

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

5) Dê um nome para o seu conector preencha as informações conforme abaixo:

ID da conta: é o início do endereço que você usa para acessar a sua página do Fatura Simples. Por exemplo, se o seu endereço é suaempresa.faturasimples.com.br, então o valor que você deve colocar aqui é suaempresa
Chave da API: é a chave gerada no passo (3)

Agora, basta criar as integrações e começar a criar seus modelos para acompanhar a saúde financeira da sua empresa!

Pipelines

Diagrama de relacionamento

Clique para expandir

Parcelas Venda

Tipo de replicacao: Integral

Relacionamentos:

id_venda → Vendas > id

[pt] Parcelas das vendas/faturas: cada linha é uma parcela de cobrança com vencimento, valores, status de pagamento e dados do boleto.

Campo	Tipo
id	text	[pt] Identificador único da parcela da venda.
id_venda	text	[pt] Identificador da venda à qual a parcela pertence. Vendas > > id
parcela	float	[pt] Número da parcela dentro do parcelamento da venda.
numero	text	[pt] Número do documento/boleto da parcela.
data_vencimento	date	[pt] Data de vencimento da parcela.
data_credito	date	[pt] Data de crédito do valor da parcela.
data_vencimento_original	date	[pt] Data de vencimento original da parcela, antes de prorrogações.
valor	float	[pt] Valor da parcela, em reais (R$).
valor_original	float	[pt] Valor original da parcela antes de descontos, juros ou multa, em reais (R$).
valor_recebido	float	[pt] Valor efetivamente recebido da parcela, em reais (R$).
valor_tarifas	float	[pt] Valor de tarifas descontadas da parcela, em reais (R$).
status	text	[pt] Status de cobrança da parcela (ex.: pago, pendente, vencido).
data_recebimento	timestamp	[pt] Data e hora de recebimento do pagamento da parcela.
pdf_url	text	[pt] URL do PDF do boleto da parcela.
linha_digitavel	text	[pt] Linha digitável do boleto da parcela.

Vendas

Tipo de replicacao: Integral

Objeto principal

[pt] Vendas/faturas do Fatura Simples: cada linha é uma fatura com cliente, serviço, valores, vencimento, meio de pagamento e dados de cobrança.

Campo	Tipo
id	text	[pt] Identificador único da venda/fatura no Fatura Simples.
id_servico	text	[pt] Identificador do serviço principal associado à venda.
valor_recebido	float	[pt] Valor total já recebido da venda, em reais (R$).
sms_enviado	text	[pt] Indica se o SMS de cobrança foi enviado ao cliente.
agendamento_sequencia	float	[pt] Número de sequência da venda dentro de um agendamento recorrente.
agendamento_automatico	float	[pt] Indica se o agendamento de geração da venda é automático.
nfse_status	float	[pt] Status de emissão da nota fiscal de serviço (NFS-e) da venda.
meio_pagamento__desconto_valor	text	[pt] Valor de desconto configurado no meio de pagamento (boleto).
meio_pagamento__instrucao_2	text	[pt] Segunda linha de instruções impressa no boleto de cobrança.
meio_pagamento__agencia	text	[pt] Agência bancária utilizada na cobrança.
meio_pagamento__banco	text	[pt] Código ou nome do banco emissor da cobrança.
meio_pagamento__nome	text	[pt] Nome do meio de pagamento configurado.
meio_pagamento__tarifa_cobranca	float	[pt] Tarifa cobrada pela emissão da cobrança/boleto.
meio_pagamento__expiracao_prazo	text	[pt] Prazo de expiração do meio de pagamento.
meio_pagamento__conta_dv	text	[pt] Dígito verificador da conta bancária da cobrança.
meio_pagamento__especie	text	[pt] Espécie do documento de cobrança (ex.: DM, duplicata).
meio_pagamento__agencia_dv	text	[pt] Dígito verificador da agência bancária.
meio_pagamento__multa	float	[pt] Percentual ou valor de multa por atraso configurado na cobrança.
meio_pagamento__instrucao_1	text	[pt] Primeira linha de instruções impressa no boleto de cobrança.
meio_pagamento__desconto_prazo	text	[pt] Prazo limite para concessão de desconto na cobrança.
meio_pagamento__juros	float	[pt] Percentual ou valor de juros por atraso configurado na cobrança.
meio_pagamento__cnab	text	[pt] Configuração do layout CNAB do meio de pagamento.
meio_pagamento__tempo_credito	text	[pt] Prazo para crédito do valor após o pagamento.
meio_pagamento__desconto_recorrente	float	[pt] Indica se o desconto é aplicado de forma recorrente.
meio_pagamento__id_conta_finan	text	[pt] Identificador da conta financeira vinculada ao meio de pagamento.
meio_pagamento__parcelas_fixo	text	[pt] Quantidade fixa de parcelas configurada no meio de pagamento.
meio_pagamento__cartao_tarifa	text	[pt] Tarifa aplicada em pagamentos por cartão.
meio_pagamento__id	text	[pt] Identificador do meio de pagamento.
meio_pagamento__prazo_pagamento_fixo	text	[pt] Prazo fixo de pagamento configurado no meio de pagamento.
meio_pagamento__tipo	text	[pt] Tipo do meio de pagamento (boleto, cartão, pix, etc.).
meio_pagamento__boleto_confirmacao	float	[pt] Indica se há confirmação automática do pagamento do boleto.
meio_pagamento__remessa_numero	text	[pt] Número da remessa bancária da cobrança.
meio_pagamento__cartao_valor_fixo	text	[pt] Valor fixo configurado para cobrança via cartão.
meio_pagamento__primeiropay_url	text	[pt] URL de pagamento gerada pelo gateway PrimeiroPay.
meio_pagamento__desconto_valor_percentual	float	[pt] Percentual de desconto configurado no meio de pagamento.
meio_pagamento__intervalo_parcelas	float	[pt] Intervalo, em dias, entre as parcelas.
meio_pagamento__primeiropay_channel_id	text	[pt] Identificador do canal no gateway PrimeiroPay.
meio_pagamento__status	text	[pt] Status do meio de pagamento da cobrança.
meio_pagamento__parcelas	float	[pt] Número de parcelas do meio de pagamento.
meio_pagamento__carteira	text	[pt] Carteira bancária utilizada na emissão do boleto.
meio_pagamento__atualizar_link	text	[pt] Link para atualização dos dados do meio de pagamento.
meio_pagamento__aceite	float	[pt] Indica o aceite do documento de cobrança.
meio_pagamento__primeiropay_access_token	text	[pt] Token de acesso ao gateway PrimeiroPay.
meio_pagamento__convenio	text	[pt] Número do convênio bancário da cobrança.
meio_pagamento__cartao_intermediario	text	[pt] Intermediador de pagamento por cartão configurado.
meio_pagamento__prazo_pagamento	text	[pt] Prazo de pagamento configurado na cobrança.
meio_pagamento__conta	text	[pt] Conta bancária utilizada na cobrança.
meio_pagamento__prazo	text	[pt] Prazo configurado no meio de pagamento.
meio_pagamento__instrucoes1	text	[pt] Primeira instrução adicional do meio de pagamento.
meio_pagamento__instrucoes2	text	[pt] Segunda instrução adicional do meio de pagamento.
meio_pagamento__instrucoes3	text	[pt] Terceira instrução adicional do meio de pagamento.
meio_pagamento__instrucoes4	text	[pt] Quarta instrução adicional do meio de pagamento.
email_erro	timestamp	[pt] Data e hora de erro no envio do e-mail de cobrança.
parcela_status	float	[pt] Status da parcela associada à venda.
agendamento_data	date	[pt] Data do agendamento de geração da venda.
agendamento_data_fim	text	[pt] Data final do agendamento recorrente da venda.
agendamento	float	[pt] Indica se a venda possui agendamento recorrente.
metodo_cobranca	text	[pt] Método de cobrança utilizado na venda.
parcelas	float	[pt] Número de parcelas da venda.
nfse	text	[pt] Dados da nota fiscal de serviço (NFS-e) vinculada à venda.
agendamento_data_geracao	text	[pt] Data de geração da venda dentro do agendamento.
agendamento_frequencia	float	[pt] Frequência do agendamento recorrente (ex.: mensal).
data	date	[pt] Data de emissão da venda/fatura.
valor_venda	float	[pt] Valor total da venda, em reais (R$).
email_leitura	timestamp	[pt] Data e hora de leitura do e-mail de cobrança pelo cliente.
agendamento_ativo	float	[pt] Indica se o agendamento da venda está ativo.
servico__status	float	[pt] Status do serviço associado à venda.
servico__codigo_tributacao_municipio	text	[pt] Código de tributação municipal do serviço.
servico__impostos_percentual	text	[pt] Percentual de impostos aplicado ao serviço.
servico__id_atividade	text	[pt] Identificador da atividade do serviço.
servico__id_servico	text	[pt] Identificador do serviço.
servico__id	text	[pt] Identificador do registro de serviço.
servico__atividade	text	[pt] Descrição da atividade do serviço.
servico__nome	text	[pt] Nome do serviço.
servico__servico	text	[pt] Descrição do serviço prestado.
servico__dados_extra	text	[pt] Dados extras do serviço.
servico__valor	float	[pt] Valor unitário do serviço, em reais (R$).
servico__discriminacao	text	[pt] Discriminação detalhada do serviço.
boletos	text	[pt] Lista de boletos gerados para a venda.
valor_parcelas	float	[pt] Valor de cada parcela da venda, em reais (R$).
email_enviar	float	[pt] Indica se o e-mail de cobrança deve ser enviado.
data_vencimento	date	[pt] Data de vencimento da venda/cobrança.
data_vencimento_original	date	[pt] Data de vencimento original da cobrança, antes de prorrogações.
sms_enviar	text	[pt] Indica se o SMS de cobrança deve ser enviado.
pagamento_online_link	text	[pt] Link para pagamento online da venda.
email_entrega	timestamp	[pt] Data e hora de entrega do e-mail de cobrança.
vencido_dias	float	[pt] Quantidade de dias em atraso da cobrança.
fenix_count	float	[pt] Contador de tentativas de recuperação automática da cobrança.
email_enviado	timestamp	[pt] Data e hora de envio do e-mail de cobrança.
dados_extra	text	[pt] Dados extras da venda.
data_recebimento	date	[pt] Data de recebimento do pagamento da venda.
agendamento_numero	float	[pt] Número da ocorrência dentro do agendamento recorrente.
discriminacao	text	[pt] Discriminação detalhada da venda/fatura.
cliente__id_cidade	float	[pt] Identificador da cidade do cliente.
cliente__inscricao_estadual	text	[pt] Inscrição estadual do cliente.
cliente__data_nascimento	text	[pt] Data de nascimento do cliente.
cliente__id	float	[pt] Identificador único do cliente.
cliente__complemento	text	[pt] Complemento do endereço do cliente.
cliente__tipo	text	[pt] Tipo de cliente (pessoa física ou jurídica).
cliente__nome	text	[pt] Nome do cliente.
cliente__inscricao_municipal	text	[pt] Inscrição municipal do cliente.
cliente__logotipo	text	[pt] Logotipo do cliente.
cliente__status	float	[pt] Status do cadastro do cliente.
cliente__cnpj	text	[pt] CNPJ do cliente (pessoa jurídica).
cliente__bairro	text	[pt] Bairro do endereço do cliente.
cliente__numero	text	[pt] Número do endereço do cliente.
cliente__cep	text	[pt] CEP do endereço do cliente.
cliente__estado	text	[pt] Estado (UF) do cliente.
cliente__cadastro	text	[pt] Informações de cadastro do cliente.
cliente__razao_social	text	[pt] Razão social do cliente (pessoa jurídica).
cliente__dados_extra	text	[pt] Dados extras do cliente.
cliente__cpf	text	[pt] CPF do cliente (pessoa física).
cliente__identidade	text	[pt] Documento de identidade (RG) do cliente.
cliente__data_cadastro	timestamp	[pt] Data e hora de cadastro do cliente.
cliente__endereco	text	[pt] Logradouro do endereço do cliente.
cliente__codigo	text	[pt] Código de referência do cliente.
cliente__obs	text	[pt] Observações sobre o cliente.
agendamento_repetir	float	[pt] Número de repetições do agendamento recorrente.
desconto	text	[pt] Valor ou percentual de desconto aplicado à venda.

faturasimples_vendas__servicos

[pt] Itens de serviço de cada venda/fatura: relaciona a venda aos serviços cobrados, com quantidade, valor unitário e total.

Campo	Tipo
venda_id	text	[pt] Identificador da venda à qual o serviço pertence.
servicos__recorrente	float	[pt] Indica se o serviço é recorrente (1) ou avulso (0).
servicos__servico	text	[pt] Descrição do serviço incluído na venda.
servicos__id_servico	text	[pt] Identificador do serviço incluído na venda.
servicos__qtd	float	[pt] Quantidade do serviço na venda.
servicos__valor	float	[pt] Valor unitário do serviço, em reais (R$).
servicos__total	float	[pt] Valor total do item de serviço (quantidade x valor), em reais (R$).

Notas

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

Integrar Fatura Simples à Kondado

Conecte os dados de cobranças e faturas do Fatura Simples ao seu data warehouse via Kondado para acompanhar a saúde financeira da empresa.

Gerar chave de API no Fatura Simples

Acesse o Fatura Simples, vá em Configurações no menu lateral e selecione Chaves da API. Clique em gerar nova chave e copie o valor gerado.

Identificar o ID da conta

O ID da conta é o prefixo do seu endereço de acesso (ex: suaempresa.faturasimples.com.br). Anote esse valor para usar na configuração do conector.

Adicionar o conector na Kondado

Na plataforma da Kondado, vá para a página de adicionar conectores, selecione o Fatura Simples e preencha o nome, ID da conta e a chave da API.

Criar integrações e modelos de dados

Após configurar o conector, crie as integrações de dados e monte seus modelos para analisar vendas, parcelas e serviços no seu data warehouse.

Visualizar dados em dashboards

Utilize os dados integrados para construir análises financeiras. Você pode explorar dashboards prontos ou conectar a ferramentas de BI para acompanhar métricas de faturamento.

Perguntas frequentes

O que é o Fatura Simples?▼

O Fatura Simples é uma plataforma brasileira para gestão de cobranças e faturas, com suporte a faturamento recorrente automático, emissão de nota fiscal, boleto bancário e integração com principais bancos e prefeituras.

Quais dados do Fatura Simples posso integrar pela Kondado?▼

É possível integrar dados das tabelas Vendas, Serviços e Parcelas Venda, incluindo informações sobre clientes, meios de pagamento, status de NFSe, valores recebidos, datas de vencimento e muito mais.

Onde encontro a chave de API no Fatura Simples?▼

Faça login no Fatura Simples, acesse o menu lateral em Configurações e depois Chaves da API. Na página correspondente, clique no botão para gerar uma nova chave e copie o valor gerado.

Como identifico meu ID da conta no Fatura Simples?▼

O ID da conta é o início do endereço URL que você utiliza para acessar sua página no Fatura Simples. Por exemplo, se seu endereço é suaempresa.faturasimples.com.br, o ID da conta é suaempresa.

Para que serve integrar o Fatura Simples a um data warehouse?▼

A integração permite centralizar dados de cobranças e faturas para análise consolidada. Com os dados no data warehouse, você pode criar modelos, acompanhar a saúde financeira da empresa e conectar a ferramentas de BI para visualizações avançadas.

O Fatura Simples tem integração nativa com ferramentas de BI?▼

Através da Kondado, os dados do Fatura Simples podem ser enviados para diversos destinos. A plataforma oferece páginas específicas de visualização como Data Studio, Amazon QuickSight e outras ferramentas de BI.

Escrito por

Thassyo Pereira·Publicado em 2020-03-24·Atualizado em 2026-06-01