# Exemplo de chamada e retorno

**Chamada**

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:sys="http://systax.com.br">  
 <soap:Header/>  
 <soap:Body>  
 <sys:associarProdutoGrupo>  
 <sys:usuario>superdemo</sys:usuario>  
 <sys:senha>systax741</sys:senha>  
 <sys:xmlGrupoProdutos><!\[CDATA\[  
 <systaxCadastro>  
 <produto>  
 <cProd>94394394</cProd>  
 <orig>0</orig>  
 <grupos>  
 <grupo>MG-MG-121-3,134-140</grupo>  
 <grupo>MG-AC-121-3,134-140</grupo>  
 </grupos>  
 </produto>   
 </systaxCadastro>\]\]></sys:xmlGrupoProdutos>  
 </sys:associarProdutoGrupo>  
 </soap:Body>  
</soap:Envelope>

<span style="text-decoration: underline;">***Observação**: A tag &lt;grupo&gt; pode ser adicionada de acordo com a quantidadade necessária pelo cliente.*</span>

**Retorno**

&lt;soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"&gt;  
 &lt;soapenv:Body&gt;  
 &lt;ns:associarProdutoGrupoResponse xmlns:ns="http://systax.com.br"&gt;  
 &lt;ns:return xsi:type="ax21:SystaxCadastroResp" xmlns:ax21="http://retorno.systax.com.br/xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"&gt;  
 &lt;ax21:grupo xsi:nil="true"/&gt;  
 &lt;ax21:produto xsi:type="ax21:Produto"&gt;  
 &lt;ax21:ID xsi:nil="true"/&gt;  
 &lt;ax21:cProd&gt;P0123&lt;/ax21:cProd&gt;  
 &lt;ax21:codigo&gt;128&lt;/ax21:codigo&gt;  
 &lt;ax21:grupos xsi:type="ax21:Grupos"&gt;  
 &lt;ax21:grupo xsi:type="ax21:Grupo"&gt;  
 &lt;ax21:ID&gt;82393179&lt;/ax21:ID&gt;  
 &lt;ax21:codigo&gt;128&lt;/ax21:codigo&gt;  
 &lt;ax21:mensagem&gt;Grupo associado com sucesso. Cenário já existente.&lt;/ax21:mensagem&gt;  
 &lt;ax21:nomeGrupo&gt;grupoABC&lt;/ax21:nomeGrupo&gt;  
 &lt;/ax21:grupo&gt;  
 &lt;ax21:grupo xsi:type="ax21:Grupo"&gt;  
 &lt;ax21:ID&gt;82393180&lt;/ax21:ID&gt;  
 &lt;ax21:codigo&gt;128&lt;/ax21:codigo&gt;  
 &lt;ax21:mensagem&gt;Grupo associado com sucesso. Cenário já existente.&lt;/ax21:mensagem&gt;  
 &lt;ax21:nomeGrupo&gt;grupoDEF&lt;/ax21:nomeGrupo&gt;  
 &lt;/ax21:grupo&gt;  
 &lt;ax21:grupo xsi:type="ax21:Grupo"&gt;  
 &lt;ax21:ID&gt;82393181&lt;/ax21:ID&gt;  
 &lt;ax21:codigo&gt;128&lt;/ax21:codigo&gt;  
 &lt;ax21:mensagem&gt;Grupo associado com sucesso. Cenário já existente.&lt;/ax21:mensagem&gt;  
 &lt;ax21:nomeGrupo&gt;grupoGHI&lt;/ax21:nomeGrupo&gt;  
 &lt;/ax21:grupo&gt;  
 &lt;/ax21:grupos&gt;  
 &lt;ax21:mensagem&gt;Grupo associado com sucesso. Cenário já existente.&lt;/ax21:mensagem&gt;  
 &lt;ax21:orig&gt;0&lt;/ax21:orig&gt;  
 &lt;/ax21:produto&gt;  
 &lt;/ns:return&gt;  
 &lt;/ns:associarProdutoGrupoResponse&gt;  
 &lt;/soapenv:Body&gt;  
&lt;/soapenv:Envelope&gt;

**Obs.:**

Quando a chamada possuí mais de um grupo associado ao produto, é criado um código de retorno para cada grupo envolvido na requisição (em verde), e também, um código de retorno isolado (em amarelo). Veja abaixo:

[![Assoc_Prod_Grupo_001.PNG](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/scaled-1680-/assoc-prod-grupo-001.PNG)](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/assoc-prod-grupo-001.PNG)

Quando há apenas um único grupo envolvido na requisição, os códigos de retorno são iguais conforme na imagem:

[![Assoc_Prod_Grupo_002.PNG](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/scaled-1680-/assoc-prod-grupo-002.PNG)](https://documentacao.systax.com.br/uploads/images/gallery/2025-07/assoc-prod-grupo-002.PNG)

Para fins de integração, recomenda-se obter sempre os códigos de retorno envolvidos nos grupos (em verde). O código de retorno (em amarelo) é usado apenas por integrações desenvolvidas anteriormente.