Web Service Dia Atual de Vencimento

O WebService recebe apenas requisições do tipo GET, e os parâmetros são passados via Query Parameter. A funcionalidade irá buscar o dia de vencimento do imóvel informado.

São esperados os seguintes parâmetros:

Parâmetro	Valor	Tipo
matricula	Matrícula do Imóvel	String

Descrição dos Campos de Retorno:

Campos	Tipo	Descrição
dia	Inteiro	Representa o dia de vencimento atual. É obtido a partir do imóvel ou, caso não esteja definido, do grupo de faturamento.
mesesCarenciaAlteracao	Inteiro	Indica a quantidade de meses desde a última alteração do vencimento (carência). Esse valor é calculado com base na diferença entre a data atual e a data de implantação do último vencimento alternativo registrado para o imóvel. Serve para controlar se o cliente ainda está dentro do período mínimo antes de poder solicitar uma nova alteração de vencimento.

Exemplo de Requisição

https://<URL_GSAN>:<porta>/gsan/chatbot/diaAtualVencimento?matricula=9999999

Retornos

Com sucesso:

Caso imóvel exista.

{"body":{"dia":22,"mesesCarenciaAlteracao":5}}

Caso NÃO exista imóvel.

{}

Com erro:

{
    "error": {
        "parametrosMensagem": [],
        "detailMessage": "Erro de acesso ao banco de dados, favor contactar administrador do sistema.",
        "stackTrace": [],
        "suppressedExceptions": []
    }
}

Possíveis Códigos de Retorno

Código
200	“OK”
500	“Internal Server Error”