Serviço pesquisarFuncionario

33.1 - Requisição

O serviço pesquisarFuncionario realiza a busca por funcionários utilizando o número de identificação do cliente (opcional). A busca pode ser refinada pelo número de matrícula do funcionário ou pelo período referente à atualização dos seus dados. Caso seja inserido o número de matrícula, não se deve inserir as datas para busca por período, o registro inicial, nem a quantidade máximo de registros que podem ser retornados.

Caso selecionado a busca por período é necessário informar a data inicial e final, a quantidade de registros que podem ser retornados e o registro inicial que será apresentado, este dado serve para visualizar solicitações que ultrapassem o limite máximo de 50 registros por requisição, ou do número estabelecido na tag “quantidadeRegistros”, sendo dessa forma necessário paginar os resultados (Obs: na resposta da solicitação é retornada uma tag que informa a quantidade de registros que correspondem com os parâmetros inseridos na pesquisa. Vide “resposta”).

Obs: Para que haja qualquer interação com o sistema de Webservice é necessário informar o cabeçalho de autenticação. Vide “Cabeçalho de Autenticação”.

Descrição dos campos de requisição funcionário

Tag	Descrição	Parent	Formato	Required
idClienteRef	Número de identificação do cliente	pesquisarFuncionario	Integer	false
funcionarioRef	Matricula do funcionário	pesquisarFuncionario	String	true
dataInicialAtualizacao	Data inicial do período para busca por data de atualização	pesquisarFuncionario	Data	true
dataFinalAtualizacao	Data final do período para busca por data de atualização	pesquisarFuncionario	Data	true
registroInicial	Primeiro registro relevante para a busca	pesquisarFuncionario	Inteiro	true
quantidadeRegistros	Quantidade de registros que o serviço pode retornar por consulta *retorno máximo 50 registros	pesquisarFuncionario	Inteiro	false

Descrição do campo FuncionarioRef

Tag	Descrição	Parent	Formato	Required
matricula	Código identificador do funcionário no sistema	funcionarioRef	String	True

33.2 - Exemplo

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
    xmlns:ser="http://lemontech.com.br/selfbooking/wsselfbooking/services">
   <soapenv:Header>
      <ser:userPassword>userPassword</ser:userPassword>
      <ser:userName>userName</ser:userName>
      <ser:keyClient>keyClient</ser:keyClient>
   </soapenv:Header>
   <soapenv:Body>
      <ser:pesquisarFuncionario>
         <!--Optional:-->
         <idClienteRef>idClienteRef</idClienteRef>
         <funcionarioRef>
            <matricula>matricula</matricula>
         </funcionarioRef>         
      </ser:pesquisarFuncionario>
   </soapenv:Body>
</soapenv:Envelope>

33.3 - Exemplo

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
    xmlns:ser="http://lemontech.com.br/selfbooking/wsselfbooking/services">
   <soapenv:Header>
      <ser:userPassword>userPassword</ser:userPassword>
      <ser:userName>userName</ser:userName>
      <ser:keyClient>keyClient</ser:keyClient>
   </soapenv:Header>
   <soapenv:Body>
      <ser:pesquisarFuncionario>
         <!--Optional:-->
         <idClienteRef>idClienteRef</idClienteRef>
         <dataInicialAtualizacao>2014-09-05T00:00:00</dataInicialAtualizacao>
         <dataFinalAtualizacao>2014-09-05T23:59:59</dataFinalAtualizacao>
         <registroInicial>1</registroInicial>
         <!--Optional:-->
         <quantidadeRegistros>50</quantidadeRegistros>
      </ser:pesquisarFuncionario>
   </soapenv:Body>
</soapenv:Envelope>

33.4 - Resposta

A resposta do serviço é enviada com a tag pesquisarFuncionarioResponse informando “Sucesso”, caso o cadastro efetuado corretamente, “Erro”, caso ocorra algum problema ou “Alerta”, caso ocorra algum problema não-crítico no cadastro ou alteração.

Descrição dos campos de pesquisar Funcionario Response

Tag	Descrição	Parent	Formato	Since Version
resultadoOperacao	Resultado da operação solicitada	pesquisarFuncionarioResponse	ResultadoOperacao	1.0
funcionarios	Funcionários retornados da pesquisa	pesquisarFuncionarioResponse	Funcionarios	1.0

Descrição dos campos Funcionarios

Tag	Descrição	Parent	Formato	Since Version
funcionario	Item retornado pela pesquisa solicitada	funcionarios	Funcionario	1.0

Descrição dos campos de requisição funcionário

Tag	Descrição	Parent	Formato
idusuario	ID do funcionário	funcionario	Numérico
matricula	Matricula do funcionário	funcionario	String
nome	Nome do funcionário	funcionario	String
departamento	Departamento do funcionário	funcionario	String
cargo	Cargo do funcionário	funcionario	String
cpf	CPF do funcionário	funcionario	String
passaporte	Passaporte do funcionário	funcionario	String
dataNascimento	Data de nascimento do funcionário	funcionario	Data
sexo	Sexo do funcionário. MASCULINO e FEMININO	funcionario	Enum
centroDeCustoRef	Referência do centro de custo no qual o funcionário pertence	funcionario	CentroDeCustoRef
subCentroDeCustoRef	Referência do sub centro de custo no qual o funcionário pertence	funcionario	SubCentroDeCustoRef
contato	Informações de contato do funcionário	funcionario	Contato
login	Informações de login do funcionário	funcionario	Login
configuracao	Configurações do funcionário	funcionario	Configuração
ativo	Status do funcionário	funcionario	Boolean

