Capítulo12

Serviço cadastrarParametrizacaoCentroDeCusto

12.1 - Requisição

O serviço cadastrarParametrizacaoCentroDeCusto cadastra ou altera uma parametrização de centro de custo para determinado cliente. Para cadastrar é preciso informar a referência do funcionário, e do Centro de Custo ou do Sub Centro de Custo 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.

Existe três tipos de parametrização: Aprovação, Solicitação e Débito

Descrição dos campos de requisição parametrização de centro de custo aprovação

Tag	Descrição	Parent	Formato	Required
funcionarioRef	Código identificador do funcionário no sistema	parametrizacaoCentroDeCustoAprovacao	FuncionarioRef	True
centroDeCustoRef	Referência do centro de custo no qual o funcionário pertence. (O centroDeCustoRef ou o subCentroDeCustosRef é obrigarório)	parametrizacaoCentroDeCustoAprovacao	CentroDeCustoRef	False
subCentroDeCustoRef	Referência do sub centro de custo no qual o funcionário pertence. (O subCentroDeCustoRef ou o centroDeCustosRef é obrigarório)	parametrizacaoCentroDeCustoAprovacao	SubCentroDeCustoRef	False
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	parametrizacaoCentroDeCustoAprovacao	Numérico	False
tipoDeViagemDaAprocacao	Tipo de Viagem da Aprovação: TODOS, NACIONAL, CONTINENTAL, INTERNACIONAL, INTERCONTINENTAL. Para tanto o cliente deverá estar devidamente parametrizado.	parametrizacaoCentroDeCustoAprovacao	Enum	False
tipoDePassageiro	Tipo de passageiro: TODOS, PASSAGEIRO, TERCEIRO	parametrizacaoCentroDeCustoAprovacao	Enum	False
aprovaSomenteAprovador	Aprova somente Aprovador. Quando estiver como 'S', as pendencias desse aprovador serão somente as que o passageiro tiver perfil de aprovador	parametrizacaoCentroDeCustoAprovacao	Boolean	False
aprovaSomenteDentroDaPolitica	Aprova somente dentro da politica. Quando estiver como 'S', somente as solicitações dentro da politica poderão ser aprovadas pelo aprovador	parametrizacaoCentroDeCustoAprovacao	Boolean	False
periodoViagemInicial	Período de viagem inicial	parametrizacaoCentroDeCustoAprovacao	Data	False
vencimento	Data de vencimento da parametrização	parametrizacaoCentroDeCustoAprovacao	Data	False
periodoViagemFinal	Período de viagem final	parametrizacaoCentroDeCustoAprovacao	Data	False
valorAlcadaInicial	Valor da alçada inicial	parametrizacaoCentroDeCustoAprovacao	Double (#.##)	False
valorAlcadaFinal	Valor da alçada final	parametrizacaoCentroDeCustoAprovacao	Double (#.##)	False
tipoDeSolicitacao	Tipo de Solicitação: TODOS, CORPORATIVO, EXPENSE, INCENTIVO.	parametrizacaoCentroDeCustoAprovacao	Enum	False

Descrição dos campos de ParametrizacaoCentroDeCustoAprovacaoRef

Tag	Descrição	Parent	Formato	Required
funcionarioRef	Referência do funcionário no sistema	parametrizacaoCentroDeCustoAprovacaoRef	FuncionarioRef	True
centroDeCustoRef	Referência do centro de custo no sistema	parametrizacaoCentroDeCustoAprovacaoRef	CentroDeCustoRef	True
subCentroDeCustoRef	Referência do sub centro de custo no sistema	parametrizacaoCentroDeCustoAprovacaoRef	SubCentroDeCustoRef	False
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.	parametrizacaoCentroDeCustoAprovacaoRef	Numérico	False
tipoDeViagemDaAprocacao	Tipo de Viagem da Aprovação: TODOS, NACIONAL, CONTINENTAL, INTERNACIONAL, INTERCONTINENTAL. Para tanto o cliente deverá estar devidamente parametrizado.	parametrizacaoCentroDeCustoAprovacaoRef	Enum	False
tipoDePassageiro	Tipo de passageiro: TODOS, PASSAGEIRO, TERCEIRO.	parametrizacaoCentroDeCustoAprovacaoRef	Enum	False
aprovaSomenteAprovador	Aprova somente Aprovador. Quando estiver como 'S', as pendencias desse aprovador serão somente as que o passageiro tiver perfil de aprovador	parametrizacaoCentroDeCustoAprovacaoRef	Boolean	False
aprovaSomenteDentroDaPolitica	Aprova somente dentro da politica. Quando estiver como 'S', somente as solicitações dentro da politica poderão ser aprovadas pelo aprovador	parametrizacaoCentroDeCustoAprovacaoRef	Boolean	False
periodoViagemInicial	Período de viagem inicial	parametrizacaoCentroDeCustoAprovacaoRef	Data	False

Descrição dos campos de requisição parametrização de centro de custo solicitação

Tag	Descrição	Parent	Formato	Required
funcionarioRef	Referência do funcionário no sistema	parametrizacaoCentroDeCustoSolicitacao	FuncionarioRef	True
centroDeCustoRef	Referência do centro de custo no qual o funcionário pertence	parametrizacaoCentroDeCustoSolicitacao	CentroDeCustoRef	True
subCentroDeCustoRef	Referência do sub centro de custo no qual o funcionário pertence	parametrizacaoCentroDeCustoSolicitacao	SubCentroDeCustoRef	False
vencimento	Data de vencimento da parametrização	parametrizacaoCentroDeCustoSolicitacao	Data	False

Descrição dos campos de ParametrizacaoCentroDeCustoSolicitacaoRef

Tag	Descrição	Parent	Formato	Required
funcionarioRef	Referência do funcionário no sistema	parametrizacaoCentroDeCustoSolicitacaoRef	FuncionarioRef	True
centroDeCustoRef	Referência do centro de custo no qual o funcionário pertence	parametrizacaoCentroDeCustoSolicitacaoRef	CentroDeCustoRef	True
subCentroDeCustoRef	Referência do sub centro de custo no qual o funcionário pertence	parametrizacaoCentroDeCustoSolicitacaoRef	SubCentroDeCustoRef	False

Descrição dos campos de requisição parametrização de centro de custo débito

Tag	Descrição	Parent	Formato	Required
funcionarioRef	Código identificador do funcionário no sistema	parametrizacaoCentroDeCustoDebito	FuncionarioRef	True
centroDeCustoRef	Referência do centro de custo no qual o funcionário pertence	parametrizacaoCentroDeCustoDebito	CentroDeCustoRef	True
subCentroDeCustoRef	Referência do sub centro de custo no qual o funcionário pertence	parametrizacaoCentroDeCustoDebito	SubCentroDeCustoRef	False
vencimento	Data de vencimento da parametrização	parametrizacaoCentroDeCustoDebito	Data	True

Descrição dos campos de ParametrizacaoCentroDeCustoDebitoRef

Tag	Descrição	Parent	Formato	Required
funcionarioRef	Referência do funcionário no sistema	parametrizacaoCentroDeCustoDebitoRef	FuncionarioRef	True
centroDeCustoRef	Referência do centro de custo no qual o funcionário pertence	parametrizacaoCentroDeCustoDebitoRef	CentroDeCustoRef	True
subCentroDeCustoRef	Referência do sub centro de custo no qual o funcionário pertence	parametrizacaoCentroDeCustoDebitoRef	SubCentroDeCustoRef	False
idCliente	Número de identificação do Cliente	parametrizacaoCentroDeCustoDebitoRef	Inteiro	False

12.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:cadastrarParametrizacaoCentroDeCusto>
            <parametrizacaoCentroDeCustoAprovacao>
                <funcionarioRef>
                    <matricula>funcionario1</matricula>
                </funcionarioRef>
                <centroDeCustoRef>
                    <codigo>centroDeCusto1</codigo>
                    <regionalRef>
                        <codigo>regional1</codigo>
                    </regionalRef>
                </centroDeCustoRef>
                <nivelDeAprovacao>1</nivelDeAprovacao>
                <tipoDeViagemDaAprocacao>TODOS</tipoDeViagemDaAprocacao>
                <tipoDePassageiro>TODOS</tipoDePassageiro>
                <aprovaSomenteAprovador>false</aprovaSomenteAprovador>
                <aprovaSomenteDentroDaPolitica>false</aprovaSomenteDentroDaPolitica>
                <vencimento>2020-09-24</vencimento>
            </parametrizacaoCentroDeCustoAprovacao>
        </ser:cadastrarParametrizacaoCentroDeCusto>
    </soapenv:Body>
</soapenv:Envelope>

12.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>senha</ser:userPassword>
        <ser:userName>usuario</ser:userName>
        <ser:keyClient>chave_da_empresa_cliente</ser:keyClient>
    </soapenv:Header>
    <soapenv:Body>
        <ser:cadastrarParametrizacaoCentroDeCusto>
            <parametrizacaoCentroDeCustoAprovacao>
                <funcionarioRef>
                    <matricula>funcionario1</matricula>
                </funcionarioRef>
                <subCentroDeCustoRef>
                    <codigo>subCentroDeCusto1</codigo>
                    <centroDeCustoRef>
                        <codigo>centroDeCusto1</codigo>
                        <regionalRef>
                            <codigo>regional1</codigo>
                        </regionalRef>
                    </centroDeCustoRef>
                </subCentroDeCustoRef>
                <nivelDeAprovacao>1</nivelDeAprovacao>
                <tipoDeViagemDaAprocacao>TODOS</tipoDeViagemDaAprocacao>
                <tipoDePassageiro>TODOS</tipoDePassageiro>
                <aprovaSomenteAprovador>false</aprovaSomenteAprovador>
                <aprovaSomenteDentroDaPolitica>false</aprovaSomenteDentroDaPolitica>
                <vencimento>2020-09-24</vencimento>
            </parametrizacaoCentroDeCustoAprovacao>
        </ser:cadastrarParametrizacaoCentroDeCusto>
    </soapenv:Body>
</soapenv:Envelope>

12.4 - 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:cadastrarParametrizacaoCentroDeCusto>
            <parametrizacaoCentroDeCustoSolicitacao>
                <funcionarioRef>
                    <matricula>funcionario1</matricula>
                </funcionarioRef>
                <centroDeCustoRef>
                    <codigo>centroDeCusto1</codigo>
                    <regionalRef>
                        <codigo>regional1</codigo>
                    </regionalRef>
                </centroDeCustoRef>
                <vencimento>2020-09-24</vencimento>
            </parametrizacaoCentroDeCustoSolicitacao>
        </ser:cadastrarParametrizacaoCentroDeCusto>
    </soapenv:Body>
</soapenv:Envelope>

12.5 - 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:cadastrarParametrizacaoCentroDeCusto>
            <parametrizacaoCentroDeCustoDebito>
                <funcionarioRef>
                    <matricula>funcionario1</matricula>
                </funcionarioRef>
                <centroDeCustoRef>
                    <codigo>centroDeCusto1</codigo>
                    <regionalRef>
                        <codigo>regional1</codigo>
                    </regionalRef>
                </centroDeCustoRef>
                <vencimento>2020-09-24</vencimento>
            </parametrizacaoCentroDeCustoDebito>
            <!--Optional:-->
            <idCliente>idDoCliente</idCliente>
        </ser:cadastrarParametrizacaoCentroDeCusto>
    </soapenv:Body>
</soapenv:Envelope>

12.6 - Resposta

A reposta dos três serviços de cadastro de parametrização (Aprovação, Solicitação e Débito), são iguais. É enviada com a tag cadastrarParametrizacaoCentroDeCustoResponse 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 Centro de Custo

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

12.7 - Exemplo

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

Capítulo anterior

Serviço cadastrarFornecedor

Próximo capítulo

Serviço deletarParametrizacaoCentroDeCusto