Web service com.senior.g5.co.mcm.ven.frete

Este web service é utilizado na solução de integração do ERP (Gestão Empresarial | ERP) com o Gestão de Fretes.

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_mcm_ven_frete?wsdl
• Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_mcm_ven_frete?wsdl
• Agendado: http://example.com/g5-senior-services/sapiens_Schedulecom_senior_g5_co_mcm_ven_frete?wsdl

Porta(s)

• ExportarDadosCalculoFrete
• ExportarNotaFiscal
• ExportarPedidoCancelado
• ImportarDadosCalculoFrete
• TrocarTransportadora

ExportarDadosCalculoFrete

Para exportação dos dados para integração com o TMS Embarcador dos pedidos e notas fiscais eletrônicas de venda que possuem pendência no processo "TMS - Dados de cálculo do frete".

Necessita autenticação: Sim.

Situação da versão: Atual.

Versão: 1.

Classe do sistema ERP que implementa a porta do web service: TSrExpDadosCalculoFrete.

Requisição:

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ExportarDadosCalculoFrete>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <CodEmp>Integer</CodEmp>
        <CodFil>Integer</CodFil>
        <SigInt>String</SigInt>
      </parameters>
    </ser:ExportarDadosCalculoFrete>
  </soapenv:Body>
</soapenv:Envelope>

```

Parâmetros da requisição:

Resposta:

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ExportarDadosCalculoFreteResponse>
      <result>
        <LinhaDados>
          <SeqInt>Integer</SeqInt>
          <CodEmp>Integer</CodEmp>
          <CodFil>Integer</CodFil>
          <CodCli>Integer</CodCli>
          <TmsPed>Integer</TmsPed>
          <VlrLiq>Double</VlrLiq>
          <PesRea>Double</PesRea>
          <PesCub>Double</PesCub>
          <QtdVol>Integer</QtdVol>
          <CodTra>Integer</CodTra>
          <TipEnt>Integer</TipEnt>
          <CifFob>String</CifFob>
          <NomCli>String</NomCli>
          <CgcCpf>String</CgcCpf>
          <NumRge>String</NumRge>
          <InsEst>String</InsEst>
          <FonEnt>String</FonEnt>
          <CelEnt>String</CelEnt>
          <EmaEnt>String</EmaEnt>
          <CepEnt>Integer</CepEnt>
          <EndEnt>String</EndEnt>
          <NenEnt>String</NenEnt>
          <BaiEnt>String</BaiEnt>
          <CidEnt>String</CidEnt>
          <CodRai>Integer</CodRai>
          <EstEnt>String</EstEnt>
          <ObsEnt>String</ObsEnt>
          <TriIcm>String</TriIcm>
        </LinhaDados>
        <FinalizaramRegistros>String</FinalizaramRegistros>
        <TipoRetorno>Integer</TipoRetorno>
        <MensagemRetorno>String</MensagemRetorno>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ExportarDadosCalculoFreteResponse>
  </soapenv:Body>
</soapenv:Envelope>

```

Atributos da resposta:

ExportarNotaFiscal

Para exportação dos dados de uma NF-e logo após sua autorização indicando ao TMS Embarcador que o pedido foi faturado. Deve exportar as notas fiscais eletrônicas autorizadas quando o processo "TMS - Faturamento NF saída" estiver habilitado para ser integrado.

Necessita autenticação: Sim.

Situação da versão: Atual.

Versão: 1.

Classe do sistema ERP que implementa a porta do web service: TSrExtNotaFiscal.

Requisição:

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ExportarNotaFiscal>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <CodEmp>Integer</CodEmp>
        <CodFil>Integer</CodFil>
        <SigInt>String</SigInt>
      </parameters>
    </ser:ExportarNotaFiscal>
  </soapenv:Body>
</soapenv:Envelope>

