Web service com.senior.g5.rh.hr.lgpd.QueryLGPDData
Serviço responsável por buscar os dados pessoais do titular das informações, indicando se cada informação é sensível e/ou legal.
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://servidor:1234/g5-senior-services/rubi_Synccom_senior_g5_rh_hr_lgpd?wsdl
- Assíncrono: http://servidor:1234/g5-senior-services/rubi_Asynccom_senior_g5_rh_hr_lgpd?wsdl
- Agendamento: http://servidor:1234/g5-senior-services/rubi_Schedulecom_senior_g5_rh_hr_lgpd?wsdl
QueryLGPDData
Necessita autenticação: Sim
Situação da versão: Atual
Versão: 1
Versão atual: 1
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:QueryLGPDData> <user>String</user> <password>String</password> <encryption>Integer</encryption> <parameters> <camposPesquisa>String</camposPesquisa> </parameters> </ser:QueryLGPDData> </soapenv:Body> </soapenv:Envelope>
Parâmetros da requisição:
Nome | Tipo | Preenchimento | Ajuda |
---|---|---|---|
camposPesquisa | String | Opcional | Como entrada, o webservice espera um JSON passando as informações que devem ser usadas nos campos de pesquisa/filtro. |
No mapeamento padrão do RH há as seguintes opções:
- nome: nome da pessoa natural, no qual se deseja buscar as informações pessoais.
- cpf: número do CPF da pessoa natural, no qual se deseja buscar as informações pessoais. Documento principal obrigatório para pesquisa, exceto no caso de a pessoa ser estrangeira e não possuir CPF; nesse caso, deverá ser informado o Registro de Estrangeiro (registro_estrangeiro).
- rg: número do RG da pessoa natural, no qual se deseja buscar as informações pessoais.
- cnh: número da CNH da pessoa natural, no qual se deseja buscar as informações pessoais.
- pis: número do PIS da pessoa natural, no qual se deseja buscar as informações pessoais.
- passaporte: número do Passaporte da pessoa natural, no qual se deseja buscar as informações pessoais.
- registro_estrangeiro: rúmero do Registro do Estrangeiro da pessoa natural, no qual se deseja buscar as informações pessoais. Deve ser informado no caso de colaborador estrangeiro que não possui CPF.
- empresa: permite informar uma empresa ou uma abrangência de empresas que se deseja considerar na pesquisa.
- numero_inscricao: permite informar o Número de Inscrição da empresa na qual se deseja que sejam buscadas as informações da pessoa.
{"nome":"Nome da pessoa","cpf":"99999999999","rg":"99999999"}
Resposta:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br"> <soapenv:Body> <ser:QueryLGPDDataResponse> <result> <retorno>String</retorno> <status>Integer</status> <erroExecucao>String</erroExecucao> </result> </ser:QueryLGPDDataResponse> </soapenv:Body> </soapenv:Envelope>
Atributos da resposta:
Nome | Tipo | Preenchimento | Ajuda |
---|---|---|---|
retorno | String | Opcional | JSON contendo: nome da pessoa que teve os dados pesquisados, documento principal da pessoa e relação de informações encontradas da pessoa. |
status | Integer | Opcional | 1 - OK; 2 - ERROR |
erroExecucao | String | Opcional | Mensagem do erro |
No JSON de retorno conterá:
- Nome da pessoa natural que teve os dados pesquisados;
- Documento principal da pessoa;
- Relação de informações encontradas da pessoa, sendo divididas por entidades, onde cada entidade por conter N campos e pode conter N outras subentidades.
No mapeamento padrão da Senior, haverá duas entidades no primeiro nível para agrupar as informações: uma para reunir as informações por empresa (como Empregado, Dependente) e outra para agrupar as entidades que valem para todas empresas (ecomo Pessoa, Candidato).
Dentro dessas entidades "agrupadoras" estarão contidas as entidades em si, que, por sua vez, conterão as informações da pessoa natural. Ou seja, dentro de cada entidade haverá uma lista de campos de acordo com as informações pessoais mapeadas, podendo haver subentidades, e assim sucessivamente.
{ "personName": "Nome do Colaborador", "identificationDocument": "CPF", "identificationDocumentValue": "999.999.999-99", "entities": [ { "description": "Informações por empresa", "properties": [ { "description": "Razão Social", "value": "Demonstra S/A - Matriz", "legalInfo": false, "sensibleInfo": false }, { "description": "Tipo de Inscrição", "value": "CNPJ", "legalInfo": false, "sensibleInfo": false }, { "description": "Número de Inscrção", "value": "12345678010158", "legalInfo": false, "sensibleInfo": false } ], "entities": [ { "description": "Empregado", "properties": [ { "description": "Nome", "value": "Nome do Colaborador", "legalInfo": true, "sensibleInfo": false }, { "description": "CPF", "value": "99999999999", "legalInfo": true, "sensibleInfo": false }, { "description": "PIS", "value": "999999999", "legalInfo": true, "sensibleInfo": false }, { "description": "Sexo", "value": "Masculino", "legalInfo": true, "sensibleInfo": false }, { "description": "Estado Civil", "value": "Solteiro", "legalInfo": true, "sensibleInfo": false }, { "description": "Data de Nascimento", "value": "20/05/1973", "legalInfo": true, "sensibleInfo": false }, { "description": "Nacionalidade", "value": "Brasileiro", "legalInfo": true, "sensibleInfo": false }, { "description": "Raça/Cor", "value": "Branca", "legalInfo": true, "sensibleInfo": true } ], "entities": [ { "description": "Ficha Complementar", "properties": [ { "description": "País (Endereço)", "value": "Brasil", "legalInfo": true, "sensibleInfo": false }, { "description": "Estado (Endereço)", "value": "Santa Catarina", "legalInfo": true, "sensibleInfo": false } { "description": "Cidade (Endereço)", "value": "BLUMENAU", "legalInfo": true, "sensibleInfo": false }, { "description": "Bairro (Endereço)", "value": "CENTRO", "legalInfo": false, "sensibleInfo": false }, { "description": "Tipo de Logradouro", "value": "Rua", "legalInfo": true, "sensibleInfo": false }, { "description": "Endereço", "value": "Beinjamim Constant", "legalInfo": true, "sensibleInfo": false } ] } ] } ] }, { "description": "Informações gerais", "properties": [ ], "entities": [ { "description": "Pessoa", "properties": [ { "description": "Nome", "value": "Nome da pessoa", "legalInfo": true, "sensibleInfo": false }, { "description": "Raça/Cor", "value": "Branca", "legalInfo": true, "sensibleInfo": true } ] } ] } ] }