Gestão de Pessoas - senior X - Manual do Usuário > Admissão Digital > Integrações > Integração via APIs > Buscar as pré-admissões por status (preAdmissionListQuery)

Buscar as pré-admissões por status — APIs da Admissão Digital

Busca todas as pré-admissões finalizadas que apresentam um status específico e de um determinado período, listando as informações completas de cada uma.

A lista de pré-admissões tem paginação, ou seja, somente alguns registros são exibidos em cada página.

Algumas regras são aplicadas na busca das pré-admissões:

A quantidade de registros por página não pode ser superior a 30 registros (a quantidade padrão é igual a 10).
O período de admissão não pode ser superior a 31 dias.
A ordenação das pré-admissões será efetuada por data de admissão. Se houver mais de uma pré-admissão com a mesma data de admissão, a ordenação será pelo nome do novo colaborador.

URL

POST <url_plataforma>/t/senior.com.br/bridge/1.0/rest/hcm/onboardingintegration/queries/preAdmissionListQuery

Substitua <url_plataforma> pela URL correspondente ao seu ambiente. Se for o ambiente de produção, substitua por: https://platform.senior.com.br

Cabeçalho (Header)

Authorization	Bearer <access_token>
Content-Type	application/json

Substitua <access_token> pela chave de acesso obtida a partir da API de autenticação na plataforma.

Parâmetros

* Obrigatórios

Parâmetro	Tipo	Descrição
startDate *	Date	Data inicial para a pesquisa pela data de admissão. Formato esperado: `AAAA-MM-DD`
endDate *	Date	Data final para a pesquisa pela data de admissão. Formato esperado: `AAAA-MM-DD`
status *	String	Status atual da pré-admissão. Valores permitidos: `UNREAD` = Não lido `READ` = Lido `EXPIRED` = Expirado `IN_VALIDATION` = Em validação `FINISHED` = Finalizado `PENDING_ADMISSION` = Admissão pendente `STARTED_ADMISSION` = Admissão iniciada `FINISHED_ADMISSION` = Admissão concluída
size	Integer	Quantidade de registros que deve ser apresentada em cada página. Quando não é informado, o tamanho padrão das páginas é de 10 registros. O limite de registros por página é 30.
page	Integer	Número da página atual. A primeira página inicia em 0 (zero). Quando não é informado, a página padrão é 0 (zero).

Exemplo

{
  "startDate": "2019-05-01",
  "endDate": "2019-05-15",
  "status": "IN_VALIDATION",
  "size": 10,
  "page": 0
}

Respostas

Código

Descrição

Campos da resposta

200

Campo		Tipo	Descrição
result { }			Resultados da requisição.
	totalElements	Integer	Total de pré-admissões encontradas.
	totalPages	Integer	Total de páginas encontradas.
	contents { }		Relação das pré-admissões relacionadas à página.

Conteúdo de contents:

Campo	Tipo	Descrição
preAdmissionId	String	Identificador único da pré-admissão.
admissionDate	String	Data em que o novo colaborador será admitido.
contract { }		Informações de contrato com a empresa.
personalData { }		Informações pessoais do novo colaborador.
document { }		Documentos do novo colaborador.
dependents { }		Relação de dependentes do novo colaborador.

Conteúdo de contract:

Campo	Tipo	Descrição
employeeType	String	Tipo do colaborador.
employeeContract	String	Tipo de contrato.
eSocialCategory	String	Categoria do eSocial.
sefipCategory	String	Categoria da SEFIP.
unemploymentInsurance	String	Tipo do seguro desemprego.
raisType	String	Vínculo da RAIS.
customFields { }		Campos customizados.

Conteúdo de personalData:

Campo		Tipo	Descrição
basic { }			Informações básicas do novo colaborador.
	employeeFullName	String	Nome completo.
	gender	String	Gênero.
	birthDate	String	Data de nascimento.
	preferredName	String	Nome pelo qual prefere ser chamado.
	mothersName	String	Nome da mãe.
	fathersName	String	Nome do pai.
	customFields { }		Campos customizados.
