PORTAL DE DOCUMENTAÇÃO
Gestão Empresarial PME | GO UP - versão 5.10.3 (XTended)
No conteúdo deste manual são citados Identificadores de Regras, porém, no GO UP não é possível incluir, excluir ou alterar identificadores e suas regras associadas, pois o sistema possui funções nativas devido aos processos de negócio pré-definidos.
Integrações com outros sistemas > Web services > Web services disponíveis no Gestão Empresarial > Com.senior.g5.co.int.varejo.ordemcompra

Web service Com.senior.g5.co.int.varejo.ordemcompra

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

ClosedConsultarGeral

Integrações - Varejo - Suprimentos - Gestão de Compras - Ordem de Compra

Necessita autenticação: Sim

Situação de versão: Atual

Versão: 1

ClosedRequisição: 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ConsultarGeral>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <codEmp>Integer</codEmp>
        <produto>
          <codPro>String</codPro>
        </produto>
        <codFil>Integer</codFil>
        <numeroOrdem>
          <numOcp>Integer</numOcp>
        </numeroOrdem>
        <sigInt>String</sigInt>
        <situacaoOrdem>
          <sitOcp>Integer</sitOcp>
        </situacaoOrdem>
        <prcOcp>Integer</prcOcp>
        <situacaoItem>
          <sitIpo>Integer</sitIpo>
        </situacaoItem>
        <datEmiIni>String</datEmiIni>
        <datEmiFim>String</datEmiFim>
      </parameters>
    </ser:ConsultarGeral>
  </soapenv:Body>
</soapenv:Envelope>
ClosedParâmetros da requisição:
Nome Tipo Preenchimento Descrição
codEmp Integer Opcional Código da Empresa
produto Set Opcional Lista de produtos da ordem de compra
produto.codPro String Opcional Código do produto
codFil Integer Opcional Código da Filial
numeroOrdem Set Opcional Lista ordem de compras
numeroOrdem.numOcp Integer Opcional Número da ordem de compra
sigInt String Opcional Sigla do sistema integrado
situacaoOrdem Set Opcional Situação da ordem de compra (1 - Aberto Total, 2 - Aberto Parcial, 3 - Suspenso, 4 - Liquidado, 5 - Cancelado, 6 - Aguardando WMS, 7 - Em transmissão, 8 - Preparação Análise ou NF, 9 - Não Fechado)
situacaoOrdem.sitOcp Integer Opcional Situação da ordem de compra (1 - Aberto Total, 2 - Aberto Parcial, 3 - Suspenso, 4 - Liquidado, 5 - Cancelado, 6 - Aguardando WMS, 7 - Em transmissão, 8 - Preparação Análise ou NF, 9 - Não Fechado)
prcOcp Integer Opcional Origem da ordem de compra (0 - Todas, 1 - ERP, 2 - Retaguarda)
situacaoItem Set Opcional Lista de situações dos itens da ordem de compra
situacaoItem.sitIpo Integer Opcional Situação dos itens da ordem de compra (1 - Aberto Total, 2 - Aberto Parcial, 3 - Suspenso, 4 - Liquidado, 5 - Cancelado, 6 - Aguardando WMS, 7 - Em transmissão, 8 - Preparação Análise ou NF, 9 - Não Fechado)
datEmiIni String Opcional Data inicial da emissão da ordem de compra
datEmiFim String Opcional Data final da emissão da ordem de compra
ClosedResposta: 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:ConsultarGeralResponse>
      <result>
        <erros>
          <mensagemErro>String</mensagemErro>
        </erros>
        <tipoRetorno>Integer</tipoRetorno>
        <ordemCompra>
          <codEmp>Integer</codEmp>
          <codFil>Integer</codFil>
          <numOcp>Integer</numOcp>
          <datEmi>DateTime</datEmi>
          <sitOcp>Integer</sitOcp>
          <filPed>Integer</filPed>
          <numPed>Integer</numPed>
          <produtos>
            <codPro>String</codPro>
            <desPro>String</desPro>
            <codDer>String</codDer>
            <qtdPro>Double</qtdPro>
            <uniMed>String</uniMed>
            <sitIpo>Integer</sitIpo>
            <qtdPen>Double</qtdPen>
            <qtdOrd>Double</qtdOrd>
          </produtos>
        </ordemCompra>
        <mensagemRetorno>String</mensagemRetorno>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:ConsultarGeralResponse>
  </soapenv:Body>
</soapenv:Envelope>
ClosedAtributos da resposta:
Nome Tipo Preenchimento Descrição
erros Set Opcional Retorno de erros
erros.mensagemErro String Opcional

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 sucesso;
  • A mensagem do erro ocorrido no servidor.
