Base de Conhecimento de Gestão Comercial de Saneamento

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
{{ajuda:logo-gsan3.png?90|}}


====== WebService Acompanhamento de Registro de Atendimento  ======

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

Ele espera os seguintes Parâmetros:
  - matricula, //String// contendo o código do imóvel.
  - pagination, //Integer// Inteiro que espera o número da página com as primeiras 6 OS.
</columns>
\\

===== Exemplo de requisição para o sistema =====

Com as seguintes informações:
|IP|192.168.64.111|
|matricula|9199|
|pagination|1|

\\

===== A Requisição Seria =====

http://192.168.64.111:8080/gsan/acompanharRA?matricula=9199&pagination=1

\\


===== Retorno em Caso de Sucesso =====

<code javascript>
{
    "body": [
        {
            "idRegistroAtendimento": "1634783",
            "tipoSolicitacao": "PADRAO",
            "especificacao": "MUDANCA DE CAVALETE COM RELIGACAO",
            "dataAtendimento": "04/09/2023",
            "situacao": "Encerrado",
            "numeroProtocolo": "20231203143833",
            "dataEncerramento": "30/05/2024",
            "motivoEncerramento": "EXECUCAO DO SERVICO"
        },
        {
            "idRegistroAtendimento": "837278",
            "tipoSolicitacao": "PADRAO",
            "especificacao": "ALTERACAO DE CADASTRO",
            "dataAtendimento": "13/02/2019",
            "situacao": "Encerrado",
            "numeroProtocolo": "20191201907165",
            "dataEncerramento": "13/02/2019",
            "motivoEncerramento": "OUTROS (ESPECIFICAR)"
        },
        {
            "idRegistroAtendimento": "148",
            "tipoSolicitacao": "PADRAO",
            "especificacao": "MULTA / NAO ATENDER EXIG.DAERP",
            "dataAtendimento": "31/05/2017",
            "situacao": "Encerrado",
            "numeroProtocolo": "20170127314",
            "dataEncerramento": "23/01/2024",
            "motivoEncerramento": "PROCESSO DEFERIDO"
        },
        {
            "idRegistroAtendimento": "147",
            "tipoSolicitacao": "PADRAO",
            "especificacao": "MULTA / NAO ATENDER EXIG.DAERP",
            "dataAtendimento": "27/04/2017",
            "situacao": "Encerrado",
            "numeroProtocolo": "20170099604",
            "dataEncerramento": "23/01/2024",
            "motivoEncerramento": "PROCESSO DEFERIDO"
        },
        {
            "idRegistroAtendimento": "145",
            "tipoSolicitacao": "PADRAO",
            "especificacao": "MULTA / NAO ATENDER EXIG.DAERP",
            "dataAtendimento": "12/04/2017",
            "situacao": "Encerrado",
            "numeroProtocolo": "20170086430",
            "dataEncerramento": "23/01/2024",
            "motivoEncerramento": "PROCESSO DEFERIDO"
        },
        {
            "idRegistroAtendimento": "146",
            "tipoSolicitacao": "PADRAO",
            "especificacao": "MULTA / OBSTRUCAO A FISCALIZACAO",
            "dataAtendimento": "12/04/2017",
            "situacao": "Encerrado",
            "numeroProtocolo": "20170089390",
            "dataEncerramento": "20/09/2024",
            "motivoEncerramento": "PROCESSO DEFERIDO"
        },
        {
            "idRegistroAtendimento": "144",
            "tipoSolicitacao": "PADRAO",
            "especificacao": "INSC.DEBITO TARIFARIO EM D.A.",
            "dataAtendimento": "02/09/2014",
            "situacao": "Encerrado",
            "numeroProtocolo": "20140262132",
            "dataEncerramento": "18/06/2025",
            "motivoEncerramento": "PROCESSO DEFERIDO"
        },
        {
            "idRegistroAtendimento": "143",
            "tipoSolicitacao": "PADRAO",
            "especificacao": "INSC.DEBITO TARIFARIO EM D.A.",
            "dataAtendimento": "28/03/2014",
            "situacao": "Encerrado",
            "numeroProtocolo": "20140090510",
            "dataEncerramento": "18/06/2025",
            "motivoEncerramento": "PROCESSO DEFERIDO"
        },
        {
            "idRegistroAtendimento": "44716",
            "tipoSolicitacao": "PADRAO",
            "especificacao": "MULTA / VIOLACAO DO CORTE",
            "dataAtendimento": "30/09/2010",
            "situacao": "Encerrado",
            "numeroProtocolo": "20100269233",
            "dataEncerramento": "11/01/2013",
            "motivoEncerramento": "OUTROS (ESPECIFICAR)"
        },
        {
            "idRegistroAtendimento": "44712",
            "tipoSolicitacao": "PADRAO",
            "especificacao": "REVISAO DE CONSUMO",
            "dataAtendimento": "28/06/2010",
            "situacao": "Encerrado",
            "numeroProtocolo": "20100184467",
            "dataEncerramento": "20/10/2010",
            "motivoEncerramento": "OUTROS (ESPECIFICAR)"
        },
        {}
    ]
}
</code>


===== Retorno em Caso de erro =====
<code javascript>
{
	"error": (Integer) Código de erro da requisição,
	"msg": (String) Mensagem indicando o que houve, ou vazio em caso de erro 500,
	"qtd": (Integer) sempre valor 0
}
</code>

\\

===== Possíveis Códigos de Retorno =====
|Código|Mensagem|
|200|"Sucesso"|
|400|"parâmetros inválidos"|
|401|"chave inválida"|
|404|"A consulta não trouxe resultados"|
|500|“”|
\\

Clique **[[=treinamentos:integracoes|AQUI]]** para acessar outros serviços com os detalhes técnicos das integrações.