Web service com.senior.g5.rh.fp.locais
Atualmente, o campo tabOrg tem um limite de 4 dígitos (9999) apenas para os usuários que utilizam o banco de dados SQL Server. Para os usuários que utilizam o banco de dados Oracle, o limite do campo tabOrg é de 3 dígitos (999). Para esses usuários, a rotina de organograma com 4 dígitos está em desenvolvimento, com previsão para ser liberada em 29/09/2023.
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 identificado o tipo no parâmetro <encryption>, conforme seus valores possíveis.
WSDL
- Síncrono: http://example.com/g5-senior-services/rubi_Synccom_senior_g5_rh_fp_locais?wsdl
- Assíncrono: http://example.com/g5-senior-services/rubi_Asynccom_senior_g5_rh_fp_locais?wsdl
- Agendado: http://example.com/g5-senior-services/rubi_Scheduledcom_senior_g5_rh_fp_locais?wsdl
Porta
Local_2
Web service para manutenção do cadastro de locais de organograma.
Necessita autenticação: Sim
Situação de versão: Atual
Versão: 2
Requisição:
<soapenv:Envelope xmlns:ser="http://services.senior.com.br" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Body> <ser:Local> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <tabOrg>Integer</tabOrg> <codLoc>String</codLoc> <nomLoc>String</nomLoc> <locPai>String</locPai> <codRat>Integer</codRat> <datCri>DateTime</datCri> <datExt>DateTime</datExt> <datUH>String</datUH> <datExc>DateTime</datExc> <conPPP>String</conPPP> <tabFeD>Integer</tabFeD> <tabFeN>Integer</tabFeN> <ferOfD>Integer</ferOfD> <ferOfN>Integer</ferOfN> <tipOpe>String</tipOpe> </parameters> </ser:Local> </soapenv:Body> </soapenv:Envelope>
Parâmetros da requisição:
Nome | Preenchimento | Tipo | Descrição |
---|---|---|---|
tabOrg | Obrigatório | Integer | Código da Tabela de Organograma.
- Obrigatório - Chave - Máscara: 9[4] |
codLoc | Obrigatório | String | Corresponde ao código do local, ou apelido, podendo ser alfanumérico.
- Campo Chave - Obrigatório - Máscara: Especial, sendo que são 9 digitos numéricos + separadores |
nomLoc | Opcional | String | Informar a nomenclatura do local: Exemplo: Depto Financeiro - Contas a pagar.
- Máscara: A[60] |
locPai | Opcional | String | Local pai corresponde ao local que está acima do que está sendo inserido
- Obrigatório para inclusões. - Máscara: Especial, sendo que são 9 digitos numéricos + separadores |
codRat | Opcional | Integer | Se a empresa utilizar a rotina de rateio de mão-de-obra por local, neste campo deverá constar o código do rateio correspondente a esse local.
- Máscara: 9[9] |
datCri | Opcional | DateTime | Data da criação do local na estrutura.
- Opcional - Máscara: DD/MM/YYYY |
datExt | Opcional | DateTime | Informar a data de extição do local.
- Opcional - Máscara: DD/MM/YYYY |
datUH | Opcional | String |
Informar Sim para considerar a última data de início da hierarquia do organograma, somente disponível na ação de inclusão. Caso contrário, será considerada a data de criação como data de início do local no organograma. |
datExc | Opcional | DateTime | Informar a data de exclusão do local.
- Obrigatório quando a ação for de Exclusão. - Máscara: DD/MM/YYYY |
conPPP | Opcional | String | Este campo é utilizado somente no módulo Segurança.
Informar Sim para considerar este local na emissão do PPP caso contrário( Não), o local não será considerado. - Valores: S- Sim N- Não - Máscara: U[1] |
tabFeD | Opcional | Integer | Informar o código da tabela de feriados diurna que será utilizada pelos colaboradores alocados neste local.
- Opcional - Máscara: 9[4] |
tabFeN | Opcional | Integer | Informar o código da tabela de feriados noturna que será utilizada pelos colaboradores alocados neste local.
- Opcional - Máscara: 9[4] |
ferOfD | Opcional | Integer | Informar a tabela de feriados diurna que contenha somente feriados nacionais, para fins de cálculo do Vale Transporte.
- Opcional - Máscara: 9[4] |
ferOfN | Opcional | Integer | Informar a tabela de feriados noturna que contenha somente feriados nacionais, para fins de cálculo do Vale Transporte.
- Opcional - Máscara: 9[4] |
tipOpe | Opcional | String | Tipo da operação a ser efetuada na integração
- Obrigatório "I" - Inclusão "A" - Alteração "E" - Exclusão Se não for informado, será considerado "alteraçã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:ser="http://services.senior.com.br" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Body> <ser:LocalResponse> <result> <status> <numLoc>String</numLoc> <codLoc>String</codLoc> <mensagem>String</mensagem> </status> <erroExecucao>String</erroExecucao> </result> </ser:LocalResponse> </soapenv:Body> </soapenv:Envelope>
Atributos da resposta:
Nome | Preenchimento | Tipo | Descrição |
---|---|---|---|
status | Opcional | Set | Indica retorno do registro processado ao executar o web service. |
status.numLoc | Opcional | String | Número do Local inserido\alterado. |
status.codLoc | Opcional | String | Código do Local inserido\alterado. |
status.mensagem | Opcional | String | A mensagem de sucesso relacionada ao registro processado. |
erroExecucao | Opcional | 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 sucesso; - A mensagem do erro ocorrido no servidor. |