Cada vez mais o mercado exige que as operações complexas e manipulação de dados ainda mais ágeis e com custos reduzidos.
Frente a esta necessidade, foi criada uma API para fazer a integração direta entre o ERP e o sistema TFS
O objetivo dessa integração é permitir que o TFS tenha acesso facilitado as informações dos funcionário cadastrados no EPS Datasul, reduzindo o trabalho de inclusão manual
Arquitetura (Tecnologia)
Por intermédio desta integração será disponibilizada a seguinte funcionalidade:
O Sistema requisitante enviará as informações via Json para a interface de integração, desta forma será validado as informações contidas no Json. 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:
|
Ordem da busca do funcionário, se informado os seguintes campos:
1 - companyInternalId e employeeInternalId
Já que foi informado o caminho exato da matrícula do funcionário, faz a busca direta.
2 - companyFederalIdentification e employeeCode
Busca pelo CNPJ da empresa e o código do funcionário.
3 - companyFederalIdentification e employeeFederalIdentification
Busca pelo CNPJ da empresa e CPF do funcionário.
Parâmetros e Chamada do Método:
Autenticação do tipo básica.
Método POST.
{protocolo}://{host}/dts/datasul-rest/resources/prg/rh/v1/EmployeePayrollInfo
Request da API
Dados utilizados da API
Propriedade API REST | CAMPO HCM | DESCRIÇÃO | Formato / Exemplo |
---|---|---|---|
companyInternalID | cdn_empresa | Empresa para o qual o funcionário pertence | "123" |
companyFederalIdentification | cod_id_feder | CNPJ da empresa em que o funcionário trabalha | "21.819.560/0001-42" |
employeeInternalID | cdn_estab e cdn_funcionario | Estabelecimento e matricula do funcionário. | "302|45" |
employeeFederalIdentification | cod_id_feder | CPF do funcionário | "093.546.557-00" |
employeeCode | cdn_funcionario | Código do funcionário | "45" |
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 HCM:
Mensagens de Pré-Validação
Erro | Mensagem | Solução |
1 | Funcionário inexistente | Verificar se foram passados dados de um funcionário. |
2 | Pessoa física inexistente | Verificar o cadastro do funcionário. |
3 | Cargo básico inexistente | Verificar o cadastro do funcionário |
4 | Não existe cadastro demonstrativo de desconto últimos 5 meses | Verifique se existe no programa FP0200 registro que a descrição inicie com TFS5M. |
Itens a serem verificados durante o atendimento: