Buscar Clientes Ativos

Descrição

Este endpoint retorna a lista de clientes com contratos ativos, incluindo informações sobre contratos atuais e futuros. É útil para acompanhamento da base ativa, planejamento de retenção e análise de contratos vigentes.

🔑 Parâmetros da Requisição

Este endpoint não possui parâmetros.

📤 Estrutura da Resposta

A resposta retorna uma lista de clientes ativos com detalhes sobre contratos atuais e futuros.

Campo	Tipo	Descrição
idFilial	int32	Identificador da filial.
filial	string	Nome da filial.
idCliente	int32	Identificador do cliente.
nomeCompleto	string	Nome completo do cliente.
telefone	string	Telefone do cliente.
email	string	Email do cliente.
idClienteContratoAtivo	int32	ID do contrato ativo do cliente.
contratoAtivo	string	Nome ou descrição do contrato ativo.
dtInicioContratoAtivo	string(date-time)	Data de início do contrato ativo.
dtFimContratoAtivo	string(date-time)	Data de término do contrato ativo.
idClienteContratoFuturo	int32	ID do contrato futuro do cliente, se houver.
contratoFuturo	string	Nome ou descrição do contrato futuro, se houver.
dtInicioContratoFuturo	string(date-time)	Data de início do contrato futuro, se houver.
dtFimContratoFuturo	string(date-time)	Data de término do contrato futuro, se houver.

✅ Exemplo de Resposta

[
  {
    "idFilial": 10,
    "filial": "Filial Centro",
    "idCliente": 12345,
    "nomeCompleto": "João da Silva",
    "telefone": "+5511999999999",
    "email": "[email protected]",
    "idClienteContratoAtivo": 789,
    "contratoAtivo": "Plano Anual Premium",
    "dtInicioContratoAtivo": "2025-01-01T00:00:00Z",
    "dtFimContratoAtivo": "2025-12-31T23:59:59Z",
    "idClienteContratoFuturo": 790,
    "contratoFuturo": "Plano Anual VIP",
    "dtInicioContratoFuturo": "2026-01-01T00:00:00Z",
    "dtFimContratoFuturo": "2026-12-31T23:59:59Z"
  }
]