Cada vez mais o mercado exige que as operações complexas e manipulação de dados ainda mais ágeis e com custos reduzidos. Com o RH não é diferente, por isso os processos administrativos e judiciais pertinentes aos autônomos ou produtores rurais que foram cadastrados no EMS, precisam ser enviados para o eSocial de forma transparente para o usuário.
Frente a esta necessidade, foi criada uma interface que possibilite automatizar o cadastro de processo, através de uma interface de integração.
HCM (módulo Folha de Pagamento): O módulo Folha de Pagamento visa efetuar os cálculos da folha de pagamento para os funcionários, mantendo o controle sobre os valores referentes aos eventos relativos a estes funcionários.
O objetivo desta integração é permitir que a área do RH, recebam os processos administrativos e judiciais de outros sistemas especializados na área, reduzindo assim o trabalho de inclusão manual de todas as informações dentro do sistema;
Por intermédio desta integração será disponibilizada a seguinte funcionalidade:
Abaixo demonstramos um desenho como esta integração se dará:
Fora do escopo
Processos
O Sistema requisitante enviará as informações via Json para a interface de integração, desta forma será gerado um novo registro na tabela de processos no HCM. Caso tenha êxito na geração do registro, será retornado a mesma estrutura de Json confirmando sua gravação, caso contrário enviará as informações de inconsistências citadas nos próximos tópicos.
Para realizar a integração, é necessário as informações básicas para cadastramento do processo.
Parâmetro | Valor de Exemplo | Obrigatório | Tipo | Valor Default | Descrição |
authorization | usuario:senha | Sim | header | autenticação é importante para o funcionamento correto da API em casos de ambientes com autenticação Http Basic. | |
content | request da api | sim | body | Estrutura json com informações de cadastro do processo: Propriedades Obrigatórias: Dados do Processo:
Dados da Suspensão:
|
Parâmetros e Chamada do Método:
Autenticação do tipo básica.
Método POST.
{protocolo}://{host}/api/rh/v2/administrativeJudicialProceedings
Request da API: Exemplo:
Dados utilizados da API
Propriedade API REST | CAMPO DATASUL | DESCRIÇÃO | Formato / Exemplo |
---|---|---|---|
company | cdn_empresa | Empresa que o | 001 |
tpProc | cdn_estab | Estabelecimento que o candidato será admitido. | 101 |
nrProc | cdn_cargo_basic + cdn_niv_cargo | Cargo e nível que o candidato será admitido, separados por traço (-). | 10-0 |
iniValid | cod_unid_lotac | Lotação que o candidato será admitido. | 110010 |
fimValid | nom_candempr | Nome do Candidato | João da Silva Santos |
indAutoria | nom_abrev | Nome Abreviado ou Apelido | Jão |
indMatProc | nom_cidad_rh | Cidade (endereço) | Santos |
observacao | cod_unid_federac_rh | Estado (endereço) | SP |
ufVara | cod_pais_rh | País (endereço) | Brasil |
codMunic | cod_cep_rh | Cep (endereço) | 12345678 |
idVara | num_ddd + num_telefone | DDD e Fone | 1312345678 |
infoSusp | |||
codSusp | cod_id_estad_fisic | RG | 123456789 |
indSusp | cod_unid_federac_estad_fisic | UF RG | PR |
dtDecisao | cod_orgao_emis_estad_fisic | Órgão Emissor RG | SSP |
indDeposito | dat_emis_estad_fisic | Data Emissão RG | 2018-07-21 |
O envio de dados inesperados nos parâmetros de entrada da API REST pode ocasionar alguns erros. Desta forma, foram criados alguns tratamentos de erros, listados abaixo, cada um com sua respectiva mensagem e solução.
Tratamento de erros de integração Datasul:
Mensagens de Pré-Validação
Erro | Mensagem | Solução | API RESPONSE | |
1 | Já existe candidato externo com o CPF informado. | Verificar se o CPF (cpf) informado já é um candidato externo no RS0027 ou RS0009 ou pessoa física no FP1440. |
| |
366 | Nome deve ser preenchido. | Verificar se a propriedade json name está preenchida no pacote enviado . |
| |
158 | País / UF Nascimento inválido. | Verificar se as propriedades json nativeCountry e homeState existem. Lembrando que país é o nome do país de nascimento e UF é a sigla da UF de nascimento. Ambos devem existir no FP0100. |
| |
56 | Parâmetros Recrutamento e Seleção (RS0006) inexistente para a empresa informada. | Verificar se o programa RS0006 foi minimamente preenchido na empresa que o candidato será admitido. Estas informações são necessárias para o correto cadastramento do candidato no Sistema. |
| |
158 | Funcionário Responsável não foi informado nos Parâmetros Recrutamento e Seleção (RS0006) para a empresa informada. | Não foi informado responsável pela requisição no RS0006. Verificar o RS0006 da empresa (companyId) informada. |
| |
158 | Motivo Requisição Pessoal não foi informado nos Parâmetros Recrutamento e Seleção (RS0006) para a empresa informada. | Não foi informado o motivo padrão de solicitação de requisição de pessoal no RS0006. Verificar o RS0006 da empresa (companyId) informada. |
| |
56 | Funcionário Responsável Inexistente. Verifique Parâmetros Recrutamento e Seleção (RS0006) da empresa informada. | Existe alguma informação de responsável pela requisição no RS0006, porém este funcionário não existe. Verificar o RS0006 da empresa (companyId) informada. |
| |
158 | Grau de Instrução inválido. | Verificar se o grau de instrução (educationalLevel) informado para o candidato está relacionado em algum grau de instrução eSocial no FP0120. |
| |
158 | Empresa Parâmetros RH inválida. | Verificar se a empresa (companyId) informada é uma empresa de RH e possui registro no FP0500. |
|
OBS: Estas mensagens de validações serão retornadas sempre que algum campo passado que seja obrigatório ou que algum campo enviado tenha sua origem de dados em outra tabela e não seja localizado na mesma, vale lembrar que são apenas exemplos de mensagens de erros e podendo variar o nome da propriedade enviada.
Itens a serem verificados durante o atendimento: