# Incluir Clientes com Cenários

**Objetivo**: Incluir clientes associados ao cenário.  
**Método**: incluirCliente  
**Parâmetros**:

- String usuario
- String senha
- String xml

**Observação:**

- Essa request sempre conterá a totalidade de cenários que devem existir no cadastro do cliente, pois os cenários enviados que já existem serão mantidos, os novos serão incluídos, e os não enviados, serão excluídos. Exemplo:

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-cen%C3%A1rios-existentes-"><tbody><tr><td>**Cenários existentes em 01/01**</td><td>**Cenários enviados em 02/01**</td><td>**Consequências**</td></tr><tr><td>A,B,C</td><td>A,B,E</td><td>1- A e B serão mantidos

2 - C será excluído

3 - E será incluído

</td></tr></tbody></table>

- Se o bloco “cenarios” não for enviado, nenhuma ação será efetuada.
- Se a entidade já existir, os cenários serão atualizados no cadastro desta. Caso a entidade não exista, será criado um novo cadastro de cliente já com os respectivos cenários.
- A tag finalidade somente deve ser preenchida para cenários de entrada.

**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:usuário</td><td>Usuário do site Systax</td></tr><tr><td>sys:senha</td><td>Senha do usuário</td></tr><tr><td>entidade</td><td>Entidade</td></tr><tr><td>tratamento</td><td>Tratamento</td></tr><tr><td>nome</td><td>Nome do cliente</td></tr><tr><td>ddd</td><td>DDD do cliente</td></tr><tr><td>telefone</td><td>Telefone do cliente</td></tr><tr><td>ramal</td><td>Ramal do cliente</td></tr><tr><td>email</td><td>E-mail do cliente</td></tr><tr><td>uf\_origem</td><td>UF do remetente</td></tr><tr><td>uf\_destino</td><td>UF do destinatário</td></tr><tr><td>perfil\_ex\_origem</td><td>Perfil do remetente</td></tr><tr><td>perfil\_ex\_destinacao</td><td>Perfil do destinatário</td></tr><tr><td>natureza\_operacao</td><td>Natureza de Operação</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 de retorno</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:incluirCliente&gt;  
 &lt;sys:usuario&gt;usuário&lt;/sys:usuario&gt;  
 &lt;sys:senha&gt;senha&lt;/sys:senha&gt;  
 &lt;sys:xmlCliente&gt;  
 &lt;!\[CDATA\[  
 &lt;systaxCadastro&gt;  
 &lt;cliente&gt;  
 &lt;entidade&gt;Cliente1&lt;/entidade&gt;  
 &lt;tratamento&gt;Sr&lt;/tratamento&gt;  
 &lt;nome&gt;Cliente1 Ltda&lt;/nome&gt;  
 &lt;ddd&gt;11&lt;/ddd&gt;  
 &lt;telefone&gt;0000-0000&lt;/telefone&gt;  
 &lt;ramal&gt;00&lt;/ramal&gt;  
 &lt;email&gt;email@cliente.com.br&lt;/email&gt;  
 &lt;/cliente&gt;  
 &lt;cenarios&gt;  
 &lt;cenario&gt;  
 &lt;uf\_origem&gt;RJ&lt;/uf\_origem&gt;  
 &lt;uf\_destino&gt;AC&lt;/uf\_destino&gt;  
 &lt;perfil\_ex\_origem&gt;2,134,24&lt;/perfil\_ex\_origem&gt;  
 &lt;perfil\_ex\_destinacao&gt;1&lt;/perfil\_ex\_destinacao&gt;  
 &lt;natureza\_operacao&gt;121&lt;/natureza\_operacao&gt;  
 &lt;/cenario&gt;  
 &lt;/cenarios&gt;  
 &lt;/systaxCadastro&gt;  
 \]\]&gt;  
 &lt;/sys:xmlCliente&gt;  
 &lt;/sys:incluirCliente&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:incluirClienteResponse xmlns:ns="http://systax.com.br"&gt;  
 &lt;ns:return&gt;&lt;!\[CDATA\[&lt;systaxCadastroResp&gt;&lt;codigo&gt;112&lt;/codigo&gt;&lt;mensagem&gt;Atualizado com sucesso.&lt;/mensagem&gt;&lt;id&gt;481361&lt;/id&gt;&lt;/systaxCadastroResp&gt;\]\]&gt;&lt;/ns:return&gt;  
 &lt;/ns:incluirClienteResponse&gt;  
 &lt;/soapenv:Body&gt;  
&lt;/soapenv:Envelope&gt;