Histórico da Página

Índice

CONTEÚDO

1. Versões
2. Visão Geral
3. Parametrização e Exemplo de utilização
4. Documentação

01. VERSÕES

Informações

icon	false

A partir dos patches:

- 12.1.2511.5
- 12.1.2507.11
- 12.1.2503.17
- ou superiores.

...

03. PARAMETRIZAÇÃO E EXEMPLO DE UTILIZAÇÃO

Deck of Cards

id	1

Card

id	5
label	Configuração Integração Datasul X ATS
title	Documentação Relacionada

VISÃO GERAL

SMARTLINK CLIENT DATASUL

O SmartLink Client é o componente responsável por realizar a comunicação entre o SmartLink Server e o ERP Datasul. Instalado na infraestrutura do próprio cliente (on-premise), ele atua como ponte para envio e recebimento de mensagens entre os sistemas.

Para que a integração com o SmartLink ocorra corretamente no ambiente Datasul, é necessário configurar as credenciais de acesso à TOTVS Apps:

Informações

title	Siga os passos abaixo:

Acesse o programa "Propriedades Integrações TOTVS" no Datasul.
Na aba "SmartLink", cadastre um usuário do produto Datasul no campo “Usuário”.
- O usuário deve possuir perfil de administrador ou ser o usuário padrão utilizado no recebimento e processamento de mensagens via SmartLink, além de ter acesso a todas as empresas que participarão da integração.
Localize a área de configuração TOTVS Apps.
Habilite a integração com a plataforma.
Preencha obrigatoriamente os seguintes campos:
- ClientId do RAC
- Secret do RAC

Essas credenciais são fornecidas via TOTVS Apps e são essenciais para autenticar a comunicação entre o SmartLink Client e o Datasul.

GERENCIADOR DE MENSAGENS SMARTLINK CLIENT

Aviso

title	Recomendação

Recomendamos que este programa deve ser acessado apenas por usuários administradores do produto Datasul, garantindo segurança e manutenção da integração.

Verifique se os seguintes tipos de mensagens foram criados corretamente no cadastro de Tipos de Mensagens do SmartLink Client:

Image Added

Informações

title	Importante

Esses registros são criados internamente pela TOTVS.
A criação ocorre automaticamente por meio da console de atualização do produto Datasul.

Para maiores detalhes sobre o gerenciador de mensagens acessar o link abaixo:

Gerenciador de Mensagens do Smart Link

INSTALAÇÃO SMARTLINK CLIENT

A instalação do Smart Link Client deve ser realizada conforme as instruções disponíveis no link abaixo:

Instalação Smart Link Client

Para maiores detalhes sobre a integração Datasul x Smartlink Client, acessar o link abaixo:

Integração Datasul x Smarlink Client.

CONFIGURAÇÕES ERP DATASUL

Necessario Realizar a configuração do usuário e do TOTVS APPS

Image Added

Propriedade	Descrição
TOTVS Apps
Habilitar Integração	Habilita a integração com o TOTVS Apps
Tipo de ambiente	Tipo de ambiente utilizado para a integração
ClientId do RAC:	Client oAuth para a autenticação no RAC (necessário que seja um client oAuth e tenha permissão Resource Owner)
Secret do RAC	Senha do client oAuth
TenantId do RAC	Tenant Id referente as credenciais do RAC (apenas leitura, não é necessário cadastrar).

MONITOR SMARTLINK SERVER

O correto funcionamento do SmartLink via Behavior Sharing depende de um monitoramento eficiente das mensagens que trafegam entre os serviços. Para isso, está disponível o Monitor do Smart Link, ferramenta essencial para acompanhar o comportamento das filas dos Clients. Através dele, é possível verificar:

A quantidade de mensagens atualmente na fila, aguardando leitura pelo Client;
Qual mensagem está há mais tempo pendente na fila;
Os tipos de mensagens que estão sendo processadas ou aguardando processamento.

Informações

title	Importante

O Monitor exibe apenas as mensagens originadas nos TOTVS Apps, que têm como destino o SmartLink Client.

Image Added

Para maiores informações sobre uso e acesso ao monitor, consulte o link abaixo:

Monitor SmartLink

Card

id	1
label	Documentação

Card

default	true
id	1
label	Parametrização
title	Parametrização

Informações

title	Importante

Card

id	2
label	FP1440
title	Integração

É possível realizar a integração de um candidato na Pessoa Física na Folha de Pagamento RH Datasul através do programa FP1440 - Manutenção Pessoa Física.

- Foi criado o campo Candidato no programa FP1440 que permite selecionar candidatos vindos do ATS:

- O campo Cadastro tem um zoom que permite filtrar e selecionar o candidato:
  - Aba Candidato:

