Web service com.senior.g5.co.mct.imp.importarmovimentacaocombustiveis
Tipo de execução
Para cada tipo de execução, existem diferentes parâmetros que podem ser comuns a todas as portas.
Autenticação
Caso seja utilizada alguma forma de autenticação para integração de informações através de web services, é necessário identificar o tipo no parâmetro <encryption>, conforme seus valores possíveis.
Campos numéricos
Orientação válida para qualquer campo de web service que possui objetivo de receber valores, independentemente do seu tipo ser Integer, Double e String. Estas orientações devem ser seguidas nas requisições efetuadas via SOAP e em execuções efetuadas através do SGI, relatórios e regras LSP.
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
- Envio no formato ZZZZ,ZZ
- É fundamental não enviar os campos numéricos com separador de milhar, pois ocorrerá erro ao executar a requisição
- Obrigatória a utilização do separador decimal com vírgula, e não com ponto
- Obrigatória a utilização do zero a direita. Por exemplo, se o valor for 350,20, a requisição deve ser enviada com este exato valor. Se o valor enviado for enviado como 350,2, o sistema não irá interpretar a requisição adequadamente
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
number(005,2) = 350,20 - o sistema espera que o número digitado contenha até 3 casas antes da vírgula e obrigatoriamente duas após;
number(015,2): 35000,20 - o sistema espera que o número digitado contenha até 13 casas antes da vírgula e obrigatoriamente duas após;
number(008,4) = 3200,2074 - o sistema espera que o número digitado contenha até 4 casas antes da vírgula e obrigatoriamente duas após.
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
- Envio no formato ZZZZ.ZZ
- É fundamental não enviar os campos numéricos com separador de milhar, pois ocorrerá erro ao executar a requisição
- Obrigatória a utilização do separador decimal com ponto, e não com vírgula
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
- number(005,2) = 350.20 - o sistema espera que o número digitado contenha até 3 casas antes da vírgula e obrigatoriamente duas após;
- number(015,2): 35000.20 - o sistema espera que o número digitado contenha até 13 casas antes da vírgula e obrigatoriamente duas após;
- number(008,4) = 3200.2074 - o sistema espera que o número digitado contenha até 4 casas antes da vírgula e obrigatoriamente duas após.
WSDL
- Síncrono: http://example.com/g5-senior-services/sapiens_Synccom_senior_g5_co_mct_imp_importarmovimentacaocombustiveis?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_mct_imp_importarmovimentacaocombustiveis?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Scheduledcom_senior_g5_co_mct_imp_importarmovimentacaocombustiveis?wsdl
Porta
Importar
Controladoria - Gestão de Tributos - Escrituração - Combustíveis - Importar Movimentação Diária
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 1
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:Importar> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <movimentoBomba> <codEmp>Integer</codEmp> <codFil>Integer</codFil> <codPro>String</codPro> <codDer>String</codDer> <datFec>String</datFec> <estAbe>Double</estAbe> <volRec>Double</volRec> <volSai>Double</volSai> <valPer>Double</valPer> <valGan>Double</valGan> <estFec>Double</estFec> </movimentoBomba> <movDiaria> <codEmp>Integer</codEmp> <codFil>Integer</codFil> <codPro>String</codPro> <codDer>String</codDer> <datFec>String</datFec> <numTan>String</numTan> <estAbe>Double</estAbe> <volRec>Double</volRec> <volSai>Double</volSai> <valPer>Double</valPer> <valGan>Double</valGan> </movDiaria> <volumeVendas> <codEmp>Integer</codEmp> <codFil>Integer</codFil> <codPro>String</codPro> <codDer>String</codDer> <datFec>String</datFec> <numTan>String</numTan> <codBic>Integer</codBic> <numIte>Integer</numIte> <motInt>String</motInt> <nomInt>String</nomInt> <numCgc>Double</numCgc> <cpfInt>Double</cpfInt> <vlrFin>Double</vlrFin> <vlrIni>Double</vlrIni> <afeBom>Double</afeBom> </volumeVendas> </parameters> </ser:Importar> </soapenv:Body> </soapenv:Envelope>
Parâmetros da requisição:
Nome | Tipo | Descrição |
---|---|---|
movimentoBomba | Set | |
movimentoBomba.codEmp | Integer | (Obrigatório) - CodEmp - Number(004) - Código da empresa |
movimentoBomba.codFil | Integer | (Obrigatório) - CodFil - Number(005) - Código da filial |
movimentoBomba.codPro | String | (Obrigatório) - CodPro - String(014) - Código do produto |
movimentoBomba.codDer | String | (Obrigatório) - CodDer - String(007) - Código da Derivação do Produto |
movimentoBomba.datFec | DateTime | (Obrigatório) - DatFec - Date(DD/MM/YYYY) - Data de fechamento da movimentação do combustível |
movimentoBomba.estAbe | Double | (Opcional) - EstAbe - Number(015,3) - Estoque no inicio do dia |
movimentoBomba.volRec | Double | (Opcional) - VolRec - Number(015,3) - Volume recebido no dia |
movimentoBomba.volSai | Double | (Opcional) - VolSai - Number(015,3) - Volume total das saídas |
movimentoBomba.valPer | Double | (Opcional) - ValPer - Number(015,3) - Valor da perda |
movimentoBomba.valGan | Double | (Opcional) - ValGan - Number(015,3) - Valor do ganho |
movimentoBomba.estFec | Double | (Opcional) - EstFec - Number(015,3) - Estoque de fechamento |
movDiaria | Set | |
movDiaria.codEmp | Integer | (Obrigatório) - CodEmp - Number(004) - Código da empresa |
movDiaria.codFil | Integer | (Obrigatório) - CodFil - Number(005) - Código da filial |
movDiaria.codPro | String | (Obrigatório) - CodPro - String(014) - Código do produto |
movDiaria.codDer | String | (Obrigatório) - CodDer - String(007) - Código da Derivação do Produto |
movDiaria.datFec | DateTime | (Obrigatório) - DatFec - Date(DD/MM/YYYY) - Data de fechamento da movimentação do combustível |
movDiaria.numTan | String | (Obrigatório) - NumTan - String(003) - Tanque que armazena o combustível ligado ao bico da bomba de combustível |
movDiaria.estAbe | Double | (Opcional) - EstAbe - Number(015,3) - Estoque no inicio do dia |
movDiaria.volRec | Double | (Opcional) -VolRec - Number(015,3) - Volume recebido no dia |
movDiaria.volSai | Double | (Opcional) -VolSai - Number(015,3) - Volume total das saídas |
movDiaria.valPer | Double | (Opcional) -ValPer - Number(015,3) - Valor da perda |
movDiaria.valGan | Double | (Opcional) -ValGan - Number(015,3) - Valor do ganho |
volumeVendas | Set | |
volumeVendas.codEmp | Integer | (Obrigatório) - CodEmp - Number(004) - Código da empresa |
volumeVendas.codFil | Integer | (Obrigatório) - CodFil - Number(005) - Código da filial |
volumeVendas.codPro | String | (Obrigatório) - CodPro - String(014) - Código do produto |
volumeVendas.codDer | String | (Obrigatório) - CodDer - String(007) - Código da Derivação do Produto |
volumeVendas.datFec | DateTime | (Obrigatório) - DatFec - Date(DD/MM/YYYY) - Data de fechamento da movimentação do combustível |
volumeVendas.numTan | String | (Obrigatório) - NumTan - String(003) - Tanque que armazena o combustível ligado ao bico da bomba de combustível |
volumeVendas.codBic | Integer | (Obrigatório) - CodBic - Number(003) - Número sequencial do bico ligado a bomba de combustível |
volumeVendas.numIte | Integer | (Opcional) - NumIte - Number(009) - Número da intervenção |
volumeVendas.motInt | String | (Opcional) - MotInt - String(050) - Motivo da intervenção |
volumeVendas.nomInt | String | (Opcional) - NomInt - String(030) - Nome do Interventor |
volumeVendas.numCgc | Double | (Opcional) - NumCgc - Number(014,0) - CNPJ da empresa responsável pela intervenção |
volumeVendas.cpfInt | Double | (Opcional) - CpfInt - Number(012,0) - CPF do técnico responsável pela interveção |
volumeVendas.vlrFin | Double | (Opcional) - VlrFin - Number(015,3) - Valor final do contador, no fechamento do bico |
volumeVendas.vlrIni | Double | (Opcional) - VlrIni - Number(015,3) - Valor inicial do contador, na abertura do bico |
volumeVendas.afeBom | Double | (Opcional) - AfeBom - Number(015,3) - Aferições da bomba |
Resposta:
Observação
Envelope SOAP de resposta de requisições síncronas. Para requisições assíncronas ou agendamentos, a resposta é apenas uma String chamada "result" com o valor "OK", se foi executado com sucesso ou, caso contrário, a mensagem do erro ocorrido.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:ImportarResponse> <result> <retorno> <codEmp>Integer</codEmp> <codFil>Integer</codFil> <codPro>String</codPro> <codDer>String</codDer> <datFec>String</datFec> <msgRet>String</msgRet> </retorno> <erroExecucao>String</erroExecucao> </result> </ser:ImportarResponse> </soapenv:Body> </soapenv:Envelope>
Atributos da resposta:
Nome | Tipo | Descrição |
---|---|---|
erroExecucao | String | Indica erros ocorridos no servidor ao executar o serviço, podendo conter os seguintes valores:Vazio ou nulo, indicando que a execução foi feita com sucessoA mensagem do erro ocorrido no servidorSó impede a gravação quando o retorno.tipRet for igual a "2" |
retorno | Set | |
retorno.codEmp | Integer | CodEmp - (Retorno) - Number(004) - Código da empresa |
retorno.codFil | Integer | CodFil - (Retorno) - Number(005) - Código da filial |
retorno.codPro | String | CodPro - (Retorno) - String(014) - Código do produto |
retorno.codDer | String | CodDer - (Retorno) - String(007) - Código da Derivação do Produto |
retorno.datFec | DateTime | DatFec - (Retorno) - Date(DD/MM/YYYY) - Data de fechamento da movimentação do combustível |
retorno.msgRet | String | MsgRet - (Retorno) - String - Mensagem de retorno do processament |