# Consultar Grupos

# Consultar Grupos

**Objetivo**: Consultar os grupos do cliente.  
**Método**: consultarGrupos  
**Parâmetros**:

- String usuario
- String senha
- String idCliente

**Descrição dos campos de chamada:**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-tag-descri%C3%A7%C3%A3o-sys%3Aus"><tbody><tr><td>**TAG**</td><td>**Descrição**</td></tr><tr><td>sys:usuario</td><td>Usuário do site Systax</td></tr><tr><td>sys:senha</td><td>Senha do usuário</td></tr><tr><td>sys:idCl</td><td>Identifcador do cliente</td></tr></tbody></table>

**Descrição dos campos de retorno:**

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-tag-descri%C3%A7%C3%A3o-ns%3Aret"><tbody><tr><td>**TAG**</td><td>**Descrição**</td></tr><tr><td>ns:return</td><td>XML dos grupos</td></tr></tbody></table>

**Exemplo de chamada:**

&lt;soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://systax.com.br"&gt;  
 &lt;soapenv:Header/&gt;  
 &lt;soapenv:Body&gt;  
 &lt;sys:consultaGrupos&gt;  
 &lt;sys:usuario&gt;usuário&lt;/sys:usuario&gt;  
 &lt;sys:senha&gt;senha&lt;/sys:senha&gt;  
 &lt;sys:idCli&gt;71408&lt;/sys:idCli&gt;  
 &lt;/sys:consultaGrupos&gt;  
 &lt;/soapenv:Body&gt;  
&lt;/soapenv:Envelope&gt;

**Exemplo de retorno:**

&lt;soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"&gt;  
 &lt;soapenv:Body&gt;  
 &lt;ns:consultaGruposResponse xmlns:ns="http://systax.com.br"&gt;  
 &lt;ns:return&gt;  
 &lt;!\[CDATA\[  
 &lt;systaxCadastroResp&gt;  
 &lt;grupo&gt;  
 &lt;id&gt;2195&lt;/id&gt;  
 &lt;descricao&gt;Grupo1&lt;/descricao&gt;  
 &lt;/grupo&gt;  
 &lt;grupo&gt;  
 &lt;id&gt;4586&lt;/id&gt;  
 &lt;descricao&gt;Grupo2&lt;/descricao&gt;  
 &lt;/grupo&gt;   
 \]\]&gt;  
 &lt;/ns:return&gt;  
 &lt;/ns:consultaGruposResponse&gt;  
 &lt;/soapenv:Body&gt;  
&lt;/soapenv:Envelope&gt;