English
Español
Integrações com outros sistemas > Web services > Web services disponíveis no Gestão Empresarial > Com.senior.g5.co.int.varejo.reducaoz
Web service Com.senior.g5.co.int.varejo.reducaoz
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_int_varejo_reducaoz?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_int_varejo_reducaoz?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Scheduledcom_senior_g5_co_int_varejo_reducaoz?wsdl
Porta
GravarReducaoZIdentificada
Integrações - Varejo - Tributos/Escrituração - Gravar Redução Z (Varejo EM)
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:GravarReducaoZIdentificada>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<reducoesZ>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<codEqu>Integer</codEqu>
<numSer>String</numSer>
<datRef>String</datRef>
<numMar>Integer</numMar>
<numRez>Integer</numRez>
<vlrGtf>String</vlrGtf>
<vlrBru>String</vlrBru>
<vlrDsc>String</vlrDsc>
<vlrCan>String</vlrCan>
<vlrSer>String</vlrSer>
<vlrGti>String</vlrGti>
<vlrAcr>String</vlrAcr>
<conRei>Integer</conRei>
<ideExt>Integer</ideExt>
<cooRed>Integer</cooRed>
<aliquotas>
<codStr>String</codStr>
<alqImp>String</alqImp>
<vltImp>String</vltImp>
<tipImp>Integer</tipImp>
</aliquotas>
<meiosPagamento>
<codMpg>String</codMpg>
<desMpg>String</desMpg>
<vlrTot>String</vlrTot>
</meiosPagamento>
<totalizadorNaoFiscal>
<codTot>String</codTot>
<desTot>String</desTot>
<qtdOpe>String</qtdOpe>
<vlrTot>String</vlrTot>
</totalizadorNaoFiscal>
</reducoesZ>
<dataBuild>String</dataBuild>
<sigInt>String</sigInt>
</parameters>
</ser:GravarReducaoZIdentificada>
</soapenv:Body>
</soapenv:Envelope>
Parâmetros da requisição:
| Nome | Tipo | Descrição |
|---|---|---|
| reducoesZ | Set | |
| reducoesZ.codEmp | Integer | (Obrigatório) - Number(004) - Código da empresa |
| reducoesZ.codFil | Integer | (Obrigatório) - Number(005) - Código da filial |
| reducoesZ.codEqu | Integer | (Obrigatório) - Number(003) - Código do equipamento fiscal da redução Z |
| reducoesZ.numSer | String | (Opcional) - String(020) - Número de Série do equipamento fiscal - Condição: Obrigatório quando não informado o campo CodEqu. Observação: Caso o campo CodEqu seja informado o conteúdo deste campo será desconsiderado. |
| reducoesZ.datRef | String | (Obrigatório) - Date - Data de referência da redução Z (Se não informado utiliza data atual) |
| reducoesZ.numMar | Integer | (Opcional) - Number(006) - Número do mapa resumo |
| reducoesZ.numRez | Integer | (Obrigatório) - Number(006) - Número da redução Z |
| reducoesZ.vlrGtf | String | (Opcional) - Number(015,2) - Gran total do final do dia da redução Z |
| reducoesZ.vlrBru | String | (Opcional) - Number(015,2) - Valor bruto da redução Z |
| reducoesZ.vlrDsc | String | (Opcional) - Number(015,2) - Valor dos descontos da redução Z |
| reducoesZ.vlrCan | String | (Opcional) - Number(015,2) - Valor dos cancelamentos da redução Z |
| reducoesZ.vlrSer | String | (Opcional) - Number(015,2) - Valor dos serviços da redução Z |
| reducoesZ.vlrGti | String | (Opcional) - Number(015,2) - Gran total do início do dia da redução Z |
| reducoesZ.vlrAcr | String | (Opcional) - Number(015,2) - Valor dos acréscimos da redução Z |
| reducoesZ.conRei | Integer | (Opcional) - Number(003) - Valor acumulado no contador de reinício de operação |
| reducoesZ.ideExt | Integer | (Opcional) - Inteiro - Identificador externo do Registro (obrigatório quando Varejo Eletro Móveis) |
| reducoesZ.cooRed | Integer | (Opcional) - Number(006) - Número do cont. de ordem de ope. último documento emitido (COO da Redução Z). |
| reducoesZ.aliquotas | Set | |
| reducoesZ.aliquotas.codStr | String | (Opcional) - String(003) - Situação tributária do item do cupom fiscal. |
| reducoesZ.aliquotas.alqImp | String | (Opcional) - Number(003,2) - Alíquota do imposto |
| reducoesZ.aliquotas.vltImp | String | (Opcional) - Number(013,2) - Valor total da alíquota do imposto |
| reducoesZ.aliquotas.tipImp | Integer | (Opcional) - Number(001) - Tipo do Imposto (1 - ICMS, 2 - ISS) |
| reducoesZ.meiosPagamento | Set | |
| reducoesZ.meiosPagamento.codMpg | String | (Opcional) - String(003) - Código do meio de pagamento. |
| reducoesZ.meiosPagamento.desMpg | String | (Opcional) - String(100) - Descrição do meio de pagamento. |
| reducoesZ.meiosPagamento.vlrTot | String | (Opcional) - Number(013,2) - Valor total acumulado do meio de pagamento na redução Z. |
| reducoesZ.totalizadorNaoFiscal | Set | |
| reducoesZ.totalizadorNaoFiscal.codTot | String | (Opcional) - String(003) - Código do totalizador não fiscal. |
| reducoesZ.totalizadorNaoFiscal.desTot | String | (Opcional) - String(100) - Descrição do totalizador não fiscal. |
| reducoesZ.totalizadorNaoFiscal.qtdOpe | String | (Opcional) - Number(003) - Quantidade de operações não fiscais. |
| reducoesZ.totalizadorNaoFiscal.vlrTot | String | (Opcional) - Number(013,2) - Valor total do totalizador não fiscal. |
| dataBuild | String | Mantido por compatibilidade. |
| sigInt | String | (Obrigatório) - String(15) - Sigla do Sistema de Integração |
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:GravarReducaoZIdentificadaResponse>
<result>
<tipoRetorno>Integer</tipoRetorno>
<retornos>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<codEqu>Integer</codEqu>
<numSer>String</numSer>
<datRef>String</datRef>
<retorno>String</retorno>
<tipRet>Integer</tipRet>
<msgRet>String</msgRet>
<ideExt>Integer</ideExt>
</retornos>
<mensagemRetorno>String</mensagemRetorno>
<erroExecucao>String</erroExecucao>
</result>
</ser:GravarReducaoZIdentificadaResponse>
</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" |
| tipoRetorno | Integer | (Obrigatório) - Number(001) - Tipo de Retorno de Processamento - Lista: 1 = Processado, 2 = Erro na Solicitação |
| retornos | Set | |
| retornos.codEmp | Integer | (Obrigatório) - Number(004) - Código da empresa |
| retornos.codFil | Integer | (Obrigatório) - Number(005) - Código da filial |
| retornos.codEqu | Integer | (Obrigatório) - Number(003) - Código do equipamento fiscal da redução Z |
| retornos.numSer | String | (Opcional) - String(020) - Número de Série do Equipamento Fiscal - Condição: Será retornado quando informado na chamada |
| retornos.datRef | String | (Obrigatório) - Date - Data de referência da redução Z |
| retornos.retorno | String | (Obrigatório) - String(1000) - Retorno referente ao registro |
| retornos.tipRet | Integer | (Obrigatório) - TipRet - Number(001) - Tipo de retorno. Valores: 1 - Processado com sucess; 2 - Ocorreram Erros. |
| retornos.msgRet | String | (Opcional) - String(1000) - Mensagem de Retorno da Gravação da Nota |
| retornos.ideExt | Integer | (Opcional) - Inteiro - Identificador externo do Registro (obrigatório quando Varejo Eletro Móveis) |
| mensagemRetorno | String | (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento |
English
Español
