English
Español
Integrações com outros sistemas > Web services > Web services disponíveis no Gestão Empresarial > Com.senior.g5.co.mcm.est.solicitacaocompra
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.
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_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
buscarPendentes_3
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
Requisição:
<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>
Parâmetros da requisição:
| 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. |
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: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>
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" |
| 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 |
aprovar
Suprimentos - Gestão de Compras - Solicitação de Compra - Aprovar
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: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>
Parâmetros da requisição:
| 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 |
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: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>
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" |
| 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 |
reprovar
Suprimentos - Gestão de Compras - Solicitação de Compra - Reprovar
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: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>
Parâmetros da requisição:
| 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 |
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: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>
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" |
| 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 |
English
Español
