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>