complementary { }			Informações complementares do novo colaborador.
	maritalStatus	String	Estado civil.
	degreeOfEducation	String	Grau de instrução.
	nationality	String	Nacionalidade.
	religion	String	Religião.
	race	String	Raça/Cor.
	socialName	String	Nome social.
	customFields { }		Campos customizados.
birthPlace { }			Informações do local de nascimento do novo colaborador.
	country	String	País do local de nascimento.
	state	String	Estado do local de nascimento.
	city	String	Cidade do local de nascimento.
	customFields { }		Campos customizados.
address { }			Informações do endereço do novo colaborador.
	country	String	País.
	state	String	Estado/unidade federativa.
	city	String	Cidade.
	cep	String	CEP.
	neighborhood	String	Bairro.
	addressType	String	Logradouro.
	address	String	Endereço.
	number	String	Número do endereço.
	additional	String	Informações adicionais sobre o endereço.
	customFields { }		Campos customizados.
email { }			E-mails de contato do novo colaborador.
	firstType	String	Tipo do e-mail principal.
	firstEmail	String	E-mail principal do novo colaborador.
	secondType	String	Tipo do e-mail secundário.
	secondEmail	String	E-mail secundário do novo colaborador.
	customFields { }		Campos customizados.
phone { }			Telefones de contato do novo colaborador.
	firstType	String	Tipo do telefone principal.
	firstPhone	String	Telefone principal do novo colaborador.
	secondType	String	Tipo do telefone secundário.
	secondPhone	String	Telefone secundário do novo colaborador.
	customFields { }		Campos customizados.

Conteúdo de document:

Campo		Tipo	Descrição
cpf { }			Informações do Cadastro de Pessoa Física (CPF) do novo colaborador.
	number	String	Número do documento.
	customFields { }		Campos customizados.
pis { }			Informações do Programa de Integração Social (PIS) do novo colaborador.
	number	String	Número do documento.
	issueDate	String	Data de emissão do documento.
	customFields { }		Campos customizados.
ctps { }			Informações da Carteira de Trabalho e Previdência Social (CTPS) do novo colaborador.
	number	String	Número do documento.
	serie	String	Número de série do documento.
	digit	String	Dígito do número do documento.
	issuerState	String	Estado de emissão do documento.
	issueDate	String	Data de emissão do documento.
	customFields { }		Campos customizados.
rg { }			Informações do Registro Geral (RG) do novo colaborador.
	number	String	Número do documento.
	issuer	String	Órgão emissor do documento.
	issuerState	String	Estado de emissão do documento.
	issueDate	String	Data de emissão do documento.
	customFields { }		Campos customizados.
passport { }			Informações do Passaporte do novo colaborador.
	number	String	Número do documento.
	issuer	String	Órgão emissor do documento.
	issueDate	String	Data de emissão do documento.
	expiryDate	String	Data de validade do documento.
	issuerCountry	String	País de emissão do documento.
	issuerState	String	Estado de emissão do documento.
	customFields { }		Campos customizados.
ric { }			Informações do Registro de Identidade Civil (RIC) do novo colaborador.
	number	String	Número do documento.
	issuer	String	Órgão emissor do documento.
	issuerCity	String	Cidade de emissão do documento.
	issuerState	String	Estado de emissão do documento.
	issueDate	String	Data de emissão do documento.
	expiryDate	String	Data de validade do documento.
	customFields { }		Campos customizados.
voter { }			Informações do Título de Eleitor do novo colaborador.
	number	String	Número do documento.
	votingDistrict	String	Zona eleitoral do documento.
	votingSection	String	Seção de votação do documento.
	issueDate	String	Data de emissão do documento.
	issuerCity	String	Cidade de emissão do documento.
	issuerState	String	Estado de emissão do documento.
	customFields { }		Campos customizados.
