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

Síncrono: http://example.com/g5-senior-services/ronda_Synccom_senior_g5_rh_hr_locais?wsdl
Assíncrono: http://example.com/g5-senior-services/ronda_Asynccom_senior_g5_rh_hr_locais?wsdl
Agendado: http://example.com/g5-senior-services/ronda_Scheduledcom_senior_g5_rh_hr_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 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.