Descrição do campo Contato

Tag	Descrição	Parent	Formato
email	Email do funcionário	contato	String
ddiTelefone	DDI do telefone do funcionário	contato	Numérico
dddTelefone	DDD do telefone do funcionário	contato	Numérico
telefone	Telefone do funcionário	contato	Numérico
ddiCelular	DDI do celular do funcionário	contato	Numérico
dddCelular	DDD do celular do funcionário	contato	Numérico
celular	Celular do funcionário	contato	Numérico

Descrição do campo Login

Tag	Descrição	Parent	Formato
usuario	Login do funcionário	login	String

Descrição do campo Configuração

Tag	Descrição	Parent	Formato
autoAprova	Caso o aprovador seja o passageiro e essa opção estiver como SIM. A solicitação será automaticamente aprovada no nível do aprovador	configuracao	Boolean
solicitaParaTodos	Quando o funcionário tiver um perfil 4=Solicitante ou 3=Aprovador e este campo estiver como 'S', ele poderá solicitar para todos os funcionários. Independente das Parametrizações	configuracao	Boolean
preAprovaTodos	Quando o funcionário tiver um perfil 4=Solicitante ou 3=Aprovador e este campo estiver como 'S', ele poderá pré aprovar todas os solicitações. Independente das parametrizações.	configuracao	Boolean
forcaDeVenda	Quando estiver como 'S' será pedido para validar o número de autorização. Para tanto o cliente deverá estar devidamente parametrizado	configuracao	Boolean
nivelHierarquico	Numero hierárquico do funcionário, na listagem de aprovadores aparecerá somente os aprovadores com numero inferior ao do passageiro. Para tanto o cliente deverá estar devidamente parametrizado	configuracao	Boolean
tipoCadastro	Tipo de Cadastro: SELF_BOOKING, FRONT_OFFICE, FRONT_SELF	configuracao	Enum
categoriaHospedagem	Categoria de hotel a ser associada ao cadastro do funcionário	configuracao	String
perfilFuncionario	Perfil do funcionário: GESTOR, APROVADOR, SOLICITANTE, PASSAGEIRO, APROVADOR_MASTER	configuracao	Enum
perfilAereo	Perfil de aereo: ECONOMICA, EXECUTIVA, PRIMEIRA_CLASSE, ECONOMICA_PLUS	configuracao	Enum
perfilHospedagem	Perfil de hospedagem: SIMPLES, MEDIO_CONFORTO, CONFORTAVEL, MUITO_CONFORTAVEL, LUXO	configuracao	Enum
usuarioTerceiro	Especificar se um usuario sera terceiro	configuracao	Boolean
visualizaSaldoBudgetAprovacao	Visualiza se houve aprovação do saldo budget	configuracao	Boolean
aprovaBudgetNegativo	Aprova budget negativo	configuracao	Boolean
antecedenciaViagemNacional	Quantidade em dias para antecedencia de viagem nacional	configuracao	Integer
antecedenciaViagemInternacional	Quantidade em dias para antecedencia de viagem internacional	configuracao	Integer
politicaDespesa	Politica de despesa a ser associada ao cadastro do funcionario	configuracao	String

Descrição do campo resultadoOperacao

Tag	Descrição	Parent	Formato
status	Se SUCESSO a pesquisa foi efetuada com sucesso Se ERRO ocorreu algum problema durante a pesquisa Se ALERTA ocorreu algum problema não-crítico durante a pesquisa	resultadoOperacao	String
mensagem	Mensagem com a descrição do status retornado	resultadoOperacao	String

33.5 - Exemplo

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" 
    xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <S:Body>
      <ns2:pesquisarFuncionarioResponse 
        xmlns:ns2="http://lemontech.com.br/selfbooking/wsselfbooking/services">
         <resultadoOperacao>
            <status>SUCESSO</status>
         </resultadoOperacao>
         <funcionarios>
            <funcionario>
               <idusuario>2755872</idusuario>
               <matricula>123455QWE</matricula>
               <nome>Gestor</nome>
               <departamento>DEPARTAMENTO</departamento>
               <cargo>CARGO</cargo>
               <passaporte/>
               <sexo>MASCULINO</sexo>
               <centroDeCustoRef>
                  <codigo>TESTE</codigo>
                  <regionalRef>
                     <codigo>SPTESTE</codigo>
                  </regionalRef>
               </centroDeCustoRef>
               <contato>
                  <email>teste@teste.com.br</email>
                  <dddTelefone>11</dddTelefone>
                  <telefone>35449733</telefone>
                  <dddCelular>11</dddCelular>
                  <celular>311111111</celular>
               </contato>
               <configuracao>
                  <autoAprova>true</autoAprova>
                  <solicitaParaTodos>false</solicitaParaTodos>
                  <preAprovaTodos>false</preAprovaTodos>
                  <forcaDeVenda>false</forcaDeVenda>
                  <nivelHierarquico>0</nivelHierarquico>
                  <perfilFuncionario>GESTOR</perfilFuncionario>
                  <perfilAereo>ECONOMICA</perfilAereo>
                  <perfilHospedagem>SIMPLES</perfilHospedagem>
                  <visualizaSaldoBudgetAprovacao>false</visualizaSaldoBudgetAprovacao>
                  <aprovaBudgetNegativo>false</aprovaBudgetNegativo>
                  <usuarioTerceiro>false</usuarioTerceiro>
               </configuracao>
               <ativo>true</ativo>
            </funcionario>
         </funcionarios>
      </ns2:pesquisarFuncionarioResponse>
   </S:Body>
</S:Envelope>