# Aira

## Docs

- [Autenticação](https://docs.useaira.com/api-reference/autenticacao.md): Autentique suas requisições à API da Aira usando uma chave de API no header X-API-KEY.
- [Activate contract](https://docs.useaira.com/api-reference/contracts/activate-contract.md): Activates a draft contract. The contract must already have at least one active plan instance.
- [Create contract](https://docs.useaira.com/api-reference/contracts/create-contract.md): Creates a new contract in draft status. Plan instances must be attached before the contract can be activated.
- [Create customer](https://docs.useaira.com/api-reference/customers/create-customer.md): This endpoint allows creating a new customer.
- [Delete customer](https://docs.useaira.com/api-reference/customers/delete-customer.md): This endpoint allows deleting a customer by id.
- [Delete customer by external ID](https://docs.useaira.com/api-reference/customers/delete-customer-by-external-id.md): This endpoint allows deleting a customer by external ID.
- [Fetch customer](https://docs.useaira.com/api-reference/customers/fetch-customer.md): This endpoint allows fetching a customer by id.
- [Fetch customer by external ID](https://docs.useaira.com/api-reference/customers/fetch-customer-by-external-id.md): This endpoint allows fetching a customer by external ID.
- [List customers](https://docs.useaira.com/api-reference/customers/list-customers.md): This endpoint allows fetching a list of customers.
- [Update customer](https://docs.useaira.com/api-reference/customers/update-customer.md): This endpoint allows updating a customer by id.
- [Update customer by external ID](https://docs.useaira.com/api-reference/customers/update-customer-by-external-id.md): This endpoint allows updating a customer by external ID.
- [Respostas de erro](https://docs.useaira.com/api-reference/error-responses.md): Entenda o formato de erros e os códigos de status HTTP retornados pela API da Aira.
- [Ingest events](https://docs.useaira.com/api-reference/events/ingest-events.md): This endpoint allows ingesting events related to customer interactions with resources. Each event captures interactions at a specific point in time, including the event name and customer, the nature of the interaction (value), related properties and when it occurred.
- [Referência da API](https://docs.useaira.com/api-reference/introduction.md): Use a API REST da Aira para integrar eventos de uso, gerenciar clientes, consultar faturas e automatizar seu fluxo de faturamento.
- [Download invoice PDF](https://docs.useaira.com/api-reference/invoices/download-invoice-pdf.md): This endpoint allows downloading the invoice artifact PDF file.
- [Fetch invoice](https://docs.useaira.com/api-reference/invoices/fetch-invoice.md): This endpoint allows fetching an invoice by id.
- [Fetch invoice by provider ID](https://docs.useaira.com/api-reference/invoices/fetch-invoice-by-provider-id.md): This endpoint allows fetching an invoice by its provider ID (e.g. ERP processor id from invoice_sync).
- [List invoices](https://docs.useaira.com/api-reference/invoices/list-invoices.md): This endpoint allows fetching a list of invoice summaries.
- [Create plan instance](https://docs.useaira.com/api-reference/plan-instances/create-plan-instance.md): Creates a plan instance on a contract using the plan's current active version settings.
- [Update plan instance](https://docs.useaira.com/api-reference/plan-instances/update-plan-instance.md): Overrides the pricing and metrics of a plan instance by creating a new plan instance version.
- [Fetch resource](https://docs.useaira.com/api-reference/resources/fetch-resource.md): This endpoint allows fetching a resource by id.
- [List resources](https://docs.useaira.com/api-reference/resources/list-resources.md): This endpoint allows fetching a list of resources.
- [Webhooks](https://docs.useaira.com/api-reference/webhooks.md): Receba notificações em tempo real sobre eventos do sistema via webhooks.
- [Criar clientes](https://docs.useaira.com/clientes/criar-clientes.md): Cadastre clientes na Aira para associá-los a contratos, eventos de uso e faturas.
- [Portal do cliente](https://docs.useaira.com/clientes/portal-do-cliente.md): Disponibilize um portal dedicado para seus clientes acessarem faturas, métricas de uso e informações de cobrança.
- [Tipos e hierarquias](https://docs.useaira.com/clientes/tipos-e-hierarquias.md): Organize clientes em estruturas hierárquicas para cenários como holdings, subsidiárias e organizações com múltiplas unidades.
- [Conceitos Fundamentais](https://docs.useaira.com/comece-aqui/conceitos.md): Entenda as entidades centrais da Aira e como elas se conectam para formar um sistema completo de faturamento baseado em uso.
- [Primeiros passos](https://docs.useaira.com/comece-aqui/primeiros-passos.md): Envie seu primeiro evento, configure um recurso e crie um plano. Em poucos minutos, você verá a Aira calculando cobranças automaticamente.
- [Aira](https://docs.useaira.com/comece-aqui/visao-geral.md): A Aira é a plataforma de faturamento baseada em uso para empresas de software no Brasil. Gerencie eventos de consumo, precificação flexível, faturas automáticas e documentos fiscais em um único lugar.
- [Ciclo de vida](https://docs.useaira.com/contratos/ciclo-de-vida.md): Entenda os status de um contrato na Aira e as transições possíveis entre eles.
- [Configuração de cobrança](https://docs.useaira.com/contratos/configuracao-de-cobranca.md): Configure ciclos de cobrança, períodos, âncoras e prorrata nos contratos da Aira.
- [Criar contratos](https://docs.useaira.com/contratos/criar-contratos.md): Contratos vinculam um ou mais planos a um cliente, definindo quando a cobrança começa, o ciclo de faturamento e as regras de reajuste.
- [Reajustes](https://docs.useaira.com/contratos/reajustes.md): Aplique reajustes automáticos por IGPM, IPCA ou índice customizado aos contratos da Aira.
- [Conceder e consumir créditos](https://docs.useaira.com/creditos/conceder-e-consumir.md): Adicione créditos ao saldo de clientes e acompanhe como são consumidos automaticamente nas faturas.
- [Visão geral](https://docs.useaira.com/creditos/visao-geral.md): Créditos são saldos pré-pagos que podem ser aplicados automaticamente a faturas, reduzindo o valor a pagar.
- [Enviar eventos](https://docs.useaira.com/eventos/enviar-eventos.md): Envie eventos de uso para a Aira via API, interface do Dashboard, planilhas ou integrações.
- [Propriedades e idempotência](https://docs.useaira.com/eventos/propriedades-e-idempotencia.md): Use propriedades adicionais para segmentar eventos e chaves de idempotência para prevenir duplicatas.
- [Visão geral](https://docs.useaira.com/eventos/visao-geral.md): Eventos são registros de uso gerados pelos seus clientes. Eles são a base de todo o faturamento baseado em uso na Aira.
- [Ciclo de vida da fatura](https://docs.useaira.com/faturas/ciclo-de-vida.md): Faturas passam por múltiplos status — de Aberta até Paga ou Atrasada — com ações disponíveis em cada etapa.
- [Descontos e alocações](https://docs.useaira.com/faturas/descontos-e-alocacoes.md): Aplique descontos monetários ou percentuais e distribua o valor da fatura entre múltiplos destinatários.
- [Documentos fiscais](https://docs.useaira.com/faturas/documentos-fiscais.md): A Aira sincroniza NFSe via ERP e gera PDFs e XMLs automaticamente como parte do fluxo de faturamento.
- [Faturamento de clientes](https://docs.useaira.com/faturas/faturamento-de-clientes.md): Entenda como a Aira gera faturas automaticamente a partir de ciclos de cobrança, com itens de linha detalhados e cálculos baseados no uso real.
- [Importação de faturas](https://docs.useaira.com/faturas/importacao.md): Importe faturas em lote a partir de uma planilha XLSX. Cada linha representa uma linha de cobrança; múltiplas linhas com a mesma chave de idempotência formam uma única fatura.
- [Asaas](https://docs.useaira.com/integracoes/asaas.md): Processe cobranças via PIX, Boleto e cartão de crédito com o Asaas.
- [Celcash](https://docs.useaira.com/integracoes/celcash.md): Processe cobranças via PIX, Boleto e Bolepix com rastreamento automático de pagamentos.
- [Conta Azul](https://docs.useaira.com/integracoes/conta-azul.md): Sincronize dados financeiros e contábeis com o Conta Azul.
- [HubSpot](https://docs.useaira.com/integracoes/hubspot.md): Crie contratos e registre expansões na Aira direto dos deals do HubSpot via webhooks.
- [NetSuite](https://docs.useaira.com/integracoes/netsuite.md): Sincronize faturas e dados contábeis com o Oracle NetSuite.
- [Omie](https://docs.useaira.com/integracoes/omie.md): Sincronize faturas, contratos, pagamentos e documentos fiscais com o ERP Omie.
- [Rubeus](https://docs.useaira.com/integracoes/rubeus.md): Sincronize clientes e oportunidades com a Rubeus.
- [Salesforce](https://docs.useaira.com/integracoes/salesforce.md): Sincronize clientes e oportunidades com o Salesforce CRM.
- [Senior](https://docs.useaira.com/integracoes/senior.md): Integre a Aira ao ERP Senior para sincronizar faturas e dados financeiros.
- [Stripe](https://docs.useaira.com/integracoes/stripe.md): Processe pagamentos internacionais e gerencie cobranças com o Stripe.
- [TOTVS](https://docs.useaira.com/integracoes/totvs.md): Integre a Aira ao ERP TOTVS para sincronizar faturas e dados financeiros.
- [Integrações](https://docs.useaira.com/integracoes/visao-geral.md): Conecte a Aira ao seu ERP, gateway de pagamento e CRM para automatizar o fluxo financeiro completo.
- [Métodos de pagamento](https://docs.useaira.com/pagamentos/metodos-de-pagamento.md): A Aira suporta cobrança via PIX, Boleto e Bolepix, integrados com gateways de pagamento brasileiros.
- [Rastreamento e conciliação](https://docs.useaira.com/pagamentos/rastreamento-e-conciliacao.md): Acompanhe o status de pagamentos, registre pagamentos manuais e concilie com o ERP.
- [Criar planos](https://docs.useaira.com/planos/criar-planos.md): Planos definem as regras de cobrança: mensalidade fixa, franquia mínima e métricas baseadas em uso com precificação flexível.
- [Modelos de precificação](https://docs.useaira.com/planos/modelos-de-precificacao.md): A Aira suporta precificação por unidade, pacote, valor fixo e percentual, com faixas progressivas ou faixa única.
- [Versionamento](https://docs.useaira.com/planos/versionamento.md): Planos são versionados por contrato. Cada contrato mantém sua própria versão do plano, garantindo zero efeitos colaterais.
- [Filtragem e agregação](https://docs.useaira.com/recursos/filtragem-e-agregacao.md): Configure filtros para selecionar eventos específicos e escolha como eles serão agregados dentro do ciclo de cobrança.
- [Tipos de recursos](https://docs.useaira.com/recursos/tipos-de-recursos.md): Recursos podem ser unitários (quantidades discretas) ou monetários (valores financeiros). O tipo afeta como são exibidos e quais modelos de precificação podem ser aplicados.
- [Visão geral](https://docs.useaira.com/recursos/visao-geral.md): Recursos transformam eventos brutos em métricas de cobrança, definindo quais eventos contam e como são agregados.
- [Dashboard](https://docs.useaira.com/relatorios/dashboard.md): Acompanhe métricas de faturamento, pagamentos e uso dos seus clientes em um painel centralizado.
- [Exportação de dados](https://docs.useaira.com/relatorios/exportacao-de-dados.md): Exporte dados de eventos, planos, faturas e relatórios customizados em CSV ou Excel.
- [Segurança](https://docs.useaira.com/seguranca/visao-geral.md): Como a Aira protege os dados financeiros dos seus clientes.

## OpenAPI Specs

- [openapi](https://docs.useaira.com/api-reference/openapi.yaml)

## Optional

- [Dashboard](https://app.useaira.com)
- [Fale com a equipe](mailto:contato@useaira.com)