Capítulo8

Serviço cadastrarCentroDeCusto

8.1 - Requisição

O serviço cadastrarCentroDeCusto cadastra ou altera um centro de custo para determinado cliente. Para cadastrar é preciso informar um código identificador do centro de custo e também o código da regional na qual esse centro de custo pertence, caso já tenha cadastrado no sistema, um centro de custo com esse código para tal cliente, o sistema irá atualizar as informações da mesma.

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

Tag

Descrição

Parent

Formato

Required

codigo

Código identificador do centro de custo no sistema

centroDeCusto

String

True

regionalRef

Código identificador da regional na qual esse centro de custo pertence

centroDeCusto

RegionalRef

True

descricao

Descrição do centro de custo

centroDeCusto

String

True

configuracao

Configuração do Centro de Custo

centroDeCusto

Configuração

True

ativo

Status do centro de custo

centroDeCusto

Boolean

True

idCliente

Número de identificação do Cliente

centroDeCusto

Inteiro

False

Descrição do campo Configuração

Tag

Descrição

Parent

Formato

Required

autoAprovavel

Centro de Custo auto aprovavel

configuracao

Boolean

True

debitaBudget

Permite debito de budget

configuracao

Boolean

False

Descrição do campo CentroDeCustoRef

Tag

Descrição

Parent

Formato

Required

codigo

Código identificador do centro de custo no sistema

centroDeCustoRef

String

True

regionalRef

Código identificador da regional na qual esse centro de custo pertence

centroDeCustoRef

RegionalRef

True


8.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:cadastrarCentroDeCusto>
            <centroDeCusto>
            	<idCliente>idDoCliente</idCliente>
                <codigo>centroDeCusto1</codigo>
                <regionalRef>
                    <codigo>regional1</codigo>
                </regionalRef>
                <descricao>Centro de Custo 1</descricao>
                <configuracao>
                    <autoAprovavel>true</autoAprovavel>
                    <debitaBudget>true</debitaBudget>
                </configuracao>
            </centroDeCusto>
            <!--Optional:-->
            <idCliente>idDoCliente</idCliente>
        </ser:cadastrarCentroDeCusto>
    </soapenv:Body>
</soapenv:Envelope>

8.3 - Resposta

A reposta do serviço é enviada com a tag cadastrarCentroDeCustoResponse informando “Sucesso”, caso o cadastro efetuado corretamente, ou “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


8.4 - Exemplo

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