Buscar Clientes Não-Renovados

Descrição

Este endpoint retorna a lista de clientes que não renovaram seus contratos em um período específico. É útil para acompanhamento de inadimplência, cancelamentos ou análise de retenção de clientes.

🔑 Estrutura de Requisição (Query Param)

Parâmetro	Tipo	Obrigatório	Descrição
dtStart	string(date-time)	Sim	Data inicial do período a ser consultado.
dtEnd	string(date-time)	Sim	Data final do período a ser consultado.

📤 Estrutura de Resposta

A resposta retorna uma lista de clientes com contratos não renovados e informações detalhadas sobre cada registro.

Campo	Tipo	Descrição
idFilial	int32	Identificador da filial.
nomeFilial	string	Nome da filial.
idCliente	int32	Identificador do cliente.
status	string	Status do contrato ou cliente.
contratoAtivo	string	Indica se o contrato estava ativo antes do término.
nome	string	Nome do cliente.
sobrenome	string	Sobrenome do cliente.
contratoVencido	string	Indica se o contrato venceu no período informado.
dataInicio	string(date-time)	Data de início do contrato.
dataFim	string(date-time)	Data de término do contrato.
mesesPermanencia	int32	Quantidade de meses de permanência do contrato.
valor	decimal	Valor do contrato.
flCancelado	boolean	Indica se o contrato foi cancelado.
dtCancelamento	string(date-time)	Data de cancelamento do contrato (se aplicável).
contratoCancelado	string	Descrição do contrato cancelado.
motivoCancelamento	string	Motivo do cancelamento informado.
nomeConsultor	string	Nome do consultor responsável pelo cliente.
celular	string	Telefone do cliente.
email	string	Email do cliente.

✅ Exemplo de Resposta

[
  {
    "idFilial": 10,
    "nomeFilial": "Filial Centro",
    "idCliente": 12345,
    "status": "Contrato Vencido",
    "contratoAtivo": "Não",
    "nome": "João",
    "sobrenome": "Silva",
    "contratoVencido": "Sim",
    "dataInicio": "2024-10-01T00:00:00Z",
    "dataFim": "2025-09-30T23:59:59Z",
    "mesesPermanencia": 12,
    "valor": 1200.00,
    "flCancelado": true,
    "dtCancelamento": "2025-09-30T15:30:00Z",
    "contratoCancelado": "Contrato Anual",
    "motivoCancelamento": "Mudança de cidade",
    "nomeConsultor": "Maria Oliveira",
    "celular": "+5511999999999",
    "email": "[email protected]"
  }
]