cnh { }			Informações da Carteira Nacional de Habilitação (CNH) do novo colaborador.
	number	String	Número do documento.
	category	String	Categoria da habilitação.
	issuer	String	Órgão emissor do documento.
	issuerState	String	Estado de emissão do documento.
	issueDate	String	Data de emissão do documento.
	expiryDate	String	Data de validade do documento.
	firstDriverLicenseDate	String	Data da primeira habilitação.
	customFields { }		Campos customizados.
reservist { }			Informações do Certificado de Reservista do novo colaborador.
	number	String	Número do documento.
	serie	String	Número de série do documento.
	ra	String	Número do Registro de Alistamento (RA).
	exemptionDate	String	Data de dispensa.
	hasCertificate	Boolean	Indica se a pessoa tem certificado de reservista.
	customFields { }		Campos customizados.
civilCertificate { }			Informações da Certidão Civil do novo colaborador.
	type	String	Tipo da certidão.
	issueDate	String	Data de emissão do documento.
	registry	String	Matrícula da certidão.
	term	String	Termo da certidão.
	book	String	Livro da certidão.
	sheet	String	Folha da certidão.
	notaryOffice	String	Cartório da certidão.
	issuerCity	String	Cidade de emissão do documento.
	issuerState	String	Estado de emissão do documento.
	customFields { }		Campos customizados.
cns { }			Informações do Cartão Nacional de Saúde (CNS) do novo colaborador.
	number	String	Número do documento.
	customFields { }		Campos customizados.
dnv { }			Informações da Declaração de Nascido Vivo (DNV) do novo colaborador.
	number	String	Número do documento.
	customFields { }		Campos customizados.
bankAccount { }
	bank	String	Identificador do banco.
	branch	String	Número da agência bancária.
	accountType	String	Tipo da conta.
	bankAccount	String	Conta bancária.
	digit	String	Dígito da conta.
	customFields { }		Campos customizados.
receiveSalaryAdvance		String	Indicativo se o novo colaborador gostaria de receber adiantamento salarial.

Conteúdo de dependents:

Campo		Tipo	Descrição
fullName		String	Nome completo do dependente.
degreeOfKinship		String	Grau de parentesco com o dependente.
gender		String	Gênero do dependente.
birthDate		String	Data de nascimento do dependente.
mothersName		String	Nome da mãe do dependente.
maritalStatus		String	Estado civil do dependente.
declareIncomeTax		String	Indica se o dependente declara Imposto de Renda.
cpf { }			Informações do Cadastro de Pessoa Física (CPF) do dependente.
	number	String	Número do documento.
	customFields { }		Campos customizados.
rg { }			Informações do Registro Geral (RG) do dependente.
	number	String	Número do documento.
	issuer	String	Órgão emissor do documento.
	issuerState	String	Estado de emissão do documento.
	issueDate	String	Data de emissão do documento.
	customFields { }		Campos customizados.
ric { }			Informações do Registro de Identidade Civil (RIC) do dependente.
	number	String	Número do documento.
	issuer	String	Órgão emissor do documento.
	issuerCity	String	Cidade de emissão do documento.
	issuerState	String	Estado de emissão do documento.
	issueDate	String	Data de emissão do documento.
	expiryDate	String	Data de validade do documento.
	customFields { }		Campos customizados.
sus { }			Informações do Cartão do sistema único de saúde (SUS).
	number	String	Número do documento.
	customFields { }		Campos customizados.
vaccinationBooklet { }			Informações da Caderneta de Vacinação.
	customFields { }		Campos customizados.
proofOfEnrollment { }			Informações do comprovante de matrícula.
	customFields { }		Campos customizados.
