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:
Cenários existentes em 01/01 | Cenários enviados em 02/01 | Consequências |
A,B,C | A,B,E |
1- A e B serão mantidos 2 - C será excluído 3 - E será incluído |
- 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:
TAG | Descrição |
sys:usuário | Usuário do site Systax |
sys:senha | Senha do usuário |
entidade | Entidade |
tratamento | Tratamento |
nome | Nome do cliente |
ddd | DDD do cliente |
telefone | Telefone do cliente |
ramal | Ramal do cliente |
E-mail do cliente | |
uf_origem | UF do remetente |
uf_destino | UF do destinatário |
perfil_ex_origem | Perfil do remetente |
perfil_ex_destinacao | Perfil do destinatário |
natureza_operacao | Natureza de Operação |
Descrição dos campos de retorno:
TAG | Descrição |
ns:return | XML de retorno |
Exemplo de chamada:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sys="http://systax.com.br">
<soapenv:Header/>
<soapenv:Body>
<sys:incluirCliente>
<sys:usuario>usuário</sys:usuario>
<sys:senha>senha</sys:senha>
<sys:xmlCliente>
<![CDATA[
<systaxCadastro>
<cliente>
<entidade>Cliente1</entidade>
<tratamento>Sr</tratamento>
<nome>Cliente1 Ltda</nome>
<ddd>11</ddd>
<telefone>0000-0000</telefone>
<ramal>00</ramal>
<email>email@cliente.com.br</email>
</cliente>
<cenarios>
<cenario>
<uf_origem>RJ</uf_origem>
<uf_destino>AC</uf_destino>
<perfil_ex_origem>2,134,24</perfil_ex_origem>
<perfil_ex_destinacao>1</perfil_ex_destinacao>
<natureza_operacao>121</natureza_operacao>
</cenario>
</cenarios>
</systaxCadastro>
]]>
</sys:xmlCliente>
</sys:incluirCliente>
</soapenv:Body>
</soapenv:Envelope>
Exemplo de retorno:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<ns:incluirClienteResponse xmlns:ns="http://systax.com.br">
<ns:return><![CDATA[<systaxCadastroResp><codigo>112</codigo><mensagem>Atualizado com sucesso.</mensagem><id>481361</id></systaxCadastroResp>]]></ns:return>
</ns:incluirClienteResponse>
</soapenv:Body>
</soapenv:Envelope>