{{ajuda:logo-gsan3.png?90|}}


====== WebService Consultar Doação ======

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

Os seguinte parâmetros são esperados:
  - key (Obrigatório), //String// contendo a chave de autenticação da empresa.
  - cnpj (Obrigatório), //String// contendo o CNPJ (apenas números) da entidade beneficente que receberá a doação.
  - dtInicial (Obrigatório), //String// contendo uma data no formato "dd/mm/aaaa" com a data inicial da adesão ao cadastro de doações
  - matricula (Opcional), //String// contendo o identificador do imóvel.
</columns>
\\

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

Com as seguintes informações:
|URL|http://evolutiva.consensotec.com.br:8106|
|key|j4iugjg94l-jg1ekgK9-Z9epV_SZSiL_CB_REQ1yFUi-0KSDcbeYlhj6xev5aBAC|
|cnpj|05726909000145|
|dtInicial|01/01/2023|
\\

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

http://evolutiva.consensotec.com.br:8106/gsan/consultarDoacao

===== Envio - JSON  ===== 

<code javascript>
{
    "key": "fqzc36y8cv-jg1ekgK9-Z9epV_SZSiL_CB_REQ1yFUi-0KSDcbeYlhj6xev5aATX",
    "cnpj": "40970592000190",
    "dtInicial": "01/05/2023"
}
</code>
\\

===== Retorno com Sucesso - JSON =====

<code javascript>
{
    "key": "fqzc36y8cv-jg1ekgK9-Z9epV_SZSiL_CB_REQ1yFUi-0KSDcbeYlhj6xev5aATX",
    "qtd": 3,
    "resultado": {
        "motivo": "OK",
        "doacoes": [
            {
                "matricula": "11885343",
                "entidade": "AMECC - ASSOCIACAO MENORES COM CRISTO",
                "valor": "40,00",
                "dtAdesao": "23/08/2023",
                "usuarioAdesao": "INTERNET",
                "dtCancelamento": "23/08/2023",
                "usuarioCancelamento": "INTERNET"
            },
            {
                "matricula": "11885343",
                "entidade": "AMECC - ASSOCIACAO MENORES COM CRISTO",
                "valor": "500,00",
                "dtAdesao": "22/08/2023",
                "usuarioAdesao": "INTERNET",
                "dtCancelamento": "22/08/2023",
                "usuarioCancelamento": "INTERNET"
            },
            {
                "matricula": "60",
                "entidade": "AMECC - ASSOCIACAO MENORES COM CRISTO",
                "valor": "150,00",
                "dtAdesao": "19/08/2023",
                "usuarioAdesao": "GSAN ADMIN"
            }
        ]
    }
}
</code>
\\

===== Retorno com Insucesso - JSON ===== 
<code javascript>
{
    "key": "fqzc36y8cv-jg1ekgK9-Z9epV_SZSiL_CB_REQ1yFUi-0KSDcbeYlhj6xev5aATX",
    "error": 422,
    "qtd": 0,
    "resultado": {
        "motivo": "A pesquisa não retornou resultados."
    }
}
</code>
\\

===== Possíveis Códigos de Retorno =====
|Código|Mensagem|Body
|200|"OK"|
|500|"Internal Server Error"|
|404|"Page not found"|
|422|"Unprocessable Entity"|

\\

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