birthCertificate { }			Informações da Certidão de Nascimento do dependente.
	type	String	Tipo da certidão.
	issueDate	String	Data de emissão do documento.
	registry	String	Matrícula da certidão.
	term	String	Termo da certidão.
	book	String	Livro da certidão.
	sheet	String	Folha da certidão.
	notaryOffice	String	Cartório da certidão.
	issuerCity	String	Cidade de emissão do documento.
	issuerState	String	Estado de emissão do documento.
	customFields { }		Campos customizados.
deathCertificate { }			Informações da Certidão de Óbito do dependente.
	type	String	Tipo da certidão.
	issueDate	String	Data de emissão do documento.
	registry	String	Matrícula da certidão.
	term	String	Termo da certidão.
	book	String	Livro da certidão.
	sheet	String	Folha da certidão.
	notaryOffice	String	Cartório da certidão.
	issuerCity	String	Cidade de emissão do documento.
	issuerState	String	Estado de emissão do documento.
	customFields { }		Campos customizados.
customFields { }			Campos customizados.

Conteúdo de customFields:

Campo	Tipo	Descrição
field	String	Nome do campo customizado.
value	String	Valor do campo customizado.

401

Invalid credentials

default

Error response

Campo	Tipo	Descrição
message	String	Mensagem descritiva do erro.
reason	String	Um código que representa a categoria da causa do erro.

Exemplo da resposta (200):

