English
Español
Integrações com outros sistemas > Web services > Web services disponíveis no Gestão Empresarial > Com.senior.g5.co.sgq.execucaoinspecao
Web service Com.senior.g5.co.sgq.execucaoinspecao
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.
Campos 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
Exemplo:
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.
Campos 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
Exemplo:
- 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_sgq_execucaoinspecao?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_sgq_execucaoinspecao?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Scheduledcom_senior_g5_co_sgq_execucaoinspecao?wsdl
A utilização do web service Com.senior.g5.co.sgq.execucaoinspecao permite que seja feita uma execução de inspeção, como ocorre na tela Registro de execução de Plano de Inspeções (F102CEI). Os passos para realizar essa execução de inspeção por meio do web service são:
- Executar a porta Execucao, com a operação igual a "I - Inserção". Neste momento, são geradas as informações da execução conforme consta no plano de inspeções, gerando os registros de inspeção (tabela SGQ - INSPEÇÕES - EXECUÇÃO (E102EIN)) e de verificações (tabela SGQ - EXECUÇÃO DE VERIFICAÇÕES (E102EIV)). Ao final, será retornada uma mensagem com o número da execução de inspeção gerada, que deve ser usado nas demais portas, a fim de atualizar as informações das verificações e inspeções.
- Em seguida, executar a porta Verificações, para informar os valores e a situação das verificações de cada inspeção.
- Posteriormente, executar a porta Defeito, caso houver, para registrar os defeitos que ocorreram em cada inspeção.
- Depois, executar a porta Inspeção, para que, em cada sequência de inspeção, seja possível atribuir uma nota, um documento, bem como ajustar a sua situação para "2 - Conforme".
- Por fim, se a execução de inspeção estiver de acordo, executar novamente a porta Execucao, com a operação igual a "A - Alteração", informando o número da execução e a sua situação para "2 - Conforme".
Portas
Execucao
Qualidade - Gestão de Qualidade - Registro de execução de planos de inspeção - Execução.
Necessita autenticação: sim.
Situação de versão: atual.
Versão: 1.
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:Execucao>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<operacao>String</operação>
<fasIns>String</fasIns>
<numEpi>Integer</numEpi>
<codPin>String</codPin>
<sitEpi>Integer</sitEpi>
<codDoc>String</codDoc>
<obsEpi>String</obsEpi>
<obsCpl>String</obsCpl>
<datExe>String</datExe>
<horExe>String</horExe>
<qtdInp>Double</qtdInp>
<qtdRec>Double</qtdRec>
<codPro>String</codPro>
<codDer>String</codDer>
<codRot>String</codRot>
<codEtg>Integer</codEtg>
<seqRot>Integer</seqRot>
<codOri>String</codOri>
<numOrp>Integer</numOrp>
<seqEoq>Integer</seqEoq>
<uniMed>String</uniMed>
<uniNfc>String</uniNfc>
<codFor>Integer</codFor>
<codSer>String</codSer>
<codFil>Integer</codFil>
<numNfc>Integer</numNfc>
<codSnf>String</codSnf>
<seqIpc>Integer</seqIpc>
<seqIsc>Integer</seqIsc>
<qtdEst>Double</qtdEst>
<notMin>Double</notMin>
<codLot>String</codLot>
<numSep>String</numSep>
</parameters>
</ser:Execucao>
</soapenv:Body>
</soapenv:Envelope>
Parâmetros da requisição:
| Nome | Tipo | Descrição |
|---|---|---|
| operacao | String | (Obrigatório) - String(001) - Operação que será realizada - Lista: I = Inserção, A = Alteração, E = Exclusão |
| fasIns | String | (Opcional) - String(003) - Fase de inspeção - Lista: LIV = Livre, PRD = Produção, REC = Recebimento - Condição: Obrigatório na inclusão |
| numEpi | Integer | (Opcional) - Number(009) - Número da execução - Condição: Obrigatório na Alteração e Exclusão |
| codPin | String | (Opcional) - String(20) - Código do plano de inspeção - Condição: Obrigatório na inclusão |
| sitEpi | Integer | (Opcional) - Number(001) - Situação do plano de inspeção - Lista: 1 = Em aberto, 2 = Conforme, 3 = Não Conforme, 4 = Não conforme com desvio, 5 = Cancelada |
| codDoc | String | (Opcional) - String(020) - Código do documento |
| obsEpi | String | (Opcional) - String(1999) - Observação da inspeção |
| obsCpl | String | (Opcional) - String(250) - Observação complementar |
| datExe | DateTime | (Opcional) - Date(DD/MM/AAAA) - Data de execução |
| horExe | Time | (Opcional) - Time(HH:MM) - Hora da execução |
| qtdInp | Double | (Opcional) - Number(014,5) - Quantidade inspecionada |
| qtdRec | Double | (Opcional) - Number(014,5) - Quantidade recebida |
| codPro | String | (Opcional) - String(014) - Código do produto - Condição: Obrigatório quando for a inserção na fase de produção ou recebimento |
| codDer | String | (Opcional) - String(007) - Derivação do produto |
| codRot | String | (Opcional) - String(014) - Roteiro de produção do produto - Condição: Obrigatório quando for inserção na fase de produção |
| codEtg | Integer | (Opcional) - Number(004) - Estágio - Condição: Obrigatório quando for inserção na fase de produção |
| seqRot | Integer | (Opcional) - Number(004) - Sequência roteiro - Condição: Obrigatório quando for inserido código do roteiro |
| codOri | String | (Opcional) - String(003) - Origem do produto - Obrigatório quando for inserção na fase de produção |
| numOrp | Integer | (Opcional) - Number(009) - Número da O.P. - Condição: Obrigatório quando for inserção na fase de produção |
| seqEoq | Integer | (Opcional) - Number(005) - Sequência do movimento - Condição: Obrigatório quando for uma inserção na fase de produção |
| uniMed | String | (Opcional) - String(003) - Unidade de medida - Condição: Obrigatório quando for inserção na fase de recebimento |
| uniNfc | String | (Opcional) - String(003) - Unidade da nota fiscal - Condição: obrigatório quando for inserção na fase de recebimento |
| codFor | Integer | (Opcional) - Number(009) - Código do fornecedor - Condição: Obrigatório quando for inserção na fase de recebimento |
| codSer | String | (Opcional) - String(014) - Código do serviço - Condição: Obrigatório quando for inserção na fase de recebimento e não tiver sido informado produto |
| codFil | Integer | (Opcional) - Number(004) - Còdigo da Filial - Condição: Obrigatório na inserção quando a fase for recebimento |
| numNfc | Integer | (Opcional) - Number(009) - Número da nota fiscal - Condição: Obrigatório na inserção quando a fase for recebimento |
| codSnf | String | (Opcional) - String(003) - Série da nota fiscal - Condição: Obrigatório quando for inserção e a fase for recebimento |
| seqIpc | Integer | (Opcional) - Number(003) - Sequência do item de produto da nota - Condição: Obrigatório quando for inserção e a fase for recebimento e teve produto informado |
| seqIsc | Integer | (Opcional) - Number(003) - Sequência do item de serviço da nota - Condição: Obrigatório quando for inserção e a fase for recebimento e teve serviço informado |
| qtdEst | Double | (Opcional) - Number(014,5) - Quantidade em estoque |
| notMin | Double | (Opcional) - Number(005,2) - Nota mínima para aprovação |
| codLot | String | (Opcional) - String(050) - Código do lote - Condição: É obrigatório quando o tipo de inspeção for detalhada, houver mais de um lote para o mesmo item da nota fiscal e a fase for de recebimento |
| numSep | String | (Opcional) - String(050) - Número de série - Condição: É obrigatório quando o tipo de inspeção for detalhada, houver mais de uma série para o mesmo item da nota fiscal e a fase for de recebimento |
Resposta:
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:ExecucaoResponse>
<result>
<msgRet>String</msgRet>
<erroExecucao>String</erroExecucao>
</result>
</ser:ExecucaoResponse>
</soapenv:Body>
</soapenv:Envelope>
Atributos 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" |
| msgRet | String | (Opcional) - String(500) - Mensagem de sucesso ou erro gerada após a execução do web service |
Inspecao
Qualidade - Gestão de Qualidade - Registro de execução de planos de inspeção - Inspeção
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 1
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:Inspecao>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<numEpi>Integer</numEpi>
<seqEin>Integer</seqEin>
<qtdInp>Double</qtdInp>
<notEin>Double</notEin>
<sitEin>Integer</sitEin>
<codDoc>String</codDoc>
<tipInp>String</tipInp>
</parameters>
</ser:Inspecao>
</soapenv:Body>
</soapenv:Envelope>
Parâmetros da requisição:
| Nome | Tipo | Descrição |
|---|---|---|
| numEpi | Integer | (Obrigatório) - Number(009) - Número da execução. |
| seqEin | Integer | (Obrigatório) - Number(006) - Sequência da inspeção. |
| qtdInp | Double | (Opcional) - Number(014,5) - Quantidade inspecionada. |
| notEin | Double | (Opcional) - Number(005,2) - Nota da inspeção. |
| sitEin | Integer | (Opcional) - Number(001) - Situação da inspeção - Lista: 1 = Em aberto, 2 = Conforme, 3 = Não conforme, 4 = Não conforme com desvio, 5 = Cancelada. |
| codDoc | String | (Opcional) - String(020) - Código do documento. |
| tipInp | String | (Opcional) - String(001) - Tipo de inspeção - Lista: I = Interna, E = Externa. |
Resposta:
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:InspecaoResponse>
<result>
<msgRet>String</msgRet>
<erroExecucao>String</erroExecucao>
</result>
</ser:InspecaoResponse>
</soapenv:Body>
</soapenv:Envelope>
Atributos 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" |
| msgRet | String | (Opcional) - String(500) - Mensagem de sucesso ou erro gerada após a execução do webservice. |
Verificacao
Qualidade - Gestão de Qualidade - Registro de execução de planos de inspeção - Verificação
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 1
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:Verificacao>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<numEpi>Integer</numEpi>
<seqEin>Integer</seqEin>
<seqEiv>Integer</seqEiv>
<vlrVer>Double</vlrVer>
<vlrMin>Double</vlrMin>
<vlrMax>Double</vlrMax>
<sitAva>String</sitAva>
<obsVer>String</obsVer>
<codEqp>String</codEqp>
<notEiv>Double</notEiv>
<qtdInp>Double</qtdInp>
</parameters>
</ser:Verificacao>
</soapenv:Body>
</soapenv:Envelope>
Parâmetros da requisição:
| Nome | Tipo | Descrição |
|---|---|---|
| numEpi | Integer | (Obrigatório) - Number(009) - Número da execução. |
| seqEin | Integer | (Obrigatório) - Number(006) - Sequência da inspeção. |
| seqEiv | Integer | (Obrigatório) - Number(004) - Sequência da verificação. |
| vlrVer | Double | (Opcional) - Number(014,5) - Valor da verificação. |
| vlrMin | Double | (Opcional) - Number(014,5) - Valor mínimo. |
| vlrMax | Double | (Opcional) - Number(014,5) - Valor máximo. |
| sitAva | String | (Opcional) - String(001) - Situação verificação - Lista: A = Aprovado, R = Reprovado, N = Não analisado, I = Ignorado. |
| obsVer | String | (Opcional) - String(1999) - Observação da verificação. |
| codEqp | String | (Opcional) - String(020) - Código do equipamento. |
| notEiv | Double | (Opcional) - Number(005,2) - Nota da verificação. |
| qtdInp | Double | (Opcional) - Number(014,5) - Quantidade verificada. |
Resposta:
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:VerificacaoResponse>
<result>
<msgRet>String</msgRet>
<erroExecucao>String</erroExecucao>
</result>
</ser:VerificacaoResponse>
</soapenv:Body>
</soapenv:Envelope>
Atributos 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" |
| msgRet | String | (Opcional) - String(500) - Mensagem de sucesso ou erro gerada após a execução do web service. |
Defeito
Qualidade - Gestão de Qualidade - Registro de execução de planos de inspeção - Defeito
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 1
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:Defeito>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<operacao>String</operação>
<numEpi>Integer</numEpi>
<seqEin>Integer</seqEin>
<seqDei>Integer</seqDei>
<codDft>String</codDft>
<qtdDft>Integer</qtdDft>
<tipDft>String</tipDft>
<obsDei>String</obsDei>
</parameters>
</ser:Defeito>
</soapenv:Body>
</soapenv:Envelope>
Parâmetros da requisição:
| Nome | Tipo | Descrição |
|---|---|---|
| operacao | String | (Obrigatório) - String(001) - Operação que será realizada - Lista: I = Inserção, A = Alteração, E = Exclusão. |
| numEpi | Integer | (Opcional) - Number(009) - Número da execução. Condição: Obrigatório na alteração e execlusão. |
| seqEin | Integer | (Opcional) - Number(006) - Sequência da inspeção - Condição: Obrigatório na alteração e exclusão. |
| seqDei | Integer | (Opcional) - Number(004) - Sequência do defeito - Condição: Obrigatório na alteração e exclusão. |
| codDft | String | (Opcional) - String(004) - Código do defeito - Condição: Obrigatório na inclusão. |
| qtdDft | Integer | (Opcional) - Number(014,5) - Quantidade com defeito. |
| tipDft | String | (Opcional) - String(001) - Tipo do defeito - Lista: C = Crítico, G = Grave, T = Tolerável. |
| obsDei | String | (Opcional) - String(1999) - Observação do defeito. |
Resposta:
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:DefeitoResponse>
<result>
<msgRet>String</msgRet>
<erroExecucao>String</erroExecucao>
</result>
</ser:DefeitoResponse>
</soapenv:Body>
</soapenv:Envelope>
Atributos 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" |
| msgRet | String | (Opcional) - String(500) - Mensagem de sucesso ou erro gerada após a execução do webservice. |
English
Español