```

Parâmetros da requisição:

Resposta:

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ExportarNotaFiscalResponse>
      <result>
        <TipoRetorno>Integer</TipoRetorno>
        <MensagemRetorno>String</MensagemRetorno>
        <LinhaDados>
          <SeqInt>String</SeqInt>
          <CodEmp>Integer</CodEmp>
          <CodFil>Integer</CodFil>
          <CodCli>Integer</CodCli>
          <TmsPed>String</TmsPed>
          <NumNfv>Integer</NumNfv>
          <SerNfv>String</SerNfv>
          <DatEmi>String</DatEmi>
          <ChvAcs>String</ChvAcs>
          <QtdVol>Integer</QtdVol>
          <CFOP>String</CFOP>
        </LinhaDados>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ExportarNotaFiscalResponse>
  </soapenv:Body>
</soapenv:Envelope>

Atributos da resposta:

ExportarPedidoCancelado

Para exportação do cancelamento de um pedido ou de uma NF-e de venda ao sistema TMS Embarcador para que o TMS Embarcador cancele o cálculo do frete e não acione a transportadora. Deve exportar o cancelamento quando o processo "TMS - Cancelamento de pedido" estiver habilitado para ser integrado.

Necessita autenticação: Sim.

Situação da versão: Atual

Versão: 1.

Classe do sistema ERP que implementa a porta do web service: TSrExportarPedidoCancelado.

Requisição:

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ExportarPedidoCancelado>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <CodEmp>Integer</CodEmp>
        <CodFil>Integer</CodFil>
        <SigInt>String</SigInt>
        <QuantidadeRegistros>Integer</QuantidadeRegistros>
      </parameters>
    </ser:ExportarPedidoCancelado>
  </soapenv:Body>
</soapenv:Envelope>

```

Parâmetros da requisição:

Resposta:

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ExportarPedidoCanceladoResponse>
      <result>
        <LinhaDados>
          <SeqInt>String</SeqInt>
          <CodEmp>Integer</CodEmp>
          <CodCli>Integer</CodCli>
          <MotCan>String</MotCan>
          <CodFil>Integer</CodFil>
          <TmsPed>String</TmsPed>
        </LinhaDados>
        <TipoRetorno>Integer</TipoRetorno>
        <MensagemRetorno>String</MensagemRetorno>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ExportarPedidoCanceladoResponse>
  </soapenv:Body>
</soapenv:Envelope>

```

Atributos da resposta:

ImportarDadosCalculoFrete

Para importação dos dados de um frete calculado pelo Gestão de Fretes para um pedido ou um NF-e de venda. Para que o frete calculado seja importado o processo de "TMS - Dados de cálculo do frete" deve estar habilitado.

Necessita autenticação: Sim.

Situação da versão: Atual.

Versão: 1.

Classe do sistema ERP que implementa a porta do web service: TSrImpFreteCalculado.

Requisição:

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ImportarDadosCalculoFrete>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <LinhaDados>
          <CodEmp>Integer</CodEmp>
          <CodFil>Integer</CodFil>
          <CodCli>Integer</CodCli>
          <TmsPed>String</TmsPed>
          <NumTra>Integer</NumTra>
          <TipEnt>Integer</TipEnt>
          <QtdDia>Integer</QtdDia>
          <ValFre>Double</ValFre>
          <PesPed>Double</PesPed>
        </LinhaDados>
      </parameters>
    </ser:ImportarDadosCalculoFrete>
  </soapenv:Body>
</soapenv:Envelope>

```

Parâmetros da requisição:

Resposta:

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ImportarDadosCalculoFreteResponse>
      <result>
        <TipoRetorno>Integer</TipoRetorno>
        <MensagemRetorno>String</MensagemRetorno>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ImportarDadosCalculoFreteResponse>
  </soapenv:Body>
</soapenv:Envelope>

```

Atributos da resposta:

TrocarTransportadora

Para importação dos dados enviados pelo TMS Embarcador sobre a alteração de transportadora de um pedido ou NF-e de venda.

Necessita autenticação: Sim.

Situação da versão: Atual.

Versão: 1.

Classe do sistema ERP que implementa a porta do web service: TSrTrocaTransportadora.

Requisição:

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:TrocarTransportadora>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <LinhaDados>
          <CodEmp>Integer</CodEmp>
          <CodFil>Integer</CodFil>
          <CodCli>Integer</CodCli>
          <TmsPed>String</TmsPed>
          <CodTra>Integer</CodTra>
          <QtdDia>Integer</QtdDia>
          <VlrFre>Double</VlrFre>
          <IdOrig>String</IdOrig>
        </LinhaDados>
      </parameters>
    </ser:TrocarTransportadora>
  </soapenv:Body>
</soapenv:Envelope>

```

Parâmetros da requisição:

Resposta:

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:TrocarTransportadoraResponse>
      <result>
        <TipoRetorno>Integer</TipoRetorno>
        <Retorno>
          <TmsPed>String</TmsPed>
          <TipRet>Integer</TipRet>
          <MsgRet>String</MsgRet>
          <IdOrig>String</IdOrig>
        </Retorno>
        <MensagemRetorno>String</MensagemRetorno>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:TrocarTransportadoraResponse>
  </soapenv:Body>
</soapenv:Envelope>

```

Atributos da resposta: