Documentação WSSelfbooking

21.1 - Requisição

O serviço cadastrarFuncionario cadastra ou altera um funcionário para determinado cliente. Para cadastrar é preciso informar a matricula, e também a referência do centro de custo ou sub centro de custo que esse funcionário pertence, caso já tenha cadastrado no sistema, um funcionário com a matricula informada para tal cliente, o sistema irá atualizar as informações do mesmo.

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

Tag	Descrição	Parent	Formato	Required
matricula	Matricula do funcionário	funcionario	String	True
nome	Nome do funcionário	funcionario	String	True
departamento	Departamento do funcionário	funcionario	String	True
cargo	Cargo do funcionário	funcionario	String	True
cpf	CPF do funcionário	funcionario	String	False
passaporte	Passaporte do funcionário	funcionario	String	False
dataNascimento	Data de nascimento do funcionário	funcionario	Data	False
sexo	Sexo do funcionário. MASCULINO e FEMININO	funcionario	Enum	True
centroDeCustoRef	Referência do centro de custo no qual o funcionário pertence	funcionario	CentroDeCustoRef	True
subCentroDeCustoRef	Referência do sub centro de custo no qual o funcionário pertence	funcionario	SubCentroDeCustoRef	False
contato	Informações de contato do funcionário	funcionario	Contato	True
login	Informações de login do funcionário	funcionario	Login	True
bypassAprovacaoNacional	Aprovação automática para nacional	funcionario	Boolean	False
bypassAprovacaoInternacional	Aprovação automática para internacional	funcionario	Boolean	False
configuracao	Configurações do funcionário	funcionario	Configuração	True
nomeaAgenciaPreferencial	Nome da agência preferencial para do funcionario	funcionario	String	False
ativo	Status do funcionário	funcionario	Boolean	True
idCliente	Número de identificação do Cliente	funcionario	Inteiro	False

Descrição do campo Contato

Tag	Descrição	Parent	Formato	Required
email	Email do funcionário	contato	String	True
ddiTelefone	DDI do telefone do funcionário	contato	Numérico	False
dddTelefone	DDD do telefone do funcionário	contato	Numérico	False
telefone	Telefone do funcionário	contato	Numérico	True
ddiCelular	DDI do celular do funcionário	contato	Numérico	False
dddCelular	DDD do celular do funcionário	contato	Numérico	False
celular	Celular do funcionário	contato	Numérico	False
forcaAtualizacao	Ao enviar True o sistema obrigatoriamente atualiza os contatos com os dados da requisição. Por padrão se não informado será False, dessa forma o sistema verifica se já existe contato cadastrado no sistema e não substitue com os dados de contato da requisição.	contato	Boolean	False

Descrição do campo Login

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

Descrição do campo Configuração

