# Associação de Produto e Grupo Associa um produto á um ou mais grupos de produtos no Portal de Classificação Fiscal. # Observações da funcionalidade O nome do grupo pode ser criado da forma que melhor represente o agrupamento de produtos do cliente, mas recomendamos que seja criado conforme o padrão abaixo: - UFORIGEM-UFDESTINO-NATUREZADEOPERACAO-PERFILORIGEM-PERFILDESTINACAO-FINALIDADE *Exemplo: SP-SP-120-1-140-569. Essa notação permite que os grupos sejam facilmente associados aos seus respectivos cenários.* A opção "Finalidade" não é obrigatória e será utilizada somente para cenários de entrada. É importante frisar que a não associação de produtos a grupos determina que sejam criadas regras tributárias para todos os cenários sem grupos disponíveis, o que nem sempre é necessário. # Descrição dos campos de chamada e retorno **Chamada**
**Pai** **Campo** **Tipo** **Descrição** **Obrigatório**
associarProdutoGrupos usuário String Usuário do Portal CFM Sim
associarProdutoGrupos senha String Senha Sim
associarProdutoGrupos xmlGrupoProdutos String XML Sim
**Retorno**
**Pai** **Campo** **Descrição**
produto cProd Código de produto
produto codigo Código da mensagem de retorno
grupo ID ID do grupo
grupo codigo Código da mensagem de retorno
grupo mensagem Mensagem de retorno
grupo nomeGrupo Nome do grupo de produto
# 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> ***Observação**: A tag <grupo> pode ser adicionada de acordo com a quantidadade necessária pelo cliente.* **Retorno** <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Body> <ns:associarProdutoGrupoResponse xmlns:ns="http://systax.com.br"> <ns:return xsi:type="ax21:SystaxCadastroResp" xmlns:ax21="http://retorno.systax.com.br/xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <ax21:grupo xsi:nil="true"/> <ax21:produto xsi:type="ax21:Produto"> <ax21:ID xsi:nil="true"/> <ax21:cProd>P0123</ax21:cProd> <ax21:codigo>128</ax21:codigo> <ax21:grupos xsi:type="ax21:Grupos"> <ax21:grupo xsi:type="ax21:Grupo"> <ax21:ID>82393179</ax21:ID> <ax21:codigo>128</ax21:codigo> <ax21:mensagem>Grupo associado com sucesso. Cenário já existente.</ax21:mensagem> <ax21:nomeGrupo>grupoABC</ax21:nomeGrupo> </ax21:grupo> <ax21:grupo xsi:type="ax21:Grupo"> <ax21:ID>82393180</ax21:ID> <ax21:codigo>128</ax21:codigo> <ax21:mensagem>Grupo associado com sucesso. Cenário já existente.</ax21:mensagem> <ax21:nomeGrupo>grupoDEF</ax21:nomeGrupo> </ax21:grupo> <ax21:grupo xsi:type="ax21:Grupo"> <ax21:ID>82393181</ax21:ID> <ax21:codigo>128</ax21:codigo> <ax21:mensagem>Grupo associado com sucesso. Cenário já existente.</ax21:mensagem> <ax21:nomeGrupo>grupoGHI</ax21:nomeGrupo> </ax21:grupo> </ax21:grupos> <ax21:mensagem>Grupo associado com sucesso. Cenário já existente.</ax21:mensagem> <ax21:orig>0</ax21:orig> </ax21:produto> </ns:return> </ns:associarProdutoGrupoResponse> </soapenv:Body> </soapenv:Envelope> **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.