{{:ajuda:logo-gsan3.png?90}}

====== 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 ==
<code>

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

</code>

== Retornos ==

<columns> Com sucesso:

Caso imóvel **exista**.
<code javascript>
{"body":{"dia":22,"mesesCarenciaAlteracao":5}}

</code>

Caso **NÃO** exista imóvel.
<code javascript>
{}

</code>

Com erro:

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


</code>

</columns>

== Possíveis Códigos de Retorno ==

|**Código** | |
|200|"OK"|
|500|"Internal Server Error"|