# Administração

![](https://1903351976-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LDNb2_jHPaxMkJuVb78%2F-LDNb6wc-IXE5Wl_vyZI%2F-LDNb7Utg_q7uESmghId%2Fsws_logo150x35.png?generation=1527273787883481\&alt=media)

## Administração

### Webservices Administrativos

#### Endpoints

**Descrição:** Consultar o Saldo disponível em uma conta:

**Produção:** <http://www.soawebservices.com.br/webservices/producao/sws/administracao.asmx>

**Test-Drive:** Não Disponível

**Headers:**

```
POST /webservices/producao/sws/administracao.asmx HTTP/1.1
Host: www.soawebservices.com.br
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "SOAWebServices/Saldo"
```

**Requisição SOAP/XML:**

```markup
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <Saldo xmlns="SOAWebServices">
      <Credenciais>
        <Email>string</Email>
        <Senha>string</Senha>
      </Credenciais>
    </Saldo>
  </soap:Body>
</soap:Envelope>
```

**Resposta SOAP/XML:**

```markup
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <SaldoResponse xmlns="SOAWebServices">
      <SaldoResult>
        <Saldo>decimal</Saldo>
        <Mensagem>string</Mensagem>
        <Status>boolean</Status>
        <Transacao>
          <Status>boolean</Status>
          <CodigoStatus>string</CodigoStatus>
          <CodigoStatusDescricao>string</CodigoStatusDescricao>
        </Transacao>
      </SaldoResult>
    </SaldoResponse>
  </soap:Body>
</soap:Envelope>
```

**Modelo de Dados:**

| Item | Tipo         | Nome                  | Descrição                                                                 |
| ---- | ------------ | --------------------- | ------------------------------------------------------------------------- |
| 1    | Decimal      | Saldo                 | Saldo atual de seu contrato. Este campo é formatado com 4 casas decimais. |
| 2    | varchar(max) | Mensagem              | Mensagem do Sistema para a transação(\*)                                  |
| 3    | Boolean      | Status                | Status da Transação(\*)                                                   |
| 4    | **XML Node** | Transacao             | Node contendo mensagem padronizada sobre a transação.                     |
| 4    | varchar(2)   | Status                | Status da Transação                                                       |
| 4    | varchar(2)   | CodigoStatus          | Código de Status                                                          |
| 4    | varchar(2)   | CodigoStatusDescricao | Descrição do Código de Status                                             |

**Atenção(\*):**

Todas as transações estão vindo agora com o Node XML <**Transacao**>, este node tem como finalidade padronizar as respostas de status e descrições. Quando estiver integrando suas aplicações nao utilizar as tags <**Status**> e <**Descricao**> porque elas serão descontinuadas em breve.

**As mensagens de status novas estão documentadas no link abaixo:** <http://www.soawebservices.com.br/integracao/manuais/mensagens.aspx>