Base de Conhecimento de Gestão Comercial de Saneamento

A maior base de documentação de GSAN do mercado mantida pela Consenso Tecnologia

Ferramentas do usuário

Ferramentas do site


integracoes:web-services-obter-negociacao-parcelamento

Web Service Obter Negociação do Parcelamento

O WebService recebe apenas requisições do tipo GET, e os parâmetros são passados via Query Parameter.

São esperados os seguintes parâmetros:

Parâmetro Valor Tipo
matricula Id do imóvelString
hash hash utilizado para identificar o parcelamentoString
entrada Valor da entradaString
parcela Quantidade de parcelasString
pagination Número da páginaString
Exemplo de Requisição
https://<URL_GSAN>:<porta>/gsan/obterNegociacaoParcelamento?matricula=878510&hash=0195f2e1-22b9-1826-841d-6cc2823505c286c5&entrada=250&parcela=6
Retornos

Com sucesso:

{
    "body": {
        "Saldorestante": 519.82,
        "OpcoesParcelamento": [
            {
                "quantidadePrestacao": 1,
                "valorPrestacao": 523.72,
                "taxaJuros": 0.75,
                "indicadorValorPrestacaoMaiorValorLimite": 2,
                "valorEntrada": 250.00
            },
            {
                "quantidadePrestacao": 2,
                "valorPrestacao": 262.84,
                "taxaJuros": 0.75,
                "indicadorValorPrestacaoMaiorValorLimite": 2,
                "valorEntrada": 250.00
            },
            {
                "quantidadePrestacao": 3,
                "valorPrestacao": 175.88,
                "taxaJuros": 0.75,
                "indicadorValorPrestacaoMaiorValorLimite": 2,
                "valorEntrada": 250.00
            },
            {
                "quantidadePrestacao": 4,
                "valorPrestacao": 132.40,
                "taxaJuros": 0.75,
                "indicadorValorPrestacaoMaiorValorLimite": 2,
                "valorEntrada": 250.00
            },
            {
                "quantidadePrestacao": 5,
                "valorPrestacao": 106.31,
                "taxaJuros": 0.75,
                "indicadorValorPrestacaoMaiorValorLimite": 2,
                "valorEntrada": 250.00
            },
            {
                "indicadorQuantidadeParcelas": 6,
                "quantidadePrestacao": 6,
                "valorPrestacao": 88.93,
                "taxaJuros": 0.75,
                "indicadorValorPrestacaoMaiorValorLimite": 2,
                "valorEntrada": 250.00
            },
            {
                "quantidadePrestacao": 7,
                "valorPrestacao": 76.50,
                "taxaJuros": 0.75,
                "indicadorValorPrestacaoMaiorValorLimite": 2,
                "valorEntrada": 250.00
            },
            {
                "quantidadePrestacao": 8,
                "valorPrestacao": 67.19,
                "taxaJuros": 0.75,
                "indicadorValorPrestacaoMaiorValorLimite": 2,
                "valorEntrada": 250.00
            },
            {
                "quantidadePrestacao": 9,
                "valorPrestacao": 59.95,
                "taxaJuros": 0.75,
                "indicadorValorPrestacaoMaiorValorLimite": 2,
                "valorEntrada": 250.00
            },
            {
                "quantidadePrestacao": 10,
                "valorPrestacao": 54.15,
                "taxaJuros": 0.75,
                "indicadorValorPrestacaoMaiorValorLimite": 2,
                "valorEntrada": 250.00
            }
        ],
        "possuiMaisPaginas": false,
        "quantidadeMaximaPrestacoes": 10,
        "quantidadePrestacaoSelecionada": 6,
        "valorEntradaSelecionada": 250,
        "valorPrestacaoSelecionada": 88.93
    }
}

Com erro:

{
    "error": {
        "parametrosMensagem": [],
        "detailMessage": "Valor da entrada deve ser maior ou igual a entrada miníma do parcelamento R$ 230,95.",
        "stackTrace": [],
        "suppressedExceptions": []
    }
}
Possíveis Códigos de Retorno
Código
200 “OK”
500 “Internal Server Error”
integracoes/web-services-obter-negociacao-parcelamento.txt · Última modificação: 10/09/2025 20:04 por hiroshi.goncalves