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.
- 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_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
Suprimentos - Gestão de Compras - Cotações de Preços - Consultas
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 2
<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>
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). |
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>
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" |