ASAAS

Adicionando a fonte de dados

O ASAAS é um sistema financeiro que permite ao empreendedor realizar a emissão rápida de cobranças via cartão e boleto . A integração de dados do ASAAS para o Data Warehouse criada pela Kondado possibilita que você tenha acesso aos seus dados de cobrança na sua nuvem analítica.

Adicionando o conector

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

1) Faça login na sua conta do ASAAS, na sessão "Minha Conta" clique na aba "Integração" e clique em "Gerar API Key":

2) Após gerar a API Key, copie a chave gerada

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

4) Dê um nome para o seu conector e, em "Token" cole a chave gerada no passo (2)

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

Pipelines

Diagrama de relacionamento

Clique para expandir

Assinaturas

Tipo de replicacao: Integral

[pt] Assinaturas (cobrancas recorrentes) do Asaas: valor em R$, periodicidade, forma de pagamento e status.

Campo	Tipo
customer	text	[pt] Identificador do cliente da assinatura. Clientes > > id
status	text	[pt] Situacao da assinatura: ACTIVE, EXPIRED ou INACTIVE.
billingtype	text	[pt] Forma de pagamento das cobrancas da assinatura: BOLETO, CREDIT_CARD, PIX, DEBIT_CARD, etc.
description	text	[pt] Descricao da assinatura.
sendpaymentbypostalservice	boolean	[pt] Indica se as cobrancas da assinatura sao enviadas via correios.
deleted	boolean	[pt] Indica se a assinatura foi removida.
object	text	[pt] Tipo do objeto retornado pela API do Asaas.
value	float	[pt] Valor de cada cobranca da assinatura, em reais (R$).
datecreated	date	[pt] Data de criacao do registro no Asaas.
discount__type	text	[pt] Campo retornado pela API do Asaas.
discount__limitdate	date	[pt] Campo retornado pela API do Asaas.
discount__duedatelimitdays	float	[pt] Campo retornado pela API do Asaas.
discount__value	float	[pt] Campo retornado pela API do Asaas.
nextduedate	date	[pt] Data de vencimento da proxima cobranca da assinatura.
interest__type	text	[pt] Campo retornado pela API do Asaas.
interest__value	float	[pt] Campo retornado pela API do Asaas.
fine__type	text	[pt] Campo retornado pela API do Asaas.
fine__value	float	[pt] Campo retornado pela API do Asaas.
id	text	[pt] Identificador unico do registro no Asaas.
externalreference	text	[pt] Referencia/identificador do registro no sistema externo do cliente.
cycle	text	[pt] Periodicidade da assinatura: WEEKLY, BIWEEKLY, MONTHLY, BIMONTHLY, QUARTERLY, SEMIANNUALLY ou YEARLY.

Clientes

Tipo de replicacao: Integral

Objeto principal

[pt] Clientes cadastrados no Asaas (pagadores das cobrancas), com dados cadastrais, documento e endereco.

Campo	Tipo
additionalemails	text	[pt] E-mails adicionais do cliente para envio de notificacoes (separados por virgula).
id	text	[pt] Identificador unico do registro no Asaas.
foreigncustomer	boolean	[pt] Indica se o cliente e estrangeiro (sem CPF/CNPJ).
city	text	[pt] Codigo IBGE da cidade do cliente.
cpfcnpj	text	[pt] CPF ou CNPJ do cliente.
state	text	[pt] Unidade federativa (UF) do cliente.
addressnumber	text	[pt] Numero do endereco do cliente.
postalcode	text	[pt] CEP do cliente.
email	text	[pt] E-mail principal do cliente.
province	text	[pt] Bairro do cliente.
notificationdisabled	boolean	[pt] Indica se as notificacoes de cobranca estao desabilitadas para o cliente.
mobilephone	text	[pt] Telefone celular do cliente.
deleted	boolean	[pt] Indica se o registro foi removido (true/false).
company	text	[pt] Empresa associada ao cliente.
object	text	[pt] Tipo do objeto retornado pela API do Asaas.
datecreated	date	[pt] Data de criacao do registro no Asaas.
phone	text	[pt] Telefone fixo do cliente.
address	text	[pt] Logradouro (endereco) do cliente.
complement	text	[pt] Complemento do endereco do cliente.
externalreference	text	[pt] Referencia/identificador do registro no sistema externo do cliente.
name	text	[pt] Nome ou razao social do cliente.
country	text	[pt] Pais do cliente.

asaas_customers__groups

[pt] Grupos aos quais cada cliente do Asaas pertence (relacao cliente x grupo).

Campo	Tipo
groups__name	text	[pt] Campo retornado pela API do Asaas.
customer_id	text	[pt] Identificador unico do registro no Asaas.

Notas Fiscais

Tipo de replicacao: Integral

[pt] Notas fiscais de servico emitidas pelo Asaas: valor em R$, impostos, status e dados do servico municipal.

