English
Español
Web service Com.senior.g5.co.int.gs.titulo.receber
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_gs_titulo_receber?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_int_gs_titulo_receber?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Schedulecom_senior_g5_co_int_gs_titulo_receber?wsdl
Porta(s)
Substituir
Esta porta tem como objetivo realizar a baixa de pagamentos realizados no caixa do Gestão de Supermercados Senior, levando em consideração que o mesmo não conhece regras de negócio do Gestão Empresarial | ERP.
O Gestão de Supermercados irá realizar uma chamada desse serviço sempre que houver um pagamento em mais de uma forma de pagamento no Gestão de Supermercados.
Em caso de pagamento em cartão, o sistema usa os dados de cartão para realizar a substituição dos títulos contra a operadora, além de criar títulos para cada uma das parcelas a serem pagas. Em caso de pagamento com cheque, o sistema irá realizar a substituição do título (ou vários títulos) contra o cheque em questão. O sacado, nesse caso, precisa ser um cliente cadastrado no Gestão Empresarial | ERP.
Demais pagamentos está sendo tratado em dinheiro, onde será feita a própria baixa e movimentação.
Necessita autenticação: Sim.
Situação da versão: Atual.
Versão: 1.
Versão atual: 1.
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:Substituir>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<sistemaIntegracao>String</sistemaIntegracao>
<movimento>
<ideExt>Integer</ideExt>
<usuBai>Double</usuBai>
<cartao>
<catExt>String</catExt>
<qtdPar>Integer</qtdPar>
<catTef>String</catTef>
<nsuTef>String</nsuTef>
<codOpe>Integer</codOpe>
<debCre>String</debCre>
<banCar>String</banCar>
<nsuHst>String</nsuHst>
<vlrPar>Double</vlrPar>
<codFpg>Integer</codFpg>
</cartao>
<cheque>
<cheBan>String</cheBan>
<cheAge>String</cheAge>
<cheCta>String</cheCta>
<cheNum>String</cheNum>
<codBar>String</codBar>
<codSac>String</codSac>
<vctChe>DateTime</vctChe>
<codFpg>Integer</codFpg>
<vlrChe>Double</vlrChe>
</cheque>
<codFil>Integer</codFil>
<codEmp>Integer</codEmp>
<datPgt>DateTime</datPgt>
<vlrTro>Double</vlrTro>
<numPdv>Integer</numPdv>
<titulos>
<codFil>Integer</codFil>
<numTit>String</numTit>
<codTpt>String</codTpt>
<vlrPag>Double</vlrPag>
<vlrJur>Double</vlrJur>
<vlrMul>Double</vlrMul>
<vlrDsc>Double</vlrDsc>
<vlrAcr>Double</vlrAcr>
</titulos>
<outrospagamentos>
<codFpg>Integer</codFpg>
<vlrPar>Double</vlrPar>
</outrospagamentos>
</movimento>
</parameters>
</ser:Substituir>
</soapenv:Body>
</soapenv:Envelope>
Parâmetros da requisição:
| Nome | Tipo | Preenchimento | Descrição |
|---|---|---|---|
| sistemaIntegracao | String | Opcional | Sigla do sistema integrado |
| movimento | Set | Opcional | Movimentos gerados |
| movimento.ideExt | Integer | Opcional | Identificação externa do movimento |
| movimento.usuBai | Double | Opcional | Usuário que efetuou a baixa |
| cartao | Set | Opcional | Pagamentos com cartão |
| cartao.catExt | String | Opcional | Código de autorização externo |
| cartao.qtdPar | Integer | Opcional | Quantidade de parcelas |
| cartao.catTef | String | Opcional | Código de autorização do TEF |
| cartao.nsuTef | String | Opcional | Número sequencial único da transação |
| cartao.codOpe | Integer | Opcional | Código da operadora |
| cartao.debCre | String | Opcional | Indicativos se venda é débito ou crédito (D/C) |
| cartao.banCar | String | Opcional | Bandeira do cartão |
| cartao.nsuHst | String | Opcional | NSU do host autorizador |
| cartao.vlrPar | Double | Opcional | Valor do pagamento |
| cartao.codFpg | Integer | Opcional | Código da forma de pagamento |
| cheque | Set | Opcional | Pagamentos com cheque |
| cheque.cheBan | String | Opcional | Banco do cheque |
| cheque.cheAge | String | Opcional | Agência do cheque |
| cheque.cheCta | String | Opcional | Número da conta |
| cheque.cheNum | String | Opcional | Número do cheque |
| cheque.codBar | String | Opcional | CMC7 do cheque |
| cheque.codSac | String | Opcional | Código do sacado (CPF ou CNPJ do dono do cheque) |
| cheque.vctChe | DateTime | Opcional | Vencimento do cheque |
| cheque.codFpg | Integer | Opcional | Código da forma de pagamento |
| cheque.vlrChe | Double | Opcional | Valor do cheque |
| movimento.codFil | Integer | Opcional | Código da Filial que está realizando o movimento |
| movimento.codEmp | Integer | Opcional | Código da empresa que está realizando o movimento |
| movimento.datPgt | DateTime | Opcional | Data em que o pagamento foi realizado |
| movimento.vlrTro | Double | Opcional | Valor do troco (em caso de existência) |
| movimento.numPdv | Integer | Opcional | Número do PDV |
| titulos | Set | Opcional | Títulos pagos no processo |
| titulos.codFil | Integer | Opcional | Código da Filial |
| titulos.numTit | String | Opcional | Número do título |
| titulos.codTpt | String | Opcional | Código do tipo de título |
| titulos.vlrPag | Double | Opcional | Valor total pago |
| titulos.vlrJur | Double | Opcional | Valor dos juros |
| titulos.vlrMul | Double | Opcional | Valor da multa |
| titulos.vlrDsc | Double | Opcional | Valor dos descontos concedidos |
| titulos.vlrAcr | Double | Opcional | Valor dos acréscimos cobrados |
| outrospagamentos | Set | Opcional | Outros pagamentos que não estejam em cheque/cartão (basicamente dinheiro) |
| outrospagamentos.codFpg | Integer | Opcional | Código da forma de pagamento |
| outrospagamentos.vlrPar | Double | Opcional | Valor do pagamento |
Resposta:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:SubstituirResponse>
<result>
<retorno>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<chvlot>String</chvlot>
<ideExt>Integer</ideExt>
<detalhes>
<txtRet>String</txtRet>
<tipRet>Integer</tipRet>
</detalhes>
<tipRet>Integer</tipRet>
<msgRet>String</msgRet>
</retorno>
<mensagemRetorno>String</mensagemRetorno>
<tipoRetorno>String</tipoRetorno>
<erroExecucao>String</erroExecucao>
</result>
</ser:SubstituirResponse>
</soapenv:Body>
</soapenv:Envelope>
Atributos da resposta:
| Nome | Tipo | Preenchimento | Descrição |
|---|---|---|---|
| retorno | Set | Opcional | |
| retorno.codEmp | Integer | Opcional | |
| retorno.codFil | Integer | Opcional | |
| retorno.chvlot | String | Opcional | |
| retorno.ideExt | Integer | Opcional | |
| detalhes | Set | Opcional | |
| detalhes.txtRet | String | Opcional | |
| detalhes.tipRet | Integer | Opcional | |
| retorno.tipRet | Integer | Opcional | |
| retorno.msgRet | String | Opcional | |
| mensagemRetorno | String | Opcional | |
| tipoRetorno | String | Opcional | |
| erroExecucao | String | Opcional |
English
Español
