Gestão de Pessoas - Manual do Usuário > Integrações com outros sistemas > Web services > Controle de Ponto e Refeitório > Com.senior.g5.rh.hr.locais

Web service com.senior.g5.rh.hr.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

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:

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.

Este artigo ajudou você?