Clientes são as empresas ou pessoas que consomem o seu produto e serão cobradas pela Aira. Todo o fluxo de faturamento começa com um cliente cadastrado.
O que é um cliente na Aira
Um cliente representa a entidade que será faturada. Ele é o elo entre os eventos de uso gerados pela sua aplicação e as faturas emitidas pela Aira. Sem um cliente cadastrado, não é possível criar contratos, enviar eventos nem gerar cobranças. Cada cliente possui um ID externo — um identificador definido por você que conecta o cliente no seu sistema ao cliente na Aira. Quando sua aplicação envia eventos de uso, ela referencia o cliente pelo ID externo, e a Aira sabe a quem atribuir o consumo.Criar um cliente
- Via Dashboard
- Via API
- Acesse Clientes no menu lateral
- Clique em Novo Cliente
- Preencha os dados do cliente:
- Nome — nome da empresa ou pessoa
- ID Externo — identificador único no seu sistema
- Tipo — Individual, Subsidiária ou Organização
- Opcionalmente, cadastre uma conta de pagamento com os dados fiscais:
- Razão social, nome fantasia, CNPJ/CPF
- Endereço completo (CEP, rua, número, bairro, cidade, estado)
- E-mails de contato financeiro
- Salve o cliente
Campos do cliente
ID Externo, Tipo e Prefixo de fatura são imutáveis após a criação. O prefixo é gerado automaticamente pela Aira com base no nome do cliente e garante unicidade na numeração de faturas.
Conta de pagamento
Ao criar um cliente, você pode opcionalmente cadastrar uma conta de pagamento — ela armazena os dados fiscais e legais usados nas faturas:- Razão social e nome fantasia
- CNPJ ou CPF (com validação de unicidade)
- Endereço completo (usado em documentos fiscais)
- E-mails para envio de faturas e cobranças
Os e-mails cadastrados aqui são exatamente os endereços que recebem as cobranças. Quando um envio aparece como devolvido em e-mails enviados, é aqui, na conta de pagamento, que você corrige o endereço do destinatário.
Régua de cobrança
A régua de cobrança define os e-mails que o cliente recebe sobre suas faturas — do aviso de emissão aos lembretes de vencimento. Ao criar um cliente, a Aira atribui automaticamente a régua padrão do workspace, se houver uma configurada.Um cliente sem régua atribuída não recebe nenhum e-mail de cobrança — nem o de emissão da fatura. A régua padrão é definida em Réguas de cobrança → Configurações de cobrança; trocá-la depois não reatribui os clientes que já existem.
Gerenciar clientes
Arquivar clientes
Arquivar é uma exclusão lógica — o cliente é marcado como inativo, mas todo o histórico (contratos, faturas, eventos) é preservado para consulta e relatórios. Restrições para arquivar:- Individual ou Organização: Não pode ter contratos ativos ou em rascunho. Todos os contratos precisam estar cancelados ou completos.
- Subsidiária: Não pode estar sendo usada em alocações de nenhum contrato.
- Organização: Ao arquivar, todas as subsidiárias não arquivadas são arquivadas automaticamente.
Clientes arquivados podem ser desarquivados a qualquer momento, restaurando-os para o estado ativo.
Excluir clientes
Além de arquivar, é possível excluir permanentemente um cliente. A exclusão remove o cliente e faz cascata em todos os dados vinculados (contratos, ciclos de cobrança, faturas, contas de pagamento).A exclusão só é permitida quando todas as faturas do cliente estão em Aberta, Em Revisão ou Cancelada; essas faturas são removidas junto. Faturas em qualquer outro status — Emitida, Sincronizada, Pendente, Paga, Atrasada ou Falhou — bloqueiam a exclusão. Esta ação é irreversível.
Próximos passos
- Tipos e hierarquias — entenda a diferença entre Individual, Subsidiária e Organização
- Régua de cobrança — os e-mails de cobrança que o cliente recebe
- E-mails enviados — confirme se as cobranças chegaram ao cliente
- Portal do cliente — disponibilize um portal para seus clientes acessarem faturas e métricas
- Eventos — comece a enviar eventos de uso associados aos seus clientes
- Contratos — vincule planos a clientes para iniciar o faturamento