# Incluir Grupos de Produtos

<main class="col-6" id="bkmrk-objetivo%3A-incluir%C2%A0gr">**Objetivo**: Incluir grupos de produtos.  
**Método**: incluirGrupoProdutos  
**Parâmetros**:

<div>- String usuario
- String senha
- String xml

</div>**Observação 1:** Os grupos serão criados se não existirem. O sistema não emitirá alerta caso o grupo já exista ou caso algum produto já esteja associado a ele.

**Observação 2:** Há um limite de 200 produtos por requisição. Recomendamos enviar um único produto em cada requisição, se o objetivo for inclusão e imediata recuperação das informações de tributação do produto (recurso disponível apenas para clientes com tratamento específico nos segmentos de Varejo).

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

<div><table border="1" cellpadding="1" cellspacing="1"><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>idCli</td><td>Identificador do cliente</td></tr><tr><td>origem\_produto</td><td>Origem do produto</td></tr><tr><td>descricao</td><td>Descrição do produto</td></tr><tr><td>código</td><td>Código do produto</td></tr></tbody></table>

</div>**Descrição dos campos de retorno:**

<div><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td>**TAG**</td><td>**Descrição**</td></tr><tr><td>codStatus</td><td>Código de retorno </td></tr><tr><td>msgStatus</td><td>Mensagem do código de retorno</td></tr></tbody></table>

</div>**Tabela de referência das TAG´s "codStatus" e "msgStatus" do retorno:**

Acessar o tópico: [https://documentacao.systax.com.br/PublicView2/Index/36eef5d3eb1fa6ea70f89dad5/26180/30475](https://documentacao.systax.com.br/PublicView2/Index/36eef5d3eb1fa6ea70f89dad5/26180/30475)

**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:incluirGrupoProdutos&gt;  
 &lt;sys:usuario&gt;usuário&lt;/sys:usuario&gt;  
 &lt;sys:senha&gt;senha&lt;/sys:senha&gt;  
 &lt;sys:xmlGrupoProdutos&gt;&lt;!\[CDATA\[   
 &lt;systaxCadastro&gt;  
 &lt;grupoProdutos&gt;  
 &lt;idCli&gt;71408&lt;/idCli&gt;  
 &lt;origem\_produto&gt;0&lt;/origem\_produto&gt;  
 &lt;descricao&gt;Grupo1&lt;/descricao&gt;  
 &lt;produtos&gt;  
 &lt;codigo&gt;Produto1&lt;/codigo&gt;  
 &lt;codigo&gt;Produto2&lt;/codigo&gt;  
 &lt;/produtos&gt;  
 &lt;/grupoProdutos&gt;  
 &lt;/systaxCadastro&gt;  
 \]\]&gt;  
 &lt;/sys:xmlGrupoProdutos&gt;  
 &lt;/sys:incluirGrupoProdutos&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:incluirGrupoProdutosResponse xmlns:ns="http://systax.com.br"&gt;  
 &lt;ns:return xsi:type="ax21:SystaxRet" xmlns:ax21="http://systaxret.systax.com.br/xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"&gt;  
 &lt;ax21:origem&gt;Systax&lt;/ax21:origem&gt;  
 &lt;ax21:ponteiro xsi:nil="true"/&gt;  
 &lt;ax21:sistema&gt;Cadastro Retorno&lt;/ax21:sistema&gt;  
 &lt;ax21:status xsi:type="ax21:Status"&gt;  
 &lt;ax21:ID xsi:nil="true"/&gt;  
 &lt;ax21:codStatus&gt;100&lt;/ax21:codStatus&gt;  
 &lt;ax21:msgStatus&gt;Incluído com sucesso.&lt;/ax21:msgStatus&gt;  
 &lt;/ax21:status&gt;  
 &lt;/ns:return&gt;  
 &lt;/ns:incluirGrupoProdutosResponse&gt;  
 &lt;/soapenv:Body&gt;  
&lt;/soapenv:Envelope&gt;

<div></div></main>