Histórico da Página

...

Deck of Cards

id	1

Card

id	1
label	Exemplo 1 :

Funcionário possui Abono cadastrado na data 03102025

No Postman foi criado um método Delete

Bloco de código

language	bash
theme	Confluence

http://localhost:8051/api/rh/v1/allowanceControl/1;2;3|00004;2025-10-03;03:00;1|0005

Resposta:

O abono será excluído e demonstrará a seguinte mensagem 204 No Content

Ao visualizar o espelho do funcionário o abono foi excluído

Card

id	2
label	Exemplo 2 :

Funcionário não possui Abono.

Bloco de código

language	bash
theme	Confluence

http://localhost:8051/api/rh/v1/allowanceControl/1;2;3|00004;2025-10-03;03:00;1|0005

Resposta: Será demonstrada a mensagem

Card

id	2
label	Suricato	Exemplo 2 :

Funcionário não possui Abono.
Image Added

Como realizar a chamada da API REST

Endpoint:

Deve ser configurado da seguinte forma:

Bloco de código

language	bash
theme	Confluence

{protocolo}://{host}:{porta}/api/rh/v2/recordClockMarkings/integracaobatidas

Lembrando que o host e a porta devem ser configurados de acordo com o ambiente utilizado.
Exemplo de endpoint configurado corretamente:

Bloco de código

language	bash
theme	Confluence

http://localhost:8051/api/rh/

v2

v1/

recordClockMarkings/integracaobatidas

Método:

O método disponibilizado pela API é POST, sendo obrigatório o preenchimento do corpo (body). Segue um exemplo de como enviar o body:

Bloco de código

language	bash
theme	Confluence
title	Body

{ 
    "items" :[
        {
            "codRelogioExtChave": "1;1A", 
            "codFuncMsa": "00001",
            "codNsr": 5000,
            "datMarcacAces": "2025-09-05",
            "numHorarMarcacAces": 28800,
            "codRep": "55551234567895287",
            "codUsuarExtChave": "1;00001",
            "codPisMsa": "59008268339",
            "codCPF": "51427362653",
            "codFuso": "-0300",
            "inscrEmp": "01234567891234",
            "codCCT":"12345678914258778",
            "numVersLayout": "3"
        },
        {
            "codRelogioExtChave": "1;1A", 
            "codFuncMsa": "00001",
            "codNsr": 6000,
            "datMarcacAces": "2025-09-06",
            "numHorarMarcacAces": 43200,
            "codRep": "55551234567895287",
            "codUsuarExtChave": "1;00001",
            "codPisMsa": "59008268339",
            "codCPF": "51427362653",
            "codFuso": "-0300",
            "inscrEmp": "01234567891234" ,
            "codCCT":"12345678914258778",
            "numVersLayout": "3"
        }
    ]
 }

Resposta:

O retorno da API será em JSON. Segue um exemplo de resposta:

Bloco de código

language	bash
theme	Confluence
title	Response

{
    "items": [
        {
            "codRelogioExtChave": "1;1A",
            "codFuncMSA": "00001",
            "codNSR": 6000,
            "datMarcacAces": "2025-09-06",
            "numHorarMarcacAces": 43200,
            "codRep": "55551234567895287",
            "codUsuarExtChave": "1;00001",
            "codPisMSA": "59008268339",
            "codCPF": "51427362653",
            "codFuso": "-0300",
            "inscrEmp": "01234567891234",
            "codCCT": "12345678914258778",
            "numVersLayout": 3,
            "status": 200,
            "errorCode": "",
            "message": "Gravação efetuada com sucesso"
        },
        {
            "codRelogioExtChave": "1;1A",
            "codFuncMSA": "00001",
            "codNSR": 5000,
            "datMarcacAces": "2025-09-05",
            "numHorarMarcacAces": 28800,
            "codRep": "55551234567895287",
            "codUsuarExtChave": "1;00001",
            "codPisMSA": "59008268339",
            "codCPF": "51427362653",
            "codFuso": "-0300",
            "inscrEmp": "01234567891234",
            "codCCT": "12345678914258778",
            "numVersLayout": 3,
            "status": 400,
            "errorCode": "00002",
            "message": "NSR duplicado. Número já foi importado na tabela"
        }
    ]
}

allowanceControl/1;2;3|00004;2025-10-03;03:00;1|0005

Resposta: Será demonstrada a mensagem

Image Added

Mensagens de Erro:

Table Filter

fixedCols
totalrow	,,
hidelabels	false
ddSeparator
sparkName	Sparkline
hidePane	true
customNoTableMsgText
limitHeight
sparkline	false
default
isFirstTimeEnter	true
cell-width
hideColumns	false
totalRowName
totalColName
customNoTableMsg	false
disabled	false
enabledInEditor	false
globalFilter	false
id	1759176505240_480190944
iconfilter
order
hideControls	false
inverse
numbering
datefilter
column
sort	status ⇧
totalcol
disableSave	false
rowsPerPage
separator	Point (.)
labels
thousandSeparator
ignoreFirstNrows
ddOperator
userfilter
datepattern	dd/mm/yy
numberfilter
heightValue
hideFilters
updateSelectOptions	false
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
showNRowsifNotFiltered

status	errorCode	message
200		"Gravação efetuada com sucesso."
400	"00001"	"PIS em formato inválido ou inexistente no cadastro."
400	"00001"	"CPF em formato inválido ou inexistente no cadastro."
400	"00002"	"NSR duplicado. Número já foi importado na tabela"
400	"00002"	"NSR duplicado. Número já foi importado na InscrEmp informada." Obs: (Essa validação só é feita se o campo "CodRelogioExtChave" estiver com o valor PONTOWEB )
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: 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. O campo permite a quantia de caracteres 11 ou 14 apenas."
400	"00006"	"Campo codRelogioExtChave no formato inválido. Deve ser preenchido para o Suricato: Coligada;Código do Terminal de Coleta ou para Ahgora: PONTOWEB."
400	"00006"	"Não foi informado o campo obrigatório: InscrEmp." Obs: (Essa validação só é feita se o campo "CodRelogioExtChave" estiver com o valor PONTOWEB )
400	"00007"	"Terminal de coleta não está cadastrado no ERP."
400	"99999"	"Erro interno na tabela. Registro não foi gravado."

06. ASSUNTOS RELACIONADOS

...

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 5

Nova versão 6

Chave

06. ASSUNTOS RELACIONADOS