Tag	Descrição	Parent	Formato	Required
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	False
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	False
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	False
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	False
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	False
tipoCadastro	Tipo de Cadastro: SELF_BOOKING, FRONT_OFFICE, FRONT_SELF	configuracao	Enum	False
categoriaHospedagem	Categoria de hotel a ser associada ao cadastro do funcionário	configuracao	String	False
perfilFuncionario	Perfil do funcionário: GESTOR, APROVADOR, SOLICITANTE, PASSAGEIRO, APROVADOR_MASTER	configuracao	Enum	True
perfilAereo	Perfil de aereo: ECONOMICA, EXECUTIVA, PRIMEIRA_CLASSE, ECONOMICA_PLUS	configuracao	Enum	False
perfilHospedagem	Perfil de hospedagem: SIMPLES, MEDIO_CONFORTO, CONFORTAVEL, MUITO_CONFORTAVEL, LUXO	configuracao	Enum	False
usuarioTerceiro	Especificar se um usuario sera terceiro	configuracao	Boolean	False
visualizaSaldoBudgetAprovacao	Visualiza se houve aprovação do saldo budget	configuracao	Boolean	False
aprovaBudgetNegativo	Aprova budget negativo	configuracao	Boolean	False
antecedenciaViagemNacional	Quantidade em dias para antecedencia de viagem nacional	configuracao	Integer	False
antecedenciaViagemInternacional	Quantidade em dias para antecedencia de viagem internacional	configuracao	Integer	False
bloqueiaSolicitarViagem	Campo que ira definir se bloqueia ou não solicitação de viagem	configuracao	Boolean	False
politicaDespesa	Politica de despesa a ser associada ao cadastro do funcionario	configuracao	Boolean	False
politicaPercurso	Nome da politica de percurso relacionada com usuário.	configuracao	String	False
maximoSvAdiantamentoAberto	Numero máximo de sv's de adiantamento ou reembolso em aberto para o funcionário.	configuracao	Integer	False
recebeEmail	Deseja receber email?	configuracao	Boolean	False
permiteNotificacaoFinanceiro	Informa se o usuário pode ser notificado pelo controle financeiro.	configuracao	Boolean	False
utilizaUsuarioLogado	O usuário logado deve ou não ser carregado automaticamente na criação da SV.	configuracao	Boolean	False
permiteCadastrarClienteProjetoReembolsavel	Permite o usuário cadastrar clientes para projetos reembolsáveis.	configuracao	Boolean	False
excecaoRegraRestricaoHotelRegional	Quando habilitada, usuário passa a ser exceção a regra da parametrização 1.77 Restrições de produto Hotel online por Regional.	configuracao	Boolean	False

Descrição do campo FuncionarioRef

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

21.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>senha</ser:userPassword>
        <ser:userName>usuario</ser:userName>
        <ser:keyClient>chave_da_empresa_cliente</ser:keyClient>
    </soapenv:Header>
    <soapenv:Body>
        <ser:cadastrarFuncionario>
            <funcionario>
                <matricula>001</matricula><nome>Funcionário 1</nome>
                <departamento>Departamento do Funcionário 1</departamento>
                <cargo>Cargo do Funcionário 1</cargo>
                <cpf>25511293709</cpf>
                <passaporte>88766545</passaporte>
                <dataNascimento>1987-06-30</dataNascimento>
                <sexo>MASCULINO</sexo>
                <centroDeCustoRef>
                    <codigo>centroDeCusto1</codigo>
                    <regionalRef><codigo>regional1</codigo></regionalRef>
                </centroDeCustoRef>
                <contato>
                    <email>teste@teste.com.br </email>
                    <ddiTelefone>55</ddiTelefone>
                    <dddTelefone>11</dddTelefone>
                    <telefone>55555555</telefone>
                    <ddiCelular>55</ddiCelular>
                    <dddCelular>11</dddCelular>
                    <celular>99999999</celular>
                </contato>
                <login><usuario>usuario_teste</usuario></login>
                <bypassAprovacaoNacional>false</bypassAprovacaoNacional>
                <bypassAprovacaoInternacional>false</bypassAprovacaoInternacional>
                <configuracao>
                    <autoAprova>false</autoAprova>
                    <solicitaParaTodos>false</solicitaParaTodos>
                    <preAprovaTodos>false</preAprovaTodos>
                    <perfilFuncionario>GESTOR</perfilFuncionario>
                </configuracao>
                <nomeaAgenciaPreferencial>Agência 1</nomeaAgenciaPreferencial>
                <ativo>true</ativo>
            </funcionario>
            <!--Optional:-->
            <idCliente>8888</idCliente>
        </ser:cadastrarFuncionario>
    </soapenv:Body>
</soapenv:Envelope>

21.3 - Resposta

A reposta do serviço é enviada com a tag cadastrarFuncionarioResponse 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 Resposta Conta Contábil

Tag

Descrição

Parent

Formato

status

Se SUCESSO o cadastro ou alteração foi efetuado corretamente

Se ERRO ocorreu algum problema no cadastro ou alteração

Se ALERTA ocorreu algum problema não-crítico no cadastro ou alteração

resultadoOperacao

String

mensagem

Mensagem com a descrição do status retornado