mensagemRetorno String Opcional Mensagem de retorno do web service
ordemCompra Set Opcional Retorno da ordem de compra
ordemCompra.codEmp Integer Opcional Código da Empresa
ordemCompra.codFil Integer Opcional Código da Filial
ordemCompra.numOcp Integer Opcional Número da ordem de compra
ordemCompra.datEmi DateTime Opcional Data da emissão da ordem de compra
ordemCompra.sitOcp Integer Opcional Situação da ordem de compra
ordemCompra.filPed Integer Opcional Filial do pedido
ordemCompra.numPed Integer Opcional Número do pedido
produtos Set Opcional Lista de produtos da ordem de compra
produtos.codPro String Opcional Código do produto
produtos.desPro     Descrição do produto
produtos.codDer String Opcional Código da derivação do produto
produtos.qtdPro Double Opcional Quantidade do produto
produtos.uniMed String Opcional Unidade de Medida
produtos.sitIpo Integer Opcional Situação dos itens da ordem de compra (1 - Aberto Total, 2 - Aberto Parcial, 3 - Suspenso, 4 - Liquidado, 5 - Cancelado, 6 - Aguardando WMS, 7 - Em transmissão, 8 - Preparação Análise ou NF, 9 - Não Fechado)
produtos.qtdPen Double Opcional Quantidade de produtos em trânsito
produtos.qtdOrd Double Opcional Quantidade de produtos em ordem de compra
tipoRetorno Integer Opcional Tipo de retorno do web service
erroExecucao String Opcional  
ClosedGerarOrdemCompra

Integrações - Varejo - Suprimentos - Gestão de Compras - Ordem de Compra

Necessita autenticação: Sim

Situação de versão: Atual

Versão: 1

ClosedRequisição: 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:GerarOrdemCompra>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <sistemaIntegracao>String</sistemaIntegracao>
        <ordemCompra>
          <opeExe>String</opeExe>
          <codEmp>Integer</codEmp>
          <codFil>Integer</codFil>
          <numOcp>Integer</numOcp>
          <codRep>String</codRep>
          <ideExt>Integer</ideExt>
          <ocpExt>String</ocpExt>
          <itens>
            <opeExe>String</opeExe>
            <codPro>String</codPro>
            <codDer>String</codDer>
            <codDep>String</codDep>
            <qtdPed>Integer</qtdPed>
            <uniMed>String</uniMed>
          </itens>
        </ordemCompra>
      </parameters>
    </ser:GerarOrdemCompra>
  </soapenv:Body>
</soapenv:Envelope>
ClosedParâmetros da requisição:
Nome Tipo Descrição
sistemaIntegracao String (Obrigatório) - String(15) - Identificação do sistema integrado
ordemCompra Set
ordemCompra.opeExe String (Opcional) - String(001) - Operação a executar. Lista: I - Inclusão; C - Cancelar. Quando não informado, assume "I - Inclusão".
ordemCompra.codEmp Integer (Obrigatório) - Number(004) - Código da empresa.
ordemCompra.codFil Integer (Obrigatório) - Number(005) - Código da filial.
ordemCompra.numOcp Integer (Opcional) - Number(008) - Número da ordem de compra. Obrigatório quando "OpeExe" igual a "C" (Cancelar).
ordemCompra.codRep String
ordemCompra.ideExt Integer (Obrigatório) - IdeExt - Number(09) - Identificador Externo
ordemCompra.ocpExt String (Opcional) - OcpExt - srting(015) - Ordem de Compra externa.
ordemCompra.itens Set
ordemCompra.itens.opeExe String (Opcional) - String(001) - Operação a executar. Lista: I - Inclusão. Quando não informado, assume "I - Inclusão".
ordemCompra.itens.codPro String (Obrigatório) - String(014) - Código do produto.
ordemCompra.itens.codDer String (Obrigatório) - String(007) - Código da derivação.
ordemCompra.itens.codDep String (Obrigatório) - String(007) - Código do depósito de origem dos produtos.
ordemCompra.itens.qtdPed Integer (Obrigatório) - Number(009,5) - Quantidade pedida.
ordemCompra.itens.uniMed String (Obrigatório) - String(003) - Unidade de medida.
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:GerarOrdemCompraResponse>
      <result>
        <resultado>
          <numOcp>Integer</numOcp>
          <msgErr>String</msgErr>
          <ideExt>Integer</ideExt>
          <tipRet>Integer</tipRet>
          <ocpExt>String</ocpExt>
        </resultado>
        <tipoRetorno>Integer</tipoRetorno>
        <mensagemRetorno>String</mensagemRetorno>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:GerarOrdemCompraResponse>
  </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"
resultado Set
resultado.numOcp Integer (Obrigatório) - Number(008) - Número da ordem de compra gerada.
resultado.msgErr String (Obrigatório) - String(250) - Mensagem de retorno.
resultado.ideExt Integer IdeExt - Number(09) - Identificador Externo
resultado.tipRet Integer (Obrigatório) - Number(001) - Tipo de Retorno de Processamento - Lista: 1 = Processado, 2 = Erro na Solicitação
resultado.ocpExt String (Opcional) - OcpExt - srting(015) - Ordem de Compra externa.
tipoRetorno Integer (Obrigatório) - Number(001) - Tipo de Retorno de Processamento - Lista: 1 = Processado, 2 = Erro na Solicitação
mensagemRetorno String (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento

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