Capítulo30

Serviço inserirItemDespesa

30.1 - Requisição

O serviço inserirItemDespesa irá inserir na Solicitação uma despesa. Para inserir é preciso informar a id da Solicitação, tipo da despesa, valor, moeda, url da imagem do comprovante, informações de deslocamento no caso de uma despesas como gasolina ou km rodados e observação sobre a despesa.

Descrição dos campos de requisição Inserir Item Despesa

Tag

Descrição

Parent

Formato

Required

idSolicitacaoRef

Id da Solicitação

inserirItemDespesa

String

True

tipoDespesa

Tipo de Despesa cadastrada no sistema

inserirItemDespesa

String

True

valor

Valor total da despesa

inserirItemDespesa

Double

True

moeda

Moeda na qual foi cobrada a despesa: ARS, BRL, USD, NUC, EUR, GBP, JPY, CNY, PLN

inserirItemDespesa

Enum

True

imagem

URL da imagem do comprovante da despesa

inserirItemDespesa

String

True

deslocamento

Informações de deslocamento

inserirItemDespesa

Deslocamento

False

observacao

Observação sobre a despesa

inserirItemDespesa

String

False

identificadorExterno

Identificador da despesa no sistema externo

inserirItemDespesa

String

True

Descrição dos campos do tipo Deslocamento

Tag

Descrição

Parent

Formato

Required

latitudeOrigem

Latitude da origem

deslocamento

String

True

longitudeOrigem

Longitude da origem

deslocamento

String

True

latitudeDestino

Latitude do destino

deslocamento

String

True

longitudeDestino

Longitude do destino

deslocamento

String

True

distanciaPercorrida

Distancia percorrida no deslocamento

deslocamento

Double

True


30.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:inserirItemDespesa>
         <idSolicitacaoRef>solicitacao1</idSolicitacaoRef>
         <tipoDespesa>tipoDespesa1</tipoDespesa>
         <valor>100.0</valor>
         <moeda>BRL</moeda>
         <imagem>http://teste.com/imagem_comprovante.jpg</imagem>
         <!--Optional:-->
         <deslocamento>
            <latitudeOrigem>-23,5505199</latitudeOrigem>
            <longitudeOrigem>-46,6333094</longitudeOrigem>
            <latitudeDestino>-22,9133954</latitudeDestino>
            <longitudeDestino>-43,2007101</longitudeDestino>
            <distanciaPercorrida>600.80</distanciaPercorrida>
         </deslocamento>
         <!--Optional:-->
         <observacao>Obs teste</observacao>
      </ser:inserirItemDespesa>
    </soapenv:Body>
</soapenv:Envelope>

30.3 - Resposta

A reposta do serviço é enviada com a tag inserirItemDespesaResponse informando “Sucesso”, caso a inserção seja efetuada 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 Inserção de item de Despesa

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


30.4 - Exemplo

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