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.
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 PME | GO UP, 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.cpr.aprovarcotacoes

Web service Com.senior.g5.co.mcm.cpr.aprovarcotacoes

Importante

Para utilizar o web service é necessário configurar a aprovação multinível para cotações, caso contrário será apresentada a mensagem Não foi possível realizar a operação de aprovação na sequência X da cotação X, empresa X.

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

Porta

ClosedAprovarCotacoes

Suprimentos - Gestão de Compras - Cotações de Preços - Aprovação Multinível

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:AprovarCotacoes>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <gridCotacoes>
          <aprCot>String</aprCot>
          <codEmp>String</codEmp>
          <numCot>String</numCot>
          <seqCot>String</seqCot>
          <codUsu>String</codUsu>
          <codMot>Integer</codMot>
          <obsMot>String</obsMot>
          <datPrv>String</datPrv>
        </gridCotacoes>
      </parameters>
    </ser:AprovarCotacoes>
  </soapenv:Body>
</soapenv:Envelope>
ClosedParâmetros da requisição:
Nome Tipo Descrição
gridCotacoes Set Lista de operações de cotação
gridCotacoes.aprCot String (Obrigatório) - Number(001) - Indicativo da operação de aprovação da cotação.

Valores possíveis:
* 1: Aprovar;
* 2: Cancelar aprovação.
gridCotacoes.codEmp String (Obrigatório) - Number(004) - Código da empresa
gridCotacoes.numCot String (Obrigatório) - Number(009) - Número da cotação
gridCotacoes.seqCot String (Obrigatório) - Number(003) - Sequência da cotação
gridCotacoes.codUsu String (Obrigatório) - Number(010) - Código do usuário responsável pela operação
gridCotacoes.codMot Integer (Opcional) - Number(006) - Código do motivo da aprovação da cotação
gridCotacoes.obsMot String (Opcional) - String(250) - Observação do motivo da aprovação da cotação
gridCotacoes.datPrv DateTime (Opcional) - Date - Data prevista de entrega

Obs.: somente é usado quando o identificador CPR-410DATPR01 estiver ativo.
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:AprovarCotacoesResponse>
      <result>
        <gridRetorno>
          <codEmp>String</codEmp>
          <numCot>String</numCot>
          <seqCot>String</seqCot>
          <txtRet>String</txtRet>
        </gridRetorno>
        <tpResultado>String</tpResultado>
        <resultado>String</resultado>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:AprovarCotacoesResponse>
  </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"
gridRetorno Set Listagem de registros com erro
gridRetorno.codEmp String (Obrigatório) - Number(004) - Código da empresa
gridRetorno.numCot String (Obrigatório) - Number(009) - Número da cotação
gridRetorno.seqCot String (Obrigatório) - Number(003) - Sequência da cotação
gridRetorno.txtRet String (Obrigatório) - String - Mensagem de erro
tpResultado String (Obrigatório) - Number(001) - Tipo de resultado do processamento

Valores possíveis:
* 1: execução sem erros;
* 2: execução com erros.
resultado String (Obrigatório) - String - Mensagem de resultado do processamento

Valores possíveis:
* "Processado com sucesso";
* "ERRO: Ocorreram erros no processamento de alguns registros".

Obs.: no caso de erro ao processar alguns registros, os registros que tiveram sucesso são confirmados na base de dados, e os que tiveram erro têm sua mensagem de erro retornada.

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