Web service Com.senior.g5.co.mcm.ven.entregas
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_mcm_ven_entregas?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_mcm_ven_entregas?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Scheduledcom_senior_g5_co_mcm_ven_entregas?wsdl
Portas
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
Mercado - Gestão de Faturamento e Outras Saídas - Controle de Entregas - Importação
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 1
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:ImportarEntregaMercadoria> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <entregas> <codEmp>Integer</codEmp> <codFil>Integer</codFil> <codSnf>String</codSnf> <numNfv>Integer</numNfv> <staEnt>String</staEnt> <datEnt>String</datEnt> <horEnt>String</horEnt> <codTra>Integer</codTra> <plaVei>String</plaVei> <resRec>String</resRec> <tipDoc>String</tipDoc> <docEnt>String</docEnt> <latEnt>String</latEnt> <lonEnt>String</lonEnt> <obsEnt>String</obsEnt> <imaEnt>String</imaEnt> </entregas> </parameters> </ser:ImportarEntregaMercadoria> </soapenv:Body> </soapenv:Envelope>
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
Nome | Tipo | Descrição |
---|---|---|
entregas | Set | |
entregas.codEmp | Integer | (Obrigatório) - Number(004) - Empresa |
entregas.codFil | Integer | (Obrigatório) - Number(005) - Filial |
entregas.codSnf | String | (Obrigatório) - String(003) - Série NF |
entregas.numNfv | Integer | (Obrigatório) - Number(009) - Nr. NF |
entregas.staEnt | String | (Obrigatório) - String(001) - Status - Lista: N = Não entregue, T = Tentativa, E = Entregue |
entregas.datEnt | DateTime | (Opcional) - String(010) - Data Ent. - Máscara: DD/MM/AAAA |
entregas.horEnt | String | (Opcional) - String(005) - Hora entrega - Máscara: HH:MM |
entregas.codTra | Integer | (Obrigatório) - Number(009) - Transp. |
entregas.plaVei | String | (Opcional) - String(010) - Placa |
entregas.resRec | String | (Opcional) - String(254) - Resp.Receb. |
entregas.tipDoc | String | (Opcional) - String(004) - Tip.Doc. - Lista: RG = Registro Geral, CPF = Cadastro de Pessoa Física, CNPJ = Cadastro Nacional de Pessoa Jurídica, CNH = Carteira Nacional de Habilitação, OUT = Outro documento |
entregas.docEnt | String | (Opcional) - String(099) - Doc.Entrega |
entregas.latEnt | String | (Opcional) - String(049) - Lat.Ent. |
entregas.lonEnt | String | (Opcional) - String(049) - Long.Ent. |
entregas.obsEnt | String | (Opcional) - String(999) - Observação |
entregas.imaEnt | String | (Opcional) - String(999) - Imagem ent. |
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
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:ImportarEntregaMercadoriaResponse> <result> <retorno> <codemp>Integer</codemp> <codfil>Integer</codfil> <codsnf>String</codsnf> <numNfv>Integer</numNfv> <sitNfv>String</sitNfv> </retorno> <mensagemRetorno>String</mensagemRetorno> <tipoRetorno>String</tipoRetorno> <erroExecucao>String</erroExecucao> </result> </ser:ImportarEntregaMercadoriaResponse> </soapenv:Body> </soapenv:Envelope>
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
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 | (Obrigatório) - Number(004) - Empresa |
retorno.codfil | Integer | (Obrigatório) - Number(005) - Filial |
retorno.codsnf | String | (Obrigatório) - String(003) - Série NF |
retorno.numNfv | Integer | (Obrigatório) - Number(009) - Nr. NF |
retorno.sitNfv | String | (Opcional) - String(999) - Obs. NF |
mensagemRetorno | String | (Obrigatório) - String(250) - Mensagem de retorno da importação |
tipoRetorno | String | (Obrigatório) - Number(001) - Indicativo do tipo de retorno da solicitação - Lista: 1 = Processado com sucesso, 2 = Processado com erro |
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
Mercado - Gestão de Faturamento e Outras Saídas - Cotrole de Entregas - Exportação
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 1
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:ExportarEntregaMercadoria> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <cnpFil>String</cnpFil> <codTra>Integer</codTra> <plaVei>String</plaVei> </parameters> </ser:ExportarEntregaMercadoria> </soapenv:Body> </soapenv:Envelope>
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
Nome | Tipo | Descrição |
---|---|---|
cnpFil | String | (Opcional) - Number(015) - CNPJ da Filial |
codTra | Integer | (Obrigatório) - Number(009) - Código da transportadora |
plaVei | String | (Obrigatório) - String(010) - Placa do veículo |
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
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:ExportarEntregaMercadoriaResponse> <result> <mensagemRetorno>String</mensagemRetorno> <exportacao> <codEmp>Integer</codEmp> <codFil>Integer</codFil> <codSnf>String</codSnf> <numNfv>Integer</numNfv> <nomCli>String</nomCli> <endCli>String</endCli> <nenEnt>String</nenEnt> <cplEnd>String</cplEnd> <cliPrx>String</cliPrx> <baiEnt>String</baiEnt> <cidEnt>String</cidEnt> <foncli>String</foncli> <cepEnt>Integer</cepEnt> <ufsEnt>String</ufsEnt> <vlrFin>Double</vlrFin> <totVol>Double</totVol> <codRoe>String</codRoe> <codSro>String</codSro> <seqRoe>Integer</seqRoe> <obsNfv>String</obsNfv> </exportacao> <tipoRetorno>String</tipoRetorno> <qtdLinhas>String</qtdLinhas> <erroExecucao>String</erroExecucao> </result> </ser:ExportarEntregaMercadoriaResponse> </soapenv:Body> </soapenv:Envelope>
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
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" |
mensagemRetorno | String | (Obrigatório) - String(250) - Mensagem de retorno da importação |
exportacao | Set | |
exportacao.codEmp | Integer | (Obrigatório) - Number(004) - Empresa |
exportacao.codFil | Integer | (Obrigatório) - Number(005) - Filial |
exportacao.codSnf | String | (Obrigatório) - String(003) - Série NF |
exportacao.numNfv | Integer | (Obrigatório) - Number(009) - Nr. NF |
exportacao.nomCli | String | (Obrigatório) - String(100) - Nome |
exportacao.endCli | String | (Opcional) - String(100) - Endereço |
exportacao.nenEnt | String | (Opcional) - String(060) - Número Endereço |
exportacao.cplEnd | String | (Opcional) - String(200) - Compl. |
exportacao.cliPrx | String | (Opcional) - String(120) - Proximidade |
exportacao.baiEnt | String | (Opcional) - String(075) - Bairro Ent. |
exportacao.cidEnt | String | (Opcional) - String(060) - Cid. Ent. |
exportacao.foncli | String | (Opcional) - String(020) - Fone - 1 |
exportacao.cepEnt | Integer | (Opcional) - Number(008) - CEP |
exportacao.ufsEnt | String | (Opcional) - String(002) - Estado |
exportacao.vlrFin | Double | (Opcional) - Number(015) - Vlr. Líq. NF Fin. |
exportacao.totVol | Double | (Opcional) - Number(015) - Total de volumes |
exportacao.codRoe | String | (Opcional) - String(003) - Rota |
exportacao.codSro | String | (Opcional) - String(003) - Sub Rota |
exportacao.seqRoe | Integer | (Opcional) - Number(004) - Seq. Rota |
exportacao.obsNfv | String | (Opcional) - String(999) - Obs. NF |
tipoRetorno | String | (Obrigatório) - Number(001) - Indicativo do tipo de retorno da solicitação - Lista: 1 = Processado com sucesso, 2 = Processado com erro |
qtdLinhas | String |