English
Español
Integrações com outros sistemas > Web services > Web services disponíveis no Gestão Empresarial > Com.senior.g5.co.ger.cad.transportadora
Web service Com.senior.g5.co.ger.cad.transportadora
Importante
Para mais informações sobre atualização cadastral de clientes, fornecedores e transportadoras por meio de uma consulta ao cadastro centralizado da SEFAZ, feita por meio de uma integração do Gestão Empresarial | ERP com o eDocs, verifique a documentação deste processo.
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.
Campos que representam valores monetários, quantidade e percentual e estão declarados como String
- 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
Exemplo:
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.
Campos que representam valores monetários, quantidade e percentual e não estão declarados como String
- 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
Exemplo:
- 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_ger_cad_transportadora?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_ger_cad_transportadora?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Scheduledcom_senior_g5_co_ger_cad_transportadora?wsdl
Porta(s)
GravarTransportadora
Cadastros - Mercado e Suprimentos - Transportadora - Cadastro.
Necessita autenticação: sim.
Situação de versão: atual.
Versão: 2.
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:GravarTransportadora>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<gridTransportadora>
<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>
<codGre>Integer</codGre>
<sigUfs>String</sigUfs>
<nomCto>String</nomCto>
<fonTra>String</fonTra>
<faxTra>String</faxTra>
<cxaPst>Integer</cxaPst>
<intNet>String</intNet>
<codVia>String</codVia>
<plaVei>String</plaVei>
<pesMax>Double</pesMax>
<volMax>Double</volMax>
<cifFob>String</cifFob>
<traCli>Integer</traCli>
<traFor>Integer</traFor>
<sitTra>String</sitTra>
<pagCle>String</pagCle>
<nrnTrc>String</nrnTrc>
<ideExt>String</ideExt>
<tipOpe>Integer</tipOpe>
<codHas>String</codHas>
<cEP>
<endTra>String</endTra>
<cplEnd>String</cplEnd>
<cepTra>Integer</cepTra>
<baiTra>String</baiTra>
<cidTra>String</cidTra>
<sigUfs>String</sigUfs>
<codPai>String</codPai>
<nenTra>String</nenTra>
</cEP>
<viaTransporte>
<codVia>String</codVia>
<desVia>String</desVia>
<abrVia>String</abrVia>
</viaTransporte>
</gridTransportadora>
<sistemaIntegracao>String</sistemaIntegracao>
</parameters>
</ser:GravarTransportadora>
</soapenv:Body>
</soapenv:Envelope>
Parâmetros da requisição:
| Nome | Tipo | Descrição |
|---|---|---|
| gridTransportadora | Set | - |
| gridTransportadora.codEmp | Integer | Código da Empresa |
| gridTransportadora.codFil | Integer | Código da Filial |
| gridTransportadora.codTra | Integer | Código da Transportadora |
| gridTransportadora.nomTra | String | Nome da transportadora |
| gridTransportadora.apeTra | String | Nome fantasia da transportadora |
| gridTransportadora.tipTra | String | Tipo de transportadora |
| gridTransportadora.insEst | String | Inscrição estadual da transportadora |
| gridTransportadora.insMun | String | Inscrição municipal da transportadora |
| gridTransportadora.cgcCpf | Double | Número do CNPJ ou CPF da transportadora |
| gridTransportadora.codGre | Integer | Código do grupo de empresas |
| gridTransportadora.sigUfs | String | Sigla do estado da transportadora |
| gridTransportadora.nomCto | String | Nome da pessoa de contato na transportadora |
| gridTransportadora.fonTra | String | Número do telefone da transportadora |
| gridTransportadora.faxTra | String | Número do FAX da transportadora |
| gridTransportadora.cxaPst | Integer | Número da caixa postal da transportadora |
| gridTransportadora.intNet | String | Endereço eletrônico (e-mail) |
| gridTransportadora.codVia | String | Código da via de transporte da transportadora |
| gridTransportadora.plaVei | String | Placa do veículo principal da transportadora |
| gridTransportadora.pesMax | Double | Peso Máximo para frota própria |
| gridTransportadora.volMax | Double | Volume Máximo para Frota Própria |
| gridTransportadora.cifFob | String | Indicativo se o frete da transportadora é CIF ou FOB |
| gridTransportadora.traCli | Integer | Código da transportadora como cliente |
| gridTransportadora.traFor | Integer | Código da transportadora como fornecedor |
| gridTransportadora.sitTra | String | Situação da transportadora |
| gridTransportadora.pagCle | String | Tipo de pagamento do serviço de coleta |
| gridTransportadora.nrnTrc | String | Registro nacional de transportadores rodoviários de carga - RNTRC |
| gridTransportadora.ideExt | String | |
| gridTransportadora.tipOpe | Integer | Tipo de Operação (1 = Inclusão, 2 = Alteração) |
| gridTransportadora.codHas | String | String(50) - Código da hash da requisição |
| gridTransportadora.cEP | Set | |
| gridTransportadora.cEP.endTra | String | Endereço da transportadora |
| gridTransportadora.cEP.cplEnd | String | Complemento do endereço da transportadora (sala, andar, etc.) |
| gridTransportadora.cEP.cepTra | Integer | Cep da transportadora |
| gridTransportadora.cEP.baiTra | String | Bairro da transportadora |
| gridTransportadora.cEP.cidTra | String | Cidade da transportadora |
| gridTransportadora.cEP.sigUfs | String | Sigla do estado da transportadora |
| gridTransportadora.cEP.codPai | String | Código do país da transportadora |
| gridTransportadora.cEP.nenTra | String | Número do endereço da transportadora |
| gridTransportadora.viaTransporte | Set | |
| gridTransportadora.viaTransporte.codVia | String | Código da via de transportes |
| gridTransportadora.viaTransporte.desVia | String | Nome da via de transportes |
| gridTransportadora.viaTransporte.abrVia | String | Abreviatura da via de transportes |
| sistemaIntegracao | String | String(15) - Sigla do Sistema de Integração |
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:GravarTransportadoraResponse>
<result>
<tipoRetorno>Integer</tipoRetorno>
<gridRetornoTransportadora>
<codEmp>String</codEmp>
<codFil>String</codFil>
<codTra>String</codTra>
<ideExt>String</ideExt>
<retorno>String</retorno>
</gridRetornoTransportadora>
<gridErros>
<codEmp>String</codEmp>
<codFil>String</codFil>
<codTra>String</codTra>
<ideExt>String</ideExt>
<msgErr>String</msgErr>
</gridErros>
<mensagemRetorno>String</mensagemRetorno>
<erroExecucao>String</erroExecucao>
</result>
</ser:GravarTransportadoraResponse>
</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" |
| tipoRetorno | Integer | (Obrigatório) - Number(001) - Tipo de Retorno de Processamento - Lista: 1 = Processado, 2 = Erro na Solicitação |
| gridRetornoTransportadora | Set | (Opcional) - String(030) - Identificação externa do cliente. Enviado apenas quando é fornecida a identificação externa na mensagem de requisição do serviço. |
| gridRetornoTransportadora.codEmp | String | Código da Empresa da requisição |
| gridRetornoTransportadora.codFil | String | Código da Filial da requisição |
| gridRetornoTransportadora.codTra | String | (Obrigatório) - Number(009) - Código do fornecedor. Restrição: Somente será retornado, se estiver configurado como cliente igual a fornecedor |
| gridRetornoTransportadora.ideExt | String | (Obrigatório) - String(030) - Retorna o valor do elemento IdeExt já enviado na requisição. |
| gridRetornoTransportadora.retorno | String | (Obrigatório) - String(100) - Retorno do processamento |
| gridErros | Set | (Opcional) - Lista dos erro |
| gridErros.codEmp | String | |
| gridErros.codFil | String | |
| gridErros.codTra | String | |
| gridErros.ideExt | String | |
| gridErros.msgErr | String | Erros |
| mensagemRetorno | String | (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento |
English
Español
