Entidades Básicas

São os elementos fundamentais que compõem o sistema de gestão de cobranças recorrentes. Elas são os pilares sobre os quais toda a operação de cobrança é construída.

Essas entidades básicas formam a espinha dorsal do sistema de Venda Recorrente proporcionando uma estrutura sólida e organizada para gerenciar clientes, planos, cobranças e pagamentos de forma eficiente e segura. Essa organização é fundamental para garantir uma experiência positiva, facilitando o processo de recebimentos e contribuindo para a manutenção de uma relação saudável.

📘
Exemplificando as Entidade Básicas
Maria, uma apaixonada por filmes, decidiu assinar um serviço de TV a cabo. Ela, como cliente (cliente), escolheu um pacote com canais de esportes e filmes (produto). A empresa fornecedora do serviço, TV Plus, possui diversos planos com diversos produtos a disposição de Maria, utiliza a plataforma Vindi para gerenciar as assinaturas (assinatura) e pagamentos (pagamento).
Todo mês (periodo), a Vindi gera uma fatura (fatura) detalhada para Maria, informando o valor a ser pago (cobrança) pelo serviço. Maria então recebe a fatura e faz o pagamento (transação) através da Vindi, que registra a transação e notifica a TV Plus. A Vindi facilita o processo (transação), garantindo que Maria continue assistindo seus canais favoritos enquanto a TV Plus recebe os pagamentos de forma organizada e eficiente.
Em outra ocasião, Maria decide comprar um novo televisor (produto). Ela vai até uma loja, escolhe um modelo e a loja emite uma fatura (fatura) através da Vindi. Maria paga **(cobrança)**a fatura usando a plataforma, que registra o pagamento (transação) e informa a loja.
A Vindi atua como intermediária entre Maria e os vendedores, seja TV Plus ou a loja de eletrônicos, simplificando o processo de faturamento e pagamento para ambas as partes. Isso permite que Maria tenha uma experiência de compra e assinatura tranquila e sem complicações.

As definições a seguir serão úteis tanto para a operação através do painel de administração quanto para o desenvolvimento de integrações via API.

📘
Mapa de Fluxo entre as Entidades Básicas

O diagrama de entidades ilustra o relacionamento de um para muitos (1 para X) entre os elementos do sistema, mostrando como uma única entidade pode se conectar a várias outras.

1 Cliente pode ter X Perfis/Métodos de Pagamento.
1 Cliente pode ter X Assinaturas.
1 Cliente pode ter X Faturas avulsas.

1 Assinatura pertence a 1 Cliente.
1 Assinatura pode ter X Itens da Assinatura.
1 Assinatura pode ter X Períodos.

1 Período pertence a 1 Assinatura.
1 Período pode ter X Registros de Utilização.

1 Item da Assinatura pode ter X Descontos.
1 Item da Assinatura pode gerar X Itens da Fatura.

1 Fatura pertence a 1 Cliente (se for avulsa) ou a 1 Assinatura (se for recorrente).
1 Fatura pode ter X Itens da Fatura.
1 Fatura pode ter X Descontos.
1 Fatura pode ter X Cobranças.

1 Item da Fatura pode ter X Registros de Utilização.

1 Cobrança pertence a 1 Fatura.
1 Cobrança pode ter X Transações (se houver, por exemplo, retentativas de pagamento).

1 Transação pertence a 1 Cobrança.