Capítulo40

Serviço cadastrarContaBancaria

40.1 - Requisição

O serviço cadastrarContaBancaria cadastra ou altera uma Conta Bancária, para um determinado funcionario, ao informar Agência, Nº da Conta e Instituição Bancária para um funcionário, o sistema fará uma busca no banco de dados. Caso já exista, a conta será atualizada.

Para criar uma Conta Bancária será necessário informar os campos conforme descrito na documentação!

Obs.: Para que haja qualquer interação com o sistema de Webservice e necessario informar o cabeçalho de autenticacao. Vide cabeçalho de Autenticação.

Descrição dos campos de cadastrarContaBancaria

Tag

Descrição

Parent

Formato

Required

funcionarioRef

Funcionário a qual pertence a Conta Bancária

cadastrarContaBancaria

FuncionarioRef

True

instituicaoBancariaRef

Intituição a qual pertence a Conta Bancária

cadastrarContaBancaria

instituicaoBancariaRef

True

agencia

Código da Agência Bancária

cadastrarContaBancaria

String

True

conta

Nº da Conta Bancária

cadastrarContaBancaria

String

True

padrao

Conta Bancária é a padrão do funcionário?

cadastrarContaBancaria

Boolean

False

status

Conta Bancária ativa ?

cadastrarContaBancaria

Boolean

True

Descrição dos campos de instituicaoBancariaRef

Tag

Descrição

Parent

Formato

Required

codigo

Código da Intituição Bancária

instituicaoBancariaRef

String

True


40.2 - Exemplo

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header>
      <ser:userPassword>senha</ser:userPassword>
      <ser:userName>usuario</ser:userName>
      <ser:keyClient>chave_da_empresa_cliente</ser:keyClient>
   </soapenv:Header>
   <soapenv:Body>
       <ser:cadastrarContaBancaria>
         <funcionarioRef>
            <matricula>GESTOR</matricula>
         </funcionarioRef>
         <instituicaoBancariaRef>
            <codigo>0001</codigo>
         </instituicaoBancariaRef>
         <agencia>1400</agencia>
         <conta>1448947</conta>
         <!--Optional:-->
         <padrao>false</padrao>
         <status>true</status>
      </ser:cadastrarContaBancaria>
   </soapenv:Body>
</soapenv:Envelope>

40.3 - Resposta

A resposta do serviço é enviada com a tag cadastrarContaBancariaResponse informando "Sucesso", caso o cadastro efetuado corretamente e "Erro", caso o ocorra algum problema no cadastro.

Descrição dos campos de cadastrarContaBancariaResponse

Tag

Descrição

Parent

Formato

resultadoOperacao

Resultado do cadastro

cadastrarContaBancariaResponse

ResultadoOperacao

Descrição do campo ResultadoOperacao

Tag

Descrição

Parent

Formato

status

Se SUCESSO o cadastro foi efetuado com sucesso

Se ERRO ocorreu algum problema durante o cadastro

resultadoOperacao

String


40.4 - Exemplo

<S:Envelope>
   <SOAP-ENV:Header/>
   <S:Body>
      <ns2:cadastrarContaBancariaResponse>
         <resultadoOperacao>
            <status>SUCESSO</status>
         </resultadoOperacao>
      </ns2:cadastrarContaBancariaResponse>
   </S:Body>
</S:Envelope>