Web service Com.senior.g5.co.mcm.cpr.nfdevolucaovianfsaida
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_nfdevolucaovianfsaida?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_mcm_cpr_nfdevolucaovianfsaida?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Scheduledcom_senior_g5_co_mcm_cpr_nfdevolucaovianfsaida?wsdl
Ações relacionadas
Criação de novo fornecedor ao efetuar uma devolução
Ao executar a devolução de um cupom, este web service verificará se o código do cliente já possui um código de fornecedor atrelado. Não havendo código de fornecedor atrelado, será realizada uma busca verificando se a numeração igual ao código de fornecedor ainda está disponível. Estando disponível, um fornecedor será criado com essa numeração. Caso, no entanto, não esteja disponível, será gerado um cadastro de fornecedor com a próxima numeração disponível, conforme SELECT na tabela Tabelas - Controle dos últimos números utilizados (E078ULT) com os campos E078ULT = CODFOR, CODEMP = 0 e CODFIL = 0.
O valor do campo Cliente Igual a Fornecedor, da tela Parâmetros da Filial para Vendas (F070FVE), e o parâmetro global VarCodFor, não tem interferência na execução deste web service.
Nota
- Todas as portas utilizadas sempre foram as últimas de sua respectiva versão.
- Para mais informações sobre o processo de Vendas para Entrega Futura, quando há integração, acesse a documentação aqui.
Porta
GerarDevolucao_2
Suprimentos - Gestão de Recebimento - Notas Fiscais de Entrada - Nota Fiscal de Devolução via Nota Fiscal de Saída
Observação:
Para devoluções realizadas em uma filial diferente da filial de saída, é assumido o depósito parametrizado na tela F070VAR. Para devoluções realizadas na mesma filial de saída é assumido o depósito da nota de saída.
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:GerarDevolucao_2>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<dadosGerais>
<codEmp>String</codEmp>
<codFil>String</codFil>
<cnpjFilial>Double</cnpjFilial>
<seqReq>Integer</seqReq>
<identificador>String</identificador>
<datDev>String</datDev>
<prcOti>String</prcOti>
<codCli>Integer</codCli>
<gerNfe>Integer</gerNfe>
<cuponsFiscais>
<filCfi>String</filCfi>
<cnpjFilCfi>Double</cnpjFilCfi>
<codEqu>String</codEqu>
<croEcf>Integer</croEcf>
<numCfi>Integer</numCfi>
<emiDoc>String</emiDoc>
<produtos>
<codPro>String</codPro>
<codDer>String</codDer>
<preUni>String</preUni>
<qtdRec>String</qtdRec>
<loteSerie>
<seqDls>Integer</seqDls>
<codLot>String</codLot>
<numSep>String</numSep>
<qtdEst>String</qtdEst>
</loteSerie>
<vlrLiq>Double</vlrLiq>
<seqIpv>Integer</seqIpv>
<PerSen>String</PerSen>
<VlrBsn>String</VlrBsn>
<VlrSen>String</VlrSen>
</produtos>
<servicos>
<codSer>String</codSer>
<qtdRec>String</qtdRec>
<preUni>String</preUni>
</servicos>
</cuponsFiscais>
<parcelas>
<numPar>Integer</numPar>
<codFpg>Integer</codFpg>
<numCpr>String</numCpr>
<vlrPar>String</vlrPar>
<numCoo>Integer</numCoo>
<codRep>Integer</codRep>
</parcelas>
</dadosGerais>
<idtReq>String</idtReq>
<sigInt>String</sigInt>
</parameters>
</ser:GerarDevolucao_2>
</soapenv:Body>
</soapenv:Envelope>
Parâmetros da requisição:
| Nome | Tipo | Descrição |
|---|---|---|
| dadosGerais | Set | |
| dadosGerais.codEmp | String | (Obrigatório) - Number(004) - Código da empresa da nota fiscal de saída. |
| dadosGerais.codFil | String | (Obrigatório) - Number(005) - Código da filial da nota fiscal de saída. |
| dadosGerais.cnpjFilial | Double | |
| dadosGerais.seqReq | Integer | |
| dadosGerais.identificador | String | (Opcional) - String(250) - Identificador externo para identificar a nota no retorno. |
| dadosGerais.datDev | String | (Obrigatório) - Date - Data de emissão para nota fiscal de devolução. |
| dadosGerais.prcOti | String | |
| dadosGerais.codCli | Integer | |
| dadosGerais.gerNfe | Interger | (Opcional) - Number(001) - Gerar arquivo de nota fiscal eletrônica - Lista: 1 = Sim, 0 = Não |
| dadosGerais.cuponsFiscais | Set | |
| dadosGerais.cuponsFiscais.filCfi | String | (Obrigatório) - Number(005) - Código da filial do cupom fiscal que está sendo devolvido. Condição: Opcional quando "CNPJFilial" informado. |
| dadosGerais.cuponsFiscais.cnpjFilCfi | Double | (Opcional) - Number(014) - CNPJ da filial do cupom fiscal que está sendo devolvido. Condição: Obrigatório quando "CodFil" não informados. |
| dadosGerais.cuponsFiscais.codEqu | String | (Obrigatório) - Number(003) - Código do equipamento fiscal. |
| dadosGerais.cuponsFiscais.croEcf | Integer | (Obrigatório) - Number(006) - Contador de reinício de operação do ECF. |
| dadosGerais.cuponsFiscais.numCfi | Integer | (Obrigatório) - Number(009) - Número do cupom fiscal. |
| dadosGerais.cuponsFiscais.emiDoc | DateTime | (Obrigatório) - Date - Data de emissão do cupom fiscal. |
| dadosGerais.cuponsFiscais.produtos | Set | |
| dadosGerais.cuponsFiscais.produtos.codPro | String | (Obrigatório) - String(014) - Código do produto da nota fiscal de saída. |
| dadosGerais.cuponsFiscais.produtos.codDer | String | (Obrigatório) - String(007) - Código da derivação do produto da nota fiscal de saída. |
| dadosGerais.cuponsFiscais.produtos.preUni | String | (Obrigatório) - Number(015,2) - Preço unitário do item de produto da nota fiscal de saída. |
| dadosGerais.cuponsFiscais.produtos.qtdRec | String | (Obrigatório) - Number(015,2) - Quantidade recebida do item da nota fiscal de saída. |
| dadosGerais.cuponsFiscais.produtos.loteSerie | Set | |
| dadosGerais.cuponsFiscais.produtos.loteSerie.seqDls | Integer | (Opcional) - Number(006) - Sequência de movimento de item - Condição: Obrigatório quando o produto for controlado por lote/série. |
| dadosGerais.cuponsFiscais.produtos.loteSerie.codLot | String | (Opcional) - String(050) - Código do lote de fabricação para estocagem - Condição: Obrigatório quando o produto for controlado por lote/série. |
| dadosGerais.cuponsFiscais.produtos.loteSerie.numSep | String | (Obrigatório) - String(050) - Número de Série do Produto - Condição: Obrigatório quando o produto for controlado por lote/série. |
| dadosGerais.cuponsFiscais.produtos.loteSerie.qtdEst | String | (Obrigatório) - Number(014,5) - Quantidade a ser movimentada do estoque - Condição: Obrigatório quando o produto for controlado por lote/série. |
| dadosGerais.cuponsFiscais.produtos.vlrLiq | Double | (Obrigatório) - Number(015,2) - Valor líquido do item de produto da nota fiscal de saída. |
| dadosGerais.cuponsFiscais.produtos.seqIpv | Integer | (Obrigatório) - Number(003) - Sequência do item de produto da nota fiscal de saída. |
| dadosGerais.cuponsFiscais.produtos.PerSen | String | (Opcional) - Number(004,2) - Percentual do senar |
| dadosGerais.cuponsFiscais.produtos.VlrBsn | String | (Opcional) - Number(015,2) - Valor base do senar |
| dadosGerais.cuponsFiscais.produtos.VlrSen | String | (Opcional) - Number(015,2) - Valor do senar |
| dadosGerais.cuponsFiscais.servicos | Set | |
| dadosGerais.cuponsFiscais.servicos.codSer | String | (Obrigatório) - String(014) - Código do serviço da nota fiscal de entrada. |
| dadosGerais.cuponsFiscais.servicos.qtdRec | String | (Obrigatório) - Number(014,5) - Quantidade recebida do serviço da nota fiscal de entrada. |
| dadosGerais.cuponsFiscais.servicos.preUni | String | (Obrigatório) - Number(015,2) - Preço unitário do item de serviço da nota fiscal de saída. |
| dadosGerais.parcelas | Set | |
| dadosGerais.parcelas.numPar | Integer | (Obrigatório) - Number(003) - Número da parcela. |
| dadosGerais.parcelas.codFpg | Integer | (Obrigatório) - Number(002) - Código da forma de pagamento para geração de crédito ao cliente. |
| dadosGerais.parcelas.numCpr | String | (Opcional) - String(020) - Código do cartão presente a ser creditado. |
| dadosGerais.parcelas.vlrPar | String | Valor da parcela da nota de devolução. |
| dadosGerais.parcelas.numCoo | Integer | (Opcional) - Contador da Ordem de Operação que emitiu o recebimento na ECF |
| dadosGerais.parcelas.codRep | Integer | Código do representante |
| idtReq | String | (Opcional) - String(20) - Identificação da Requisição |
| sigInt | String | (Opcional) - 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:GerarDevolucao_2Response>
<result>
<tipoRetorno>Integer</tipoRetorno>
<retornosNotasEntrada>
<codEmp>String</codEmp>
<codFil>String</codFil>
<codFor>String</codFor>
<codSnf>String</codSnf>
<numNfc>String</numNfc>
<identificador>String</identificador>
<retorno>String</retorno>
<titulos>
<codTpt>String</codTpt>
<numTit>String</numTit>
<vlrTit>String</vlrTit>
</titulos>
</retornosNotasEntrada>
<mensagemRetorno>String</mensagemRetorno>
<erroExecucao>String</erroExecucao>
</result>
</ser:GerarDevolucao_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" |
| tipoRetorno | Integer | (Obrigatório) - Number(001) - Tipo de Retorno de Processamento - Lista: 1 = Processado, 2 = Erro na Solicitação |
| retornosNotasEntrada | Set | |
| retornosNotasEntrada.codEmp | String | (Obrigatório) - Number(004) - Código da empresa da nota fiscal de entrada. |
| retornosNotasEntrada.codFil | String | (Obrigatório) - Number(005) - Código da filial da nota fiscal de entrada. |
| retornosNotasEntrada.codFor | String | (Obrigatório) - Number(008) - Código do fornecedor da nota fiscal de entrada. |
| retornosNotasEntrada.codSnf | String | (Obrigatório) - String(003) - Código da série da nota fiscal de entrada. |
| retornosNotasEntrada.numNfc | String | (Obrigatório) - Number(009) - Número da nota fiscal de entrada. |
| retornosNotasEntrada.identificador | String | (Opcional) - String(250) - Identificador externo para identificar a nota no retorno. |
| retornosNotasEntrada.retorno | String | (Obrigatório) - String(1000) - Mensagem de Retorno da Gravação da Nota - Lista: OK = Processo Executado com Sucesso, Mensagem = Mensagem do problema ocorrido. |
| retornosNotasEntrada.titulos | Set | |
| retornosNotasEntrada.titulos.codTpt | String | (Obrigatório) - String(003) - Tipo do título - Condição: Retorna sempre que a nota gerar títulos a pagar. |
| retornosNotasEntrada.titulos.numTit | String | (Opcional) - String(015) - Número do Título - Condição: Retorna sempre que a nota gerar títulos a pagar. |
| retornosNotasEntrada.titulos.vlrTit | String | (Opcional) - String(003) - Valor do título - Condição: Retorna sempre que a nota gerar títulos a pagar. |
| mensagemRetorno | String | (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento |
English
Español
English
Español


