Web service Com.senior.g5.co.int.varejo.servico
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_servico?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_int_varejo_servico?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Scheduledcom_senior_g5_co_int_varejo_servico?wsdl
Porta
Integrações - Varejo - Cadastros - Exportar Serviço
Necessita autenticação: sim
Situação de versão: atual
Versão: 8
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:Exportar> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <codEmp>Integer</codEmp> <consulta> <codSer>String</codSer> </consulta> <codFil>Integer</codFil> <tipoIntegracao>String</tipoIntegracao> <identificadorSistema>String</identificadorSistema> <quantidadeRegistros>Integer</quantidadeRegistros> </parameters> </ser:Exportar> </soapenv:Body> </soapenv:Envelope>
Nome | Tipo | Descrição |
---|---|---|
codEmp | Integer | (Obrigatório) - Number(004) - Código da Empresa |
consulta | Set | (Obrigatório) - Utilizar para informar quais registros devem ser retornados. Utilizar apenas quando o tipo de integração for específico ("E") |
consulta.codSer | String | (Obrigatório) - CodSer - String(014) - Código do serviço |
codFil | Integer | (Obrigatório) - Number(005) - Código da Filial |
tipoIntegracao | String | (Obrigatório) - String(001) - Tipo de Integração - Lista: T = Todos, A = Somente Alterados, E = Registro Específico |
identificadorSistema | String | (Obrigatório) - Number(001) - Tipo de Retorno de Processamento - Lista: 1 = Processado, 2 = Erro na Solicitação |
quantidadeRegistros | Integer | (Opcional) - Number(005) - Quantidade de registros limite para retorno da solicitação. Quando o tipo de integração for "E", este valor não é utilizado. |
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:ExportarResponse> <result> <grupoFiscal> <ideNgf>Integer</ideNgf> <codEmp>Integer</codEmp> <stIcmS>String</stIcmS> <alIcmS>Double</alIcmS> <stIcmE>String</stIcmE> <alIcmE>Double</alIcmE> <stPisS>String</stPisS> <alPisS>Double</alPisS> <stPisE>String</stPisE> <alPisE>Double</alPisE> <stCofS>String</stCofS> <alCofS>Double</alCofS> <stCofE>String</stCofE> <alCofE>Double</alCofE> <stIpiS>String</stIpiS> <alIpiS>Double</alIpiS> <stIpiE>String</stIpiE> <alIpiE>Double</alIpiE> <mdcIpi>Integer</mdcIpi> <alIssS>Double</alIssS> <alIssE>Double</alIssE> <tabMva>String</tabMva> <stbPaf>String</stbPaf> <sigUfs>String</sigUfs> <tipTrb>Integer</tipTrb> <mdbIcm>Integer</mdbIcm> <redSai>Double</redSai> <redEnt>Double</redEnt> <issErt>Double</issErt> <issSrt>Double</issSrt> <issSrd>Double</issSrd> <issERd>Double</issERd> <tprPis>String</tprPis> <tprCof>String</tprCof> <mdcCof>Integer</mdcCof> <mdcPis>Integer</mdcPis> <perDif>Double</perDif> <icmAfc>Double</icmAfc> <icmInd>Double</icmInd> <tipBda>Integer</tipBda> <redIcm>Double</redIcm> <temIcm>Integer</temIcm> </grupoFiscal> <servico> <codSer>String</codSer> <desSer>String</desSer> <codFam>String</codFam> <uniMed>String</uniMed> <indPpt>String</indPpt> <varSer>String</varSer> <codAgg>String</codAgg> <vlrIni>Double</vlrIni> <vlrFin>Double</vlrFin> <przTge>Integer</przTge> <exiNfe>String</exiNfe> <iteRap>Integer</iteRap> <obsSer>String</obsSer> <sitSer>String</sitSer> <oriMer>String</oriMer> <sigUfs>String</sigUfs> <idaMin>Integer</idaMin> <idaMax>Integer</idaMax> <desFis>String</desFis> <iteFis>String</iteFis> <vlrSer>Double</vlrSer> <codTge>Integer</codTge> <codTpr>String</codTpr> <datIni>DateTime</datIni> <seqInt>String</seqInt> <codClf>String</codClf> <codAgt>String</codAgt> <serImp>String</serImp> <codSeg>Integer</codSeg> <tipTge>String</tipTge> <numPrc>String</numPrc> <indIsv>Integer</indIsv> <codFim>String</codFim> <gruposFiscaisServico> <ideNgf>Integer</ideNgf> <sigUfs>String</sigUfs> </gruposFiscaisServico> <codTns>String</codTns> <tnsEdv>String</tnsEdv> <codCes>String</codCes> <natRen>String</natRen> <proImp>String</proImp> <codTbn>String</codTbn> </servico> <gridErros> <msgErr>String</msgErr> </gridErros> <finalizaramRegistros>String</finalizaramRegistros> <tipoRetorno>Integer</tipoRetorno> <mensagemRetorno>String</mensagemRetorno> <numeroLote>Integer</numeroLote> <erroExecucao>String</erroExecucao> </result> </ser:ExportarResponse> </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" |
grupoFiscal | Set | (Obrigatório) - Utilizar para informar quais registros devem ser retornados. Utilizar apenas quando o tipo de integração for específico ("E") |
grupoFiscal.ideNgf | Integer | (Opcional) - IdeNgf - Number(009) - Identificador do grupo fiscal |
grupoFiscal.codEmp | Integer | (Obrigatório) - CodEmp - Number(004) - Código da empresa |
grupoFiscal.stIcmS | String | (Opcional) - StIcmS - String(003) - Código da situação tributária para saídasdo produto/Serviço |
grupoFiscal.alIcmS | Double | (Opcional) - AlIcmS - Number(004,2) - Percentual de ICMS para saídas |
grupoFiscal.stIcmE | String | (Opcional) - StIcmE - String(003) - Código da situação tributária para entradas do produto/Serviço |
grupoFiscal.alIcmE | Double | (Opcional) - AlIcmE - Number(004,2) - Percentual de ICMS para entradas |
grupoFiscal.stPisS | String | (Opcional) - StPisS - String(002) - Código da situação tributária de PIS para saídas |
grupoFiscal.alPisS | Double | (Opcional) - AlPisS - Number(004,2) - Alíquota de PIS do produto/serviço para saídas |
grupoFiscal.stPisE | String | (Opcional) - StPisE - String(002) - Código da situação tributária de PIS para Entradas |
grupoFiscal.alPisE | Double | (Opcional) - AlPisE - Number(004,2) - Alíquota de PIS do produto/serviço para entradas |
grupoFiscal.stCofS | String | (Opcional) - StCofS - String(002) - Código da situação tributária de COFINS para saídas |
grupoFiscal.alCofS | Double | (Opcional) - AlCofS - Number(004,2) - Percentual de COFINS para saídas |
grupoFiscal.stCofE | String | (Opcional) - StCofE - String(002) - Código da situação tributária de COFINS para entradas |
grupoFiscal.alCofE | Double | (Opcional) - AlCofE - Number(004,2) - Percentual de COFINS para entradas |
grupoFiscal.stIpiS | String | (Opcional) - StIpiS - String(002) - Código da situação tributária de IPI |
grupoFiscal.alIpiS | Double | (Opcional) - AlIpiS - Number(004,2) - Percentual do IPI de saída |
grupoFiscal.stIpiE | String | (Opcional) - StIpiE - String(002) - Código da situação tributária de IPI para entradas |
grupoFiscal.alIpiE | Double | (Opcional) - AlIpiE - Number(004,2) - Percentual do IPI de entradas |
grupoFiscal.mdcIpi | Integer | (Opcional) - MdcIpi - Number(001) - Modo de Cálculo do IPI |
grupoFiscal.alIssS | Double | (Opcional) - AlIssS - Number(006,4) - Percentual do ISS previsto para saídas |
grupoFiscal.alIssE | Double | (Opcional) - AlIssE - Number(006,4) - Percentual do ISS previsto para entradas |
grupoFiscal.tabMva | String | (Opcional) - TabMva - String(003) - Tabela de Margem Valor Agregado |
grupoFiscal.stbPaf | String | (Opcional) - StbPaf - String(003) - Código da situação tributária do produto para PAF - Lista: (I = Isento, N = Não Tributado, F = Substituição Tributária, T = Tributado |
grupoFiscal.sigUfs | String | (Obrigatório) - SigUfs - String(002) - Sigla do estado |
grupoFiscal.tipTrb | Integer | (Opcional) - TipTrb - Number(001) - Indica Tipo de Tributo (1 = Icms, 2 = Iss) |
grupoFiscal.mdbIcm | Integer | (Opcional) - MdbIcm - Number(001) - Modalidade de determinação da BC do ICMS - Lista : 0 = Margem Valor Agregado (%), 1 = Pauta (Valor), 2 = Preço Tabelado Máx. (valor), 3 = Valor da operação |
grupoFiscal.redSai | Double | Percentual de redução/acréscimo da base do imposto nas saídas para contribuinte |
grupoFiscal.redEnt | Double | Percentual de redução/acréscimo na base do imposto nas entradas de contribuinte |
grupoFiscal.issErt | Double | (Opcional) - IssErt - Number(6,4) - Alíquota do ISS de entrada (Retido) |
grupoFiscal.issSrt | Double | (Opcional) - IssSrt - Number(6,4) - Alíquota do ISS de saída (Retido) |
grupoFiscal.issSrd | Double | (Opcional) - IssSrd - Number(6,4) - Alíquota do ISS de saída (Redução) |
grupoFiscal.issERd | Double | (Opcional) - IssERd - Number(6,4) - Alíquota do ISS de entrada (Redução) |
grupoFiscal.tprPis | String | Código da tabela de preço para o cálculo de PIS por unidade de medida |
grupoFiscal.tprCof | String | Código da tabela de preço para o cálculo de COFINS por unidade de medida |
grupoFiscal.mdcCof | Integer | Modo de Cálculo do Cofins |
grupoFiscal.mdcPis | Integer | Modo de Cálculo do PIS |
grupoFiscal.perDif | Double | (Opcional) - PerDif - Number (3 ,2) - Percentual de diferimento do serviço. |
servico | Set | (Obrigatório) - Utilizar para informar quais registros devem ser retornados. Utilizar apenas quando o tipo de integração for específico ("E") |
servico.codSer | String | (Obrigatório) - CodSer - String(014) - Código do serviço |
servico.desSer | String | (Obrigatório) - DesSer - String(070) - Descrição do serviço |
servico.codFam | String | (Obrigatório) - CodFam - String(006) - Código da família de produtos que o serviço pertence |
servico.uniMed | String | (Obrigatório) - UniMed - String(003) - Unidade de medida do serviço |
servico.indPpt | String | (Opcional) - IndPpt - String(001) - Indicador de Produção Própria ou de Terceiro |
servico.varSer | String | (Opcional) - VarSer - Inteiro - Indica o tipo de serviço para o Varejo - Lista: 2 = Frete, 3 = Garantia Estendida, 4 = Parcela Protegida |
servico.codAgg | String | (Opcional) - CodAgg - String(005) - Código de agrupamento de materiais/produtos para garantia estendida |
servico.vlrIni | Double | (Opcional) - VlrIni - Number(015,2) - Valor incial do serviço para serviços financeiros |
servico.vlrFin | Double | (Opcional) - VlrFin - Number(015,2) - Valor final do serviço para serviços financeiros |
servico.przTge | Integer | (Opcional) - PrzTge - Number(004) - Prazo de garantia estendida (em meses) |
servico.exiNfe | String | (Obrigatório) - ExiNfe - String(001) - Exige nota fiscal eletrônica - Lista : 0 = Não, 1 = Sim |
servico.iteRap | Integer | (Opcional) - IteRap - Number(001) - Item Rápido - Lista : 0 = Não, 1 = Sim |
servico.obsSer | String | (Opcional) - ObsSer - String(999) - Observação do Serviço |
servico.sitSer | String | (Obrigatório) - SitSer - String(001) - Situação do serviço (Ativo ou Inativo) - Lista: A = Ativo, I = Inativo |
servico.oriMer | String | (Opcional) - OriMer - String(001) - Origem fiscal da mercadoria - Lista: 0 = Nacional, exceto as indicadas nos códigos 3 a 5, 1 = Estrangeira - Importação direta, exceto a indicada no código 6, 2 = Estrangeira - Adquirida no mercado interno, exceto a indicada no código 7, 3 = Nacional, mercadoria ou bem com Conteúdo de Importação superior a 40% (quarenta por cento), 4 = Nacional, cuja produção tenha sido feita em conformidade com os processos produtivos básicos de que tratam o Decreto-Lei nº 288/67, e as Leis nºs 8.248/91, 8.387/91, 10.176/01 e 11.484/07, 5 = Nacional, mercadoria ou bem com Conteúdo de Importação inferior ou igual a 40% (quarenta por cento), 6 = Estrangeira - Importação direta, sem similar nacional, constante em lista de Resolução CAMEX, 7 = Estrangeira - Adquirida no mercado interno, sem similar nacional, constante em lista de Resolução CAMEX |
servico.sigUfs | String | (Opcional) - SigUfs - String(002) - Sigla do estado |
servico.idaMin | Integer | (Opcional) - IdaMin - Number(004) - Idade mínima para adquirir o serviço parcela protegida |
servico.idaMax | Integer | (Opcional) - IdaMax - Number(004) - Idade máxima para adquirir o serviço parcela protegida |
servico.desFis | String | (Opcional) - DesFis - String(255) - Descrição fiscal do item |
servico.iteFis | String | (Opcional) - IteFis - String(060) - Código fiscal do item |
servico.vlrSer | Double | (Opcional) - VlrSer - Number(015,2) - Valor que o serviço representante para serviços financeiros |
servico.codTge | Integer | (Opcional) - CodTge - Number(004) - Código da Garantia Estendida |
servico.codTpr | String | (Opcional) - CodTpr - String(004) - Código da tabela de preço padrão para serviços de varejo |
servico.datIni | DateTime | (Opcional) - DatIni - Date(DD/MM/YYYY) - Data validade inicial da tabela de preço |
servico.seqInt | String | (Obrigatório) - SeqInt - Number(015) - Sequência de Integração |
servico.codClf | String | (Opcional) - CodClf - String(003) - Código interno da classificação fiscal para os serviços com IPI |
servico.codAgt | String | (Opcional) - CodAgt - String(005) - Código de agrupamento comercial do serviço |
servico.serImp | String | (Opcional) - SerImp - String(010) - Tipo de Serviço no contexto fiscal baseado na LC 116/2003 |
servico.codSeg | Integer | (Opcional) - CodSeg - Number(009) - Código da Seguradora |
servico.tipTge | String | (Opcional) - TipTge - String(002) - Tipo de Garantia Estendida Lista: TR = Troca, RP = Reparo |
servico.numPrc | String | (Opcional) - NumPrc - String(030) - Número do processo de seguro, para garantia estendida ou parcela protegida |
servico.indIsv | Integer | (Opcional) - String(001) - Interm. de Serviços? - Lista: 1 = Sim, 0 = Não |
servico.codFim | String | (Opcional) - CodFim - String (010) - Código fiscal municipal do serviço. |
servico.gruposFiscaisServico | Set | |
servico.gruposFiscaisServico.ideNgf | Integer | (Obrigatório) - IdeNgf - Number(009) - Identificador do grupo fiscal |
servico.gruposFiscaisServico.sigUfs | String | (Obrigatório) - SigUfs - String(002) - Sigla do estado |
servico.codTns | String | (Opcional) - CodTns - String (005) - Transação para venda a consumidor final |
servico.tnsEdv | String | (Opcional) - TnsEdv - String (005) - Transação para entrada por devolução de venda |
servico.proImp | String | (Opcional) - ProImp - String(001) - Tipo serviço para impostos. Utilizado na geração do campo 07 do registro 0200 do Bloco K. Para mais informações, confira a documentação. |
servico.codTbn | String | String(006) - Código de Tributação Nacional |
gridErros | Set | (Opcional) - Lista dos erros |
gridErros.msgErr | String | Erros |
finalizaramRegistros | String | (Obrigatório) - String(001) - Indicativo se existem mais informações a serem solicitadas - Lista: S = Sim, N = Não |
tipoRetorno | Integer | (Obrigatório) - Number(001) - Tipo de Retorno de Processamento - Lista: 1 = Processado, 2 = Erro na Solicitação |
mensagemRetorno | String | (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento |
numeroLote | Integer | (Obrigatório) - Inteiro - Identificação do Lote de Exportação |