Histórico da Página

...

Deck of Cards

id	1

Card

id	1
label	Exemplo 1 :

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/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": "PONTOWEB", 
            "codFuncMsa": "00001",
            "codNsr": 1,
            "datMarcacAces": "2025-09-02",
            "numHorarMarcacAces": 28800,
            "codRep": "55551234567895287",
            "codUsuarExtChave": "1;00001",
            "codPisMsa": "59008268339",
            "codCPF": "51427362653",
            "codFuso": "-0300",
            "inscrEmp": "01234567891234",
            "codCCT":"12345678914258778",
            "numVersLayout": "3"
        },
        {
            "codRelogioExtChave": "PONTOWEB", 
            "codFuncMsa": "00001",
            "codNsr": 2,
            "datMarcacAces": "2025-09-02",
            "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": "PONTOWEB",
            "codFuncMSA": "00001",
            "codNSR": 1,
            "datMarcacAces": "2025-09-02",
            "numHorarMarcacAces": 28800,
            "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": "PONTOWEB",
            "codFuncMSA": "00001",
            "codNSR": 1,
            "datMarcacAces": "2025-09-02",
            "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 InscrEmp informada."
        }         
    ]
}

Card

id	2
label	Exemplo 2 :

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/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"
        }
    ]
}

Card

id	2
label	Suricato

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/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"
        }
    ]
}

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."

Aviso

title	Importante

Uma marcação com dados errados ou incompletos não impede que outras marcações corretas sejam integradas. O motivo do erro será retornado na resposta da chamada, na propriedade "message".

...

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 3

Nova versão 4

Chave