Web service Com.senior.g5.co.mct.ctb.criteriodedistribuicao
O serviço de Critério de Distribuição é usado para inserir, alterar e excluir critérios de distribuição, bem como suas definições utilizando a porta Integrar.
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_mct_ctb_criteriodedistribuicao?wsdl
- Assíncrono: http://example.com/g5-senior-services/sapiens_Asynccom_senior_g5_co_mct_ctb_criteriodedistribuicao?wsdl
- Agendado:http://example.com/g5-senior-services/sapiens_Schedulecom_senior_g5_co_mct_ctb_criteriodedistribuicao?wsdl
Porta
Esta porta tem finalidade de manipular os critérios e suas definições.
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:Integrar> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <CriteriosDistribuicao> <codEmp>Integer</codEmp> <codCri>Integer</codCri> <desCri>String</desCri> <sitCri>String</sitCri> <codCcu>String</codCcu> <deletar>String</deletar> <detalhes> <codFil>Integer</codFil> <mesAno>DateTime</mesAno> <codCcu>String</codCcu> <ctaAux>Integer</ctaAux> <qtdDis>Double</qtdDis> <perDis>Double</perDis> </detalhes> </CriteriosDistribuicao> </parameters> </ser:Integrar> </soapenv:Body> </soapenv:Envelope>
Nome | Tipo | Preenchimento | Ajuda |
---|---|---|---|
criteriosDistribuicao | Set | Obrigatório | Lista de critérios de distribuição |
criteriosDistribuicao.codEmp | Integer | Obrigatório | Number(004) - Código da empresa |
criteriosDistribuicao.codCri | Integer | Opcional | Number(006) - Código do critério, pra incluir um novo critério deve ser informado zero. |
criteriosDistribuicao.desCri | String | Opcional | String(100) - Descrição do critério |
criteriosDistribuicao.sitCri | String | Opcional | String(001) - Situação do critério |
criteriosDistribuicao.codCcu | String | Opcional | String(009) - Código do centro de custos |
criteriosDistribuicao.deletar | String | Opcional | String(001) - Indicativo para exclusão de registro. Só para excluir e Não para não excluir |
detalhes | Set | Opcional | Lista de definições de critério |
detalhes.codFil | Integer | Obrigatório | Number(005) - Código da filial |
detalhes.mesAno | DateTime | Obrigatório | Date(DD/MM/YYYY) - Competência de cadastro do critério |
detalhes.codCcu | String | Opcional | String(009) - Código do centro de custos |
detalhes.ctaAux | Integer | Opcional | Number(009) - Número reduzido da conta auxiliar |
detalhes.qtdDis | Double | Opcional | Number(011) - Quantidade proporcional de distribuição |
detalhes.perDis | Double | Opcional | Number(007) - Percentual de distribuição |
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:IntegrarResponse> <result> <Erros> <mensagemErro>String</mensagemErro> </Erros> <tipoRetorno>Integer</tipoRetorno> <mensagemRetorno>String</mensagemRetorno> <Criterios> <codEmp>String</codEmp> <codCri>Integer</codCri> </Criterios> <erroExecucao>String</erroExecucao> </result> </ser:IntegrarResponse> </soapenv:Body> </soapenv:Envelope>
Nome | Tipo | Preenchimento | Ajuda |
---|---|---|---|
Erros | Set | Opcional | (Opcional) - Lista dos erro |
Erros.MensagemErro | String | Opcional | (Opcional) - Itens da lista de erros |
MensagemRetorno | String | Obrigatório | (Obrigatório) - String(1000) - Mensagem de Retorno de Processamento |
criterios | Set | Opcional | Lista de critério alterados |
criterios.codEmp | String | Opcional | Number(004) - Código da empresa |
criterios.codCri | Integer | Opcional | Number(006) - Código do critério |
TipoRetorno | Integer | Obrigatório | (Obrigatório) - Number(001) - Tipo de Retorno de Processamento - Lista: 0 = Processado, -1 = Erro na Solicitação |
erroExecucao | String | Opcional | 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 sucesso; - A mensagem do erro ocorrido no servidor. |