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.
- 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
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.
- 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
- 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_mpr_cha_apontamentoopmega?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_mpr_cha_apontamentoopmega?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Schedulecom_senior_g5_co_mpr_cha_apontamentoopmega?wsdl
Porta(s)
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 somente ordens de produção onde o produto não é controlado por lote ou 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
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:
- Apontamento de início e fim de uma operação em momentos diferentes:
- 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
- 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
- Apontamento de início e fim de uma operação no mesmo momento:
- 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.
<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>
<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>
<defeitosFabricacao>
<tipQua>String</tipQua>
<codDft>String</codDft>
<qtdDft>Double</qtdDft>
</defeitosFabricacao>
</ordemProducao>
</parameters>
</ser:Gravar>
</soapenv:Body>
</soapenv:Envelope>
| 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 |
| 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 |
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>
| 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 |
|
English
Español
English
Español


