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 |
English
Español
English
Español