Campo	Tipo
validationcode	text	[pt] Codigo de validacao/verificacao da nota fiscal.
rpsserie	text	[pt] Serie do RPS (Recibo Provisorio de Servicos).
number	text	[pt] Numero da nota fiscal.
value	float	[pt] Valor da nota fiscal, em reais (R$).
id	text	[pt] Identificador unico do registro no Asaas.
pdfurl	text	[pt] URL do PDF da nota fiscal.
effectivedate	date	[pt] Data de emissao/competencia da nota fiscal.
observations	text	[pt] Observacoes da nota fiscal.
type	text	[pt] Tipo da nota fiscal.
statusdescription	text	[pt] Descricao detalhada da situacao da nota fiscal.
servicedescription	text	[pt] Descricao do servico prestado na nota fiscal.
status	text	[pt] Situacao da nota fiscal: SCHEDULED, SYNCHRONIZED, AUTHORIZED, PROCESSING_CANCELLATION, CANCELED, CANCELLATION_DENIED ou ERROR.
object	text	[pt] Tipo do objeto retornado pela API do Asaas.
rpsnumber	text	[pt] Numero do RPS (Recibo Provisorio de Servicos).
xmlurl	text	[pt] URL do XML da nota fiscal.
deductions	float	[pt] Valor das deducoes da nota fiscal, em reais (R$).
municipalservicename	text	[pt] Nome/descricao do servico municipal.
payment	text	[pt] Identificador da cobranca associada a nota fiscal. Pagamentos > > id
customer	text	[pt] Identificador do cliente da nota fiscal. Clientes > > id
installment	text	[pt] Identificador do parcelamento associado a nota fiscal.
taxes__cofins	float	[pt] Campo retornado pela API do Asaas.
taxes__iss	float	[pt] Campo retornado pela API do Asaas.
taxes__ir	float	[pt] Campo retornado pela API do Asaas.
taxes__csll	float	[pt] Campo retornado pela API do Asaas.
taxes__inss	float	[pt] Campo retornado pela API do Asaas.
taxes__retainiss	boolean	[pt] Campo retornado pela API do Asaas.
taxes__pis	float	[pt] Campo retornado pela API do Asaas.
municipalservicecode	text	[pt] Codigo do servico municipal (lista de servicos).
estimatedtaxesdescription	text	[pt] Campo "estimated taxes description" retornado pela API do Asaas.

Pagamentos

Tipo de replicacao: Integral

[pt] Cobrancas (payments) geradas no Asaas: valores em R$, forma de pagamento, status, vencimento e datas de pagamento/credito.

Campo	Tipo
lastinvoicevieweddate	timestamp	[pt] Data da ultima visualizacao da fatura pelo cliente.
interestvalue	float	[pt] Valor de juros e multa por atraso aplicado, em reais (R$).
duedate	date	[pt] Data de vencimento da cobranca.
invoicenumber	float	[pt] Numero/identificacao da fatura da cobranca.
estimatedcreditdate	date	[pt] Data estimada de credito do valor na conta Asaas.
fine__type	text	[pt] Campo retornado pela API do Asaas.
fine__value	float	[pt] Campo retornado pela API do Asaas.
lastbankslipvieweddate	timestamp	[pt] Data da ultima visualizacao do boleto pelo cliente.
id	text	[pt] Identificador unico do registro no Asaas.
paymentdate	date	[pt] Data em que a cobranca foi baixada/recebida no Asaas.
interest__type	text	[pt] Campo retornado pela API do Asaas.
interest__value	float	[pt] Campo retornado pela API do Asaas.
creditdate	date	[pt] Data em que o valor foi creditado na conta Asaas.
status	text	[pt] Situacao da cobranca: PENDING, RECEIVED, CONFIRMED, OVERDUE, REFUNDED, RECEIVED_IN_CASH, REFUND_REQUESTED, CHARGEBACK_REQUESTED, CHARGEBACK_DISPUTE, AWAITING_CHARGEBACK_REVERSAL, DUNNING_REQUESTED, DUNNING_RECEIVED ou AWAITING_RISK_ANALYSIS.
billingtype	text	[pt] Forma de pagamento: BOLETO, CREDIT_CARD, PIX, DEBIT_CARD, TRANSFER, DEPOSIT ou UNDEFINED.
clientpaymentdate	date	[pt] Data em que o cliente efetuou o pagamento.
description	text	[pt] Descricao da cobranca.
deleted	boolean	[pt] Indica se o registro foi removido (true/false).
object	text	[pt] Tipo do objeto retornado pela API do Asaas.
datecreated	date	[pt] Data de criacao do registro no Asaas.
netvalue	float	[pt] Valor liquido a receber, em reais (R$), ja descontadas as taxas do Asaas.
discount__type	text	[pt] Campo retornado pela API do Asaas.
discount__limitdate	date	[pt] Campo retornado pela API do Asaas.
discount__duedatelimitdays	float	[pt] Campo retornado pela API do Asaas.
discount__value	float	[pt] Campo retornado pela API do Asaas.
anticipated	boolean	[pt] Indica se a cobranca foi antecipada.
externalreference	text	[pt] Referencia/identificador do registro no sistema externo do cliente.
subscription	text	[pt] Identificador da assinatura que originou a cobranca (quando houver). Assinaturas > > id
customer	text	[pt] Identificador do cliente associado a cobranca. Clientes > > id
invoiceurl	text	[pt] URL da fatura da cobranca no Asaas.
bankslipurl	text	[pt] URL do boleto bancario em PDF.
originalduedate	date	[pt] Data de vencimento original da cobranca.
value	float	[pt] Valor da cobranca, em reais (R$).
originalvalue	float	[pt] Valor original da cobranca antes de juros/desconto, em reais (R$).

