PORTAL DE DOCUMENTAÇÃO
Gestão Empresarial PME | GO UP - versão 5.10.4 (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.mpr.cha.apontamentoopmega

Web service Com.senior.g5.co.mpr.cha.apontamentoopmega

Web service interno para integração com o aplicativo Aponta da MEGA.

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.

Acesse a listagem de Classes dos web services para consultar as portas/operações disponíveis e as classes responsáveis pela execução das rotinas de integração.

WSDL

Porta(s)

ClosedGravar

Apontar ordens de produção (MEGA).

  • Permite apontar somente ordens de produção que têm um produto.
  • Permite apontar somente ordens de produção com a situação “L – Liberada” ou “A – Andamento”.
  • Permite informar somente a quantidade realizada de primeira qualidade e/ou quantidade de refugo.
  • Permite apontar ordens de produção onde o produto tem controle por lote, sendo que para cada lote diferente é necessário realizar um novo apontamento.
  • Não permite apontar produto que tem controle de série.

Nota

  • O operador informado deve estar vinculado a um turno.
  • Ao informar a quantidade de refugo, será utilizado o código do produto de refugo que consta no cadastro de produto para apontar esta quantidade no estoque.
  • Para fazer um apontamento de produção, o parâmetro IndPrd deve ter o valor “S - Sim”.
  • Para fazer um apontamento de parada, o parâmetro IndPrd deve ter o valor “N - Não”.
  • Para forçar a finalização de uma operação, o parâmetro ForFim deve ter o valor “S - Sim” no apontamento de fim. Caso seja a última operação do estágio ou O.P., a situação vai ficar como finalizada, mesmo que a quantidade total apontada (realizada + refugo) seja menor que a quantidade prevista.
  • A partir da versão 2 (Gravar_2), é permitido informar os motivos de defeito da quantidade refugada, através da lista de defeitos de fabricação da ordem de produção.
  • Caso ocorra uma crítica em um dos apontamentos da lista, os demais apontamentos da lista não são processados. Somente grava os apontamentos, se todos os apontamentos da lista são realizados com sucesso.

Características do apontamento de produção

Um apontamento de produção é composto pelo movimento de início ao informar a data de início e pelo movimento de fim ao informar a data de fim. Assim, é possível fazer o apontamento de duas maneiras:

  1. Apontamento de início e fim de uma operação em momentos diferentes:
    1. Primeiro faça o apontamento de início: informe os parâmetros data e hora de início e não informe a data de fim do apontamento
    2. Depois faça o apontamento de fim: não informe os parâmetros data e hora de início e informe a data e hora de fim do apontamento
  2. Apontamento de início e fim de uma operação no mesmo momento:
    1. Informe os parâmetros data e hora de início e também a data e hora de fim do apontamento

Validações

  • A mensagem "Necessário informar a data de início do apontamento da OP, estágio, sequência" ocorre ao fazer um apontamento de fim sem ter feito o apontamento de início
  • A mensagem "Informe somente a data fim do apontamento, pois já existe o movimento com data de início para este apontamento da OP, estágio, sequência" ocorre ao fazer um apontamento com data de início, mas o apontamento de início já foi feito anteriormente

Necessita autenticação: sim.

Versão atual: 2.

ClosedRequisição: 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
  <soapenv:Body>
    <ser:Gravar>
      <user>String</user>
      <password>String</password>
      <encryption>Integer</encryption>
      <parameters>
        <token>String</token>
        <ordemProducao>
          <codEmp>Integer</codEmp>
          <codOri>String</codOri>
          <numOrp>Integer</numOrp>
          <codEtg>Integer</codEtg>
          <seqRot>Integer</seqRot>
          <numCad>Integer</numCad>
          <codMtv>String</codMtv>
          <codCre>String</codCre>
          <datIni>String</datIni>
          <horIni>String</horIni>
          <datFim>String</datFim>
          <horFim>String</horFim>
          <qtdRel>Double</qtdRel>
          <qtdRfg>Double</qtdRfg>
          <indPrd>String</indPrd>
          <forFim>String</forFim>
          <codLot>String</codLot>
          <defeitosFabricacao>
            <tipQua>String</tipQua>
            <codDft>String</codDft>
            <qtdDft>Double</qtdDft>
          </defeitosFabricacao>
        </ordemProducao>
      </parameters>
    </ser:Gravar>
  </soapenv:Body>
</soapenv:Envelope>
ClosedParâmetros da requisição:
Nome Preenchimento Tipo Ajuda
ordemProducao Opcional Set Lista das ordens de produção
ordemProducao.codEmp Opcional Integer Number(004) - Código da empresa
ordemProducao.codOri Opcional String String(003) - Código da origem
ordemProducao.numOrp Opcional Integer Number(009) - Número da ordem de produção
ordemProducao.codEtg Opcional Integer Number(004) - Código do estágio de produção
ordemProducao.seqRot Opcional Integer Number(004) - Sequência da operação
ordemProducao.numCad Opcional Integer Number(009) - Código do operador
ordemProducao.codMtv Opcional String String(004) - Código do motivo de parada
ordemProducao.codCre Opcional String String(008) - Código do centro de recurso
ordemProducao.datIni Opcional String Date(DD/MM/YYYY) - Data início do apontamento
ordemProducao.horIni Opcional String Time(HH:MM:SS) - Hora início do apontamento
ordemProducao.datFim Opcional String Date(DD/MM/YYYY) - Data fim do apontamento
ordemProducao.horFim Opcional String Time(HH:MM:SS) - Hora fim do apontamento
ordemProducao.qtdRel Opcional Double Number(14,5) - Quantidade realizada
ordemProducao.qtdRfg Opcional Double Number(14,5) - Quantidade de refugo
ordemProducao.indPrd Opcional String String(001) - Indicativo se apontamento é de produção
ordemProducao.forFim Opcional String String(001) - Indicativo se irá forçar a finalização da operação
ordemProducao.codLot Opcional String String(050) - Código do lote de produção
defeitosFabricacao Opcional Set Lista de defeitos de fabricação da ordem de produção
defeitosFabricacao.tipQua Opcional String String(001) - Tipo de qualidade do defeito de fabricação (2, 3 ou R)
defeitosFabricacao.codDft Opcional String String(004) - Código do defeito de fabricação
defeitosFabricacao.qtdDft Opcional Double Number(14,5) - Quantidade do defeito de fabricação
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:GravarResponse>
      <result>
        <tipoRetorno>Integer</tipoRetorno>
        <mensagemRetorno>String</mensagemRetorno>
        <erros>
          <mensagemErro>String</mensagemErro>
        </erros>
        <erroExecucao>String</erroExecucao>
      </result>
    </ser:GravarResponse>
  </soapenv:Body>
</soapenv:Envelope>
ClosedAtributos da resposta:
Nome Preenchimento Tipo Descrição
tipoRetorno Obrigatório Integer (Obrigatório) - Number(001) - Tipo de Retorno de Processamento - Lista: 0 = Processado, -1 = Erro na Solicitação
mensagemRetorno Obrigatório String (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento
erros Opcional Set (Opcional) - Lista dos erros
erros.mensagemErro Opcional String (Opcional) - Itens da lista de erros
erroExecucao Opcional 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 sucesso
    • A mensagem do erro ocorrido no servidor
  • Só impede a gravação quando o retorno.tipRet for igual a "2"

Este artigo ajudou você?

Base de Conhecimento

Portal de Exigências Legais

Contrato de Licenciamento de Software e Prestação de Serviços

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