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-gerar-cnd

Essa é uma revisão anterior do documento!


WebService Gerar Certidão Negativa

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 o CPF/CNPJ do cliente que se pretende pesquisar.
  3. email, String parâmetro opcional; caso seja informado o sistema envia a certidão para o e-mail informado.


Exemplo de requisição para o sistema:
Com as seguintes informações:

IP192.168.64.111
Chave de autenticaçãoaBC123DEF
Matrícula5136024
E-mail teste@teste.com


A requisição seria:

http://192.168.64.111:8080/gsan/certidaoNegativaDebitos?key=aBC123DEF&value=5136024&ref=teste@teste.com


Retorno em Caso de Sucesso

Download do arquivo PDF


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-gerar-cnd.1576172047.txt.gz · Última modificação: 12/12/2019 17:34 por tadeu.sarmento