Objetivo: Busca dos dados para listagem dos funcionários e envio dos funcionários selecionados para o back-end.
Tipo de requisição: POST Endpoint: /api/rh/v1/credito-trabalhador
POST: Estrutura do body: Campo | Campo pai | Tipo | Descrição | atualiza | - | boolean | Indica se deseja atualizar os empréstimos importados anteriormente. | branches | - | array | Indica as filiais que serão atualizadas no ERP. Se vazio atualiza todas. | items | - | array | Lista dos empréstimos que devem ser gravados. | ifConcessora | items | object | Instituição financeira. | codigo | ifConcessora | number | Código da Instituição financeira. | descricao | ifConcessora | string | Descrição da Instituição financeira. | contrato | items | string | Número do contrato | cpf | items | string | Número do CPF do trabalhador. | matricula | items | string | Matrícula do trabalhador no eSocial. | inscricaoEmpregador | items | object | Objeto da Inscrição do empregador | codigo | inscricaoEmpregador | number |
| numeroInscricaoEmpregador | items | string | Número da inscrição do empregador. | nomeTrabalhador | items | string | Nome completo do trabalhador. | dataInicioContrato | items | string | Data de início do contrato. | dataFimContrato | items | string | Data de término do contrato. | competenciaInicioDesconto | items | string | Competência inicial do desconto (mês/ano). | competenciaFimDesconto | items | string | Competência final do desconto (mês/ano). | totalParcelas | items | number | Total de parcelas do empréstimo. | valorParcela | items | number | Valor de cada parcela. | valorEmprestimo | items | number | Valor total do empréstimo. | valorLiberado | items | number | Valor que foi liberado. | qtdPagamentos | items | number | Quantidade de pagamentos realizados. | qtdEscrituracoes | items | number | Quantidade de escriturações. | categoriaTrabalhador | items | object | Objeto com informações da categoria do trabalhador. | codigo | categoriaTrabalhador | number | Código da categoria do trabalhador. | competencia | items | string | Competência (mês/ano). | inscricaoEstabelecimento | items | object | Objeto com informações da inscrição do estabelecimento. | codigo | inscricaoEstabelecimento | number |
| numeroInscricaoEstabelecimento | items | string | Número da inscrição do estabelecimento. | dataAdmissao | items | string | Data de admissão do trabalhador. | _index | items | number | Índice do item na lista. (gerado pelo frontend no momento da importação) |
{
"atualiza": true,
"branches": [
"estabelecimento 01",
"estabelecimento 02"
],
"items": [
{
"ifConcessora": {
"codigo": 0,
"descricao": "string"
},
"contrato": "string",
"cpf": "string",
"matricula": "string",
"inscricaoEmpregador": {
"codigo": 1
},
"numeroInscricaoEmpregador": "string",
"nomeTrabalhador": "string",
"dataInicioContrato": "01/05/2025",
"dataFimContrato": "string",
"competenciaInicioDesconto": "05/2025",
"competenciaFimDesconto": "08/2025",
"totalParcelas": 1,
"valorParcela": 100.99,
"valorEmprestimo": 400.99,
"valorLiberado": 300.99,
"qtdPagamentos": 0,
"qtdEscrituracoes": 0,
"categoriaTrabalhador": {
"codigo": 101
},
"competencia": "05/2025",
"inscricaoEstabelecimento": {
"codigo": 1
},
"numeroInscricaoEstabelecimento": "string",
"dataAdmissao": "28/02/2020",
"_index": 0
}
]
} |
Estrutura de Retorno: Campo | Tipo | Exemplo | id (obrigatório) | string | "2026-59303411099" | yearRectif(obrigatório) | number | 2026 | companyCode | string | "1" | branchCode(obrigatório) | string | “02” | type | string | "Funcionário" ou "Prestador" ou "Funcionário/Prestador" | registrationNumber | string | "59303411099" | name | string | "Nome do funcionário" | enableMonths | array | [1,5,6,7,9,12]
| Months | array | [5,9,12] |
Exemplo de Requisição: GET: api/rh/v1/RefificaPerAnt?page=1&pageSize=20&yearRectif=2026 Se atentar com a paginação. {
"items": [
{
"id": "2026-59303411099",
"yearRectif": 2026, "companyCode": "1",
"branchCode": "1",
"type": "Funcionário",
"registrationNumber": "59303411099",
"name": "Admitido Antes da Retificação e Ativo",
"enableMonths": [
1,
2,
3,
6,
7,
8,
10,
11
],
"months": [
3,
6,
7,
8,
10,
11
]
},
{
"id": "2026-59429296027",
"yearRectif": 2026, "companyCode": "1",
"branchCode": "1",
"type": "Funcionário",
"registrationNumber": "59429296027",
"name": "teste paginacao 8",
"enableMonths": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12
],
"months": [
3,
5
]
}
],
"hasNext": false,
"total": 2
} |
Post: /api/rh/v1/RefificaPerAnt Nome | Descrição | Tipo | Obrigatório | Exemplo | id (obrigatório) | Código interno do funcionário | string | Sim | "2026-59303411099" | companyCode | Empresa ou Coligada | string | Sim | "10" | branchCode | Estabelecimento ou Filial | string | Sim | "1" | months | Meses retificados | array | Sim | [1,3,5,9,12] |
A partir do filtro realizado, ao clicar editar e confirmar, os dados serão enviados para o back-end. {
"items":
[
{
"id":"2026-59303411099",
"companyCode":"10", "branchCode":"11",
"months":[1,2,6,8,12]
}
]
} |
Para o retorno de erro, seguir a estrutura abaixo. Campo | Tipo | code | number | message | string | detailedMessage | string | type | string (“error”, “warning”, “success”) |
{
"code": 500,
"detailedMessage": "",
"message": "Internal Server Error",
"type": "error"
} |
|