- - - Na aba Candidato é possível realizar o filtro pelo ID do registro, Nome do Candidato e o Status do registro:
    - No browse são exibidos os campos
      - ID do Registro
      - Nome do Candidato
      - CPF do candidato
      - Código do registro do candidato do ATS
      - Código da Vaga
      - Email do candidato
      - Status do registro do candidato, se está cadastrado ou com o cadastro com alguma pendência.

- - Aba Vaga:

- - - Na aba Vaga é possível realizar o filtro pelo ID do registro, Código do Registro do Candidato do ATS, Código da Vaga e da Data de Contratação:
    - No browse são exibidos os campos
      - ID do Registro
      - Código do registro do candidato do ATS
      - Código da Vaga
      - Nome do Candidato
      - Data de Contratação
      - CPF do candidato
      - Email do candidato
      - Status do registro do candidato, se está cadastrado ou com o cadastro com alguma pendência.

- - Aba CPF:

Image Modified

cadastro de peé necessário Para Integrar um candidato vindo do ATS deve serPara acessar o novo programa de integração dos produtos do RH Datasul com a Ahgora, vá ao menu e procure, por exemplo, pela palavra 'Ahgora'. Em seguida, será exibido o programa 'Integração Ahgora'.

Ao executar esse programa, será apresentada a aplicação com o menu 'Integração Ahgora', contendo itens como Funcionários e Afastamentos. No menu seguinte, 'Exclusão Ahgora', encontra-se a opção Afastamentos.

A seguir, detalharemos um pouco mais cada uma dessas opções.

- - - Na aba CPF é possível realizar o filtro pelo ID do registro, CPF do candidato, Email do Candidato e a Data de Contratação:
    - No browse são exibidos os campos:
      - ID do Registro
      - Nome do Candidato
      - CPF do candidato
      - Data de Contratação
      - Código do registro do candidato do ATS
      - Código da Vaga
      - Email do candidato
      - Status do registro do candidato, se está cadastrado ou com o cadastro com alguma pendência.

- - É possível visualizar e exportar o JSON da integração do Candidato do ATS através do botão Ver Json

Image Added

Informações

title	Importante

Exporta Json

Ao realizar a exportação do Json, é gerado um arquivo Json no diretório 'C:\Temp' com o código do candidato do ATS.

Card

id	3
label	De/Para
title	De/Para

Card

id	1
label	De/Para
title	De/Para

Card

id	3
label	De/Para
title	De/Para

1 - FUNCIONÁRIOS

2 - AFASTAMENTOS

3 - EXCLUSÃO DE AFASTAMENTOS

Obrigatório o envio do DEL quando for exclusão de informação

Card

id	1
label	De/Para
title	De/Para

Descrição

Campo Tabela RH Datasul

Descrição / Regra

Identificação do colaborador

funcionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario

Matricula do Funcionário
Enviar concatenado Empresa + Estabelecimento + Matricula

Nome do Funcionário

funcionario.nom_pessoa_fisic

Nome do Funcionário

PIS do Funcionário

funcionario.cod_pis

Numero do PIS do Funcionário

Matrícula do E-Social

sped_participan.cod_matr_sped

Matricula do eSocial

Data em que o Funcionário foi Admitido

funcionario.dat_admis_func

Data de Admissão

Data de Demissão

funcionario.dat_desligto_func

Data de Demissão

Código da escala/ turno do funcionário

funcionario.cdn_turno_trab

Turno do Funcionário

Data da alteração de escala/turno

func_turno_trab.dat_inic_lotac_func_turno_trab

Data do ultimo histórico de turno

Tipo de Escala de Trabalho

turno_trab.idi_period_turno_trab

Enviar sempre as horas padrão mensal do FP1400

Carteira de Trabalho

funcionario.cod_cart_trab -
funcionario.cod_ser_cart_trab -
funcionario.cod_unid_federac_cart_trab

Carteira de Trabalho do Funcionário

Título do Cargo

funcionario.cdn_cargo_basic +
cargo.des_cargo

Código do Cargo + descrição

Descrição do departamento do Funcionário

funcionario.cod_unid_lotac

Código da Lotação + descrição

Gênero do Funcionário

rh_pessoa_fisic.idi_sexo

Sexo

E-mail do Funcionário

rh_pessoa_fisic.nom_e_mail

rh_pessoa_fisic.nom_mail_contat

E-mail e E-mail contato. Prioriza o informado e se ambos, considera o e-mail

CPF do Funcionário

rh_pessoa_fisic.cod_id_feder

CPF, sem caracteres

RG do Funcionário

rh_pessoa_fisic.cod_id_estad_fisic

Carteira Identidade

CNPJ da filial do Funcionário

rh_pessoa_jurid.cod_id_feder

CNPJ da Pessoa Juridica do estabelecimento sem caracteres

Data da atribuição do CNPJ da empresa ao funcionário

funcionario.dat_admis_transf_func

Data da transferência entre estabelecimentos

Código do centro de custo do funcionário

funcionario.cdn_empresa
funcionario.cod_rh_ccusto