{
  "result": {
    "totalElements": 0,
    "totalPages": 0,
    "contents": [
      {
        "preAdmissionId": "string",
        "admissionDate": "2022-02-08",
        "contract": {
          "employeeType": "string",
          "employeeContract": "string",
          "eSocialCategory": "string",
          "sefipCategory": "string",
          "unemploymentInsurance": "string",
          "raisType": "string",
          "company": {
            "id": "string",
            "companyName": "string",
            "code": "string",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "branchOffice": {
            "id": "string",
            "branchOfficeName": "string",
            "tradingName": "string",
            "code": "string",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "jobPosition": {
            "id": "string",
            "name": "string",
            "code": "string",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "customFields": [
            {
              "field": "string",
              "value": "string",
              "valueList": [
                "string"
              ]
            }
          ]
        },
        "personalData": {
          "basic": {
            "employeeFullName": "string",
            "gender": "string",
            "birthDate": "2022-02-08",
            "preferredName": "string",
            "mothersName": "string",
            "fathersName": "string",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "complementary": {
            "maritalStatus": "string",
            "degreeOfEducation": 0,
            "nationality": "string",
            "religion": "string",
            "race": "string",
            "socialName": "string",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "birthPlace": {
            "country": "string",
            "state": "string",
            "city": "string",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "address": {
            "country": "string",
            "state": "string",
            "city": "string",
            "cep": "string",
            "neighborhood": "string",
            "addressType": "string",
            "address": "string",
            "number": "string",
            "additional": "string",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "email": {
            "emailPersonal": "string",
            "emailBusiness": "string",
            "firstType": "string",
            "firstEmail": "string",
            "secondType": "string",
            "secondEmail": "string",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "phone": {
            "firstType": "string",
            "firstPhone": "string",
            "secondType": "string",
            "secondPhone": "string",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          }
        },
        "document": {
          "cpf": {
            "number": "string",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "pis": {
            "number": "string",
            "issueDate": "2022-02-08",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "ctps": {
            "number": "string",
            "serie": "string",
            "digit": "string",
            "issuerState": "string",
            "issueDate": "2022-02-08",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "rg": {
            "number": "string",
            "issuer": "string",
            "issuerState": "string",
            "issueDate": "2022-02-08",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "passport": {
            "number": "string",
            "issuer": "string",
            "issueDate": "2022-02-08",
            "expiryDate": "2022-02-08",
            "issuerCountry": "string",
            "issuerState": "string",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "ric": {
            "number": "string",
            "issuer": "string",
            "issuerCity": "string",
            "issuerState": "string",
            "issueDate": "2022-02-08",
            "expiryDate": "2022-02-08",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "voter": {
            "number": "string",
            "votingDistrict": "string",
            "votingSection": "string",
            "issueDate": "2022-02-08",
            "issuerCity": "string",
            "issuerState": "string",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "cnh": {
            "number": "string",
            "category": "string",
            "issuer": "string",
            "issuerState": "string",
            "issueDate": "2022-02-08",
            "expiryDate": "2022-02-08",
            "firstDriverLicenseDate": "2022-02-08",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "reservist": {
            "number": "string",
            "serie": "string",
            "ra": "string",
            "exemptionDate": "2022-02-08",
            "hasCertificate": true,
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "civilCertificate": {
            "type": "string",
            "issueDate": "2022-02-08",
            "registry": "string",
            "term": "string",
            "book": "string",
            "sheet": "string",
            "notaryOffice": "string",
            "issuerCity": "string",
            "issuerState": "string",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "cns": {
            "number": "string",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "dnv": {
            "number": "string",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "bankAccount": {
            "bank": "string",
            "branch": 0,
            "accountType": "string",
            "bankAccount": "string",
            "digit": "string",
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          },
          "receiveSalaryAdvance": "string"
        },
        "dependents": [
          {
            "fullName": "string",
            "degreeOfKinship": "string",
            "gender": "string",
            "birthDate": "2022-02-08",
            "mothersName": "string",
            "maritalStatus": "string",
            "declareIncomeTax": "string",
            "cpf": {
              "number": "string",
              "customFields": [
                {
                  "field": "string",
                  "value": "string",
                  "valueList": [
                    "string"
                  ]
                }
              ]
            },
            "rg": {
              "number": "string",
              "issuer": "string",
              "issuerState": "string",
              "issueDate": "2022-02-08",
              "customFields": [
                {
                  "field": "string",
                  "value": "string",
                  "valueList": [
                    "string"
                  ]
                }
              ]
            },
            "ric": {
              "number": "string",
              "issuer": "string",
              "issuerCity": "string",
              "issuerState": "string",
              "issueDate": "2022-02-08",
              "expiryDate": "2022-02-08",
              "customFields": [
                {
                  "field": "string",
                  "value": "string",
                  "valueList": [
                    "string"
                  ]
                }
              ]
            },
            "sus": {
              "number": "string",
              "customFields": [
                {
                  "field": "string",
                  "value": "string",
                  "valueList": [
                    "string"
                  ]
                }
              ]
            },
            "vaccinationBooklet": {
              "customFields": [
                {
                  "field": "string",
                  "value": "string",
                  "valueList": [
                    "string"
                  ]
                }
              ]
            },
            "proofOfEnrollment": {
              "customFields": [
                {
                  "field": "string",
                  "value": "string",
                  "valueList": [
                    "string"
                  ]
                }
              ]
            },
            "deathCertificate": {
              "type": "string",
              "issueDate": "2022-02-08",
              "registry": "string",
              "term": "string",
              "book": "string",
              "sheet": "string",
              "notaryOffice": "string",
              "issuerCity": "string",
              "issuerState": "string",
              "customFields": [
                {
                  "field": "string",
                  "value": "string",
                  "valueList": [
                    "string"
                  ]
                }
              ]
            },
            "birthCertificate": {
              "type": "string",
              "issueDate": "2022-02-08",
              "registry": "string",
              "term": "string",
              "book": "string",
              "sheet": "string",
              "notaryOffice": "string",
              "issuerCity": "string",
              "issuerState": "string",
              "customFields": [
                {
                  "field": "string",
                  "value": "string",
                  "valueList": [
                    "string"
                  ]
                }
              ]
            },
            "customFields": [
              {
                "field": "string",
                "value": "string",
                "valueList": [
                  "string"
                ]
              }
            ]
          }
        ]
      }
    ]
  }
}

PORTAL DE DOCUMENTAÇÃO
Gestão de Pessoas \| HCM - senior X