Web service Com.senior.g5.co.int.varejo.tabelasprecove
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_int_varejo_tabelasprecove?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_int_varejo_tabelasprecove?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Scheduledcom_senior_g5_co_int_varejo_tabelasprecove?wsdl
Porta
Integrações - Varejo - Cadastros - Exportar Tabelas de Preço - Varejo Eletro Móveis
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:Exportar_2> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <codEmp>Integer</codEmp> <consulta> <codTpr>String</codTpr> <datIni>String</datIni> <codPro>String</codPro> <codDer>String</codDer> <codSer>String</codSer> </consulta> <codFil>Integer</codFil> <quantidadeRegistros>Integer</quantidadeRegistros> <identificadorSistema>String</identificadorSistema> <tipoIntegracao>String</tipoIntegracao> </parameters> </ser:Exportar_2> </soapenv:Body> </soapenv:Envelope>
Nome | Tipo | Descrição |
---|---|---|
codEmp | Integer | (Obrigatório) - Number(004) - Código da Empresa |
consulta | Set | Obrigatório quando o tipo de integração (tipoIntegracao) for "E". Para consultar, deve-se informar pelo menos um dos sub-elementos: codTpr, datIni, codPro ou codSer. Também é possível combiná-los, isto é, informar codTpr e codPro simultaneamente. Neste caso, será retornado o preço do produto naquela tabela de preço. O sub-elemento codDer somente deve ser utilizado quando codPro também for informado. Não informar simultaneamente os elementos codPro e codSer. |
consulta.codTpr | String | (Opcional) - String(004) - Código da Tabela de Preço |
consulta.datIni | DateTime | (Opcional) - Date - Data de Validade Inicial da tabela de preço |
consulta.codPro | String | (Opcional) - String(014) - Código do Produto |
consulta.codDer | String | (Opcional) - String(007) - Código da Derivação |
consulta.codSer | String | (Opcional) - String(014) - Código do Serviço |
codFil | Integer | (Obrigatório) - Number(005) - Código da Filial |
quantidadeRegistros | Integer | (Opcional) - Number(005) - Quantidade de registros limite para retorno da solicitação. Obrigatório quando o tipo de integração for "T" ou "A". Quando o tipo de integração for "E", este valor não é utilizado |
identificadorSistema | String | (Obrigatório) - String(15) - Sigla do Sistema de Integração |
tipoIntegracao | String | (Obrigatório) - String(001) - Tipo de Integração - Lista: T = Todos, A = Somente Alterados |
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:Exportar_2Response> <result> <tabelaPreco> <codTpr>String</codTpr> <desTpr>String</desTpr> <abrTpr>String</abrTpr> <aplTpv>Integer</aplTpv> <tabBld>String</tabBld> <tipTab>Integer</tipTab> <sitReg>String</sitReg> <validade> <datIni>String</datIni> <datFim>String</datFim> <perDsc>Double</perDsc> <perCom>Double</perCom> <sitReg>String</sitReg> <item> <proSer>String</proSer> <codIte>String</codIte> <codDer>String</codDer> <preBas>Double</preBas> <perDsc>Double</perDsc> <tolMai>Double</tolMai> <tolMen>Double</tolMen> <mgcMin>Double</mgcMin> <mgcLim>Double</mgcLim> <mgcCom>Double</mgcCom> <preCus>Double</preCus> <sitReg>String</sitReg> <seqInt>Integer</seqInt> <codAgg>String</codAgg> <codTge>Integer</codTge> <tipTge>String</tipTge> <itePad>Integer</itePad> <codExp>String</codExp> <vlrIni>Double</vlrIni> <vlrFin>Double</vlrFin> <vlrCus>Double</vlrCus> <idaMin>Integer</idaMin> <idaMax>Integer</idaMax> <campoUsuario> <campo>String</campo> <valor>String</valor> </campoUsuario> </item> </validade> <formaPagamento> <codFpg>Integer</codFpg> <sitReg>String</sitReg> </formaPagamento> <condicaoPagamento> <codCpg>String</codCpg> <sitReg>String</sitReg> </condicaoPagamento> <camposUsuarioDadosGerais> <campo>String</campo> <valor>String</valor> </camposUsuarioDadosGerais> </tabelaPreco> <resultado> <codTpr>String</codTpr> <datIni>String</datIni> <codPro>String</codPro> <codDer>String</codDer> <codSer>String</codSer> <observacao>String</observacao> </resultado> <erros> <msgErr>String</msgErr> </erros> <lote>Integer</lote> <finalizaramRegistros>String</finalizaramRegistros> <mensagemRetorno>String</mensagemRetorno> <tipoRetorno>Integer</tipoRetorno> <erroExecucao>String</erroExecucao> </result> </ser:Exportar_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" |
tabelaPreco | Set | |
tabelaPreco.codTpr | String | CodTpr - (Obrigatório) - String(004) - Código da tabela de preço |
tabelaPreco.desTpr | String | DesTpr - (Obrigatório) - String(250) - Descrição da tabela de preço |
tabelaPreco.abrTpr | String | AbrTpr - (Obrigatório) - String(010) - Abreviatura da tabela de preço |
tabelaPreco.aplTpv | Integer | AplTpv - (Obrigatório) - Number(001) - Aplicação da tabela de preço de venda - Lista: 1 = Vendas |
tabelaPreco.tabBld | String | TabBld - (Opcional) - String(001) - Indicativo se a tabela de preço é um tablóide - Lista: S = Sim, N = Não |
tabelaPreco.tipTab | Integer | TipTab - (Obrigatório) - Inteiro - Indicativo do tipo da tabela de preço. 1 = Normal, 2 = Tabloide, 3 = Promoção |
tabelaPreco.sitReg | String | SitReg - (Obrigatório) - String(001) - Situação do registro - Lista: A = Ativo, I = Inativo |
tabelaPreco.validade | Set | |
tabelaPreco.validade.datIni | DateTime | DatIni - (Obrigatório) - Date(DD/MM/YYYY) - Data início de validade da tabela de preço |
tabelaPreco.validade.datFim | DateTime | DatFim - (Obrigatório) - Date(DD/MM/YYYY) - Data final de validade da tabela de preço |
tabelaPreco.validade.perDsc | Double | PerDsc - (Opcional) - Number(005,2) - Percentual de desconto a ser concedido |
tabelaPreco.validade.perCom | Double | PerCom - (Opcional) - Number(005,2) - Percentual a acrescentar ou diminuir à comissão dos representantes |
tabelaPreco.validade.sitReg | String | SitReg - (Obrigatório) - String(001) - Situação do registro - Lista: A = Ativo, I = Inativo |
tabelaPreco.validade.item | Set | |
tabelaPreco.validade.item.proSer | String | ProSer - (Obrigatório) - String(001) - Indicativo de produto ou serviço - P = Produto, S = Serviço |
tabelaPreco.validade.item.codIte | String | CodIte - (Obrigatório)- String(014) - Código do Produto ou Serviço |
tabelaPreco.validade.item.codDer | String | CodDer - (Obrigatório) - String(007) - Código da derivação da tabela de preço |
tabelaPreco.validade.item.preBas | Double | PreBas - (Obrigatório) - Number(014,5) - Valor base do produto na tabela de preço |
tabelaPreco.validade.item.perDsc | Double | PerDsc - (Opcional) - Number(005,2) - Percentual de desconto a ser concedido |
tabelaPreco.validade.item.tolMai | Double | TolMai - (Opcional) - Number(005,2) - Percentual de tolerância de preço a maior |
tabelaPreco.validade.item.tolMen | Double | TolMen - (Opcional) - Number(005,2) - Percentual de tolerância de preço a menor |
tabelaPreco.validade.item.mgcMin | Double | MgcMin - (Opcional) - Number(015,6) - Percentual de margem de contribuição mínima |
tabelaPreco.validade.item.mgcLim | Double | MgcLim - (Opcional) - Number(015,6) - Percentual de margem de contribuição limite |
tabelaPreco.validade.item.mgcCom | Double | MgcCom - (Opcional) - Number(015,6) - Percentual de margem de contribuição para comissão |
tabelaPreco.validade.item.preCus | Double | PreCus - (Opcional) - Number(015,6) - Preço de custo base para o cálculo |
tabelaPreco.validade.item.sitReg | String | SitReg - (Obrigatório) - String(001) - Situação do produto na tabela de preço - Lista: A = Ativo, I = Inativo |
tabelaPreco.validade.item.seqInt | Integer | SeqInt - (Obrigatório) - Inteiro - Número sequencial do registro integrado |
tabelaPreco.validade.item.codAgg | String | CodAgg - (Opcional) - String(005) - Código de agrupamento de materiais/produtos para garantia estendida |
tabelaPreco.validade.item.codTge | Integer | CodTge - (Opcional) - Inteiro - Código da Garantia Estendida |
tabelaPreco.validade.item.tipTge | String | Tipo de Garantia Estendida |
tabelaPreco.validade.item.itePad | Integer | ItePad - Inteiro - Indicativo de Item Padrão de garantia(0=Não, 1 = Sim) |
tabelaPreco.validade.item.codExp | String | CodExp - String (010) Código de exportação da garantia estendida |
tabelaPreco.validade.item.vlrIni | Double | VlrIni - Number(014,5) - Valor inicial da faixa de aplicação da garantia estendida |
tabelaPreco.validade.item.vlrFin | Double | VlrFin - Number(014,5) - Valor final da faixa de aplicação da garantia estendida |
tabelaPreco.validade.item.vlrCus | Double | VlrCus - Number(014,5) - Valor do custo da garantia estendia |
tabelaPreco.validade.item.idaMin | Integer | (Opcional) - Number(004) - Idade mínima para adquirir o serviço parcela protegida |
tabelaPreco.validade.item.idaMax | Integer | (Opcional) - Number(004) - Idade máxima para adquirir o serviço parcela protegida |
tabelaPreco.validade.item.campoUsuario | Set | Campos de usuário ligados ao produto |
tabelaPreco.validade.item.campoUsuario.campo | String | Campo - String - Nome do campo de usuário. |
tabelaPreco.validade.item.campoUsuario.valor | String | Valor - String - Valor do campo de usuário. |
tabelaPreco.formaPagamento | Set | |
tabelaPreco.formaPagamento.codFpg | Integer | CodFpg - (Obrigatório) - Number(002) - Código da forma de pagamento |
tabelaPreco.formaPagamento.sitReg | String | SitReg - (Opcional) - String(001) - Situação do registro - Lista: A = Ativo, I = Inativo |
tabelaPreco.condicaoPagamento | Set | |
tabelaPreco.condicaoPagamento.codCpg | String | CodCpg - (Obrigatório) - String(006) - Código da condição de pagamento |
tabelaPreco.condicaoPagamento.sitReg | String | SitReg - (Opcional) - String(001) - Situação do registro - Lista: A = Ativo, I = Inativo |
tabelaPreco.camposUsuarioDadosGerais | Set | |
tabelaPreco.camposUsuarioDadosGerais.campo | String | |
tabelaPreco.camposUsuarioDadosGerais.valor | String | |
resultado | Set | (Opcional) - Este elemento somente é alimentado quando o tipo de Integração é "E" (Registro Específico) |
resultado.codTpr | String | (Obrigatório) - String(004) - Código da Tabela de Preço |
resultado.datIni | DateTime | (Obrigatório) - Date - Data de validade inicial da tabela de preço |
resultado.codPro | String | (Obrigatório) - String(014) - Código do Produto |
resultado.codDer | String | (Obrigatório) - String(007) - Código da Derivação |
resultado.codSer | String | (Obrigatório) - String(014) - Código do Serviço |
resultado.observacao | String | (Obrigatório) - String(100) - Motivo do registro não ter sido exportado |
erros | Set | |
erros.msgErr | String | MsgErr - (Obrigatório) - String - Mensagem de erros encontrados no processamento |
lote | Integer | (Obrigatório) - Numeric(7) - Número do lote |
finalizaramRegistros | String | (Obrigatório) - String(001) - Indicativo se existem mais informações a serem solicitadas - Lista: S = Sim, N = Não |
mensagemRetorno | String | (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento. Quando ocorrer erro de processamento, este elemento apresentará a mensagem de erro de processamento |
tipoRetorno | Integer | (Obrigatório) - Número(001) - Tipo de Retorno de Processamento - Lista: 1 = Processado, 2 = Erro na Solicitação |