Centro Custo concatenado com Empresa + Código Centro de Custo

Regime de Trabalho do Funcionário

funcionario.idi_tip_func

DE/PARA dos tipos conforme regra da Ahgora, dados preenchidos pela descrisão

Data de Nascimento do Funcionário

rh_pessoa_fisic.dat_nascimento

Data Nascimento

Data de Alteração de Cargo

histor_sal_func.dat_liber_sal

Data da transferência entre cargos. Sempre considerado o último

Definição de carga horária

turno_trab.qtd_hrs_padr_mes_rh

Quantidade de horas mês

Ponto Obrigatório

func_aux_func.idi_elig_ponto

Disponível somente quando habilita o produto do ponto

Data de troca da elegibilidade do registro de ponto

func_aux_func.dat_troca_elig_ponto

Enviar a data quando passou a utilizar ponto, ou quando deixou de utilizar ponto.

Matrícula Chefia Imediata

Enviar a matricula do líder imediato da tabela de permissões

Nome Chefia Imediata

Nome do líder imediato

e-mail Chefia Imediata

e-mail líder imediato

Código do Sindicato

funcionario.cdn_sindicato

Código do Sindicato

Data da alteração do código do sindicato

Data da inclusão. Sempre considerado o último

Telefone

rh_pessoa_fisic.num_telefone rh_pessoa_fisic.num_telef_contat

Telefone do funcionário

PIS

Preencher com true quando não tiver o PIS cadastrado e false quando tiver PIS cadastrado.

codInterno

funcionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario

Matricula do Funcionário
Enviar concatenado com separador pipe "|"
Enviar concatenado Empresa + Estabelecimento + Matricula

Matricula Anterior

Preencher com a matricula do funcionário transferido.

Define o custo hora do funcionário, utilizado para cálculos financeiros.

histor_sal_func.val_salario_hora

Salário hora

Valor do salário do colaborador

funcionario.val_salario_atual

Caso o colaborar for mensalista, enviar o salário mensal
Caso o colaborar for horista, enviar o salário da hora

Descrição

Campo Tabela RH Datasul

Descrição / Regra

Identificação do colaborador

funcionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario +
numero sequencial

Matricula do Funcionário
Enviar concatenado Empresa + Estabelecimento + Matrícula

Motivo do Afastamento

sit_afast.cdn_sit_afast_func

Situação de Afastamento

Data e/ou hora Inicial do Afastamento

sit_afast_func.dat_inic_sit_afast
sit_afast_func.num_horar_inic_sit_afast

Data inicio do afastamento
Hora inicio: (00:00)
Hora Final: (24:00)

Data e/ou hora Final do Afastamento

sit_afast_func.dat_term_sit_afast
sit_afast_func.num_horar_term_sit_afast

Data fim do afastamento
Sem data fim, enviar vazio.

Código interno do Afastamento

funcionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario +
numero sequencial

Sequência Afastamento
Informar chave única para identificar. Concatenar informações(empresa, estabelecimento, matricula e Sequência).

Ação a ser realizada

Inclusão ou alteração é 'INS'

Descrição

Campo Tabela RH Datasul

Descrição / Regra

Identificação do colaborador

funcionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario +
numero sequencial

Matricula do Funcionário
Enviar concatenado Empresa + Estabelecimento + Matrícula

Motivo do Afastamento

sit_afast.cdn_sit_afast_func

Situação de Afastamento

Data e/ou hora Inicial do Afastamento

sit_afast_func.dat_inic_sit_afast
sit_afast_func.num_horar_inic_sit_afast

Data inicio do afastamento
Hora inicio: (00:00)
Hora Final: (24:00)

Data e/ou hora Final do Afastamento

sit_afast_func.dat_term_sit_afast
sit_afast_func.num_horar_term_sit_afast

Data fim do afastamento
Sem data fim, enviar vazio)

Código interno do Afastamento

funcionario.cdn_empresa +
funcionario.cdn_estab +
funcionario.cdn_funcionario +
numero sequencial

Sequência Afastamento
Informar chave única para identificar. Concatenar informações(empresa, estabelecimento, matricula e Sequência).

Ação a ser realizada

Card

id	4
label	Documentação Relacionada
title	Documentação Relacionada

Card

id	1
label	Documentação

Card

id	5
label	Vídeos
title	Vídeos How To

Árvore de páginas

Versões comparadas

Versão antiga 4

Nova versão 14

Chave

Índice

CONTEÚDO

01. VERSÕES

03. PARAMETRIZAÇÃO E EXEMPLO DE UTILIZAÇÃO

VISÃO GERAL

SMARTLINK CLIENT DATASUL

GERENCIADOR DE MENSAGENS SMARTLINK CLIENT

INSTALAÇÃO SMARTLINK CLIENT

CONFIGURAÇÕES ERP DATASUL

MONITOR SMARTLINK SERVER