PORTAL DE DOCUMENTAÇÃO
Gestão Empresarial | ERP - versão 5.10.3 (XTended)
Devido à descontinuação da versão 5.10.3, que ocorrerá em 30/09/2025, informamos que este manual não receberá atualizações a partir desta data. Para mais informações sobre a evolução do Gestão Empresarial | ERP, acesse a documentação sobre a PCVV - Política do Ciclo de Vida das Versões.

Informamos que as funcionalidades da Reforma Tributária estão disponíveis apenas a partir da versão 5.10.4 do Gestão Empresarial.
Acesse o Portal de Exigências Legais da Senior para saber como preparar o seu negócio!

Integrações com outros sistemas > Web services > Web services disponíveis no Gestão Empresarial > Com.senior.g5.co.mcm.ven.entregas

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.

ClosedCampos 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
ClosedExemplo:

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.

ClosedCampos 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
ClosedExemplo:
  • 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

Portas

ClosedImportarEntregaMercadoria

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

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

ClosedRequisição: 
<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>
ClosedParâmetros da requisição:
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.
ClosedResposta:

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>
ClosedAtributos 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"
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
ClosedExportarEntregaMercadoria

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

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

ClosedRequisição: 
<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>
ClosedParâmetros da requisição:
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
ClosedResposta:

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>
ClosedAtributos 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"
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

Este artigo ajudou você?

Base de Conhecimento

Portal de Exigências Legais

Documentação em outros idiomas:

English

Español

Senior Store

Universidade Corporativa

Fórum de Produtos

Trabalhe conosco

Blog

Todos os direitos de cópias reservadas para Senior Sistemas S.A.

A reprodução não autorizada desta publicação, no todo ou em parte, constitui violação dos direitos autorais (Lei 9.610/98).

Ver site completo