Web service Com.senior.g5.co.int.varejo.transportadoras
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.
- 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
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.
- 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
- 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_int_varejo_transportadoras?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_int_varejo_transportadoras?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Scheduledcom_senior_g5_co_int_varejo_transportadoras?wsdl
Portas
Integrações - Varejo - Cadastros - Exportar Transportadoras
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 2
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:Exportar_2> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <codEmp>Integer</codEmp> <gridConsulta> <consulta>String</consulta> </gridConsulta> <codFil>Integer</codFil> <quantidadeRegistros>Integer</quantidadeRegistros> <tipoIntegracao>String</tipoIntegracao> <identificacaoSistema>String</identificacaoSistema> </parameters> </ser:Exportar_2> </soapenv:Body> </soapenv:Envelope>
Nome | Tipo | Descrição |
---|---|---|
codEmp | Integer | (Obrigatório) - Number(004) - Código da Empresa |
gridConsulta | Set | (Obrigatório) - Utilizar para informar quais registros devem ser retornados. Utilizar apenas quando o tipo de integração for específico ("E") |
gridConsulta.consulta | String | (Obrigatório) - Number(009) - Código da Transportadora. |
codFil | Integer | (Obrigatório) - Number(005) - Código da Filial |
quantidadeRegistros | Integer | (Opcional) - Number(005) - Quantidade de registros limite para retorno da solicitação. Quando o tipo de integração for "E", este valor não é utilizado. |
tipoIntegracao | String | (Obrigatório) - String(001) - Tipo de Integração - Lista: T = Todos, A = Somente Alterados, E = Registro Específico |
identificacaoSistema | String | (Obrigatório) - String(15) - - Identificação do sistema integrado |
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:Exportar_2Response> <result> <tipoRetorno>Integer</tipoRetorno> <gridTransportadoras> <seqInt>String</seqInt> <codTra>Integer</codTra> <nomTra>String</nomTra> <apeTra>String</apeTra> <tipTra>String</tipTra> <insEst>String</insEst> <insMun>String</insMun> <cgcCpf>String</cgcCpf> <nomCto>String</nomCto> <fonTra>String</fonTra> <faxTra>String</faxTra> <cxaPst>Integer</cxaPst> <intNet>String</intNet> <codVia>String</codVia> <plaVei>String</plaVei> <cifFob>String</cifFob> <traCli>Integer</traCli> <traFor>Integer</traFor> <sitTra>String</sitTra> <pesMax>Double</pesMax> <volMax>Double</volMax> <codGre>Integer</codGre> <indExp>Integer</indExp> <eenTra>String</eenTra> <pagCle>String</pagCle> <nenTra>String</nenTra> <nrnTrc>String</nrnTrc> <cEP> <endTra>String</endTra> <cplEnd>String</cplEnd> <cepTra>Integer</cepTra> <baiTra>String</baiTra> <cidTra>String</cidTra> <sigUfs>String</sigUfs> <codPai>String</codPai> </cEP> <vIA> <codVia>String</codVia> <desVia>String</desVia> <abrVia>String</abrVia> </vIA> <datGer>String</datGer> <horGer>String</horGer> <datAlt>String</datAlt> <horAlt>String</horAlt> <endTra>String</endTra> </gridTransportadoras> <gridErros> <msgErr>String</msgErr> </gridErros> <mensagemRetorno>String</mensagemRetorno> <finalizaramRegistros>String</finalizaramRegistros> <numeroLote>Integer</numeroLote> <erroExecucao>String</erroExecucao> </result> </ser:Exportar_2Response> </soapenv:Body> </soapenv:Envelope>
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" |
tipoRetorno | Integer | (Obrigatório) - Number(001) - Tipo de Retorno de Processamento - Lista: 1 = Processado, 2 = Erro na Solicitação |
gridTransportadoras | Set | |
gridTransportadoras.seqInt | String | (Obrigatório) - SeqInt - Number(009) - Sequencial do Registro Integrado |
gridTransportadoras.codTra | Integer | CodTra - Number(009) - Código da Transportadora |
gridTransportadoras.nomTra | String | NomTra - String(100) - Nome da transportadora |
gridTransportadoras.apeTra | String | ApeTra - String(050) - Nome fantasia da transportadora |
gridTransportadoras.tipTra | String | TipTra - String(001) - Tipo de transportadora Lista: J = Pessoa Jurídica, F = Pessoa Física |
gridTransportadoras.insEst | String | InsEst - String(025) - Inscrição estadual da transportadora |
gridTransportadoras.insMun | String | InsMun - String(016) - Inscrição municipal da transportadora |
gridTransportadoras.cgcCpf | String | CgcCpf - String(014) - Número do CNPJ ou CPF da transportadora |
gridTransportadoras.nomCto | String | NomCto - String(150) - Nome da pessoa de contato na transportadora |
gridTransportadoras.fonTra | String | FonTra - String(020) - Número do telefone da transportadora |
gridTransportadoras.faxTra | String | FaxTra - String(020) - Número do FAX da transportadora |
gridTransportadoras.cxaPst | Integer | CxaPst - Number(006) - Número da caixa postal da transportadora |
gridTransportadoras.intNet | String | IntNet - String(100) - Endereço eletrônico (e-mail) |
gridTransportadoras.codVia | String | CodVia - String(003) - Código da via de transporte da transportadora |
gridTransportadoras.plaVei | String | PlaVei - String(010) - Placa do veículo principal da transportadora |
gridTransportadoras.cifFob | String | CifFob - String(001) - Indicativo se o frete da transportadora é CIF ou FOB Lista: C = Por conta do emitente, F = Por conta do destinatário, T = Por conta de terceiros, X = Sem frete |
gridTransportadoras.traCli | Integer | TraCli - Number(009) - Código da transportadora como cliente |
gridTransportadoras.traFor | Integer | TraFor - Number(009) - Código da transportadora como fornecedor |
gridTransportadoras.sitTra | String | SitTra - String(001) - Situação da transportadora Lista: A = Ativo, I = Inativo |
gridTransportadoras.pesMax | Double | PesMax - Number(011,2) - Peso Máximo para frota própria |
gridTransportadoras.volMax | Double | VolMax - Number(011,2) - Volume Máximo para Frota Própria |
gridTransportadoras.codGre | Integer | CodGre - Number(004) - Código do grupo de empresas |
gridTransportadoras.indExp | Integer | IndExp - Number(001) - Indicativo se o registro foi alterado para exportar para o palm Lista: 0 = Para Exportar, 1 = Em Exportação, 2 = Exportado, 3 = Aprovado, 4 = Em Digitação, 5 = Aguardando Liberação para Envio, 9 = Erro |
gridTransportadoras.eenTra | String | EenTra - String(018) - Código do endereço da transportadora |
gridTransportadoras.pagCle | String | PagCle - String(001) - Tipo de pagamento do serviço de coleta Lista: K = Quilometragem, L = Litragem |
gridTransportadoras.nenTra | String | NenTra - String(060) - Número do endereço da transportadora |
gridTransportadoras.nrnTrc | String | NrnTrc - String(014) - Registro nacional de transportadores rodoviários de carga - RNTRC |
gridTransportadoras.cEP | Set | |
gridTransportadoras.cEP.endTra | String | EndTra - String(100) - Endereço da transportadora |
gridTransportadoras.cEP.cplEnd | String | CplEnd - String(200) - Complemento do endereço da transportadora (sala, andar, etc.) |
gridTransportadoras.cEP.cepTra | Integer | CepTra - Number(008) - Cep da transportadora |
gridTransportadoras.cEP.baiTra | String | BaiTra - String(075) - Bairro da transportadora |
gridTransportadoras.cEP.cidTra | String | CidTra - String(060) - Cidade da transportadora |
gridTransportadoras.cEP.sigUfs | String | SigUfs - String(002) - Sigla do estado da transportadora |
gridTransportadoras.cEP.codPai | String | CodPai - String(004) - Código do país da transportadora |
gridTransportadoras.vIA | Set | |
gridTransportadoras.vIA.codVia | String | CodVia - String(003) - Código da via de transportes |
gridTransportadoras.vIA.desVia | String | DesVia - String(030) - Nome da via de transportes |
gridTransportadoras.vIA.abrVia | String | AbrVia - String(010) - Abreviatura da via de transportes |
gridTransportadoras.datGer | DateTime | DatGer - Date(DD/MM/YYYY) - Data da geração do registro |
gridTransportadoras.horGer | String | HorGer - Time(HH:MM) - Hora da geração do registro |
gridTransportadoras.datAlt | DateTime | DatAlt - Date(DD/MM/YYYY) - Data da última alteração do registro |
gridTransportadoras.horAlt | String | HorAlt - Time(HH:MM) - Hora da última alteração do registro |
gridTransportadoras.endTra | String | Endereço da transportadora |
gridErros | Set | (Opcional) - Lista dos erro |
gridErros.msgErr | String | Erros |
mensagemRetorno | String | (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento |
finalizaramRegistros | String | (Obrigatório) - String(001) - Indicativo se existem mais informações a serem solicitadas - Lista: S = Sim, N = Não |
numeroLote | Integer | (Obrigatório) - Inteiro - Identificação do Lote de Exportação |
Integrações - Varejo - Cadastros - Importar Transportadoras
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 1
<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> <transportadora> <codEmp>Integer</codEmp> <codFil>Integer</codFil> <codTra>Integer</codTra> <nomTra>String</nomTra> <apeTra>String</apeTra> <tipTra>String</tipTra> <insEst>String</insEst> <insMun>String</insMun> <cgcCpf>Double</cgcCpf> <endTra>String</endTra> <cplEnd>String</cplEnd> <cepTra>Integer</cepTra> <baiTra>String</baiTra> <cidTra>String</cidTra> <sigUfs>String</sigUfs> <nomCto>String</nomCto> <fonTra>String</fonTra> <faxTra>String</faxTra> <cxaPst>Integer</cxaPst> <intNet>String</intNet> <codVia>String</codVia> <plaVei>String</plaVei> <cifFob>String</cifFob> <traCli>Integer</traCli> <traFor>Integer</traFor> <sitTra>String</sitTra> <usuGer>Double</usuGer> <datGer>String</datGer> <horGer>String</horGer> <usuAlt>Double</usuAlt> <datAlt>String</datAlt> <horAlt>String</horAlt> <pagCle>String</pagCle> <nenTra>String</nenTra> <nrnTrc>String</nrnTrc> <codPai>String</codPai> <vlrKmt>Double</vlrKmt> <ideExt>Integer</ideExt> <proTra>Integer</proTra> </transportadora> <sistemaIntegracao>String</sistemaIntegracao> </parameters> </ser:Importar> </soapenv:Body> </soapenv:Envelope>
Nome | Tipo | Descrição |
---|---|---|
transportadora | Set | |
transportadora.codEmp | Integer | (Obrigatório) - CodEmp - Number(004) - Código da empresa |
transportadora.codFil | Integer | (Obrigatório) - CodFil - Number(005) - Código da filial |
transportadora.codTra | Integer | (Obrigatório) - CodTra - Number(009) - Código da Transportadora |
transportadora.nomTra | String | (Obrigatório) - NomTra - String(100) - Nome da transportadora |
transportadora.apeTra | String | (Obrigatório) - ApeTra - String(050) - Nome fantasia da transportadora |
transportadora.tipTra | String | (Obrigatório) - TipTra - String(001) - Tipo de transportadora Lista: J = Pessoa Jurídica, F = Pessoa Física |
transportadora.insEst | String | (Opcional) - InsEst - String(025) - Inscrição estadual da filial da empresa |
transportadora.insMun | String | (Opcional) - InsMun - String(016) - Inscrição municipal da filial da empresa |
transportadora.cgcCpf | Double | (Opcional) - CgcCpf - Number(014,0) - Número do CNPJ ou CPF da transportadora |
transportadora.endTra | String | (Opcional) - EndTra - String(100) - Endereço da transportadora |
transportadora.cplEnd | String | (Opcional) - CplEnd - String(200) - Complemento do endereço da filial da empresa (Sala, andar, etc.) |
transportadora.cepTra | Integer | (Opcional) - CepTra - Number(008) - Cep da transportadora |
transportadora.baiTra | String | (Opcional) - BaiTra - String(075) - Bairro da transportadora |
transportadora.cidTra | String | (Opcional) - CidTra - String(060) - Cidade da transportadora |
transportadora.sigUfs | String | (Opcional) - SigUfs - String(002) - Sigla do estado da filial da empresa |
transportadora.nomCto | String | (Opcional) - NomCto - String(150) - Nome da pessoa de contato na transportadora |
transportadora.fonTra | String | (Opcional) - FonTra - String(020) - Número do telefone da transportadora |
transportadora.faxTra | String | (Opcional) - FaxTra - String(020) - Número do FAX da transportadora |
transportadora.cxaPst | Integer | (Opcional) - CxaPst - Number(006) - Número da caixa postal da filial da empresa |
transportadora.intNet | String | (Opcional) - IntNet - String(100) - Endereço eletrônico (e-mail) |
transportadora.codVia | String | (Obrigatório) - CodVia - String(003) - Código da via de transporte da transportadora |
transportadora.plaVei | String | (Opcional) - PlaVei - String(010) - Placa do veículo principal da transportadora |
transportadora.cifFob | String | (Obrigatório) - CifFob - String(001) - Indicativo se o frete da transportadora é CIF ou FOB Lista: C = Por conta do emitente, F = Por conta do destinatário, T = Por conta de terceiros, X = Sem frete |
transportadora.traCli | Integer | (Opcional) - TraCli - Number(009) - Código da transportadora como cliente |
transportadora.traFor | Integer | (Opcional) - TraFor - Number(009) - Código da transportadora como fornecedor |
transportadora.sitTra | String | (Obrigatório) - SitTra - String(001) - Situação da transportadora Lista: A = Ativo, I = Inativo |
transportadora.usuGer | Double | (Opcional) - UsuGer - Number(010,0) - Usuário responsável pela geração do registro |
transportadora.datGer | DateTime | (Opcional) - DatGer - Date(DD/MM/YYYY) - Data da geração do registro |
transportadora.horGer | String | (Opcional) - HorGer - Time(HH:MM) - Hora da geração do registro |
transportadora.usuAlt | Double | (Opcional) - UsuAlt - Number(010,0) - Usuário responsável pela última alteração do registro |
transportadora.datAlt | DateTime | (Opcional) - DatAlt - Date(DD/MM/YYYY) - Data da última alteração do registro |
transportadora.horAlt | String | (Opcional) - HorAlt - Time(HH:MM) - Hora da última alteração do registro |
transportadora.pagCle | String | (Opcional) - PagCle - String(001) - Tipo de pagamento do serviço de coleta Lista: K = Quilometragem, L = Litragem |
transportadora.nenTra | String | (Opcional) - NenTra - String(060) - Número do endereço da transportadora |
transportadora.nrnTrc | String | (Opcional) - NrnTrc - String(014) - Registro nacional de transportadores rodoviários de carga - RNTRC |
transportadora.codPai | String | (Opcional) - CodPai - String(004) - Código do país da transportadora |
transportadora.vlrKmt | Double | (Opcional) - VlrKmt - Number(015,2) - Valor pago por quilômetro utilizado |
transportadora.ideExt | Integer | (Obrigatório) - IdeExt - Number(015) - Identificador Externo |
transportadora.proTra | Integer | (Opcional) - ProTra - Number(001) - Tipo proprietário Lista: 0 = TAC Agregado, 1 = TAC Independente, 2 = Outros |
sistemaIntegracao | String | (Obrigatório) - String(15) - Identificação do sistema integrado |
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> <tipoRetorno>Integer</tipoRetorno> <retorno> <codEmp>Integer</codEmp> <codFil>Integer</codFil> <codTra>Integer</codTra> <cgcCpf>String</cgcCpf> <ideExt>Integer</ideExt> <tipRet>Integer</tipRet> <msgRet>String</msgRet> </retorno> <mensagemRetorno>String</mensagemRetorno> <erroExecucao>String</erroExecucao> </result> </ser:ImportarResponse> </soapenv:Body> </soapenv:Envelope>
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" |
tipoRetorno | Integer | (Obrigatório) - Number(001) - Tipo de Retorno de Processamento - Lista: 1 = Processado, 2 = Erro na Solicitação |
retorno | Set | |
retorno.codEmp | Integer | CodEmp - Number(004) - Código da empresa |
retorno.codFil | Integer | CodFil - Number(005) - Código da filial |
retorno.codTra | Integer | CodTra - Number(009) - Código da Transportadora |
retorno.cgcCpf | String | CgcCpf - String(014,0) - Número do CNPJ ou CPF da transportadora |
retorno.ideExt | Integer | IdeExt - Number(015) - Identificador Externo |
retorno.tipRet | Integer | TipRet - Number(001) - Tipo do retorno do processamento - Lista: 1 = Processado, 2 = Ocorreram Erros |
retorno.msgRet | String | MsgRet - String - Mensagem de retorno do processamento |
mensagemRetorno | String | (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento |