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-acompanhar-os

WebService Acompanhamento de Registro de Atendimento

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:

  1. matricula, String contendo o código do imóvel.
  2. pagination, Integer Inteiro que espera o número da página com as primeiras 6 OS.


Exemplo de requisição para o sistema

Com as seguintes informações:

IP192.168.64.111
matricula9199
pagination1


A Requisição Seria

Retorno em Caso de Sucesso

{
    "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)"
        },
        {}
    ]
}

Retorno em Caso de erro

{
	"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
}


Possíveis Códigos de Retorno

CódigoMensagem
200“Sucesso”
400“parâmetros inválidos”
401“chave inválida”
404“A consulta não trouxe resultados”
500“”


Clique AQUI para acessar outros serviços com os detalhes técnicos das integrações.

integracoes/web-services-acompanhar-os.txt · Última modificação: 18/02/2026 19:37 por moises.simoes