Transferências

Tipo de replicacao: Integral

[pt] Transferencias (saques) realizadas a partir da conta Asaas: valores em R$, taxa, tipo de operacao (PIX/TED) e status.

Campo	Tipo
status	text	[pt] Situacao da transferencia: PENDING, BANK_PROCESSING, DONE, CANCELLED ou FAILED.
bankaccount__agencydigit	text	[pt] Campo retornado pela API do Asaas.
bankaccount__account	text	[pt] Campo retornado pela API do Asaas.
bankaccount__agency	text	[pt] Campo retornado pela API do Asaas.
bankaccount__accountdigit	text	[pt] Campo retornado pela API do Asaas.
bankaccount__ownername	text	[pt] Campo retornado pela API do Asaas.
bankaccount__cpfcnpj	text	[pt] Campo retornado pela API do Asaas.
bankaccount__bank__code	text	[pt] Campo retornado pela API do Asaas.
bankaccount__bank__name	text	[pt] Campo retornado pela API do Asaas.
bankaccount__accountname	text	[pt] Campo retornado pela API do Asaas.
scheduledate	date	[pt] Data de agendamento da transferencia.
object	text	[pt] Tipo do objeto retornado pela API do Asaas.
datecreated	date	[pt] Data de criacao do registro no Asaas.
netvalue	float	[pt] Valor liquido transferido, em reais (R$), ja descontada a taxa.
id	text	[pt] Identificador unico do registro no Asaas.
effectivedate	timestamp	[pt] Data efetiva (liquidacao) da transferencia.
value	float	[pt] Valor da transferencia, em reais (R$).
transferfee	float	[pt] Taxa cobrada pela transferencia, em reais (R$).
authorized	boolean	[pt] Indica se a transferencia foi autorizada.
type	text	[pt] Campo "type" retornado pela API do Asaas.

Notas

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

Integrar dados do ASAAS via Kondado

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

1

Gerar API Key no ASAAS

Acesse sua conta do ASAAS, vá em "Minha Conta" > "Integração" e clique em "Gerar API Key". Copie a chave gerada para usar na Kondado.

2

Adicionar conector na Kondado

Na plataforma da Kondado, acesse a página de conectores, selecione o ASAAS e dê um nome ao conector.

3

Configurar token de autenticação

No campo "Token", cole a API Key gerada no ASAAS. Salve o conector para finalizar a configuração.

4

Iniciar integração ao destino

Com o conector ativo, escolha seu destino na Kondado (Data Warehouse ou Data Lake) e comece a integrar dados de cobrança, clientes e pagamentos.

Perguntas frequentes

Quais dados do ASAAS posso integrar pela Kondado?▼

Você pode integrar dados de Clientes, Pagamentos, Assinaturas, Transferências e Notas Fiscais. Cada entidade possui campos detalhados como status, valores, datas e informações bancárias, disponíveis no seu Data Warehouse ou Data Lake.

Preciso de conhecimento técnico para gerar a API Key no ASAAS?▼

Não. Basta fazer login no ASAAS, ir em "Minha Conta" > "Integração" e clicar em "Gerar API Key". O processo é simples e não exige programação.

Onde colo a API Key do ASAAS na Kondado?▼

Na plataforma da Kondado, ao adicionar o conector do ASAAS, há um campo chamado "Token" onde você deve colar a chave API gerada. Depois é só salvar.

Posso usar os dados do ASAAS em dashboards?▼

Sim. Após a integração, você pode utilizar os dados em dashboards prontos ou conectar a ferramentas de BI para visualizar métricas financeiras.

Quais destinos a Kondado suporta para os dados do ASAAS?▼

A Kondado permite enviar os dados do ASAAS para Data Warehouses, Data Lakes e outras opções listadas na página de destinos, facilitando análises centralizadas.

A integração do ASAAS com a Kondado é segura?▼

Sim. A Kondado utiliza tokens de API para autenticação e oferece práticas de segurança para proteger seus dados financeiros durante o ETL. Veja mais detalhes em nossa página de segurança.

Escrito por

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