01. DADOS GERAIS
| Produto: | | Solucoes_totvs_parceirosexptotvs |
|---|
|
|
|---|
| Linha de Produto: | |
|---|
| Segmento: | |
|---|
| Módulo: | | Modulos_totvs_rh |
|---|
| ModulosTOTVSRH | 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:
| Bloco de código |
|---|
{
"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:
| Status | errorCode | message |
| 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
