Web service Com.senior.g5.co.mcm.est.solicitacaocompra
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.
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
- 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
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
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.
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
- 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
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
- 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_mcm_est_solicitacaocompra?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_mcm_est_solicitacaocompra?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Scheduledcom_senior_g5_co_mcm_est_solicitacaocompra?wsdl
Portas
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
Suprimentos - Gestão de Compras - Solicitação de Compra - Solicitações Pendentes
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 2
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:buscarPendentes> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <indicePagina>Integer</indicePagina> <limitePagina>Integer</limitePagina> <CodUsu>Integer</CodUsu> </parameters> </ser:buscarPendentes> </soapenv:Body> </soapenv:Envelope>
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
Nome | Tipo | Descrição |
---|---|---|
indicePagina | Integer | (Opcional) - Number - Para informações em relação a esse campo, consulte o item Limite de página e índice de página na documentação Configurações especiais. |
limitePagina | Integer | (Opcional) - Number - Para informações em relação a esse campo, consulte o item Limite de página e índice de página na documentação Configurações especiais. |
CodUsu | Integer | (Opcional) - Number(010) - Código do usuário para ser utilizado como filtro. Se não for informado um código, será utilizado o usuário conectado no sistema. |
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
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:buscarPendentesResponse> <result> <solicitacao> <codigoSolicitante>Integer</codigoSolicitante> <nomeSolicitante>String</nomeSolicitante> <codigoEmpresa>Integer</codigoEmpresa> <nomeEmpresa>String</nomeEmpresa> <codigoFilial>Integer</codigoFilial> <nomeFilial>String</nomeFilial> <numero>Integer</numero> <sequência>Integer</sequência> <codigoCentroCusto>String</codigoCentroCusto> <abreviaturaCentroCusto>String</abreviaturaCentroCusto> <valorAproximado>Double</valorAproximado> <descricaoProdutoServico>String</descricaoProdutoServico> <quantidadeSolicitada>Double</quantidadeSolicitada> <valorUnitario>Double</valorUnitario> <observacao>String</observacao> <dataSolicitacao>String</dataSolicitacao> <unidadeMedida>String</unidadeMedida> <siglaMoeda>String</siglaMoeda> <descricaoMoeda>String</descricaoMoeda> <abrPrj>String</abrPrj> <abrFpj>String</abrFpj> </solicitacao> <codigoResultado>String</codigoResultado> <resultado>String</resultado> <erroExecucao>String</erroExecucao> </result> </ser:buscarPendentesResponse> </soapenv:Body> </soapenv:Envelope>
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
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" |
solicitacao | Set | Lista de solicitações de compra pendentes |
solicitacao.codigoSolicitante | Integer | (Obrigatório) - Number(010) - Usuário responsável pela solicitação do produto |
solicitacao.nomeSolicitante | String | (Opcional) - String(0255) - Nome do solicitante |
solicitacao.codigoEmpresa | Integer | (Obrigatório) - Number(04) - Código da empresa |
solicitacao.nomeEmpresa | String | (Obrigatório) - String(100) - Nome da empresa |
solicitacao.codigoFilial | Integer | (Obrigatório) - Number(04) - Código da filial do solicitante do movimento de estoque |
solicitacao.nomeFilial | String | (Obrigatório) - String(100) - Razão social da filial da empresa |
solicitacao.numero | Integer | (Obrigatório) - Number(09) - Número do documento da solicitação |
solicitacao.sequência | Integer | (Obrigatório) - Number(06) - Sequência do item na solicitação de compras |
solicitacao.codigoCentroCusto | String | (Opcional) - String(09) - Centro de custo responsável pela aplicação do produto |
solicitacao.abreviaturaCentroCusto | String | (Opcional) - String(020) - Abreviatura do centro de custos |
solicitacao.valorAproximado | Double | (Obrigatório) - Number(15,6) - Valor aproximado da solicitação |
solicitacao.descricaoProdutoServico | String | (Obrigatório) - String(100) - Descrição do produto ou do serviço |
solicitacao.quantidadeSolicitada | Double | (Obrigatório) - Number(014,5) - Quantidade para solicitação de compras |
solicitacao.valorUnitario | Double | (Obrigatório) - Number(015,6) - Preço da solicitação utilizado para o controle de aprovação multinível e atualização de projetos |
solicitacao.observacao | String | (Opcional) - String(250) - Observação da solicitação de compra |
solicitacao.dataSolicitacao | DateTime | (Obrigatório) - Date(000) - Data da geração da solicitação |
solicitacao.unidadeMedida | String | (Opcional) - String(03) - Unidade de medida |
solicitacao.siglaMoeda | String | (Opcional) - String(005) - Sigla da moeda |
solicitacao.descricaoMoeda | String | (Opcional) - String(030) - Descrição da moeda ou índice |
solicitacao.AbrPrj | String | String(020) - Abreviatura do projeto |
solicitacao.AbrFpj | String | String(020) - Abreviatura da fase do projeto |
codigoResultado | String | O campo tipo resultado irá retornar para:
Execução do serviço sem erros: "1" Execução do serviço com erros: "2" |
resultado | String | O campo resultado irá retornar as seguintes mensagens:
Execução do serviço sem erros: "Processado com sucesso" Execução do serviço com erros: "ERRO: " concatenando a mensagem de erro |
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
Suprimentos - Gestão de Compras - Solicitação de Compra - Aprovar
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 1
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:aprovar> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <solicitacao> <sequência>Integer</sequência> <codigoEmpresa>Integer</codigoEmpresa> <numeroSolicitacao>Integer</numeroSolicitacao> <sequênciaSolicitacao>Integer</sequênciaSolicitacao> </solicitacao> </parameters> </ser:aprovar> </soapenv:Body> </soapenv:Envelope>
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
Nome | Tipo | Descrição |
---|---|---|
solicitacao | Set | Lista de solicitação de compra para serem aprovadas |
solicitacao.sequência | Integer | (Obrigatório) - Number(009) - Número sequencial para identificar retornos |
solicitacao.codigoEmpresa | Integer | (Obrigatório) - Number(004) - Código da empresa |
solicitacao.numeroSolicitacao | Integer | (Obrigatório) - Number(009) - Número do documento da solicitação |
solicitacao.sequênciaSolicitacao | Integer | (Obrigatório) - Number(006) - Sequência do item na solicitação de compras |
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
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:aprovarResponse> <result> <retorno> <sequência>Integer</sequência> <codigoEmpresa>Integer</codigoEmpresa> <numeroSolicitacao>Integer</numeroSolicitacao> <sequênciaSolicitacao>Integer</sequênciaSolicitacao> <resultado>Integer</resultado> <mensagemErro>String</mensagemErro> </retorno> <codigoResultado>String</codigoResultado> <resultado>String</resultado> <erroExecucao>String</erroExecucao> </result> </ser:aprovarResponse> </soapenv:Body> </soapenv:Envelope>
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
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" |
retorno | Set | |
retorno.sequência | Integer | (Obrigatório) - Number(09) - Número sequencial para identificar retornos |
retorno.codigoEmpresa | Integer | (Obrigatório) - Number(004) - Código da empresa |
retorno.numeroSolicitacao | Integer | (Obrigatório) - Number(009) - Número do documento da solicitação |
retorno.sequênciaSolicitacao | Integer | (Obrigatório) - Number(006) - Sequência do item na solicitação de compras |
retorno.resultado | Integer | (Obrigatório) - Number (001) - Código de retorno:
1 - Sucesso 2 - Erro |
retorno.mensagemErro | String | (Opcional) - String - Mensagem de retorno
Resultado: 1 - Será retornada a mensagem "Processado com sucesso" (sem aspas). 2 - Será retornada a mensagem do erro. |
codigoResultado | String | O campo tipo resultado irá retornar para:
Execução do serviço sem erros: "1" Execução do serviço com erros: "2" |
resultado | String | O campo resultado irá retornar as seguintes mensagens:
Execução do serviço sem erros: "Processado com sucesso" Execução do serviço com erros: "ERRO: " concatenando a mensagem de erro |
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
Suprimentos - Gestão de Compras - Solicitação de Compra - Reprovar
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 1
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:reprovar> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <solicitacao> <sequência>Integer</sequência> <codigoEmpresa>Integer</codigoEmpresa> <numeroSolicitacao>Integer</numeroSolicitacao> <sequênciaSolicitacao>Integer</sequênciaSolicitacao> </solicitacao> </parameters> </ser:reprovar> </soapenv:Body> </soapenv:Envelope>
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
Nome | Tipo | Descrição |
---|---|---|
solicitacao | Set | Solicitação de compra que será reprovada. |
solicitacao.sequência | Integer | (Obrigatório) - Number(009) - Número sequencial para identificar retornos |
solicitacao.codigoEmpresa | Integer | (Obrigatório) - Number(004) - Código da empresa |
solicitacao.numeroSolicitacao | Integer | (Obrigatório) - Number(009) - Número do documento da solicitação |
solicitacao.sequênciaSolicitacao | Integer | (Obrigatório) - Number(006) - Sequência do item na solicitação de compras |
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
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:reprovarResponse> <result> <retorno> <sequência>Integer</sequência> <codigoEmpresa>Integer</codigoEmpresa> <numeroSolicitacao>Integer</numeroSolicitacao> <sequênciaSolicitacao>Integer</sequênciaSolicitacao> <resultado>Integer</resultado> <mensagemErro>String</mensagemErro> </retorno> <codigoResultado>String</codigoResultado> <resultado>String</resultado> <erroExecucao>String</erroExecucao> </result> </ser:reprovarResponse> </soapenv:Body> </soapenv:Envelope>
![Closed](../Skins/Default/Stylesheets/Images/transparent.gif)
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" |
retorno | Set | |
retorno.sequência | Integer | (Obrigatório) - Number(009) - Número sequencial para identificar retornos |
retorno.codigoEmpresa | Integer | (Obrigatório) - Number(004) - Código da empresa |
retorno.numeroSolicitacao | Integer | (Obrigatório) - Number(009) - Número do documento da solicitação |
retorno.sequênciaSolicitacao | Integer | (Obrigatório) - Number(006) - Sequência do item na solicitação de compras |
retorno.resultado | Integer | (Obrigatório) - Number (001) - Código de retorno:
1 - Sucesso 2 - Erro |
retorno.mensagemErro | String | (Opcional) - String - Mensagem de retorno
Resultado: 1 - Será retornada a mensagem "Processado com sucesso" (sem aspas). 2 - Será retornada a mensagem do erro. |
codigoResultado | String | O campo tipo resultado irá retornar para:
Execução do serviço sem erros: "1" Execução do serviço com erros: "2" |
resultado | String | O campo resultado irá retornar as seguintes mensagens:
Execução do serviço sem erros: "Processado com sucesso" Execução do serviço com erros: "ERRO: " concatenando a mensagem de erro |