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-listar-listar-faturas-pagas

WebService Listar Faturas Pagas

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. key, String contendo a chave de autenticação da empresa.
  2. value, String contendo a matrícula que será usada como filtro.
  3. ano, Integer ano que será usado como filtro.


Exemplo de requisição para o sistema

Com as seguintes informações:

IP192.168.64.111
Chave de autenticaçãoaBC123DEF
Matrícula5101433
Ano2019


A Requisição Seria

Retorno em Caso de Sucesso

{
   "key": (String) chave de autenticação recebida pelo WebService,
   "qtd": (Integer) quantidade de registros retornados,
   "resultado": [
      {
         "idPagamento": (Integer) id do pagamento,
         "idDocumento": (Integer) id do documento pago,
         "referencia": (Integer) referência no formato anoMês,
         "valorPago": (String) valor pago,
         "dataPagamento": (String) data no formato dd/MM/yyyy,
         "arrecadador": Código e nome do Arrecadador no formato: “código-nome”,
         "tipoDocumento": Tipo do Documento “CONTA” ou “GUIA”,
         "dataVencimentoDocumento": (String) data no formato dd/MM/yyyy
      }
   ]
}


Exemplo:


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
}

Exemplo:



Possíveis Códigos de Retorno

CódigoMensagem
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-listar-listar-faturas-pagas.txt · Última modificação: 12/12/2019 18:37 por tadeu.sarmento