Web service com.senior.g5.rh.plr.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 parâmetros específicos, alguns dos quais podem ser comuns a todas as portas de web service.

Autenticação

Quando for utilizada alguma forma de autenticação na integração de informações por meio de web services, é necessário informar o tipo correspondente no parâmetro <encryption>, conforme os valores possíveis.

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 caso contrário será considerada a data de criação como data de início da hierarquia. Valores: S- Sim N- Não Máscara: U[1]
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:

Nota

O envelope SOAP é retornado como resposta para requisições síncronas. Já para requisições assíncronas ou agendamentos, a resposta consiste apenas em uma string chamada result, que retorna o valor “OK” quando a execução ocorre com sucesso ou, em caso de falha, 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>

Parâmetros da requisição:

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.

PORTAL DE DOCUMENTAÇÃO
Gestão de Pessoas \| HCM - versão 6.10.4