Web service Com.senior.g5.co.mcm.cpr.cotacoespendentes
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_cpr_cotacoespendentes?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_mcm_cpr_cotacoespendentes?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Scheduledcom_senior_g5_co_mcm_cpr_cotacoespendentes?wsdl
Porta
CotacoesPendentes_2
Suprimentos - Gestão de Compras - Cotações de Preços - Consultas
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:CotacoesPendentes_2>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<eCodEmp>Integer</eCodEmp>
<eCodFil>Integer</eCodFil>
<eCodPro>String</eCodPro>
<eCodDer>Integer</eCodDer>
<eCodSer>String</eCodSer>
<eNumCot>Integer</eNumCot>
<eCodUsu>Integer</eCodUsu>
<eOrdenacao>Integer</eOrdenacao>
<ePaginacaoDeslocamento>Integer</ePaginacaoDeslocamento>
<ePaginacaoQuantidade>Integer</ePaginacaoQuantidade>
</parameters>
</ser:CotacoesPendentes_2>
</soapenv:Body>
</soapenv:Envelope>
Parâmetros da requisição:
| Nome | Tipo | Descrição |
|---|---|---|
| eCodEmp | Integer | (Opcional) - Number(004) - Código da empresa |
| eCodFil | Integer | (Opcional) - Number(005) - Código da filial
Obs.: na versão 1 esse campo existe como filtro, porém efetivamente não faz nada (foi mantido somente por compatibilidade), já na versão 2 ele filtra pela filial da solicitação de compras associada à cotação. |
| eCodPro | String | (Opcional) - String(014) - Código do produto |
| eCodDer | Integer | (Opcional) - String(007) - Código da derivação do produto |
| eCodSer | String | (Opcional) - String(014) - Código do serviço |
| eNumCot | Integer | (Opcional) - Number(009) - Número da cotação |
| eCodUsu | Integer | (Opcional) - Number(010) - Código do usuário responsável pela aprovação |
| eOrdenacao | Integer | (Opcional) - Number(001) - Indicativo da ordenação em que as requisições serão retornadas.
Valores possíveis: * 0 (ou não informado): ordena ascendentemente por empresa, número da requisição e sequência da requisição; * 1: ordena decrescentemente por data/hora de entrada da requisição em aprovação. |
| ePaginacaoDeslocamento | Integer | (Opcional) - Number - Deslocamento que determina o índice da primeira cotação a ser retornada.
Exemplo: se o valor de deslocamento for 3, somente serão retornados dados da terceira cotação em diante. Obs. 1: o primeiro registro é considerado com deslocamento 1. Obs. 2: quando não informado ou com valor "0" ou "1", é retornado a partir do primeiro registro. Obs. 3: a contagem de cotações independe de sequência (fornecedor) ou possíveis usuários aprovadores (ou seja, só considera os campos CodEmp e NumCot). |
| ePaginacaoQuantidade | Integer | (Opcional) - Number - Quantidade máxima de registros a ser retornada.
Obs. 1: quando não informado ou com valor "0", não há limite de registros a serem retornados. Obs. 2: a contagem de cotações independe de sequência (fornecedor) ou possíveis usuários aprovadores (ou seja, só considera os campos CodEmp e NumCot). |
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:CotacoesPendentes_2Response>
<result>
<cotacoes>
<codEmp>Integer</codEmp>
<nomEmp>String</nomEmp>
<numCot>Integer</numCot>
<seqCot>Integer</seqCot>
<codFor>Integer</codFor>
<apeFor>String</apeFor>
<usuRap>Integer</usuRap>
<usuCot>Integer</usuCot>
<datCot>String</datCot>
<horCot>String</horCot>
<codPro>String</codPro>
<codDer>String</codDer>
<codSer>String</codSer>
<proSer>String</proSer>
<codFam>String</codFam>
<codAgc>String</codAgc>
<datPrv>String</datPrv>
<codPvp>String</codPvp>
<przEnt>String</przEnt>
<qtdCot>String</qtdCot>
<preCot>String</preCot>
<dscCot>String</dscCot>
<perIim>String</perIim>
<ipiCot>String</ipiCot>
<icmCot>String</icmCot>
<funCot>String</funCot>
<issCot>String</issCot>
<irfCot>String</irfCot>
<insCot>String</insCot>
<freCot>String</freCot>
<cifFob>String</cifFob>
<somFre>String</somFre>
<segCot>String</segCot>
<embCot>String</embCot>
<encCot>String</encCot>
<outCot>String</outCot>
<darCot>String</darCot>
<codCpg>String</codCpg>
<abrCpg>String</abrCpg>
<usuApr>String</usuApr>
<datApr>String</datApr>
<horApr>String</horApr>
<qtdApr>String</qtdApr>
<filOcp>String</filOcp>
<numOcp>String</numOcp>
<usuOcp>String</usuOcp>
<datOcp>String</datOcp>
<horOcp>String</horOcp>
<obsCot>String</obsCot>
<prcCot>String</prcCot>
<perFre>String</perFre>
<perSeg>String</perSeg>
<perEmb>String</perEmb>
<perEnc>String</perEnc>
<perOut>String</perOut>
<sitCot>String</sitCot>
<seqCto>String</seqCto>
<cplIte>String</cplIte>
<marFor>String</marFor>
<uniMed>String</uniMed>
<uniFor>String</uniFor>
<qtdFor>String</qtdFor>
<qtdAfo>String</qtdAfo>
<preFor>String</preFor>
<vlrCot>String</vlrCot>
<vlrPrs>String</vlrPrs>
<prePrs>String</prePrs>
<rotNap>String</rotNap>
<sitApr>String</sitApr>
<numApr>String</numApr>
<datMoe>String</datMoe>
<codMoe>String</codMoe>
<cotMoe>String</cotMoe>
<fecMoe>String</fecMoe>
<perPit>String</perPit>
<perCsl>String</perCsl>
<perCrt>String</perCrt>
<perOur>String</perOur>
<codMot>String</codMot>
<obsMot>String</obsMot>
<codTpr>String</codTpr>
<vlrDfa>String</vlrDfa>
<txtCot>String</txtCot>
<vlrDsc>String</vlrDsc>
<melCot>String</melCot>
<nivExi>String</nivExi>
<obrMot>String</obrMot>
<sigMoe>String</sigMoe>
<desMoe>String</desMoe>
</cotacoes>
<solicitacoes>
<codEmp>Integer</codEmp>
<nomEmp>String</nomEmp>
<numCot>Integer</numCot>
<numSol>Integer</numSol>
<seqSol>Integer</seqSol>
<filSol>Integer</filSol>
<nomFil>String</nomFil>
<codPro>String</codPro>
<codDer>String</codDer>
<codSer>String</codSer>
<proSer>String</proSer>
<cplPro>String</cplPro>
<uniMed>String</uniMed>
<qtdSol>Double</qtdSol>
<usuSol>Integer</usuSol>
<nomUsuSol>String</nomUsuSol>
<ccuRes>String</ccuRes>
<abrCcu>String</abrCcu>
<numPrj>Integer</numPrj>
<abrPrj>String</abrPrj>
<codFpj>Integer</codFpj>
<abrFpj>String</abrFpj>
<sigMoe>String</sigMoe>
<desMoe>String</desMoe>
</solicitacoes>
<resultado>String</resultado>
<tpResultado>String</tpResultado>
<erroExecucao>String</erroExecucao>
</result>
</ser:CotacoesPendentes_2Response>
</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" |
| cotacoes | Set | Lista de cotações pendentes
Obs.: Nesta lista são listadas as cotações, conforme filtros informados. Para cada cotação, são listadas também suas sequências (fornecedores) e os possíveis usuários aprovadores. |
| cotacoes.codEmp | Integer | (Obrigatório) - Number(004) - Empresa |
| cotacoes.nomEmp | String | (Obrigatório) - String(100) - Nome da empresa |
| cotacoes.numCot | Integer | (Obrigatório) - Number(009) - Número cotação |
| cotacoes.seqCot | Integer | (Obrigatório) - Number(003) - Sequência da cotação |
| cotacoes.codFor | Integer | (Obrigatório) - Number(009) - Fornecedor |
| cotacoes.apeFor | String | (Opcional) - String(050) - Nome fantasia do fornecedor |
| cotacoes.usuRap | Integer | (Opcional) - Number(010) - Usuário responsável por aprovar |
| cotacoes.usuCot | Integer | (Opcional) - Number(010) - Usuário responsável pela cotação |
| cotacoes.datCot | String | (Obrigatório) - Date(000) - Data da cotação |
| cotacoes.horCot | String | (Opcional) - Number(005) - Hora da cotação |
| cotacoes.codPro | String | (Opcional) - String(014) - Código do produto |
| cotacoes.codDer | String | (Opcional) - String(007) - Código da derivação |
| cotacoes.codSer | String | (Opcional) - String(014) - Código do serviço |
| cotacoes.proSer | String | (Obrigatório) - String(001) - Indicativo de produto ou serviço |
| cotacoes.codFam | String | (Opcional) - String(006) - Código da familia do produto |
| cotacoes.codAgc | String | (Opcional) - String(005) - Código de agrupamento para contas |
| cotacoes.datPrv | String | (Opcional) - Data(000) - Data da previsão de entrega |
| cotacoes.codPvp | String | (Opcional) - String(008) - Código do periodo de vendas e produção |
| cotacoes.przEnt | String | (Opcional) - Number(003) - Prazo de entrega do produto |
| cotacoes.qtdCot | String | (Obrigatório) - Number(014) - Quantidade cotada |
| cotacoes.preCot | String | (Opcional) - Number(014) - Preço cotado |
| cotacoes.dscCot | String | (Opcional) - Number(007) - Percentual de desconto |
| cotacoes.perIim | String | (Opcional) - Number(005) - Percentual de imposto de importação da cotação |
| cotacoes.ipiCot | String | (Opcional) - Number(005) - Percentual de IPI cotado |
| cotacoes.icmCot | String | (Opcional) - Number(005) - Percentual de ICMS cotado |
| cotacoes.funCot | String | (Opcional) - Number(004) - Percentual do funrural |
| cotacoes.issCot | String | (Opcional) - Number(005) - Percentual de ISS cotado |
| cotacoes.irfCot | String | (Opcional) - Number(005) - Percentual de IRRF cotado |
| cotacoes.insCot | String | (Opcional) - Number(004) - Percentual de INSS cotado |
| cotacoes.freCot | String | (Opcional) - Number(015) - Valor do frete cotado |
| cotacoes.cifFob | String | (Opcional) - String(001) - Indicativo se o frete é CIF ou FOB |
| cotacoes.somFre | String | (Opcional) - String(001) - Indicativo se o frete deve ser somado ao valor líquido da nota fiscal |
| cotacoes.segCot | String | (Opcional) - Number(015) - Valor do seguro cotado |
| cotacoes.embCot | String | (Opcional) - Number(015) - Valor das embalagens cotadas |
| cotacoes.encCot | String | (Opcional) - Number(015) - Valor dos encargos financeiros cotados |
| cotacoes.outCot | String | (Opcional) - Number(015) - Valor outras despesas cotadas |
| cotacoes.darCot | String | (Opcional) - Number(015) - Valor para arredondamento da cotação |
| cotacoes.codCpg | String | (Opcional) - String(006) - Código da condição de pagamento |
| cotacoes.abrCpg | String | (Opcional) - String(010) - Abreviatura da condição de pagamento |
| cotacoes.usuApr | String | (Opcional) - Number(010) - Usuário responsável pela aprovação da cotação |
| cotacoes.datApr | String | (Opcional) - Date(000) - Data da aprovação da cotação |
| cotacoes.horApr | String | (Opcional) - Number(005) - Hora da aprovação da cotação |
| cotacoes.qtdApr | String | (Opcional) - Number(014) - Quantidade aprovada para compra |
| cotacoes.filOcp | String | (Opcional) - Number(005) - Código da filial da ordem de compras |
| cotacoes.numOcp | String | (Opcional) - Number(008) - Número da ordem de compra |
| cotacoes.usuOcp | String | (Opcional) - Number(010) - Usuário responsável pela geração da ordem de compra |
| cotacoes.datOcp | String | (Opcional) - Date(000) - Data da geração da ordem de compra |
| cotacoes.horOcp | String | (Opcional) - Number(005) - Hora da geração da ordem de compra |
| cotacoes.obsCot | String | (Opcional) - String(250) - Observação da cotação |
| cotacoes.prcCot | String | (Opcional) - Number(001) - Procedência da cotação |
| cotacoes.perFre | String | (Opcional) - Number(005) - Percentual do frete |
| cotacoes.perSeg | String | (Opcional) - Number(005) - Percentual do seguro |
| cotacoes.perEmb | String | (Opcional) - Number(005) - Percentual de embalagens |
| cotacoes.perEnc | String | (Opcional) - Number(005) - Percentual de encargos |
| cotacoes.perOut | String | (Opcional) - Number(005) - Percentual de outras despesas |
| cotacoes.sitCot | String | (Opcional) - Number(001) - Situação da cotação |
| cotacoes.seqCto | String | (Opcional) - Number(002) - Contato cotação |
| cotacoes.cplIte | String | (Opcional) - String(250) - Complemento da descrição do produto/serviço |
| cotacoes.marFor | String | (Opcional) - String(250) - Marca do fornecedor |
| cotacoes.uniMed | String | (Opcional) - String(003) - Unidade de medida do produto |
| cotacoes.uniFor | String | (Opcional) - String(003) - Unidade de medida do fornecedor |
| cotacoes.qtdFor | String | (Opcional) - Number(014) - Quantidade cotada na unidade de medida do fornecedor |
| cotacoes.qtdAfo | String | (Opcional) - Number(014) - Quantidade aprovada na unidade de medida do fornecedor |
| cotacoes.preFor | String | (Opcional) - Number(014) - Preço unitário do produto na unidade de medida do fornecedor |
| cotacoes.vlrCot | String | (Opcional) - Number(015) - Valor da cotação |
| cotacoes.vlrPrs | String | (Opcional) - Number(015) - Valor presente da cotação |
| cotacoes.prePrs | String | (Opcional) - Number(014) - Valor unitário presente da cotação |
| cotacoes.rotNap | String | (Opcional) - Number(002) - Código da rotina para controle de aprovação |
| cotacoes.sitApr | String | (Opcional) - String(003) - Situação do controle de aprovação |
| cotacoes.numApr | String | (Opcional) - Number(010) - Número da aprovação |
| cotacoes.datMoe | String | (Opcional) - Date(000) - Data da cotação da moeda |
| cotacoes.codMoe | String | (Opcional) - String(003) - Código da moeda |
| cotacoes.cotMoe | String | (Opcional) - Number(019) - Valor da cotação da moeda |
| cotacoes.fecMoe | String | (Opcional) - String(001) - Indicativo se o valor da cotação é fechado |
| cotacoes.perPit | String | (Opcional) - Number(004) - Percentual de PIS retido |
| cotacoes.perCsl | String | (Opcional) - Number(004) - Percentual de CSLL retido |
| cotacoes.perCrt | String | (Opcional) - Number(004) - Percentual de Cofins retido |
| cotacoes.perOur | String | (Opcional) - Number(004) - Percentual de outras retenções |
| cotacoes.codMot | String | (Opcional) - Number(006) - Código do motivo da aprovação da cotação |
| cotacoes.obsMot | String | (Opcional) - String(250) - Observação do motivo da aprovação da cotação |
| cotacoes.codTpr | String | (Opcional) - String(004) - Código da tabela de preço do item |
| cotacoes.vlrDfa | String | (Opcional) - Number(015) - Valor diferença aliquota |
| cotacoes.txtCot | String | (Opcional) - String(1000) - Texto complementar para cotação |
| cotacoes.vlrDsc | String | (Opcional) - Number(015) - Valor de desconto |
| cotacoes.melCot | String | (Opcional) - String(001) - Indicativo se é melhor cotação |
| cotacoes.nivExi | String | (Opcional) - String(250) - Nível exigido para aprovação |
| cotacoes.obrMot | String | (Obrigatório) - String(1) - Indicativo se a aprovação exige a informação do motivo.
Valores possíveis: * "S": Sim, a aprovação exige a informação de um motivo; * "N": Não, a aprovação não exige a informação de um motivo. |
| cotacoes.sigMoe | String | (Opcional) - String(005) - Sigla da moeda da empresa |
| cotacoes.desMoe | String | (Opcional) - String(030) - Descrição da moeda da empresa |
| solicitacoes | Set | Lista de solicitações das cotações
Obs.: Nesta lista são retornadas as solicitações que geraram cada uma das cotações da lista "Cotacoes". A ligação entre esta lista e a "Cotacoes" são os campos CodEmp e NumCot de ambas as listas. |
| solicitacoes.codEmp | Integer | (Obrigatório) - Number(4) - Código da empresa |
| solicitacoes.nomEmp | String | (Obrigatório) - String(100) - Nome da empresa |
| solicitacoes.numCot | Integer | (Obrigatório) - Number(9) - Número da cotação gerada pela solicitação |
| solicitacoes.numSol | Integer | (Obrigatório) - Number(9) - Número da solicitação |
| solicitacoes.seqSol | Integer | (Obrigatório) - Number(6) - Sequência da solicitação |
| solicitacoes.filSol | Integer | (Opcional) - Number(4) - Código da filial solicitante |
| solicitacoes.nomFil | String | (Opcional) - String(100) - Nome da filial solicitante |
| solicitacoes.codPro | String | (Opcional) - String(014) - Código do produto |
| solicitacoes.codDer | String | (Opcional) - String(007) - Código da derivação |
| solicitacoes.codSer | String | (Opcional) - String(014) - Código do serviço |
| solicitacoes.proSer | String | (Obrigatório) - String(1) - Indicativo de produto ou serviço |
| solicitacoes.cplPro | String | (Opcional) - String(250) - Complemento da descrição do produto/serviço |
| solicitacoes.uniMed | String | (Opcional) - String(003) - Unidade de medida do produto |
| solicitacoes.qtdSol | Double | (Obrigatório) - Number(9,5) - Quantidade solicitada |
| solicitacoes.usuSol | Integer | (Opcional) - Number(9) - Código do usuário solicitante |
| solicitacoes.nomUsuSol | String | (Opcional) - String(255) - Nome do usuário solicitante |
| solicitacoes.ccuRes | String | (Opcional) - String(9) - Código do centro de custo solicitante |
| solicitacoes.abrCcu | String | (Opcional) - String(20) - Abreviatura do centro de custo solicitante |
| solicitacoes.numPrj | Integer | (Opcional) - Number(8) - Número do projeto |
| solicitacoes.abrPrj | String | (Opcional) - String(20) - Abreviatura do projeto |
| solicitacoes.codFpj | Integer | (Opcional) - Number(4) - Código da fase do projeto |
| solicitacoes.abrFpj | String | (Opcional) - String(20) - Abreviatura da fase do projeto |
| solicitacoes.sigMoe | String | (Opcional) - String(005) - Sigla da moeda da empresa |
| solicitacoes.desMoe | String | (Opcional) - String(030) - Descrição da moeda da empresa |
| 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 |
| tpResultado | String | O campo tipo resultado irá retornar para:
Execução do serviço sem erros: "1" Execução do serviço com erros: "2" |
English
Español
English
Español


