Web service com.senior.g5.co.int.vetorh.titulos
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.
Acesse a listagem de Classes dos web services para consultar as portas/operações disponíveis e as classes responsáveis pela execução das rotinas de integração.
WSDL
- Síncrono: http://example.com/g5-senior-services/sapiens_Synccom_senior_g5_co_int_vetorh_titulos?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_int_vetorh_titulos?wsdl
- Agendado: http://example.com/g5-senior-services/sapiens_Scheduledcom_senior_g5_co_int_vetorh_titulos?wsdl
Porta
Integrações - Gestao de Pessoas - Integrar Títulos CPA.
Necessita autenticação: sim.
Situação de versão: atual.
Versão: 1.
Observação
O identificador de regras CPA-501INTHI01 tem a finalidade de informar ao Gestão Empresarial | ERP se a integração de históricos do Gestão de Pessoas | HCM está ativo.
Com esse identificador ativo, a busca das informações do Banco, Agência e Conta Corrente terão um comportamento diferente.
1º informado no próprio web service;
2º do cadastro do fornecedor (se não tiver favorecido);
3º do cadastro do favorecido;
4º da conta bancária (primeira sequência da conta).
1º informado no próprio web service;
2º da conta bancária (última sequência da conta);
3º do cadastro do fornecedor (se não tiver favorecido);
4º do cadastro do favorecido.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:IntegrarTitulos>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<codEmp>Integer</codEmp>
<entradaTitulos>
<codFil>Integer</codFil>
<numTit>String</numTit>
<codTpt>String</codTpt>
<codFor>Integer</codFor>
<codTns>String</codTns>
<obsTcp>String</obsTcp>
<codFav>Double</codFav>
<docIdeFav>String</docIdeFav>
<codNtg>Integer</codNtg>
<numPrj>Integer</numPrj>
<codFpj>Integer</codFpj>
<ctaFin>Integer</ctaFin>
<ctaRed>Integer</ctaRed>
<codCcu>String</codCcu>
<codCrp>String</codCrp>
<datEmi>DateTime</datEmi>
<datEnt>DateTime</datEnt>
<vctOri>DateTime</vctOri>
<vlrOri>Double</vlrOri>
<codMoe>String</codMoe>
<vctPro>DateTime</vctPro>
<proJrs>String</proJrs>
<codMpt>String</codMpt>
<codFpg>Integer</codFpg>
<datNeg>DateTime</datNeg>
<jrsNeg>Double</jrsNeg>
<mulNeg>Double</mulNeg>
<dscNeg>Double</dscNeg>
<outNeg>Double</outNeg>
<cotNeg>Double</cotNeg>
<datPpt>DateTime</datPpt>
<antDsc>String</antDsc>
<datDsc>DateTime</datDsc>
<tolDsc>Integer</tolDsc>
<perDsc>Integer</perDsc>
<vlrDsc>Double</vlrDsc>
<codPor>String</codPor>
<codCrt>String</codCrt>
<codBan>String</codBan>
<tipTcc>Integer</tipTcc>
<codAge>String</codAge>
<ccbFor>String</ccbFor>
<titBan>String</titBan>
<codBar>String</codBar>
<priPgt>Integer</priPgt>
<perMul>Integer</perMul>
<tolMul>Integer</tolMul>
<jrsDia>Double</jrsDia>
<perJrs>Integer</perJrs>
<tipJrs>String</tipJrs>
<tolJrs>Integer</tolJrs>
<rateio>
<numPrj>Integer</numPrj>
<codFpj>Integer</codFpj>
<ctaFin>Integer</ctaFin>
<ctaRed>Integer</ctaRed>
<perCta>Double</perCta>
<vlrCta>Double</vlrCta>
<codCcu>String</codCcu>
<perRat>Double</perRat>
<vlrRat>Double</vlrRat>
<obsRat>String</obsRat>
</rateio>
<cotEmi>Double</cotEmi>
<vlrRba>Double</vlrRba>
<excTie>String</excTie>
<codDfs>Integer</codDfs>
<tpcPix>Integer</tpcPix>
<chvPix>String</chvPix>
<urlPix>String</urlPix>
</entradaTitulos>
<codFil>Integer</codFil>
<forCli>String</forCli>
</parameters>
</ser:IntegrarTitulos>
</soapenv:Body>
</soapenv:Envelope>
| Nome | Tipo | Preenchimento | Descrição |
|---|---|---|---|
| codEmp | Integer | Opcional | Number(004) - Código da Empresa |
| entradaTitulos | Set | Opcional | Lista de Títulos do Contas a Pagar |
| entradaTitulos.codFil | Integer | Opcional | Number(005) - Código da filial |
| entradaTitulos.numTit | String | Opcional | String(015) - Número do título a pagar |
| entradaTitulos.codTpt | String | Opcional | String(003) - Código do tipo do título a pagar |
| entradaTitulos.codFor | Integer | Opcional | Number(009) - Código do fornecedor do título a pagar |
| entradaTitulos.codTns | String | Opcional | String(005) - Código da transação origem do título a pagar |
| entradaTitulos.obsTcp | String | Opcional | String(250) - Observação para o título |
| entradaTitulos.codFav | Double | Opcional | Number(014) - Código do favorecido |
| entradaTitulos.docIdeFav | String | Opcional | String(014) - Código do favorecido |
| entradaTitulos.codNtg | Integer | Opcional | Number(004) - Código da natureza de gasto |
| entradaTitulos.numPrj | Integer | Opcional | Number(008) - Número do projeto |
| entradaTitulos.codFpj | Integer | Opcional | Number(004) - Código da fase do projeto |
| entradaTitulos.ctaFin | Integer | Opcional | Number(007) - Conta financeira reduzida |
| entradaTitulos.ctaRed | Integer | Opcional | Number(007) - Conta contábil reduzida |
| entradaTitulos.codCcu | String | Opcional | String(009) - Código do centro de custo |
| entradaTitulos.codCrp | String | Opcional | String(003) - Código do grupo de contas a pagar |
| entradaTitulos.datEmi | DateTime | Opcional | Date(DD/MM/YYYY) - Data de emissão do título a pagar |
| entradaTitulos.datEnt | DateTime | Opcional | Date(DD/MM/YYYY) - Data da entrada do título a pagar |
| entradaTitulos.vctOri | DateTime | Opcional | Date(DD/MM/YYYY) - Data do vencimento original do título a pagar |
| entradaTitulos.vlrOri | Double | Opcional | Number(015,2) - Valor original do título a pagar |
| entradaTitulos.codMoe | String | Opcional | String(003) - Código da moeda base do título a pagar |
| entradaTitulos.vctPro | DateTime | Opcional | Date(DD/MM/YYYY) - Data do vencimento atual do título a pagar |
| entradaTitulos.proJrs | String | Opcional | String(001) - Indicativo se a prorrogação do vencimento é com juros - [ S=Sim; N=Não ] |
| entradaTitulos.codMpt | String | Opcional | String(003) - Código do motivo de prorrogação do título |
| entradaTitulos.codFpg | Integer | Opcional | Number(002) - Código da forma de pagamento |
| entradaTitulos.datNeg | DateTime | Opcional | Date(DD/MM/YYYY) - Data base dos valores negociados (data até) |
| entradaTitulos.jrsNeg | Double | Opcional | Number(015,2) - Valor dos juros negociados |
| entradaTitulos.mulNeg | Double | Opcional | Number(015,2) - Valor da multa negociada |
| entradaTitulos.dscNeg | Double | Opcional | Number(015,2) - Valor dos descontos negociados |
| entradaTitulos.outNeg | Double | Opcional | Number(015,2) - Valor de outros valores negociados |
| entradaTitulos.cotNeg | Double | Opcional | Number(019,10) - Valor da cotação da moeda negociada |
| entradaTitulos.datPpt | DateTime | Opcional | Date(DD/MM/YYYY) - Data do provável pagamento do título |
| entradaTitulos.antDsc | String | Opcional | String(001) - Indicativo se calcula desconto por antecipação de pagamento - [ S=Sim; N=Não ] |
| entradaTitulos.datDsc | DateTime | Opcional | Date(DD/MM/YYYY) - Data/Tolerância válidas para desconto do título |
| entradaTitulos.tolDsc | Integer | Opcional | Number(004) - Dias de tolerância para desconto |
| entradaTitulos.perDsc | Integer | Opcional | Number(005,2) - Percentual de desconto a ser concedido ao título a pagar |
| entradaTitulos.vlrDsc | Double | Opcional | Number(015,2) - Valor do desconto a ser concedido ao título a pagar |
| entradaTitulos.codPor | String | Opcional | String(004) - Código do portador do título a pagar |
| entradaTitulos.codCrt | String | Opcional | String(002) - Código da carteira do título a pagar |
| entradaTitulos.codBan | String | Opcional | String(003) - Código do banco da conta corrente do fornecedor |
| entradaTitulos.tipTcc | Integer | Opcional | Number(002) - Tipo de conta - [ 01=Conta Corrente; 02=Conta Poupança; 03=Conta Investimento; 04=Conta Aplicação Financeira; 05=Conta Empréstimo; 06=Cota Capital; 07=Conta de Retenção; 08=Conta da Loja; 09=Conta Salário; 10=Outros ] |
| entradaTitulos.codAge | String | Opcional | String(007) - Código da agência do banco da conta corrente do fornecedor |
| entradaTitulos.ccbFor | String | Opcional | String(014) - Número da conta corrente do fornecedor no banco |
| entradaTitulos.titBan | String | Opcional | String(020) - Número do título a pagar no banco |
| entradaTitulos.codBar | String | Opcional | String(050) - Código de barras para pagamento eletrônico |
| entradaTitulos.priPgt | Integer | Opcional | Number(009) - Prioridade do pagamento do título a pagar |
| entradaTitulos.perMul | Integer | Opcional | Number(005,2) - Percentual de multa prevista para o título a pagar |
| entradaTitulos.tolMul | Integer | Opcional | Number(004) - Quantidade de dias de tolerância para a multa do título a pagar |
| entradaTitulos.jrsDia | Double | Opcional | Number(009,2) - Valor dos juros de mora ao dia a serem pagos no título a pagar |
| entradaTitulos.perJrs | Integer | Opcional | Number(005,2) - Percentual de juros de mora previsto para o título a pagar |
| entradaTitulos.tipJrs | String | Opcional | String(001) - Indicativo se os juros de mora são simples ou compostos - [ S=Juros Simples; C=Juros Compostos ] |
| entradaTitulos.tolJrs | Integer | Opcional | Number(004) - Quantidade de dias de tolerância para os juros de mora |
| rateio | Set | Opcional | Lista de Rateio dos Títulos |
| rateio.numPrj | Integer | Opcional | Number(008) - Número do projeto |
| rateio.codFpj | Integer | Opcional | Number(004) - Código da fase do projeto |
| rateio.ctaFin | Integer | Opcional | Number(007) - Conta financeira reduzida |
| rateio.ctaRed | Integer | Opcional | Number(007) - Conta contábil reduzida |
| rateio.perCta | Double | Opcional | Number(007,4) - Percentual rateado para a conta |
| rateio.vlrCta | Double | Opcional | Number(015,2) - Valor rateado para a conta |
| rateio.codCcu | String | Opcional | String(009) - Código do centro de custos |
| rateio.perRat | Double | Opcional | Number(007,4) - Percentual rateado para o centro de custos |
| rateio.vlrRat | Double | Opcional | Number(015,2) - Valor rateado para o centro de custos |
| rateio.obsRat | String | Opcional | String(120) - Observação do rateio |
| entradaTitulos.cotEmi | Double | Opcional | Number(019,10) - Valor da cotação da moeda na data de emissão do título |
| entradaTitulos.vlrRba | Double | Opcional | Number(015,2) - Valor de redução de base de IRRF |
| entradaTitulos.excTie | String | Opcional | <documente AQUI> |
| entradaTitulos.codDfs | Integer | Opcional | Number(006) - Código do dispositivo fiscal |
| entradaTitulos.tpcPix | Integer | Opcional | Number(001) - Tipo de Chave PIX - Pagamento Instantâneo - [ 1=Telefone; 2=E-mail; 3=CPF/CNPJ; 4=Chave Aleatória ] |
| entradaTitulos.chvPix | String | Opcional | String(100) - Chave PIX - Pagamento Instantâneo |
| entradaTitulos.urlPix | String | Opcional | String(100) - URL PIX - Pagamento Instantâneo |
| codFil | Integer | Opcional | Number(004) - Código da Filial |
| forCli | String | Opcional | Number(009) - Código do Fornecedor |
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/" <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:IntegrarTitulosResponse>
<result>
<gridResult>
<codEmp>Integer</codEmp>
<codFil>Integer</codFil>
<numTit>String</numTit>
<codTpt>String</codTpt>
<codFor>Integer</codFor>
<numInt>String</numInt>
<txtRet>String</txtRet>
</gridResult>
<resultado>String</resultado>
<erroExecucao>String</erroExecucao>
</result>
</ser:IntegrarTitulosResponse>
</soapenv:Body>
</soapenv:Envelope>
| Nome | Tipo | Descrição |
|---|---|---|
| gridResult | Set | Lista de Resultados do Processamento |
| gridResult.codEmp | Integer | Number(004) - Código da Empresa |
| gridResult.codFil | Integer | Number(004) - Código da Filial |
| gridResult.numTit | String | String(15) - Número do Título a Pagar |
| gridResult.codTpt | String | String(3) - Código do Tipo do Título a Pagar |
| gridResult.codFor | Integer | Number(9) - Código do Fornecedor |
| gridResult.numInt | String | Número(001) - Tipo de Retorno de Processamento - Lista: 0 = Processado, -1 = Erro na Solicitação |
| gridResult.txtRet | String | String(1000) - Mensagem de Retorno de Processamento |
| resultado | String | O campo resultado irá retornar as seguintes mensagens: Execução do serviço sem erros: "OK" -> Verificar títulos baixados e gerados na grid "Retorno" Execução do serviço com erros: "ERRO" -> Analizar os erros na grid "Retorno" |
| 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" |
English
Español
English
Español


