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
email 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>