Capítulo14

Serviço cadastrarParametrizacaoViajante

14.1 - Requisição

O serviço cadastrarParametrizacaoViajante cadastra ou altera uma parametrização de centro de custo para determinado viajante. Para cadastrar é preciso informar a referência do funcionário que aprova e do viajante que a parametrização pertence, caso já tenha cadastrado no sistema, uma parametrização com essas referências, o sistema irá atualizar as informações da mesma.

Descrição dos campos de requisição parametrização de viajante aprovação

Tag

Descrição

Parent

Formato

Required

funcionarioRef

Código identificador do funcionário no sistema

parametrizacaoViajanteAprovacao

FuncionarioRef

True

viajanteRef

Código identificador do viajante no sistema

parametrizacaoViajanteAprovacao

ViajanteRef

True

nivelDeAprovacao

Nível de aprovação, após aprovação desse nível o sistema enviará a solicitação para o próximo nível caso tenha. Para tanto o cliente deverá estar devidamente parametrizado

parametrizacaoViajanteAprovacao

Numérico

False

tipoDeViagemDaAprocacao

Tipo de Viagem da Aprovação: TODOS, NACIONAL, CONTINENTAL, INTERNACIONAL, INTERCONTINENTAL. Para tanto o cliente deverá estar devidamente parametrizado.

parametrizacaoViajanteAprovacao

Enum

False

aprovaSomenteDentroDaPolitica

Aprova somente dentro da politica. Quando estiver como 'S', somente as solicitações dentro da politica poderão ser aprovadas pelo aprovador

parametrizacaoViajanteAprovacao

Boolean

False

periodoViagemInicial

Período de viagem inicial

parametrizacaoViajanteAprovacao

Data

False

periodoViagemFinal

Período de viagem final

parametrizacaoViajanteAprovacao

Data

False

valorAlcadaInicial

Valor da alçada inicial

parametrizacaoViajanteAprovacao

Double (#.##)

False

valorAlcadaFinal

Valor da alçada final

parametrizacaoViajanteAprovacao

Double (#.##)

False

vencimento

Data de vencimento da parametrização

parametrizacaoViajanteAprovacao

Data

False

tipoDeSolicitacao

Tipo de Solicitação: TODOS, CORPORATIVO, EXPENSE, INCENTIVO.

parametrizacaoViajanteAprovacao

Enum

False

idCliente

Número de identificação do Cliente

parametrizacaoViajanteAprovacao

Inteiro

False


14.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:cadastrarParametrizacaoViajante>
            <parametrizacaoViajanteAprovacao>
                <funcionarioRef>
                    <matricula>funcionario1</matricula>
                </funcionarioRef>
                <viajanteRef>
                   <matricula>viajante1</matricula>
                </viajanteRef>
                <nivelDeAprovacao>1</nivelDeAprovacao>
                <tipoDeViagemDaAprocacao>TODOS</tipoDeViagemDaAprocacao>
                <aprovaSomenteDentroDaPolitica>false</aprovaSomenteDentroDaPolitica>
                <periodoViagemInicial>2015-09-24</periodoViagemInicial>
                <periodoViagemFinal>2020-09-24</periodoViagemFinal>
                <valorAlcadaInicial>0.0</valorAlcadaInicial>
                <valorAlcadaFinal>1000.0</valorAlcadaFinal>
                <vencimento>2020-09-24</vencimento>
            </parametrizacaoCentroDeCustoAprovacao>
            <!--Optional:-->
            <idCliente>idDoCliente</idCliente>
        </ser:cadastrarParametrizacaoViajante>
    </soapenv:Body>
</soapenv:Envelope>

14.3 - Resposta

A reposta do serviço de cadastro de parametrização é enviada com a tag cadastrarParametrizacaoViajanteResponse 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 Cadastrar Parametrizacao Viajante

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

resultadoOperacao

String


14.4 - Exemplo

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <S:Body>
        <ns2:cadastrarParametrizacaoViajanteResponse       
        xmlns:ns2="http://lemontech.com.br/selfbooking/wsselfbooking/services">
            <resultadoOperacao>
                <status>SUCESSO</status>
            </resultadoOperacao>
        </ns2:cadastrarParametrizacaoViajanteResponse>
    </S:Body>
</S:Envelope>