Linha RM

Atalhos

Páginas filhas
  • DT API recordClockMarkings


01. DADOS GERAIS

Produto:

TOTVS RH

Linha de Produto:

Linha RM

Segmento:

RH

Módulo:

TOTVS RH (Linha RM) - Automação de Ponto (CHRONUS)

Função:Alterar a API para atender a portaria 671/2021
País:Brasil
Requisito/Story/Issue (informe o requisito relacionado) :

DRHJORNRM-3514

DRHJORNRM-2755


02. SITUAÇÃO/REQUISITO

Para atender a portaria 671/2021 foram criados nas tabelas AINTEGRACAOBATIDAS e MSA_CONTROL_MARCAC os campos (CODFUSO, CODCPFFUNC, NUMVERSLAYOUTAFD e CODINSCREMP)  e serão utilizadas na integração com o Suricato, sendo necessário atualizar a API de integração de marcações para preencher os novos campos.

03. SOLUÇÃO

Alterada a API recordClockMarkings, para receber, validar e salvar os dados nos novos campos. Se as marcações a serem integradas forem referentes a portaria 671, antes de consumir a API será necessário validar se os novos campos já foram criados no RM, para isso siga a documentação a seguir: DT API recordValidatedVersion.

Após a criação dos novos campos a API estará preparada para receber as marcações, conforme o exemplo abaixo:

{
  "codIdPrevidSocial": "1",
  "codRelogioExtChave": "1;1A",
  "numDirecaoAces": 0,
  "codFuncMsa": "400425",
  "codIdFeder": "0",
  "codHash": "050C9CD87C9BBF6C165EAF1DCB5E",
  "logImportProdut": 0,
  "codLote": "000001",
  "codNsr": 1,
  "valPerfAces": 1,
  "datMarcacAces": "2022-10-10 08:30:00.000",
  "numHorarMarcacAces": 30600,
  "codRep": "001",
  "codUnidExtChave": "1;01",
  "codUsuarExtChave": "1;00001",
  "codPisMsa": "93136964036",
  "codFuso": "-0300",
  "codCPF": "67994303021",
  "numVersLayout": 671,
  "codInscrEmp": "32455228000162"
}

04. Retornos da API

A API irá retornar a lista com o indicativo individual de sucesso ou erro na gravação. Os retornos possíveis estão na lista abaixo:

StatuserrorCodemessage
200
"Gravação efetuada com sucesso."
400"00001""PIS em formato inválido ou inexistente no cadastro."
400"00002""NSR duplicado. Número já foi importado na tabela"
400"00003""NSR não foi informado e é obrigatório"
400"00006""Não foi informado o campo obrigatório: CodRelogioExtChave"
400"00006""Não foi informado o campo obrigatório: codFuncMsa"
400"00006""Não foi informado o campo obrigatório: numHorarMarcacAces"
400"00006""Código do REP é obrigatório"
400"00006""Não foi informado o campo obrigatório: codUnidExtChave"
400"00006""Não foi informado o campo obrigatório: codUsuarExtChave"
400"00006""Data da marcação é obrigatória"
400"00006""Campo 'datMarcacAces' no formato incorreto. Deve ser preenchido como data."
400"00006"Tamanho do campo InscrEmp inválido
400"00007""Terminal de coleta não está cadastrado no ERP."
400"99999""Erro interno na tabela. Registro não foi gravado"
400"00001""CPF em formato inválido ou inexistente no cadastro."

05. ASSUNTOS RELACIONADOS