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


====== WebService Inserir Doação ======

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

Ele espera os seguintes Parâmetros:
  - key, //String// contendo a chave de autenticação da empresa.
  - matricula, //String// contendo o identificador do imóvel.
  - cnpj, //String// contendo o CNPJ (apenas números) da entidade beneficente que receberá a doação.
  - valor, //String// contendo o valor (com 2 casas decimais separadas por ',') que será doado mensalmente.
  - qtdParcelas, //Integer// contendo a quantidade de parcelas que a doação será realizada.
</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|
|matricula|89035195|
|cnpj|05726909000145|
|valor|1500000,00|
|qtdParcelas|60|
\\

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

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

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

<code javascript>
{
    "key": "fqzc36y8cv-jg1ekgK9-Z9epV_SZSiL_CB_REQ1yFUi-0KSDcbeYlhj6xev5aATX",
    "matricula": 89035195,
    "cnpj": "05726909000145",
    "valor": "1500000,00",
    "qtdParcelas": 60
}
</code>
\\

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

<code javascript>
{
    "key": "fqzc36y8cv-jg1ekgK9-Z9epV_SZSiL_CB_REQ1yFUi-0KSDcbeYlhj6xev5aATX",
    "resultado": {
        "matricula": "890351945",
        "motivo": "OK"
    }
}
</code>
\\

===== Retorno com Insucesso - JSON ===== 
<code javascript>
{
    "key": "fqzc36y8cv-jg1ekgK9-Z9epV_SZSiL_CB_REQ1yFUi-0KSDcbeYlhj6xev5aATX",
    "error": 422,
    "resultado": {
        "motivo": "Entidade beneficente com CNPJ 05726909000145 não cadastrada."
    }
}
</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.