API PTRP - Documentação

Nesta documentação você pode explorar todas funcionalidades que a nossa API oferece e adaptá-los ao seu sistema seja ele no browser, desktop, mobile etc.

A API funciona por padrão no formato de dados JSON, todas as requisições respondem um objeto deste tipo. Há exceções em requisições no qual o cliente deve informar o formato (por exemplo: pdf).

Para ter acesso aos recursos da API, você deverá fazer uma autenticação. Confira as formas de se autenticar para ter acesso aos recursos a seguir.

Obter suas chaves de acesso (Token)

A API oferece dois modos de autenticação: por token gerado manualmente ou por chaves de acesso obtidos através de login na API.

Como obter seu token manualmente

  • Acesse a sua conta no PTRP (ou no ambiente que estiver desenvolvendo)
  • Localize o menu Perfil
  • Clique no botão gerar na seção Token de Autenticação da API
  • Agora, você poderá utilizar o token no cabeçalho X-Auth-Token nas requisições

Exemplo de um cabeçalho de requisição:

Host: api.ptrp.com.br 
X-Auth-Token: oe4dx4vyN3i4kugc
Content-Type: application/x-www-form-urlencoded

Como obter suas chaves de acesso por login

  • Acesse a seção Auth > Login da documetação

Exemplo de um cabeçalho de requisição:

Host: api.lvh.me
Access-Token: bShjtFhkxXlLOC8sIsBdTw
Token-Type: Bearer
Client: ESWnaQQMYjn0sEn7V91XOQ
Uid: [email protected]
Content-Type: application/x-www-form-urlencoded

Os campos access-token, client e uid são obrigatórios. Esses campos são obtidos no cabeçalho da ação de login.


Níveis de Acesso

Cada usuário possui um nível de acesso no PTRP, dependendo de qual nível seu token de acesso tiver (pertencente a um usuário), algumas funcionalidades da API serão restrinigidas e outras liberadas. Por exemplo, o usuário do tipo ‘Departamento’ tem diferentes recursos habilitados se comparado ao usuário do tipo ‘Cliente’.


Documentação

Os exemplos de uso foram gerados com a ferramenta cURL. A sintaxe você pode conferir no site https://curl.se/docs/manual.html

Atenção!

Os exemplos são descritos com o host http://api.lvh.me, esse host de exemplo deve ser substituido pelo ambiente no qual o seu desenvolvimento estiver trabalhando. Por exemplo: https://api.ptrp.com.br para ambiente de produção ou https://api.123.reviews.pontogestor.com para uma sandbox de testes.


Suporte

Se você precisar de suporte ou tem dúvidas sobre a API, contate-nos através dos canais de ajuda no whatsapp, e-mail ou helpdesk.


Auth

Alterando a senha

Este método serve para alterar a senha do usuário atual.

Endpoint

PATCH /v1/auth/password

Parameters

Name Description
password required (String) Nova senha do usuário.
password_confirmation required (String) Confirmar a mesma senha.

Request

Route

PATCH /v1/auth/password

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

Body

{
  "password": "test12",
  "password_confirmation": "test12"
}

cURL

curl "https://api.ptrp.com.br/v1/auth/password" -d '{"password":"test12","password_confirmation":"test12"}' -X PATCH \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
data (Object) Atributos do Usuário.
message (String) Mensagem do resulta do recurso.
success (Boolean) Status do recurso.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"e16504f942ecf5145529bba7c0db62a7"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: bf2dee1b-3278-4298-8afc-194c74d71042
X-Runtime: 0.179758
Vary: Origin
Content-Length: 3715

Body

{
  "success": true,
  "data": "{\"first_name\":\"funcionario1\",\"last_name\":\"\",\"cpf\":\"010.333.111-22\",\"username\":\"funcionario1\",\"station_user\":\"Funcionario\",\"roles\":[\"funcionario\"],\"created_at\":\"2026-04-06T22:37:18.000-03:00\",\"updated_at\":\"2026-04-06T22:37:19.572-03:00\",\"funcionario_uid\":\"71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0\",\"temporary_password\":false,\"empresa\":{\"uid\":\"a43bedds-ba77-4062-46c0-58f4444ded33\",\"name\":\"Empresa03\",\"nome_fantasia\":\"EmpFantasia03\",\"cnpj\":\"00.000.000/0000-03\",\"cei\":null,\"cpf\":null,\"inscricao_estadual\":null,\"address\":{\"cep\":\"85555-222\",\"city\":\"Guarapuava\",\"complement\":\"Apto52\",\"country\":\"Brasil\",\"number\":\"101\",\"state\":\"PR\",\"street\":\"Rua Armando Ribas\",\"district\":\"Rua Armando Ribas\"},\"contact\":null,\"codigo_registro_folha\":\"23\",\"ativo\":true},\"franquia\":{\"uid\":\"71ba8bd7-3b65-40fa-8e11-7daf5f0fe3f0\",\"name\":\"Franquia01\",\"nome_fantasia\":\"FranquiaFantasia01\",\"cnpj\":\"00.000.000/0000-00\",\"inscricao_estadual\":null,\"cpf\":null,\"logo\":\"/uploads/franquia/879004013/logo/879004013/logo.png\",\"clausula_aceite\":null,\"address\":{\"cep\":\"85555-222\",\"city\":\"Guarapuava\",\"complement\":\"Apto52\",\"country\":\"Brasil\",\"number\":\"101\",\"state\":\"PR\",\"street\":\"Rua Armando Ribas\",\"district\":\"Rua Armando Ribas\"},\"condicoes_comerciais\":null,\"contacts\":[{\"email\":\"[email protected]\",\"name\":\"My Contact\",\"phone\":\"(42) 05555-4444\",\"cpf\":null,\"whatsapp\":null,\"site\":null,\"instagram\":null},{\"email\":\"[email protected]\",\"name\":\"My Contact Legal\",\"phone\":\"(42) 05555-4444\",\"cpf\":null,\"whatsapp\":null,\"site\":null,\"instagram\":null},{\"email\":\"[email protected]\",\"name\":\"My Contact Tecnico\",\"phone\":\"(42) 05555-4444\",\"cpf\":null,\"whatsapp\":null,\"site\":null,\"instagram\":null}]},\"email\":\"[email protected]\",\"station\":{\"cpf\":\"07155744989\",\"cracha\":\"1\",\"data_admissao\":\"2000-01-01\",\"data_demissao\":null,\"name\":\"Func1\",\"pis\":\"123929234315\",\"registro_folha\":\"1\",\"rg\":null,\"uid\":\"71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0\",\"nacionalidade\":null,\"nome_da_mae\":null,\"nome_do_pai\":null,\"estado_civil\":null,\"conjuge\":null,\"nascimento\":null,\"ctps\":null,\"cnh\":null,\"certidao_militar\":null,\"tipo_sanguineo\":null,\"escolaridade\":null,\"observacoes\":null,\"cargos\":[{\"data\":\"2017-01-10\",\"funcao\":\"test\",\"name\":\"Auxiliar (123456)\"},{\"data\":\"2018-01-01\",\"funcao\":\"auxiliar\",\"name\":null}],\"exames\":[{\"data\":\"2017-01-10\",\"apto\":true,\"tipo_exame\":null,\"observacoes\":null,\"arquivo\":{\"url\":null}}],\"empresa\":{\"uid\":\"a43bedds-ba77-4062-46c0-58f4444ded33\",\"name\":\"Empresa03\",\"nome_fantasia\":\"EmpFantasia03\",\"cnpj\":\"00.000.000/0000-03\",\"cei\":null,\"cpf\":null,\"inscricao_estadual\":null,\"address\":{\"cep\":\"85555-222\",\"city\":\"Guarapuava\",\"complement\":\"Apto52\",\"country\":\"Brasil\",\"number\":\"101\",\"state\":\"PR\",\"street\":\"Rua Armando Ribas\",\"district\":\"Rua Armando Ribas\"},\"contact\":null,\"codigo_registro_folha\":\"23\",\"ativo\":true},\"departamento\":null,\"biometria\":null,\"email\":null,\"phone\":null,\"etnico_racial\":null,\"updated_at\":\"2026-04-06T22:37:18.000-03:00\",\"created_at\":\"2026-04-06T22:37:18.000-03:00\"},\"blocked\":false,\"avatar\":{\"url\":\"/assets/default-avatar.svg\"},\"accepted_terms\":true,\"uid\":\"[email protected]\",\"platform_auth\":\"mobile_platform_auth\",\"timezone\":\"America/Sao_Paulo\",\"permissions\":[{\"subject_class\":\"Ponto\",\"action\":\"create\"}]}",
  "message": "Your password has been successfully updated."
}

Encerrando a conta

Este método serve para excluir a conta do usuário atual.

Endpoint

DELETE /v1/auth

Request

Route

DELETE /v1/auth

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
Access-Token: SztFMkmVFWNbDV4Baw5vrA
Token-Type: Bearer
Client: xlISdZ027NkaUk-HxGZwtQ
Expiry: 1776735439
Uid: [email protected]
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/auth" -d '' -X DELETE \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "Access-Token: SztFMkmVFWNbDV4Baw5vrA" \
	-H "Token-Type: Bearer" \
	-H "Client: xlISdZ027NkaUk-HxGZwtQ" \
	-H "Expiry: 1776735439" \
	-H "Uid: [email protected]" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
message (String) Mensagem do resultado do recurso.
success (Boolean) Status do recurso.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"6d072e9fa748b4e48b9a13b3d5ad4480"
Cache-Control: max-age=0, private, must-revalidate
Set-Cookie: _ptrp_session=ajFicHF3b0h0cmRCTWZ4QzFvUXlVWmJDWll0MTFhVmwra3VjNm9IM1dJdERtS1lpc2FFUjc1ZkVQZXlMbWl6cVNoVFRNYnRXWW9lNmlpYkxtWVlxSEZOaFJqT211Tld1cE9UeURhaHBjeFI5T3ppOUJ3Z05tYzFQMWl1eFRrdHdrTStmQVgwWXp0NDNsbDI5TW9YdGRMd0VKTndvdUQ4WDNsOFdPM3BldUdLQXVnU1RLc3Npck1wWW9DL1B2QmZsLS1lUEV4RGlOc1kydGdXVUt4VjIwYzJ3PT0%3D--06620ee00e0e44c581d6af6cfbb3d76bbfae4367; domain=.ptrp.com.br; path=/; HttpOnly
X-Request-Id: ffeefc1a-df0b-43d9-8e8a-b2e86cc88cf0
X-Runtime: 0.128360
Vary: Origin
Content-Length: 87

Body

{
  "status": "success",
  "message": "A conta com uid '[email protected]' foi excluída."
}

Login

Este método serve para obter chave de acesso (access-token, client e UID) através de login e senha.Este é um método alternativo para clientes que utilizam cabeçalho “access-token” ao invés de “X-Auth-Token” para se autenticar na API.

Endpoint

POST /v1/auth/sign_in

Parameters

Name Description
login required (String) E-mail ou username.
password required (String) Senha do usuário.

Request

Route

POST /v1/auth/sign_in

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
Cookie:

Body

{
  "login": "[email protected]",
  "password": "teste123"
}

cURL

curl "https://api.ptrp.com.br/v1/auth/sign_in" -d '{"login":"[email protected]","password":"teste123"}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
data (Object) Atributos do Usuário.
message (String) Mensagem do resulta do recurso.
success (Boolean) Status do recurso.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
access-token: NdSQrI-t9z_-EzmLW1ubHA
token-type: Bearer
client: GNzANksZDl3KnSOQyDSlWg
expiry: 1776735439
uid: [email protected]
Content-Type: application/json; charset=utf-8
ETag: W/"5cdf20540161a24b2dfa3ca88a84a4c6"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 03e47c95-a01b-4cbc-83e8-8315f93928bf
X-Runtime: 0.311625
Vary: Origin
Content-Length: 3692

Body

{
  "data": {
    "first_name": "funcionario1",
    "last_name": "",
    "cpf": "010.333.111-22",
    "username": "funcionario1",
    "station_type": "Funcionario",
    "roles": [
      "funcionario"
    ],
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "updated_at": "2026-04-06T22:37:20.187-03:00",
    "funcionario_uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
    "temporary_password": false,
    "empresa": {
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "cei": null,
      "cpf": null,
      "inscricao_estadual": null,
      "address": {
        "cep": "85555-222",
        "city": "Guarapuava",
        "complement": "Apto52",
        "country": "Brasil",
        "number": "101",
        "state": "PR",
        "street": "Rua Armando Ribas",
        "district": "Rua Armando Ribas"
      },
      "contact": null,
      "codigo_registro_folha": "23",
      "ativo": true
    },
    "franquia": {
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe3f0",
      "name": "Franquia01",
      "nome_fantasia": "FranquiaFantasia01",
      "cnpj": "00.000.000/0000-00",
      "inscricao_estadual": null,
      "cpf": null,
      "logo": "/uploads/franquia/879004013/logo/879004013/logo.png",
      "clausula_aceite": null,
      "address": {
        "cep": "85555-222",
        "city": "Guarapuava",
        "complement": "Apto52",
        "country": "Brasil",
        "number": "101",
        "state": "PR",
        "street": "Rua Armando Ribas",
        "district": "Rua Armando Ribas"
      },
      "condicoes_comerciais": null,
      "contacts": [
        {
          "email": "[email protected]",
          "name": "My Contact",
          "phone": "(42) 05555-4444",
          "cpf": null,
          "whatsapp": null,
          "site": null,
          "instagram": null
        },
        {
          "email": "[email protected]",
          "name": "My Contact Legal",
          "phone": "(42) 05555-4444",
          "cpf": null,
          "whatsapp": null,
          "site": null,
          "instagram": null
        },
        {
          "email": "[email protected]",
          "name": "My Contact Tecnico",
          "phone": "(42) 05555-4444",
          "cpf": null,
          "whatsapp": null,
          "site": null,
          "instagram": null
        }
      ]
    },
    "email": "[email protected]",
    "station": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2000-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "1",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "cei": null,
        "cpf": null,
        "inscricao_estadual": null,
        "address": {
          "cep": "85555-222",
          "city": "Guarapuava",
          "complement": "Apto52",
          "country": "Brasil",
          "number": "101",
          "state": "PR",
          "street": "Rua Armando Ribas",
          "district": "Rua Armando Ribas"
        },
        "contact": null,
        "codigo_registro_folha": "23",
        "ativo": true
      },
      "departamento": {
        "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
        "name": "Departamento01",
        "empresa": {
          "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
          "name": "Empresa03",
          "nome_fantasia": "EmpFantasia03",
          "cnpj": "00.000.000/0000-03",
          "cei": null,
          "cpf": null,
          "inscricao_estadual": null,
          "address": {
            "cep": "85555-222",
            "city": "Guarapuava",
            "complement": "Apto52",
            "country": "Brasil",
            "number": "101",
            "state": "PR",
            "street": "Rua Armando Ribas",
            "district": "Rua Armando Ribas"
          },
          "contact": null,
          "codigo_registro_folha": "23",
          "ativo": true
        },
        "ativo": true
      },
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    },
    "blocked": false,
    "avatar": {
      "url": "/assets/default-avatar.svg"
    },
    "accepted_terms": true,
    "uid": "[email protected]",
    "platform_auth": "mobile_platform_auth",
    "timezone": "America/Sao_Paulo",
    "permissions": [
      {
        "subject_class": "Ponto",
        "action": "create"
      }
    ]
  }
}

Logout

Este método serve para excluir a sessão atual do usuário.

Endpoint

DELETE /v1/auth/sign_out

Request

Route

DELETE /v1/auth/sign_out

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
Access-Token: mpDb5YGDUNYz7yh20R_neQ
Client: 5qk4Sd7GPUifJfcEcZFuRg
Uid: [email protected]
Token-Type: Bearer
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/auth/sign_out" -d '' -X DELETE \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "Access-Token: mpDb5YGDUNYz7yh20R_neQ" \
	-H "Client: 5qk4Sd7GPUifJfcEcZFuRg" \
	-H "Uid: [email protected]" \
	-H "Token-Type: Bearer" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
data (Object) Atributos do Usuário.
message (String) Mensagem do resulta do recurso.
success (Boolean) Status do recurso.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"7363e85fe9edee6f053a4b319588c086"
Cache-Control: max-age=0, private, must-revalidate
Set-Cookie: _ptrp_session=c2RUaW0zUUlkSjRLb1QwTU1NTWhvUC9ldHN2ZERlOEpsNU5xbW5RQ09BZmFYMk5zL1JGOTgyQi9pUnRBNlVRcDU5ZnVESGtmSTgwc2lwdFVCcDBsc3c9PS0tazBJUk11UExacXJNamFPcFpDZ2poUT09--e6d3bd5e4b2983a23428062600d2121df676d74b; domain=.ptrp.com.br; path=/; HttpOnly
X-Request-Id: 0a3a539e-c96c-40d6-a84f-3f7a7d8df28e
X-Runtime: 0.213121
Vary: Origin
Content-Length: 16

Body

{
  "success": true
}

Renovar token

Este método serve para renovar a chave de acesso (access-token, client e UID).O novo token terá o tempo de validade novo.

Endpoint

PATCH /v1/auth/refresh

Request

Route

PATCH /v1/auth/refresh

Headers

Access-Token: IB-3X2_WT6fhF0jMBD73BA
Client: AIWePENTMAuYdGNhqmqY8B
Uid: [email protected]
Token-Type: Bearer
Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/auth/refresh" -d '' -X PATCH \
	-H "Access-Token: IB-3X2_WT6fhF0jMBD73BA" \
	-H "Client: AIWePENTMAuYdGNhqmqY8B" \
	-H "Uid: [email protected]" \
	-H "Token-Type: Bearer" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
access-token (String) Token de acesso.
expiry (String) Timestamp de vencimento do token.
token-type (String) Tipo do token.
uid (String) UID do usuário.
client (String) id do cliente.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"9139c3aea2d62a6610f777b8f845d164"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 2fefdd4b-7a24-4e5f-88af-8f6e7152bbd1
X-Runtime: 0.226292
Vary: Origin
Content-Length: 147

Body

{
  "access-token": "xV4fbopiELbs4UATBKjdKg",
  "token-type": "Bearer",
  "client": "CFGn81E2R8pugf5T1fKlSA",
  "expiry": "1776735440",
  "uid": "[email protected]"
}

Ações em Massa

Criando Justificativas

Este método cria Justificativa para vários funcionários no intervalo entre duas datas. Retorna um array de Justificativas criadas.

Endpoint

POST /v1/acoes-em-massa/justificativas

Parameters

Name Description
justificativas[funcionario_uids] required (Array) Array com UIDs dos funcionários.
justificativas[start_date] required (Date) Data inicial.
justificativas[end_date] required (Date) Data final.
justificativas[hora] required (Time) Quantidade de horas para justificar. Ex: "01:30".
justificativas[motivo_id] required (Integer) Id do Motivo (ver artigo de Motivos) da justificativa.
justificativas[motivo_personalizado_id] (Integer) ID do Motivo personalizado.
justificativas[abonar] (Boolean) "true" para a justificativa que serve para abonar horas do dia.

Request

Route

POST /v1/acoes-em-massa/justificativas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "justificativas": {
    "start_date": "2019-01-01",
    "end_date": "2019-01-09",
    "hora": "01:00",
    "motivo_id": 267869265,
    "funcionario_uids": [
      "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0"
    ]
  }
}

cURL

curl "https://api.ptrp.com.br/v1/acoes-em-massa/justificativas" -d '{"justificativas":{"start_date":"2019-01-01","end_date":"2019-01-09","hora":"01:00","motivo_id":267869265,"funcionario_uids":["71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0"]}}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Int) Id da Justificativa.
data (Date) Data.
hora (Time) Quantidade de horas.
desconta_dsr (Bool) Descontar DSR?
abonar (Bool) Assinalado para abonar?
motivo (Object) Objeto Motivo (ver artigo Motivos).
message (String) Resposta da requisição quando há erros.
errors[motivo] (Array) Mensagens de erros para o campo motivo_id.
errors[start_date] (Array) Mensagens de erros para o campo start_date.
errors[end_date] (Array) Mensagens de erros para o campo end_date.

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"45099013681c0644c8bdd86110497185"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: c94e0cca-279e-49a4-bba6-69daedffb470
X-Runtime: 0.131835
Vary: Origin
Content-Length: 1873

Body

[
  {
    "id": 1070701489,
    "data": "2019-01-01",
    "hora": "2000-01-01T01:00:00.000Z",
    "desconta_dsr": null,
    "abonar": null,
    "motivo": {
      "id": 267869265,
      "name": "Afastado(+de15dias)",
      "e_social_id": null
    },
    "motivo_personalizado": null
  },
  {
    "id": 1070701490,
    "data": "2019-01-02",
    "hora": "2000-01-01T01:00:00.000Z",
    "desconta_dsr": null,
    "abonar": null,
    "motivo": {
      "id": 267869265,
      "name": "Afastado(+de15dias)",
      "e_social_id": null
    },
    "motivo_personalizado": null
  },
  {
    "id": 1070701491,
    "data": "2019-01-03",
    "hora": "2000-01-01T01:00:00.000Z",
    "desconta_dsr": null,
    "abonar": null,
    "motivo": {
      "id": 267869265,
      "name": "Afastado(+de15dias)",
      "e_social_id": null
    },
    "motivo_personalizado": null
  },
  {
    "id": 1070701492,
    "data": "2019-01-04",
    "hora": "2000-01-01T01:00:00.000Z",
    "desconta_dsr": null,
    "abonar": null,
    "motivo": {
      "id": 267869265,
      "name": "Afastado(+de15dias)",
      "e_social_id": null
    },
    "motivo_personalizado": null
  },
  {
    "id": 1070701493,
    "data": "2019-01-05",
    "hora": "2000-01-01T01:00:00.000Z",
    "desconta_dsr": null,
    "abonar": null,
    "motivo": {
      "id": 267869265,
      "name": "Afastado(+de15dias)",
      "e_social_id": null
    },
    "motivo_personalizado": null
  },
  {
    "id": 1070701494,
    "data": "2019-01-06",
    "hora": "2000-01-01T01:00:00.000Z",
    "desconta_dsr": null,
    "abonar": null,
    "motivo": {
      "id": 267869265,
      "name": "Afastado(+de15dias)",
      "e_social_id": null
    },
    "motivo_personalizado": null
  },
  {
    "id": 1070701495,
    "data": "2019-01-07",
    "hora": "2000-01-01T01:00:00.000Z",
    "desconta_dsr": null,
    "abonar": null,
    "motivo": {
      "id": 267869265,
      "name": "Afastado(+de15dias)",
      "e_social_id": null
    },
    "motivo_personalizado": null
  },
  {
    "id": 1070701496,
    "data": "2019-01-08",
    "hora": "2000-01-01T01:00:00.000Z",
    "desconta_dsr": null,
    "abonar": null,
    "motivo": {
      "id": 267869265,
      "name": "Afastado(+de15dias)",
      "e_social_id": null
    },
    "motivo_personalizado": null
  },
  {
    "id": 1070701497,
    "data": "2019-01-09",
    "hora": "2000-01-01T01:00:00.000Z",
    "desconta_dsr": null,
    "abonar": null,
    "motivo": {
      "id": 267869265,
      "name": "Afastado(+de15dias)",
      "e_social_id": null
    },
    "motivo_personalizado": null
  }
]

Criando Justificativas - erros

Mostrando erros do método para criar Justificativa para vários funcionários no intervalo entre duas datas. Retorna um objeto com as falhas de validação.

Endpoint

POST /v1/acoes-em-massa/justificativas

Parameters

Name Description
justificativas[funcionario_uids] required (Array) Array com UIDs dos funcionários.
justificativas[start_date] required (Date) Data inicial.
justificativas[end_date] required (Date) Data final.
justificativas[hora] required (Time) Quantidade de horas para justificar. Ex: "01:30".
justificativas[motivo_id] required (Integer) Id do Motivo (ver artigo de Motivos) da justificativa.
justificativas[motivo_personalizado_id] (Integer) ID do Motivo personalizado.
justificativas[abonar] (Boolean) "true" para a justificativa que serve para abonar horas do dia.

Request

Route

POST /v1/acoes-em-massa/justificativas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "justificativas": {
    "start_date": "",
    "end_date": "",
    "hora": "",
    "motivo_id": "0",
    "funcionario_uids": [
      23
    ]
  }
}

cURL

curl "https://api.ptrp.com.br/v1/acoes-em-massa/justificativas" -d '{"justificativas":{"start_date":"","end_date":"","hora":"","motivo_id":"0","funcionario_uids":[23]}}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Int) Id da Justificativa.
data (Date) Data.
hora (Time) Quantidade de horas.
desconta_dsr (Bool) Descontar DSR?
abonar (Bool) Assinalado para abonar?
motivo (Object) Objeto Motivo (ver artigo Motivos).
message (String) Resposta da requisição quando há erros.
errors[motivo] (Array) Mensagens de erros para o campo motivo_id.
errors[start_date] (Array) Mensagens de erros para o campo start_date.
errors[end_date] (Array) Mensagens de erros para o campo end_date.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: c12a879d-a77e-4d85-986d-9d7d75bcd598
X-Runtime: 0.051123
Vary: Origin
Content-Length: 274

Body

{
  "message": "Validation Failed!",
  "errors": {
    "start_date": [
      "can't be blank",
      "Invalid Date format",
      "Invalid Date format"
    ],
    "end_date": [
      "can't be blank",
      "Invalid Date format",
      "Invalid Date format",
      "Invalid Date format"
    ],
    "hora": [
      "can't be blank"
    ],
    "motivo_id": [
      "Record not found"
    ]
  }
}

Excluindo Justificativas

Este método exclui as justificativas dos funcionários entre duas datas.

Endpoint

DELETE /v1/acoes-em-massa/justificativas

Parameters

Name Description
justificativas[funcionario_uids] required (Array) Array com UIDs dos funcionários.
justificativas[start_date] required (Date) Data inicial.
justificativas[end_date] required (Date) Data final.
justificativas[motivo_id] required (Integer) Id do Motivo (ver artigo de Motivos) da justificativa.

Request

Route

DELETE /v1/acoes-em-massa/justificativas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "justificativas": {
    "start_date": "2014-01-10",
    "end_date": "2014-01-13",
    "motivo_id": 267869265,
    "funcionario_uids": [
      "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0"
    ]
  }
}

cURL

curl "https://api.ptrp.com.br/v1/acoes-em-massa/justificativas" -d '{"justificativas":{"start_date":"2014-01-10","end_date":"2014-01-13","motivo_id":267869265,"funcionario_uids":["71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0"]}}' -X DELETE \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
message (String) Resposta da requisição quando há erros.
errors[start_date] (Array) Mensagens de erros para o campo start_date.
errors[end_date] (Array) Mensagens de erros para o campo end_date.
errors[funcionario_uids] (Array) Mensagens de erros para o campo funcionario_uids.

Status

204

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Cache-Control: no-cache
X-Request-Id: 223941f6-9b7a-44c8-8b6f-fdf10f24cd58
X-Runtime: 0.049877
Vary: Origin

Excluindo Justificativas - erros

Mostrando erros da exclusão das justificativas dos funcionários entre duas datas.

Endpoint

DELETE /v1/acoes-em-massa/justificativas

Parameters

Name Description
justificativas[funcionario_uids] required (Array) Array com UIDs dos funcionários.
justificativas[start_date] required (Date) Data inicial.
justificativas[end_date] required (Date) Data final.
justificativas[motivo_id] required (Integer) Id do Motivo (ver artigo de Motivos) da justificativa.

Request

Route

DELETE /v1/acoes-em-massa/justificativas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "justificativas": {
    "start_date": "2014-01-10",
    "end_date": "2014-05-13",
    "motivo_id": 267869265,
    "funcionario_uids": [
      "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0"
    ]
  }
}

cURL

curl "https://api.ptrp.com.br/v1/acoes-em-massa/justificativas" -d '{"justificativas":{"start_date":"2014-01-10","end_date":"2014-05-13","motivo_id":267869265,"funcionario_uids":["71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0"]}}' -X DELETE \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
message (String) Resposta da requisição quando há erros.
errors[start_date] (Array) Mensagens de erros para o campo start_date.
errors[end_date] (Array) Mensagens de erros para o campo end_date.
errors[funcionario_uids] (Array) Mensagens de erros para o campo funcionario_uids.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: c07a6af0-f39f-4589-bfa8-b6fd57604028
X-Runtime: 0.043033
Vary: Origin
Content-Length: 91

Body

{
  "message": "Destroy Failed!",
  "errors": {
    "end_date": [
      "Interval bounds of maximum 60 days."
    ]
  }
}

Cartão Ponto > Banco de Horas

Adicionando banco de horas - Extra

Este método adiciona um banco de horas na extra na data do cartão ponto.

Endpoint

POST /v1/funcionarios/:funcionario_id/cartao_ponto/:year/:month/banco_horas

Parameters

Name Description default
funcionario_id required (String) UID do funcionário.
year required (Int) Ano do periodo do cartão ponto. Ex: 2017.
month required (Int) Mês do periodo do cartão ponto. Ex: 10.
datas required (Array) Lista de datas a serem aplicadas. Ex: ["2015-01-01"].
hora required (Time) Quantidade de horas a serem aplicadas na extra/falta. Ex: "04:00". A quantidade de horas será limitada a quantidade disponível no dia.
resumo_dia_attr (String) Tipo de operação do banco de horas. Tipo "extra": adiciona ao BH(+) removendo das horas extras. Tipo "falta": adiciona ao BH(-) removendo das horas de falta. "extra"

Request

Route

POST /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d1/cartao_ponto/2015/1/banco_horas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "datas": [
    "2015-01-01"
  ],
  "hora": "04:00",
  "resumo_dia_attr": "extra"
}

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d1/cartao_ponto/2015/1/banco_horas" -d '{"datas":["2015-01-01"],"hora":"04:00","resumo_dia_attr":"extra"}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json
Cache-Control: no-cache
X-Request-Id: 59650ab1-3008-434f-8009-36814282a1cb
X-Runtime: 0.031271
Vary: Origin
Content-Length: 0

Adicionando banco de horas - Falta

Este método adiciona um banco de horas na falta na data do cartão ponto.

Endpoint

POST /v1/funcionarios/:funcionario_id/cartao_ponto/:year/:month/banco_horas

Parameters

Name Description default
funcionario_id required (String) UID do funcionário.
year required (Int) Ano do periodo do cartão ponto. Ex: 2017.
month required (Int) Mês do periodo do cartão ponto. Ex: 10.
datas required (Array) Lista de datas a serem aplicadas. Ex: ["2015-01-01"].
hora required (Time) Quantidade de horas a serem aplicadas na extra/falta. Ex: "04:00". A quantidade de horas será limitada a quantidade disponível no dia.
resumo_dia_attr (String) Tipo de operação do banco de horas. Tipo "extra": adiciona ao BH(+) removendo das horas extras. Tipo "falta": adiciona ao BH(-) removendo das horas de falta. "extra"

Request

Route

POST /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d1/cartao_ponto/2015/1/banco_horas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "datas": [
    "2015-01-01"
  ],
  "hora": "04:00",
  "resumo_dia_attr": "falta"
}

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d1/cartao_ponto/2015/1/banco_horas" -d '{"datas":["2015-01-01"],"hora":"04:00","resumo_dia_attr":"falta"}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json
Cache-Control: no-cache
X-Request-Id: 2f73e451-d366-450a-b5f6-5d9c84b4f8de
X-Runtime: 0.066875
Vary: Origin
Content-Length: 0

Adicionando banco de horas - Requisição Inválida

Este método mostra falhas na validação do banco de horas.

Endpoint

POST /v1/funcionarios/:funcionario_id/cartao_ponto/:year/:month/banco_horas

Parameters

Name Description default
funcionario_id required (String) UID do funcionário.
year required (Int) Ano do periodo do cartão ponto. Ex: 2017.
month required (Int) Mês do periodo do cartão ponto. Ex: 10.
datas required (Array) Lista de datas a serem aplicadas. Ex: ["2015-01-01"].
hora required (Time) Quantidade de horas a serem aplicadas na extra/falta. Ex: "04:00". A quantidade de horas será limitada a quantidade disponível no dia.
resumo_dia_attr (String) Tipo de operação do banco de horas. Tipo "extra": adiciona ao BH(+) removendo das horas extras. Tipo "falta": adiciona ao BH(-) removendo das horas de falta. "extra"

Request

Route

POST /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d1/cartao_ponto/2015/1/banco_horas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "datas": "2015-01-01"
}

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d1/cartao_ponto/2015/1/banco_horas" -d '{"datas":"2015-01-01"}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
errors[hora] (Array) Mensagens de erros para o campo hora.
errors[datas] (Array) Mensagens de erros para o campo datas.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: 2dbbee2c-ecf5-4ac4-bd70-e60ff870ba79
X-Runtime: 0.029110
Vary: Origin
Content-Length: 76

Body

{
  "dates": [
    "can't be blank"
  ],
  "hora": [
    "can't be blank",
    "Invalid Time format"
  ]
}

Cartão Ponto > Jutificativas

Criando Justificativa

Este método cria uma justificativa no periodo do cartão ponto.

Endpoint

POST /v1/funcionarios/:funcionario_id/cartao_ponto/:year/:month/justificativas

Parameters

Name Description
funcionario_id required (String) UID do funcionário.
year required (Int) Ano do periodo do cartão ponto. Ex: 2017.
month required (Int) Mês do periodo do cartão ponto. Ex: 10.
cartao_ponto_justificativa[data] required (Date) Data da justificativa. Ex: "2017-01-01".
cartao_ponto_justificativa[hora] required (Time) Quantidade de horas da justificativa. Ex: "08:00".
cartao_ponto_justificativa[motivo_id] required (Int) ID do Motivo.
cartao_ponto_justificativa[motivo_personalizado_id] (Int) ID do Motivo personalizado.
cartao_ponto_justificativa[descontar_dsr] (Boolean) Descontar DSR.
cartao_ponto_justificativa[abonar] (Boolean) Identifica se a justificativa serve para abonar horas do dia.

Request

Route

POST /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2014/1/justificativas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "cartao_ponto_justificativa": {
    "data": "2014-01-01",
    "hora": "04:00",
    "motivo_id": 267869265
  }
}

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2014/1/justificativas" -d '{"cartao_ponto_justificativa":{"data":"2014-01-01","hora":"04:00","motivo_id":267869265}}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Int) Identificador da Justificativa no cartão ponto.
data (Date) Data da justificativa.
hora (Time) Quantidade de horas da justificativa.
descontar_dsr (Boolean) Descontar DSR.
abonar (Boolean) Identifica se a justificativa serve para abonar horas do dia.
motivo (Motivo) motivo da justificativa.
motivo[id] (Int) ID do Motivo.
motivo[name] (String) Nome do motivo.
motivo[e_social_id] (Int) Código da tabela E-Social.
motivo_personalizado (Motivo) motivo personalizado da justificativa.
motivo_personalizado[id] (Int) ID do Motivo.
motivo_personalizado[name] (String) Nome do motivo.
motivo_personalizado[e_social_id] (Int) Código da tabela E-Social.
errors[hora] (Array) Mensagens de erros para o campo hora.
errors[motivo_id] (Array) Mensagens de erros para o campo motivo_id.

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"415c991574f348099e48864eb297d222"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: a5f135a4-5891-41f0-90c1-7c4ecd72a5f7
X-Runtime: 0.052163
Vary: Origin
Content-Length: 208

Body

{
  "id": 1070701487,
  "data": "2014-01-01",
  "hora": "2000-01-01T04:00:00.000Z",
  "desconta_dsr": false,
  "abonar": true,
  "motivo": {
    "id": 267869265,
    "name": "Afastado(+de15dias)",
    "e_social_id": null
  },
  "motivo_personalizado": null
}

Criando Justificativa - erros

Este método mostra falhas na validação da justificativa.

Endpoint

POST /v1/funcionarios/:funcionario_id/cartao_ponto/:year/:month/justificativas

Parameters

Name Description
funcionario_id required (String) UID do funcionário.
year required (Int) Ano do periodo do cartão ponto. Ex: 2017.
month required (Int) Mês do periodo do cartão ponto. Ex: 10.
cartao_ponto_justificativa[data] required (Date) Data da justificativa. Ex: "2017-01-01".
cartao_ponto_justificativa[hora] required (Time) Quantidade de horas da justificativa. Ex: "08:00".
cartao_ponto_justificativa[motivo_id] required (Int) ID do Motivo.
cartao_ponto_justificativa[motivo_personalizado_id] (Int) ID do Motivo personalizado.
cartao_ponto_justificativa[descontar_dsr] (Boolean) Descontar DSR.
cartao_ponto_justificativa[abonar] (Boolean) Identifica se a justificativa serve para abonar horas do dia.

Request

Route

POST /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2014/1/justificativas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "cartao_ponto_justificativa": {
    "data": "2014-01-01"
  }
}

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2014/1/justificativas" -d '{"cartao_ponto_justificativa":{"data":"2014-01-01"}}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Int) Identificador da Justificativa no cartão ponto.
data (Date) Data da justificativa.
hora (Time) Quantidade de horas da justificativa.
descontar_dsr (Boolean) Descontar DSR.
abonar (Boolean) Identifica se a justificativa serve para abonar horas do dia.
motivo (Motivo) motivo da justificativa.
motivo[id] (Int) ID do Motivo.
motivo[name] (String) Nome do motivo.
motivo[e_social_id] (Int) Código da tabela E-Social.
motivo_personalizado (Motivo) motivo personalizado da justificativa.
motivo_personalizado[id] (Int) ID do Motivo.
motivo_personalizado[name] (String) Nome do motivo.
motivo_personalizado[e_social_id] (Int) Código da tabela E-Social.
errors[hora] (Array) Mensagens de erros para o campo hora.
errors[motivo_id] (Array) Mensagens de erros para o campo motivo_id.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: edd65f3b-e676-4740-8322-42ed0ef63b7e
X-Runtime: 0.049600
Vary: Origin
Content-Length: 141

Body

{
  "message": "Validation Failed!",
  "errors": {
    "hora": [
      "can't be blank"
    ],
    "motivo_id": [
      "can't be blank"
    ],
    "motivo": [
      "is not included in the list"
    ]
  }
}

Excluindo uma justificativa do cartão ponto

Este método exclui a justificativa do cartão ponto do funcionário.

Endpoint

DELETE /v1/funcionarios/:funcionario_id/cartao_ponto/:year/:month/justificativas/:id

Parameters

Name Description
funcionario_id required (String) UID do funcionário.
year required (Int) Ano do periodo do cartão ponto. Ex: 2017.
month required (Int) Mês do periodo do cartão ponto. Ex: 10.
id required (Int) ID da Justificativa.

Request

Route

DELETE /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2014/1/justificativas/516301284

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2014/1/justificativas/516301284" -d '' -X DELETE \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Status

204

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Cache-Control: no-cache
X-Request-Id: b8709d3a-087e-4841-8781-0dc78a0eb8bf
X-Runtime: 0.042823
Vary: Origin

Listando Justificativas no periodo

Este método retorna um array de justificativas no periodo do cartão ponto do funcionario.

Endpoint

GET /v1/funcionarios/:funcionario_id/cartao_ponto/:year/:month/justificativas

Parameters

Name Description
funcionario_id required (String) UID do funcionário.
year required (Int) Ano do periodo do cartão ponto. Ex: 2017.
month required (Int) Mês do periodo do cartão ponto. Ex: 10.

Request

Route

GET /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2014/1/justificativas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2014/1/justificativas" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Int) Identificador da Justificativa no cartão ponto.
data (Date) Data da justificativa.
hora (Time) Quantidade de horas da justificativa.
descontar_dsr (Boolean) Descontar DSR.
abonar (Boolean) Identifica se a justificativa serve para abonar horas do dia.
motivo (Motivo) Motivo da justificativa.
motivo[id] (Int) ID do Motivo.
motivo[name] (String) Nome do motivo.
motivo[e_social_id] (Int) Código da tabela E-Social.
motivo_personalizado (Motivo) Motivo personalizado da justificativa.
motivo_personalizado[id] (Int) ID do Motivo.
motivo_personalizado[name] (String) Nome do motivo.
motivo_personalizado[e_social_id] (Int) Código da tabela E-Social.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"028106516bf3b5d5295097ed2395d0c4"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: c2fc9ec9-31f5-4d83-ade2-aa0e31f458d3
X-Runtime: 0.091404
Vary: Origin
Content-Length: 401

Body

[
  {
    "id": 516301284,
    "data": "2014-01-13",
    "hora": "2000-01-01T08:00:00.000Z",
    "desconta_dsr": false,
    "abonar": true,
    "motivo": {
      "id": 385748469,
      "name": "APS",
      "e_social_id": null
    },
    "motivo_personalizado": null
  },
  {
    "id": 362056319,
    "data": "2014-01-10",
    "hora": "2000-01-01T08:00:00.000Z",
    "desconta_dsr": false,
    "abonar": true,
    "motivo": {
      "id": 267869265,
      "name": "Afastado(+de15dias)",
      "e_social_id": null
    },
    "motivo_personalizado": null
  }
]

Cartão Ponto > Marcação

Criando Marcação

Este método cria uma marcação numa data no cartão ponto.

Endpoint

POST /v1/funcionarios/:funcionario_id/cartao_ponto/:year/:month/marcacao/:data

Parameters

Name Description
funcionario_id required (String) UID do funcionário.
year required (Int) Ano do periodo do cartão ponto. Ex: 2017.
month required (Int) Mês do periodo do cartão ponto. Ex: 10.
data required (Date) Data da Marcação. Ex: "2017-01-01".
hora required (Time) Hora da Marcação. Ex: "08:00".
motivo_id required (Int) ID do Motivo.
motivo_personalizado_id (Int) ID do Motivo personalizado.

Request

Route

POST /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2014/1/marcacao/2014-01-01

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "hora": "04:00",
  "motivo_id": 267869265
}

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2014/1/marcacao/2014-01-01" -d '{"hora":"04:00","motivo_id":267869265}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
data (Date) Data da marcação.
hora (Time) Quantidade de horas da marcação.
category (String) Tipo do registro.
tipo (String) Dado legado (usar campo category).
motivo (Motivo) motivo da marcação.
motivo[id] (Int) ID do Motivo.
motivo[name] (String) Nome do motivo.
motivo[e_social_id] (Int) Código da tabela E-Social.
motivo_personalizado (Motivo) motivo personalizado da marcação.
motivo_personalizado[id] (Int) ID do Motivo.
motivo_personalizado[name] (String) Nome do motivo.
motivo_personalizado[e_social_id] (Int) Código da tabela E-Social.
errors[data] (Array) Mensagens de erros para o campo data.
errors[hora] (Array) Mensagens de erros para o campo hora.
errors[motivo_id] (Array) Mensagens de erros para o campo motivo_id.

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"1e0189f9a6d3c19765d3ea4d95ead800"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: ae833327-7e15-4c7b-8967-4bcaba8ea06f
X-Runtime: 0.104499
Vary: Origin
Content-Length: 161

Body

{
  "data": "2014-01-01",
  "hora": "2000-01-01T04:00:00.000Z",
  "ordem": 0,
  "motivo": {
    "id": 267869265,
    "name": "Afastado(+de15dias)",
    "e_social_id": null
  },
  "category": "incluido"
}

Criando Marcação - requisição inválida

Este método mostra falhas na validação da requisição.

Endpoint

POST /v1/funcionarios/:funcionario_id/cartao_ponto/:year/:month/marcacao/:data

Parameters

Name Description
funcionario_id required (String) UID do funcionário.
year required (Int) Ano do periodo do cartão ponto. Ex: 2017.
month required (Int) Mês do periodo do cartão ponto. Ex: 10.
data required (Date) Data da Marcação. Ex: "2017-01-01".
hora required (Time) Hora da Marcação. Ex: "08:00".
motivo_id required (Int) ID do Motivo.
motivo_personalizado_id (Int) ID do Motivo personalizado.

Request

Route

POST /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2014/1/marcacao/2014-01-01

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2014/1/marcacao/2014-01-01" -d '' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
data (Date) Data da marcação.
hora (Time) Quantidade de horas da marcação.
category (String) Tipo do registro.
tipo (String) Dado legado (usar campo category).
motivo (Motivo) motivo da marcação.
motivo[id] (Int) ID do Motivo.
motivo[name] (String) Nome do motivo.
motivo[e_social_id] (Int) Código da tabela E-Social.
motivo_personalizado (Motivo) motivo personalizado da marcação.
motivo_personalizado[id] (Int) ID do Motivo.
motivo_personalizado[name] (String) Nome do motivo.
motivo_personalizado[e_social_id] (Int) Código da tabela E-Social.
errors[data] (Array) Mensagens de erros para o campo data.
errors[hora] (Array) Mensagens de erros para o campo hora.
errors[motivo_id] (Array) Mensagens de erros para o campo motivo_id.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: f2919b22-3a4d-47b9-a57a-ebff7f35c40f
X-Runtime: 0.046068
Vary: Origin
Content-Length: 96

Body

{
  "message": "Validation Failed!",
  "errors": {
    "motivo_id": [
      "can't be blank"
    ],
    "hora": [
      "is invalid"
    ]
  }
}

Coletas

Creating a Coleta with option to process

This method creates and process a new Coleta.

Endpoint

POST /v1/coletas

Parameters

Name Description
coleta[arquivo] required String of filename.
coleta[folha_de_rosto_id] Folha de Rosto Id.
coleta[equipamento_id] Equipamento Id. Required if file has no head with equipment details or API current user is not a Funcionario.
coleta[afd] Boolean if file is an AFD.
coleta[afd_parcial] Boolean if file is an AFD parcial.
process Boolean to process the file, set to "true". The request might be little longer.

Request

Route

POST /v1/coletas

Headers

Host: api.ptrp.com.br
Content-Type: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Cookie:

Body

------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="coleta[arquivo]"; filename="AFD_func_1_parcial.txt"
Content-Type: text/txt
Content-Length: 630

[uploaded data]
------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="process"

true
------------XnJLe9ZIbbGUYtzPQJ16u1--

cURL

curl "https://api.ptrp.com.br/v1/coletas" -d '------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="coleta[arquivo]"; filename="AFD_func_1_parcial.txt"
Content-Type: text/txt
Content-Length: 630

[uploaded data]
------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="process"

true
------------XnJLe9ZIbbGUYtzPQJ16u1--
' -X POST \
	-H "Content-Type: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Platform-Auth: mobile" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
arquivo Filename.
processado Boolean if coleta has been processed.
equipamento Object that coleta belongs to.
equipamento[name] Name.
equipamento[fabricante] Fabricante name.
equipamento[modelo_equipamento] Modelo Equipamento.
equipamento[ip] IP address.
equipamento[nequipamento] Nequipamento.
equipamento[nserie_rep] Serial number of equipment.
equipamento[ativo] Boolean state of equipment.
equipamento[integration_rep] Boolean if has integration with REP.
equipamento[total_marcacoes] Count of marcações.
equipamento[total_marcacoes_bobina] Count of marcações/bobina.
equipamento[metragem_bobina_recomendada] Metragem Bobina Recomendada.
created_at Creation DateTime.
updated_at Update DateTime.
folha_de_rosto Folha de rosto Object that coleta belongs to.
first_line_date DateTime of first line.
last_line_date DateTime of last line.
post_messages Array of notice messages after creation.
message String alert about response.
errors Object with field names that contain validation errors.
errors[arquivo] Array of error messages of field arquivo.
errors[equipamento_id] Array of error messages of field equipamento_id.

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"2b096c4e22199d7066474a6251744f64"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: e91caf5a-269a-43f5-90d8-5913923380ce
X-Runtime: 0.167112
Vary: Origin
Content-Length: 821

Body

{
  "arquivo": "AFD_func_1_parcial.txt",
  "processado": true,
  "equipamento": {
    "id": 218730046,
    "name": "app mobile",
    "fabricante": null,
    "modelo_equipamento": null,
    "ip": null,
    "nequipamento": null,
    "nserie_rep": "55976061efeba6bcac449b5d21bb1050e8d6b99be0c9f84b9c71901b9fb8",
    "ativo": true,
    "integration_rep": false,
    "total_marcacoes": null,
    "total_marcacoes_bobina": null,
    "metragem_bobina_recomendada": null,
    "cpf": null,
    "app": true,
    "empresa_uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
    "user": null,
    "password": null,
    "platform": "mobile"
  },
  "created_at": "2026-04-06T22:37:21.362-03:00",
  "updated_at": "2026-04-06T22:37:21.476-03:00",
  "folha_de_rosto": null,
  "first_line_date": "2019-09-01T08:01:00.000+00:00",
  "last_line_date": "2019-09-03T17:08:00.000+00:00",
  "post_messages": [
    "translation missing: en.activerecord.warning.coleta.invalid_date_count"
  ],
  "unshared": true
}

Creating a Coleta with user Funcionario

This method creates a new Coleta by user Funcionario.

Endpoint

POST /v1/coletas

Parameters

Name Description
coleta[arquivo] required String of filename.
coleta[folha_de_rosto_id] Folha de Rosto Id.
coleta[equipamento_id] Equipamento Id. Required if file has no head with equipment details or API current user is not a Funcionario.
coleta[afd] Boolean if file is an AFD.
coleta[afd_parcial] Boolean if file is an AFD parcial.
process Boolean to process the file, set to "true". The request might be little longer.

Request

Route

POST /v1/coletas

Headers

Host: api.ptrp.com.br
Content-Type: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Cookie:

Body

------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="coleta[arquivo]"; filename="AFD_func_1_parcial.txt"
Content-Type: text/txt
Content-Length: 630

[uploaded data]
------------XnJLe9ZIbbGUYtzPQJ16u1--

cURL

curl "https://api.ptrp.com.br/v1/coletas" -d '------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="coleta[arquivo]"; filename="AFD_func_1_parcial.txt"
Content-Type: text/txt
Content-Length: 630

[uploaded data]
------------XnJLe9ZIbbGUYtzPQJ16u1--
' -X POST \
	-H "Content-Type: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Platform-Auth: mobile" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
arquivo Filename.
processado Boolean if coleta has been processed.
equipamento Object that coleta belongs to.
equipamento[name] Name.
equipamento[fabricante] Fabricante name.
equipamento[modelo_equipamento] Modelo Equipamento.
equipamento[ip] IP address.
equipamento[nequipamento] Nequipamento.
equipamento[nserie_rep] Serial number of equipment.
equipamento[ativo] Boolean state of equipment.
equipamento[integration_rep] Boolean if has integration with REP.
equipamento[total_marcacoes] Count of marcações.
equipamento[total_marcacoes_bobina] Count of marcações/bobina.
equipamento[metragem_bobina_recomendada] Metragem Bobina Recomendada.
created_at Creation DateTime.
updated_at Update DateTime.
folha_de_rosto Folha de rosto Object that coleta belongs to.
first_line_date DateTime of first line.
last_line_date DateTime of last line.
post_messages Array of notice messages after creation.
message String alert about response.
errors Object with field names that contain validation errors.
errors[arquivo] Array of error messages of field arquivo.
errors[equipamento_id] Array of error messages of field equipamento_id.

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"6d21a87e246451bf122bdefcca335850"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 2e729479-fdcb-4900-a0de-bd2637282340
X-Runtime: 0.077218
Vary: Origin
Content-Length: 750

Body

{
  "arquivo": "AFD_func_1_parcial.txt",
  "processado": false,
  "equipamento": {
    "id": 218730046,
    "name": "app mobile",
    "fabricante": null,
    "modelo_equipamento": null,
    "ip": null,
    "nequipamento": null,
    "nserie_rep": "6a03e67e389dec07c0a58833eafe6dca47bd97e5ec6374af9b6f62599912",
    "ativo": true,
    "integration_rep": false,
    "total_marcacoes": null,
    "total_marcacoes_bobina": null,
    "metragem_bobina_recomendada": null,
    "cpf": null,
    "app": true,
    "empresa_uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
    "user": null,
    "password": null,
    "platform": "mobile"
  },
  "created_at": "2026-04-06T22:37:21.305-03:00",
  "updated_at": "2026-04-06T22:37:21.305-03:00",
  "folha_de_rosto": null,
  "first_line_date": "2019-09-01T08:01:00.000+00:00",
  "last_line_date": "2019-09-03T17:08:00.000+00:00",
  "post_messages": [

  ],
  "unshared": true
}

Creating a coleta

This method creates a new coleta.

Endpoint

POST /v1/coletas

Parameters

Name Description
coleta[arquivo] required String of filename.
coleta[folha_de_rosto_id] Folha de Rosto Id.
coleta[equipamento_id] Equipamento Id. Required if file has no head with equipment details or API current user is not a Funcionario.
coleta[afd] Boolean if file is an AFD.
coleta[afd_parcial] Boolean if file is an AFD parcial.
process Boolean to process the file, set to "true". The request might be little longer.

Request

Route

POST /v1/coletas

Headers

Host: api.ptrp.com.br
Content-Type: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="coleta[arquivo]"; filename="AFD_HEAD.txt"
Content-Type: text/txt
Content-Length: 3404

[uploaded data]
------------XnJLe9ZIbbGUYtzPQJ16u1--

cURL

curl "https://api.ptrp.com.br/v1/coletas" -d '------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="coleta[arquivo]"; filename="AFD_HEAD.txt"
Content-Type: text/txt
Content-Length: 3404

[uploaded data]
------------XnJLe9ZIbbGUYtzPQJ16u1--
' -X POST \
	-H "Content-Type: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
arquivo Filename.
processado Boolean if coleta has been processed.
equipamento Object that coleta belongs to.
equipamento[name] Name.
equipamento[fabricante] Fabricante name.
equipamento[modelo_equipamento] Modelo Equipamento.
equipamento[ip] IP address.
equipamento[nequipamento] Nequipamento.
equipamento[nserie_rep] Serial number of equipment.
equipamento[ativo] Boolean state of equipment.
equipamento[integration_rep] Boolean if has integration with REP.
equipamento[total_marcacoes] Count of marcações.
equipamento[total_marcacoes_bobina] Count of marcações/bobina.
equipamento[metragem_bobina_recomendada] Metragem Bobina Recomendada.
created_at Creation DateTime.
updated_at Update DateTime.
folha_de_rosto Folha de rosto Object that coleta belongs to.
first_line_date DateTime of first line.
last_line_date DateTime of last line.
post_messages Array of notice messages after creation.
message String alert about response.
errors Object with field names that contain validation errors.
errors[arquivo] Array of error messages of field arquivo.
errors[equipamento_id] Array of error messages of field equipamento_id.

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"d150503606d4afabee5fba898177711a"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: ec9b1ab7-9256-43fb-80bd-854ceaed704a
X-Runtime: 0.110077
Vary: Origin
Content-Length: 695

Body

{
  "arquivo": "AFD_HEAD.txt",
  "processado": false,
  "equipamento": {
    "id": 851363599,
    "name": "Equipamento não cadastrado 851363599",
    "fabricante": null,
    "modelo_equipamento": null,
    "ip": null,
    "nequipamento": "851363599",
    "nserie_rep": "00042002250000110",
    "ativo": true,
    "integration_rep": false,
    "total_marcacoes": null,
    "total_marcacoes_bobina": null,
    "metragem_bobina_recomendada": null,
    "cpf": null,
    "app": false,
    "empresa_uid": null,
    "user": null,
    "password": null,
    "platform": null
  },
  "created_at": "2026-04-06T22:37:21.162-03:00",
  "updated_at": "2026-04-06T22:37:21.162-03:00",
  "folha_de_rosto": null,
  "first_line_date": "2014-11-03T11:30:00.000+00:00",
  "last_line_date": "2014-11-10T16:37:00.000+00:00",
  "post_messages": [

  ],
  "unshared": false
}

Creating a coleta - errors

This method shows validation fails.

Endpoint

POST /v1/coletas

Parameters

Name Description
coleta[arquivo] required String of filename.
coleta[folha_de_rosto_id] Folha de Rosto Id.
coleta[equipamento_id] Equipamento Id. Required if file has no head with equipment details or API current user is not a Funcionario.
coleta[afd] Boolean if file is an AFD.
coleta[afd_parcial] Boolean if file is an AFD parcial.
process Boolean to process the file, set to "true". The request might be little longer.

Request

Route

POST /v1/coletas

Headers

Host: api.ptrp.com.br
Content-Type: multipart/form-data
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/coletas" -d '' -X POST \
	-H "Content-Type: multipart/form-data" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
arquivo Filename.
processado Boolean if coleta has been processed.
equipamento Object that coleta belongs to.
equipamento[name] Name.
equipamento[fabricante] Fabricante name.
equipamento[modelo_equipamento] Modelo Equipamento.
equipamento[ip] IP address.
equipamento[nequipamento] Nequipamento.
equipamento[nserie_rep] Serial number of equipment.
equipamento[ativo] Boolean state of equipment.
equipamento[integration_rep] Boolean if has integration with REP.
equipamento[total_marcacoes] Count of marcações.
equipamento[total_marcacoes_bobina] Count of marcações/bobina.
equipamento[metragem_bobina_recomendada] Metragem Bobina Recomendada.
created_at Creation DateTime.
updated_at Update DateTime.
folha_de_rosto Folha de rosto Object that coleta belongs to.
first_line_date DateTime of first line.
last_line_date DateTime of last line.
post_messages Array of notice messages after creation.
message String alert about response.
errors Object with field names that contain validation errors.
errors[arquivo] Array of error messages of field arquivo.
errors[equipamento_id] Array of error messages of field equipamento_id.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: 0ebff76e-2fcb-453a-a730-e59eeacfdab5
X-Runtime: 0.048381
Vary: Origin
Content-Length: 105

Body

{
  "message": "Validation Failed!",
  "errors": {
    "arquivo": [
      "can't be blank"
    ],
    "equipamento": [
      "can't be blank"
    ]
  }
}

Departamentos

Listando Departamentos

Este método retorna um array de departamentos.

Endpoint

GET /v1/departamentos

Request

Route

GET /v1/departamentos

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/departamentos" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
uid (String) UID do Departamento.
name (String) Nome do departamento.
empresa (Empresa) Objeto [Empresa] com dados sobre a empresa vinculada.
ativo (Boolean) Se o departamento está atualmente ativo.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"806dbd15496fce87ce3b5f2a91b66c11"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: b1f9d929-d562-44d7-995e-5717fafda93c
X-Runtime: 0.086452
Vary: Origin
Content-Length: 347

Body

[
  {
    "uid": "0b69bc9e-8704-4b3e-b66e-c26c742a8be9",
    "name": "Nome do departamento",
    "empresa": {
      "uid": "c43becdf-ba77-4062-97c0-58f3335dad92",
      "name": "Empresa01",
      "nome_fantasia": "EmpFantasia01",
      "cnpj": "00.000.000/0000-01",
      "cei": null,
      "cpf": null,
      "inscricao_estadual": null,
      "address": null,
      "contact": null,
      "codigo_registro_folha": null,
      "ativo": true
    },
    "ativo": true
  }
]

Empresas

Alterando uma Empresa

Este método altera uma empresa.

Endpoint

PATCH /v1/empresas/:id

Parameters

Name Description
empresa[cnpj] required (String) Identificador de CNPJ.
empresa[name] required (String) Razão Social.
empresa[nome_fantasia] required (String) Nome Fantasia.
empresa[cei] (String) Identificador de CEI.
empresa[cpf] (String) Identificador de CPF.
empresa[inscricao_estadual] (String) Identificador de Inscrição Estadual.
empresa[ativo] (Boolean) Status do registro.
empresa[codigo_registro_folha] (String) Código de registro de folha de pagamento.
empresa[address_attributes][cep] (String) CEP.
empresa[address_attributes][city] (String) Cidade.
empresa[address_attributes][complement] (String) Complemento.
empresa[address_attributes][country] (String) País.
empresa[address_attributes][number] (String) Número.
empresa[address_attributes][state] (String) Estado.
empresa[address_attributes][street] (String) Logradouro.
empresa[address_attributes][district] (String) Bairro.
empresa[contact_attributes][name] (String) Nome do responsável.
empresa[contact_attributes][email] (String) E-mail.
empresa[contact_attributes][phone] (String) Telefone.
empresa[contact_attributes][cpf] (String) CPF.
empresa[contact_attributes][site] (String) Endereço do Site.
empresa[contact_attributes][whatsapp] (String) Número de Whatsapp.
empresa[contact_attributes][instagram] (String) Endereço do instagram.

Request

Route

PATCH /v1/empresas/c43becdf-ba77-4062-97c0-58f3335dad92

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "empresa": {
    "name": "Novo nome"
  }
}

cURL

curl "https://api.ptrp.com.br/v1/empresas/c43becdf-ba77-4062-97c0-58f3335dad92" -d '{"empresa":{"name":"Novo nome"}}' -X PATCH \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
uid (String) UID da Empresa.
name (String) Razão social.
nome_fantasia (String) Nome fantasia.
cnpj (String) CNPJ.
cei (String) CEI.
cpf (String) CPF.
inscricao_estadual (String) Inscrição Estadual.
address (Address) Objeto com dados do endereço.
address[cep] (String) CEP.
address[city] (String) Cidade.
address[complement] (String) Complemento.
address[country] (String) País.
address[number] (String) Número.
address[state] (String) Estado.
address[street] (String) Logradouro.
address[district] (String) Bairro.
contact (Contact) Objeto com dados do contato.
contact[name] (String) Nome do responsável.
contact[email] (String) E-mail.
contact[phone] (String) Telefone.
contact[cpf] (String) CPF.
contact[site] (String) Endereço do Site.
contact[whatsapp] (String) Número de Whatsapp.
contact[instagram] (String) Endereço do instagram.
codigo_registro_folha (String) Código do registro de folha de pagamento.
ativo (Boolean) Se a empresa está atualmente ativa.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"aed5deb502bd2e2a893e41f7d8a7b5b5"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 9296ded0-6025-45b4-8471-9674806ad142
X-Runtime: 0.041333
Vary: Origin
Content-Length: 245

Body

{
  "uid": "c43becdf-ba77-4062-97c0-58f3335dad92",
  "name": "Novo Nome",
  "nome_fantasia": "EmpFantasia01",
  "cnpj": "00.000.000/0000-01",
  "cei": null,
  "cpf": null,
  "inscricao_estadual": null,
  "address": null,
  "contact": null,
  "codigo_registro_folha": null,
  "ativo": true
}

Criando uma Empresa

Este método cria uma empresa.

Endpoint

POST /v1/empresas

Parameters

Name Description
empresa[cnpj] required (String) Identificador de CNPJ.
empresa[name] required (String) Razão Social.
empresa[nome_fantasia] required (String) Nome Fantasia.
empresa[cei] (String) Identificador de CEI.
empresa[cpf] (String) Identificador de CPF.
empresa[inscricao_estadual] (String) Identificador de Inscrição Estadual.
empresa[ativo] (Boolean) Status do registro.
empresa[codigo_registro_folha] (String) Código de registro de folha de pagamento.
empresa[address_attributes][cep] (String) CEP.
empresa[address_attributes][city] (String) Cidade.
empresa[address_attributes][complement] (String) Complemento.
empresa[address_attributes][country] (String) País.
empresa[address_attributes][number] (String) Número.
empresa[address_attributes][state] (String) Estado.
empresa[address_attributes][street] (String) Logradouro.
empresa[address_attributes][district] (String) Bairro.
empresa[contact_attributes][name] (String) Nome do responsável.
empresa[contact_attributes][email] (String) E-mail.
empresa[contact_attributes][phone] (String) Telefone.
empresa[contact_attributes][cpf] (String) CPF.
empresa[contact_attributes][site] (String) Endereço do Site.
empresa[contact_attributes][whatsapp] (String) Número de Whatsapp.
empresa[contact_attributes][instagram] (String) Endereço do instagram.

Request

Route

POST /v1/empresas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "empresa": {
    "name": "Empresa Teste",
    "nome_fantasia": "Empresa Teste",
    "cnpj": "11.111.111/0001-00",
    "inscricao_estadual": "11111111111111",
    "address_attributes": {
      "cep": "85020-001",
      "city": "Cidade",
      "state": "PR",
      "country": "Brasil",
      "street": "Rua",
      "number": "100",
      "complement": "Apto 100"
    },
    "contact_attributes": {
      "name": "Nome do contato",
      "email": "[email protected]",
      "phone": "4236223344",
      "cpf": "11111111111",
      "site": "http://www.site.com",
      "whatsapp": "4236223344",
      "instagram": "@teste"
    }
  }
}

cURL

curl "https://api.ptrp.com.br/v1/empresas" -d '{"empresa":{"name":"Empresa Teste","nome_fantasia":"Empresa Teste","cnpj":"11.111.111/0001-00","inscricao_estadual":"11111111111111","address_attributes":{"cep":"85020-001","city":"Cidade","state":"PR","country":"Brasil","street":"Rua","number":"100","complement":"Apto 100"},"contact_attributes":{"name":"Nome do contato","email":"[email protected]","phone":"4236223344","cpf":"11111111111","site":"http://www.site.com","whatsapp":"4236223344","instagram":"@teste"}}}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
uid (String) UID da Empresa.
name (String) Razão social.
nome_fantasia (String) Nome fantasia.
cnpj (String) CNPJ.
cei (String) CEI.
cpf (String) CPF.
inscricao_estadual (String) Inscrição Estadual.
address (Address) Objeto com dados do endereço.
address[cep] (String) CEP.
address[city] (String) Cidade.
address[complement] (String) Complemento.
address[country] (String) País.
address[number] (String) Número.
address[state] (String) Estado.
address[street] (String) Logradouro.
address[district] (String) Bairro.
contact (Contact) Objeto com dados do contato.
contact[name] (String) Nome do responsável.
contact[email] (String) E-mail.
contact[phone] (String) Telefone.
contact[cpf] (String) CPF.
contact[site] (String) Endereço do Site.
contact[whatsapp] (String) Número de Whatsapp.
contact[instagram] (String) Endereço do instagram.
codigo_registro_folha (String) Código do registro de folha de pagamento.
ativo (Boolean) Se a empresa está atualmente ativa.

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"44602d2488478d426f8864e46e1c1c1f"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: d9b18718-5bee-483f-b846-8786bb8d8e9f
X-Runtime: 0.045654
Vary: Origin
Content-Length: 557

Body

{
  "uid": "7d6a9501-d589-4607-8cc5-ce4aa148d953",
  "name": "Empresa Teste",
  "nome_fantasia": "Empresa Teste",
  "cnpj": "11.111.111/0001-00",
  "cei": null,
  "cpf": null,
  "inscricao_estadual": "11111111111111",
  "address": {
    "cep": "85020-001",
    "city": "Cidade",
    "complement": "Apto 100",
    "country": "Brasil",
    "number": "100",
    "state": "PR",
    "street": "Rua",
    "district": null
  },
  "contact": {
    "email": "[email protected]",
    "name": "Nome Do Contato",
    "phone": "4236223344",
    "cpf": "11111111111",
    "whatsapp": "4236223344",
    "site": "http://www.site.com",
    "instagram": "@teste"
  },
  "codigo_registro_folha": null,
  "ativo": true
}

Listando Empresas

Este método retorna um array de empresas.

Endpoint

GET /v1/empresas

Parameters

Name Description
cnpj (String) Filtro por Identificador de CNPJ.
name (String) Filtro por Razão Social.
nome_fantasia (String) Filtro por Nome Fantasia.
cei (String) Filtro por Identificador de CEI.
cpf (String) Filtro por Identificador de CPF.
inscricao_estadual (String) Filtro por Identificador de Inscrição Estadual.
status (String) Filtro por Status do registro. Ex: "ativas" e "inativas"
codigo_registro_folha (String) Filtro por Código de registro de folha de pagamento.

Request

Route

GET /v1/empresas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/empresas" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
uid (String) UID da Empresa.
name (String) Razão social.
nome_fantasia (String) Nome fantasia.
cnpj (String) CNPJ.
cei (String) CEI.
cpf (String) CPF.
inscricao_estadual (String) Inscrição Estadual.
address (Address) Objeto com dados do endereço.
address[cep] (String) CEP.
address[city] (String) Cidade.
address[complement] (String) Complemento.
address[country] (String) País.
address[number] (String) Número.
address[state] (String) Estado.
address[street] (String) Logradouro.
address[district] (String) Bairro.
contact (Contact) Objeto com dados do contato.
contact[name] (String) Nome do responsável.
contact[email] (String) E-mail.
contact[phone] (String) Telefone.
contact[cpf] (String) CPF.
contact[site] (String) Endereço do Site.
contact[whatsapp] (String) Número de Whatsapp.
contact[instagram] (String) Endereço do instagram.
codigo_registro_folha (String) Código do registro de folha de pagamento.
ativo (Boolean) Se a empresa está atualmente ativa.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"c8fdd5bcd22186987abac6aca2b4bd7d"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 420bf050-af33-4f10-96d2-f956a74fcddd
X-Runtime: 0.052887
Vary: Origin
Content-Length: 489

Body

[
  {
    "uid": "07a804c2-6b4f-487e-971d-948f24fd6d15",
    "name": "Nome Da Empresa",
    "nome_fantasia": "Nome Fantasia",
    "cnpj": null,
    "cei": null,
    "cpf": null,
    "inscricao_estadual": null,
    "address": {
      "cep": "85020-001",
      "city": "Cidade",
      "complement": null,
      "country": "Brasil",
      "number": null,
      "state": "PR",
      "street": null,
      "district": null
    },
    "contact": {
      "email": "[email protected]",
      "name": "Nome Do Contato",
      "phone": "4236223344",
      "cpf": null,
      "whatsapp": null,
      "site": null,
      "instagram": null
    },
    "codigo_registro_folha": null,
    "ativo": true
  }
]

Listando Empresas - Filtrando por parâmetro

Este método retorna um array de empresas filtrando por Nome Fantasia.

Endpoint

GET /v1/empresas

Parameters

Name Description
cnpj (String) Filtro por Identificador de CNPJ.
name (String) Filtro por Razão Social.
nome_fantasia (String) Filtro por Nome Fantasia.
cei (String) Filtro por Identificador de CEI.
cpf (String) Filtro por Identificador de CPF.
inscricao_estadual (String) Filtro por Identificador de Inscrição Estadual.
status (String) Filtro por Status do registro. Ex: "ativas" e "inativas"
codigo_registro_folha (String) Filtro por Código de registro de folha de pagamento.

Request

Route

GET /v1/empresas?nome_fantasia=Nome+fantasia

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Query Parameters

nome_fantasia=Nome fantasia

cURL

curl -g "https://api.ptrp.com.br/v1/empresas?nome_fantasia=Nome+fantasia" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
uid (String) UID da Empresa.
name (String) Razão social.
nome_fantasia (String) Nome fantasia.
cnpj (String) CNPJ.
cei (String) CEI.
cpf (String) CPF.
inscricao_estadual (String) Inscrição Estadual.
address (Address) Objeto com dados do endereço.
address[cep] (String) CEP.
address[city] (String) Cidade.
address[complement] (String) Complemento.
address[country] (String) País.
address[number] (String) Número.
address[state] (String) Estado.
address[street] (String) Logradouro.
address[district] (String) Bairro.
contact (Contact) Objeto com dados do contato.
contact[name] (String) Nome do responsável.
contact[email] (String) E-mail.
contact[phone] (String) Telefone.
contact[cpf] (String) CPF.
contact[site] (String) Endereço do Site.
contact[whatsapp] (String) Número de Whatsapp.
contact[instagram] (String) Endereço do instagram.
codigo_registro_folha (String) Código do registro de folha de pagamento.
ativo (Boolean) Se a empresa está atualmente ativa.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"684da8a00836c3ca43f7937419f10087"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 79e023e6-586a-49a6-8298-387f3d66ff91
X-Runtime: 0.044701
Vary: Origin
Content-Length: 489

Body

[
  {
    "uid": "ad7191bf-8c91-4e72-b032-b37e76bfb76a",
    "name": "Nome Da Empresa",
    "nome_fantasia": "Nome Fantasia",
    "cnpj": null,
    "cei": null,
    "cpf": null,
    "inscricao_estadual": null,
    "address": {
      "cep": "85020-001",
      "city": "Cidade",
      "complement": null,
      "country": "Brasil",
      "number": null,
      "state": "PR",
      "street": null,
      "district": null
    },
    "contact": {
      "email": "[email protected]",
      "name": "Nome Do Contato",
      "phone": "4236223344",
      "cpf": null,
      "whatsapp": null,
      "site": null,
      "instagram": null
    },
    "codigo_registro_folha": null,
    "ativo": true
  }
]

Parâmetros inválidos - Erro de validação

Este método tenta criar uma empresa inválida.

Endpoint

POST /v1/empresas

Parameters

Name Description
empresa[cnpj] required (String) Identificador de CNPJ.
empresa[name] required (String) Razão Social.
empresa[nome_fantasia] required (String) Nome Fantasia.
empresa[cei] (String) Identificador de CEI.
empresa[cpf] (String) Identificador de CPF.
empresa[inscricao_estadual] (String) Identificador de Inscrição Estadual.
empresa[ativo] (Boolean) Status do registro.
empresa[codigo_registro_folha] (String) Código de registro de folha de pagamento.
empresa[address_attributes][cep] (String) CEP.
empresa[address_attributes][city] (String) Cidade.
empresa[address_attributes][complement] (String) Complemento.
empresa[address_attributes][country] (String) País.
empresa[address_attributes][number] (String) Número.
empresa[address_attributes][state] (String) Estado.
empresa[address_attributes][street] (String) Logradouro.
empresa[address_attributes][district] (String) Bairro.
empresa[contact_attributes][name] (String) Nome do responsável.
empresa[contact_attributes][email] (String) E-mail.
empresa[contact_attributes][phone] (String) Telefone.
empresa[contact_attributes][cpf] (String) CPF.
empresa[contact_attributes][site] (String) Endereço do Site.
empresa[contact_attributes][whatsapp] (String) Número de Whatsapp.
empresa[contact_attributes][instagram] (String) Endereço do instagram.

Request

Route

POST /v1/empresas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "empresa": {
    "name": "Empresa Teste"
  }
}

cURL

curl "https://api.ptrp.com.br/v1/empresas" -d '{"empresa":{"name":"Empresa Teste"}}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
message (String) Mensagem de erro da requisição.
errors (Object) Objeto com nome dos campos que contêm erros de validação. Cada campo contém uma lista de erros.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: 74f463cd-6e1a-4721-9291-7acd91377296
X-Runtime: 0.041207
Vary: Origin
Content-Length: 78

Body

{
  "message": "Validation Failed!",
  "errors": {
    "nome_fantasia": [
      "can't be blank"
    ]
  }
}

Equipamentos

Adicionando usuário

Este método registra um usuário para registro de ponto. Apenas equipamentos virtuais do tipo “app” são permitidos.

Endpoint

POST /v1/equipamentos/:id/usuarios/:cpf

Parameters

Name Description
id (Int) Id do equipamento virtual (Apenas equipamentos do tipo "app")
cpf (Int) CPF do funcionário (somente números)

Request

Route

POST /v1/equipamentos/7510104/usuarios/07155744989

Headers

Platform-Auth: app_supervisor_rep
Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/equipamentos/7510104/usuarios/07155744989" -d '' -X POST \
	-H "Platform-Auth: app_supervisor_rep" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
cpf (String) CPF do funcionário.
password (String) Senha para registro de pontos.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"fd1b9be5474d843f3d073e5c393f3ee3"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: a5150264-73ef-4b34-8a4e-504877a9d533
X-Runtime: 0.268986
Vary: Origin
Content-Length: 41

Body

{
  "cpf": "07155744989",
  "password": "806955"
}

Listando Equipamentos

Este método retorna um array de equipamentos.

Endpoint

GET /v1/equipamentos

Parameters

Name Description
per_page (Int) Número de registros por página. Padrão: 5.
page (Int) Número da página de referência da paginação. Padrão: 1.

Request

Route

GET /v1/equipamentos

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/equipamentos" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
X-Current-Page (Int) [Header] Página atual da paginação.
X-Per-Page (Int) [Header] Número máximo de registros da resposta à requisição.
X-Total-Entries (Int) [Header] Total de registros da consulta.
X-Total-Pages (Int) [Header] Total de páginas da consulta.
name (String) Nome do equipamento.
fabricante (String) Nome do fabricante.
ip (String) IP local do equipamento.
nequipamento (String) Número do equipamento.
nserie_rep (String) Número de Série do equipamento.
ativo (Boolean) Equipamento ativo?
integration_rep (Boolean) Integração com o REP está disponível?
total_marcacoes (Int) Total de marcações.
total_marcacoes_bobina (Int) Total de marcações para Bobina.
metragem_bobina_recomendada (String) Metragem da bobina recomendada para o equipamento.
cpf (String) CPF da licença do equipamento.
app (Booleano) Equipamento do tipo virtual do tipo "app".
platform (String) Plataforma do equipamento virtual (app).
empresa_uid (String) Identificador da empresa.
user (String) Usuário de acesso para integração de API.
password (String) Senha de acesso para integração de API.
modelo_equipamento[afd_layout] (String) Identificação do layout do AFD.
modelo_equipamento[name] (String) Nome do modelo.
modelo_equipamento[software_url] (String) URL do software do fabricante.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Per-Page: 5
X-Current-Page: 1
X-Total-Entries: 13
X-Total-Pages: 3
Content-Type: application/json; charset=utf-8
ETag: W/"3e64d7a96a712f3f0ac71a66a4441531"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: a672983a-ae9a-4072-8d84-167f1782bf42
X-Runtime: 0.083060
Vary: Origin
Content-Length: 2047

Body

[
  {
    "id": 193764514,
    "name": "equipamento01",
    "fabricante": "HENRY",
    "modelo_equipamento": {
      "name": "primme sf",
      "software_url": null,
      "afd_layout": "portaria_1510"
    },
    "ip": "192.168.254.20",
    "nequipamento": "1",
    "nserie_rep": "01111000011110000",
    "ativo": true,
    "integration_rep": false,
    "total_marcacoes": null,
    "total_marcacoes_bobina": null,
    "metragem_bobina_recomendada": null,
    "cpf": null,
    "app": false,
    "empresa_uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
    "user": null,
    "password": null,
    "platform": null
  },
  {
    "id": 562308933,
    "name": "equipamento0333",
    "fabricante": "HENRY",
    "modelo_equipamento": {
      "name": "primme sf",
      "software_url": null,
      "afd_layout": "portaria_1510"
    },
    "ip": "192.168.254.29",
    "nequipamento": "13",
    "nserie_rep": "01111000011113334",
    "ativo": true,
    "integration_rep": false,
    "total_marcacoes": null,
    "total_marcacoes_bobina": null,
    "metragem_bobina_recomendada": null,
    "cpf": null,
    "app": false,
    "empresa_uid": "c43becdf-ba77-4062-97c0-58f3335dad92",
    "user": null,
    "password": null,
    "platform": null
  },
  {
    "id": 310758694,
    "name": "equipamento02",
    "fabricante": null,
    "modelo_equipamento": null,
    "ip": "192.168.254.20",
    "nequipamento": "2",
    "nserie_rep": "40200896286722",
    "ativo": true,
    "integration_rep": false,
    "total_marcacoes": null,
    "total_marcacoes_bobina": null,
    "metragem_bobina_recomendada": null,
    "cpf": null,
    "app": false,
    "empresa_uid": null,
    "user": null,
    "password": null,
    "platform": null
  },
  {
    "id": 648772564,
    "name": "equipamento03",
    "fabricante": null,
    "modelo_equipamento": null,
    "ip": "192.168.254.30",
    "nequipamento": "2",
    "nserie_rep": "40200896286723",
    "ativo": true,
    "integration_rep": false,
    "total_marcacoes": null,
    "total_marcacoes_bobina": null,
    "metragem_bobina_recomendada": null,
    "cpf": null,
    "app": false,
    "empresa_uid": null,
    "user": null,
    "password": null,
    "platform": null
  },
  {
    "id": 393371806,
    "name": "equipamento04",
    "fabricante": null,
    "modelo_equipamento": null,
    "ip": "192.168.254.40",
    "nequipamento": "2",
    "nserie_rep": "12345678912345678",
    "ativo": true,
    "integration_rep": false,
    "total_marcacoes": null,
    "total_marcacoes_bobina": null,
    "metragem_bobina_recomendada": null,
    "cpf": null,
    "app": false,
    "empresa_uid": null,
    "user": null,
    "password": null,
    "platform": null
  }
]

Obtendo o comprovante em formato pdf do ponto

Este método retorna o arquivo do comprovante do ponto em formato pdf (somente para equipamentos app).

Endpoint

GET /v1/equipamentos/:equipamento_id/pontos/:id.pdf

Parameters

Name Description
equipamento_id (Int) ID do Equipamento (obs: o equipamento deve ser do tipo "app").
id (Int) ID do Ponto.

Request

Route

GET /v1/equipamentos/51636476/pontos/215362412.pdf

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/equipamentos/51636476/pontos/215362412.pdf" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Disposition: attachment; filename="comprovante-1.pdf"
Content-Transfer-Encoding: binary
Content-Type: application/pdf
Cache-Control: private
X-Request-Id: ccb3e1d2-abe1-45aa-bbcd-9abf8260db16
X-Runtime: 0.674533
Vary: Origin
Content-Length: 291298

Body

[binary data]

Registrando o ponto

Este método registra o ponto para um funcionário. Apenas equipamentos virtuais do tipo “app” são permitidos.

Endpoint

POST /v1/equipamentos/:id/pontos

Parameters

Name Description
id required (Int) Id do equipamento virtual (Apenas equipamentos do tipo "app").
password required (String) Senha de registro do usuário do equipamento.
latitude (Float) Latitude do registro do Ponto (quando disponível).
longitude (Float) Longitude do registro do Ponto (quando disponível).
data (Date) Data do ponto. Obrigatório quando offline. Ex: 01/02/2014
hora (Time) Hora do ponto. Obrigatório quando offline. Ex: 08:00
offline (Bool) Se o ponto foi registrado offline.

Request

Route

POST /v1/equipamentos/51636476/pontos

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "password": "963307"
}

cURL

curl "https://api.ptrp.com.br/v1/equipamentos/51636476/pontos" -d '{"password":"963307"}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
data (Date) Data de registro do ponto.
hora (DateTime) Hora do registro do ponto.
equipamento_id (Int) Id do equipamento que foi registrado o ponto.
processado (Boolean) Se a coleta que pertence o ponto já foi processada.
nsr (Int) Número sequencial de registro.
registro_inpi (String) Número do registro INPI.
coletor_id (Int) Identificação do equipamento de coleta. Valores: 1 - Mobile, 2 - Web.
offline (Bool) Se o ponto foi registrado offline.
cpf (Int) CPF do funcionário.
codigo_hash (String) SHA-256 dos dados registrados.
utc_offset (String) Deslocamento UTC da marcação.
ponto_geo_locale[latitude] (Float) Latitude do registro do Ponto (quando disponível).
ponto_geo_locale[longitude] (Float) Longitude do registro do Ponto (quando disponível).
funcionario[uid] (String) Funcionário UID.
funcionario[cpf] (String) Identificador de CPF.
funcionario[data_admissao] (Date) Data de admissão.
funcionario[data_demissao] (Date) Data de demissão.
funcionario[name] (String) Nome do funcionário.
funcionario[pis] (String) Identificador de PIS.
funcionario[registro_folha] (String) Identificador de Registro de Folha de pagamento.
funcionario[rg] (String) Identificador de RG.
funcionario[nacionalidade] (String) Nacionalidade.
funcionario[nome_da_mae] (String) Nome da mãe.
funcionario[nome_do_pai] (String) Nome da pai.
funcionario[estado_civil] (String) Estado civil.
funcionario[conjuge] (String) Nome do conjuge.
funcionario[nascimento] (Date) Data de nascimento.
funcionario[ctps] (String) Identificador de CTPS.
funcionario[cnh] (String) Identificador de CNH.
funcionario[phone] (String) Telefone do funcionário
funcionario[email] (String) Email do funcionário.
funcionario[certidao_militar] (String) Identificador de Certidão Militar.
funcionario[tipo_sanguineo] (String) Tipo sanguíneo.
funcionario[etnico_racial] (String) Étnico racial.
funcionario[escolaridade] (String) Escolaridade.
funcionario[observacoes] (String) Observações.
funcionario[biometria] (String) Hash da biometria cadastrada em um equipamento.
funcionario[cargos] (Array) Cargos do funcionário.
cargos[data] (Date) Data de atribuição do cargo.
cargos[funcao] (String) Nome da função.
cargos[name] (String) Nome do cargo.
funcionario[exames] (Array) Exames do funcionário.
exames[data] (Date) Data de atribuição do cargo.
exames[apto] (Boolean) Apto?
funcionario[dependentes] (Array) Dependentes do funcionário.
dependentes[name] (String) Nome do dependente.
dependentes[birth] (Date) Data de nascimento.

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"e0b76490493357d1471e5be4cf86636c"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: c80710e8-02af-4242-a88f-86a87e2355d7
X-Runtime: 0.294416
Vary: Origin
Content-Length: 1844

Body

{
  "id": 1071408923,
  "data": "2026-04-06",
  "hora": "22:37",
  "equipamento_id": 51636476,
  "processado": false,
  "ponto_geo_locale": null,
  "nsr": 1,
  "registro_inpi": "BR512022000771-1",
  "coletor_id": 2,
  "offline": false,
  "created_at": "2026-04-06T22:37:22.391-03:00",
  "cpf": "07155744989",
  "codigo_hash": "8947935db9af7e7a545c630a88e29dacda0197f746c6a62a07d9044c06a22213",
  "utc_offset": "-0300",
  "funcionario": {
    "cpf": "07155744989",
    "cracha": "1",
    "data_admissao": "2000-01-01",
    "data_demissao": null,
    "name": "Func1",
    "pis": "123929234315",
    "registro_folha": "1",
    "rg": null,
    "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [
      {
        "data": "2017-01-10",
        "funcao": "test",
        "name": "Auxiliar (123456)"
      },
      {
        "data": "2018-01-01",
        "funcao": "auxiliar",
        "name": null
      }
    ],
    "exames": [
      {
        "data": "2017-01-10",
        "apto": true,
        "tipo_exame": null,
        "observacoes": null,
        "arquivo": {
          "url": null
        }
      }
    ],
    "empresa": {
      "id": 471928375,
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "inscricao_estadual": null,
      "cpf": null,
      "created_at": "2026-04-06T22:37:18.000-03:00",
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "cliente_id": 571096427,
      "cei": null,
      "codigo_registro_folha": "23",
      "ativo": true,
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
    },
    "departamento": {
      "id": 980190962,
      "name": "Departamento01 (Empresa03)",
      "empresa_id": 471928375,
      "created_at": "2026-04-06T22:37:18.000-03:00",
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "ativo": true,
      "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
      "codigo_registro_folha": "1",
      "full_name": "Departamento01 (Empresa03)"
    },
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:18.000-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  }
}

Registrando o ponto - falha de senha não encontrada

Este método mostra falha quando a senha do funcionário não é encontrada.

Endpoint

POST /v1/equipamentos/:id/pontos

Parameters

Name Description
id required (Int) Id do equipamento virtual (Apenas equipamentos do tipo "app").
password required (String) Senha de registro do usuário do equipamento.
latitude (Float) Latitude do registro do Ponto (quando disponível).
longitude (Float) Longitude do registro do Ponto (quando disponível).
data (Date) Data do ponto. Obrigatório quando offline. Ex: 01/02/2014
hora (Time) Hora do ponto. Obrigatório quando offline. Ex: 08:00
offline (Bool) Se o ponto foi registrado offline.

Request

Route

POST /v1/equipamentos/51636476/pontos

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "password": "1234"
}

cURL

curl "https://api.ptrp.com.br/v1/equipamentos/51636476/pontos" -d '{"password":"1234"}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
data (Date) Data de registro do ponto.
hora (DateTime) Hora do registro do ponto.
equipamento_id (Int) Id do equipamento que foi registrado o ponto.
processado (Boolean) Se a coleta que pertence o ponto já foi processada.
nsr (Int) Número sequencial de registro.
registro_inpi (String) Número do registro INPI.
coletor_id (Int) Identificação do equipamento de coleta. Valores: 1 - Mobile, 2 - Web.
offline (Bool) Se o ponto foi registrado offline.
cpf (Int) CPF do funcionário.
codigo_hash (String) SHA-256 dos dados registrados.
utc_offset (String) Deslocamento UTC da marcação.
ponto_geo_locale[latitude] (Float) Latitude do registro do Ponto (quando disponível).
ponto_geo_locale[longitude] (Float) Longitude do registro do Ponto (quando disponível).
funcionario[uid] (String) Funcionário UID.
funcionario[cpf] (String) Identificador de CPF.
funcionario[data_admissao] (Date) Data de admissão.
funcionario[data_demissao] (Date) Data de demissão.
funcionario[name] (String) Nome do funcionário.
funcionario[pis] (String) Identificador de PIS.
funcionario[registro_folha] (String) Identificador de Registro de Folha de pagamento.
funcionario[rg] (String) Identificador de RG.
funcionario[nacionalidade] (String) Nacionalidade.
funcionario[nome_da_mae] (String) Nome da mãe.
funcionario[nome_do_pai] (String) Nome da pai.
funcionario[estado_civil] (String) Estado civil.
funcionario[conjuge] (String) Nome do conjuge.
funcionario[nascimento] (Date) Data de nascimento.
funcionario[ctps] (String) Identificador de CTPS.
funcionario[cnh] (String) Identificador de CNH.
funcionario[phone] (String) Telefone do funcionário
funcionario[email] (String) Email do funcionário.
funcionario[certidao_militar] (String) Identificador de Certidão Militar.
funcionario[tipo_sanguineo] (String) Tipo sanguíneo.
funcionario[etnico_racial] (String) Étnico racial.
funcionario[escolaridade] (String) Escolaridade.
funcionario[observacoes] (String) Observações.
funcionario[biometria] (String) Hash da biometria cadastrada em um equipamento.
funcionario[cargos] (Array) Cargos do funcionário.
cargos[data] (Date) Data de atribuição do cargo.
cargos[funcao] (String) Nome da função.
cargos[name] (String) Nome do cargo.
funcionario[exames] (Array) Exames do funcionário.
exames[data] (Date) Data de atribuição do cargo.
exames[apto] (Boolean) Apto?
funcionario[dependentes] (Array) Dependentes do funcionário.
dependentes[name] (String) Nome do dependente.
dependentes[birth] (Date) Data de nascimento.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: d528df5a-2381-4da5-ac4c-64acfb93b238
X-Runtime: 0.220086
Vary: Origin
Content-Length: 75

Body

{
  "message": "Validation Failed!",
  "errors": {
    "password": [
      "Record not found"
    ]
  }
}

Registrando o ponto offline

Este método registra um ponto offline para o funcionário. Apenas equipamentos virtuais do tipo “app” são permitidos.

Endpoint

POST /v1/equipamentos/:id/pontos

Parameters

Name Description
id required (Int) Id do equipamento virtual (Apenas equipamentos do tipo "app").
password required (String) Senha de registro do usuário do equipamento.
latitude (Float) Latitude do registro do Ponto (quando disponível).
longitude (Float) Longitude do registro do Ponto (quando disponível).
data (Date) Data do ponto. Obrigatório quando offline. Ex: 01/02/2014
hora (Time) Hora do ponto. Obrigatório quando offline. Ex: 08:00
offline (Bool) Se o ponto foi registrado offline.

Request

Route

POST /v1/equipamentos/51636476/pontos

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "password": "479337",
  "offline": true,
  "hora": "08:00",
  "data": "2000-01-01"
}

cURL

curl "https://api.ptrp.com.br/v1/equipamentos/51636476/pontos" -d '{"password":"479337","offline":true,"hora":"08:00","data":"2000-01-01"}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
data (Date) Data de registro do ponto.
hora (DateTime) Hora do registro do ponto.
equipamento_id (Int) Id do equipamento que foi registrado o ponto.
processado (Boolean) Se a coleta que pertence o ponto já foi processada.
nsr (Int) Número sequencial de registro.
registro_inpi (String) Número do registro INPI.
coletor_id (Int) Identificação do equipamento de coleta. Valores: 1 - Mobile, 2 - Web.
offline (Bool) Se o ponto foi registrado offline.
cpf (Int) CPF do funcionário.
codigo_hash (String) SHA-256 dos dados registrados.
utc_offset (String) Deslocamento UTC da marcação.
ponto_geo_locale[latitude] (Float) Latitude do registro do Ponto (quando disponível).
ponto_geo_locale[longitude] (Float) Longitude do registro do Ponto (quando disponível).
funcionario[uid] (String) Funcionário UID.
funcionario[cpf] (String) Identificador de CPF.
funcionario[data_admissao] (Date) Data de admissão.
funcionario[data_demissao] (Date) Data de demissão.
funcionario[name] (String) Nome do funcionário.
funcionario[pis] (String) Identificador de PIS.
funcionario[registro_folha] (String) Identificador de Registro de Folha de pagamento.
funcionario[rg] (String) Identificador de RG.
funcionario[nacionalidade] (String) Nacionalidade.
funcionario[nome_da_mae] (String) Nome da mãe.
funcionario[nome_do_pai] (String) Nome da pai.
funcionario[estado_civil] (String) Estado civil.
funcionario[conjuge] (String) Nome do conjuge.
funcionario[nascimento] (Date) Data de nascimento.
funcionario[ctps] (String) Identificador de CTPS.
funcionario[cnh] (String) Identificador de CNH.
funcionario[phone] (String) Telefone do funcionário
funcionario[email] (String) Email do funcionário.
funcionario[certidao_militar] (String) Identificador de Certidão Militar.
funcionario[tipo_sanguineo] (String) Tipo sanguíneo.
funcionario[etnico_racial] (String) Étnico racial.
funcionario[escolaridade] (String) Escolaridade.
funcionario[observacoes] (String) Observações.
funcionario[biometria] (String) Hash da biometria cadastrada em um equipamento.
funcionario[cargos] (Array) Cargos do funcionário.
cargos[data] (Date) Data de atribuição do cargo.
cargos[funcao] (String) Nome da função.
cargos[name] (String) Nome do cargo.
funcionario[exames] (Array) Exames do funcionário.
exames[data] (Date) Data de atribuição do cargo.
exames[apto] (Boolean) Apto?
funcionario[dependentes] (Array) Dependentes do funcionário.
dependentes[name] (String) Nome do dependente.
dependentes[birth] (Date) Data de nascimento.

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"19f7fa1ebad2481c62d8bad410e39d20"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 8d909cd8-b95e-4715-bb4c-2f50ad17b3bc
X-Runtime: 0.260912
Vary: Origin
Content-Length: 1843

Body

{
  "id": 1071408924,
  "data": "2000-01-01",
  "hora": "08:00",
  "equipamento_id": 51636476,
  "processado": false,
  "ponto_geo_locale": null,
  "nsr": 1,
  "registro_inpi": "BR512022000771-1",
  "coletor_id": 2,
  "offline": true,
  "created_at": "2026-04-06T22:37:22.864-03:00",
  "cpf": "07155744989",
  "codigo_hash": "b2f2423b41f33b7cdd7e5d9426ce4661e7f961480bbb7a12b37cbe4a9197271f",
  "utc_offset": "+0000",
  "funcionario": {
    "cpf": "07155744989",
    "cracha": "1",
    "data_admissao": "2000-01-01",
    "data_demissao": null,
    "name": "Func1",
    "pis": "123929234315",
    "registro_folha": "1",
    "rg": null,
    "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [
      {
        "data": "2017-01-10",
        "funcao": "test",
        "name": "Auxiliar (123456)"
      },
      {
        "data": "2018-01-01",
        "funcao": "auxiliar",
        "name": null
      }
    ],
    "exames": [
      {
        "data": "2017-01-10",
        "apto": true,
        "tipo_exame": null,
        "observacoes": null,
        "arquivo": {
          "url": null
        }
      }
    ],
    "empresa": {
      "id": 471928375,
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "inscricao_estadual": null,
      "cpf": null,
      "created_at": "2026-04-06T22:37:18.000-03:00",
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "cliente_id": 571096427,
      "cei": null,
      "codigo_registro_folha": "23",
      "ativo": true,
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
    },
    "departamento": {
      "id": 980190962,
      "name": "Departamento01 (Empresa03)",
      "empresa_id": 471928375,
      "created_at": "2026-04-06T22:37:18.000-03:00",
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "ativo": true,
      "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
      "codigo_registro_folha": "1",
      "full_name": "Departamento01 (Empresa03)"
    },
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:18.000-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  }
}

Registrando usuário - falha de cpf não encontrado

Este método mostra falha quando o cpf do funcionário não é encontrado.

Endpoint

POST /v1/equipamentos/:id/usuarios/:cpf

Parameters

Name Description
id (Int) Id do equipamento virtual (Apenas equipamentos do tipo "app")
cpf (Int) CPF do funcionário (somente números)

Request

Route

POST /v1/equipamentos/7510104/usuarios/3

Headers

Platform-Auth: app_supervisor_rep
Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/equipamentos/7510104/usuarios/3" -d '' -X POST \
	-H "Platform-Auth: app_supervisor_rep" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
cpf (String) CPF do funcionário.
password (String) Senha para registro de pontos.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: bfc2e498-9252-471d-befb-49dce04bf932
X-Runtime: 0.053643
Vary: Origin
Content-Length: 82

Body

{
  "message": "Validation Failed!",
  "errors": {
    "cpf": [
      "Funcionário não encontrado"
    ]
  }
}

Folha de Pagamento

Criando uma exportação

Este método cria uma exportação para folha de pagamento.

Endpoint

POST /v1/folhas-de-pagamento/exportacao

Parameters

Name Description
per_page (Int) Número de registros por página. Padrão: 5.
page (Int) Número da página de referência da paginação. Padrão: 1.
event_config_id required ID da configuração de eventos (ver página de configurações de eventos).
periodo required Período do ano (Ex: "02/2022").
funcionario_uids Lista de UID de funcionários.

Request

Route

POST /v1/folhas-de-pagamento/exportacao

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "periodo": "2015-06-01",
  "event_config_id": 712054099
}

cURL

curl "https://api.ptrp.com.br/v1/folhas-de-pagamento/exportacao" -d '{"periodo":"2015-06-01","event_config_id":712054099}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
X-Current-Page (Int) [Header] Página atual da paginação.
X-Per-Page (Int) [Header] Número máximo de registros da resposta à requisição.
X-Total-Entries (Int) [Header] Total de registros da consulta.
X-Total-Pages (Int) [Header] Total de páginas da consulta.
funcionario Objeto funcionário (ver página de funcionários).
events Lista de eventos.
event[code] Código do evento.
event[value] Valor do evento.
errors[event_config_id] Array of error messages of field event_config_id.
errors[funcionario_uids] Array of error messages of field funcionario_uids.
errors[periodo] Array of error messages of field periodo.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Per-Page: 5
X-Current-Page: 1
X-Total-Entries: 24
X-Total-Pages: 5
Content-Type: application/json; charset=utf-8
ETag: W/"d10204a996b5f6322b40e4d6d9248c36"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 0308a09c-06ba-4653-8039-5cbf30e249b5
X-Runtime: 0.129889
Vary: Origin
Content-Length: 1577

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2000-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "1",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "ativo": true,
        "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
        "codigo_registro_folha": "1",
        "full_name": "Departamento01 (Empresa03)"
      },
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    },
    "events": [
      {
        "code": "1",
        "value": 37800
      },
      {
        "code": "2",
        "value": 37800
      },
      {
        "code": "3",
        "value": 36000
      }
    ]
  }
]

Criando uma exportação - erros comuns

Falha ao requisitar uma exportação.

Endpoint

POST /v1/folhas-de-pagamento/exportacao

Parameters

Name Description
per_page (Int) Número de registros por página. Padrão: 5.
page (Int) Número da página de referência da paginação. Padrão: 1.
event_config_id required ID da configuração de eventos (ver página de configurações de eventos).
periodo required Período do ano (Ex: "02/2022").
funcionario_uids Lista de UID de funcionários.

Request

Route

POST /v1/folhas-de-pagamento/exportacao

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/folhas-de-pagamento/exportacao" -d '' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
X-Current-Page (Int) [Header] Página atual da paginação.
X-Per-Page (Int) [Header] Número máximo de registros da resposta à requisição.
X-Total-Entries (Int) [Header] Total de registros da consulta.
X-Total-Pages (Int) [Header] Total de páginas da consulta.
funcionario Objeto funcionário (ver página de funcionários).
events Lista de eventos.
event[code] Código do evento.
event[value] Valor do evento.
errors[event_config_id] Array of error messages of field event_config_id.
errors[funcionario_uids] Array of error messages of field funcionario_uids.
errors[periodo] Array of error messages of field periodo.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Per-Page: 5
X-Current-Page: 1
X-Total-Entries: 24
X-Total-Pages: 5
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: 20983826-c2ed-4379-ae86-6ea5947b12c6
X-Runtime: 0.045695
Vary: Origin
Content-Length: 94

Body

{
  "message": "Validation Failed!",
  "errors": {
    "periodo": [
      "can't be blank",
      "Invalid Date format"
    ]
  }
}

Listando as configurações de eventos

Este método lista as configurações de eventos para folha de pagamento.

Endpoint

GET /v1/folhas-de-pagamento/configuracoes-eventos

Request

Route

GET /v1/folhas-de-pagamento/configuracoes-eventos

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/folhas-de-pagamento/configuracoes-eventos" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id ID da configuração.
name Nome da configuração.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"2408607bede9f48d47e3f4a87ccefd5c"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: bc10917c-556c-465b-89b0-c121ba1fdc45
X-Runtime: 0.051975
Vary: Origin
Content-Length: 180

Body

[
  {
    "id": 980190962,
    "name": "Default"
  },
  {
    "id": 712054099,
    "name": "Unix eventos"
  },
  {
    "id": 688198619,
    "name": "Unix eventos"
  },
  {
    "id": 329931726,
    "name": "Dominio"
  },
  {
    "id": 188717369,
    "name": "Inline"
  }
]

Funcionário > Extrato Banco de horas

Listando extrato do banco de horas para o funcionário

Este método retorna um objeto para o período do cartão ponto.

Endpoint

GET /v1/relatorios/funcionario/:funcionario_uid/extrato-de-banco-de-horas/:year/:month

Parameters

Name Description
funcionario_uid (String) UID do funcionário.
year (Int) Ano do período.
date (Int) Mês do período.

Request

Route

GET /v1/relatorios/funcionario/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d1/extrato-de-banco-de-horas/2015/12

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/relatorios/funcionario/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d1/extrato-de-banco-de-horas/2015/12" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario_uid (String) UID do funcionário.
dates (Array) Array de objetos para as datas de extrato.
date (Date) Data da movimentação.
credit (DateTime) Quantidade de horas de crédito.
debit (DateTime) Quantidade de horas de Débito.
total[] (Int). Saldo até a data (em segundos).
total (Int) Saldo total (em segundos).

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"f321e26c84de3368bae52d4c09592829"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: fe3354bf-420e-4cd2-a7cd-307af3798445
X-Runtime: 0.068717
Vary: Origin
Content-Length: 145

Body

{
  "funcionario_uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d1",
  "dates": [
    {
      "date": "2015-12-01",
      "debit": 3600,
      "credit": null,
      "total": -3600
    }
  ],
  "total": -3600
}

Resposta para funcionário não encontrado

Endpoint

GET /v1/relatorios/funcionario/:funcionario_uid/extrato-de-banco-de-horas/:year/:month

Parameters

Name Description
funcionario_uid (String) UID do funcionário.
year (Int) Ano do período.
date (Int) Mês do período.

Request

Route

GET /v1/relatorios/funcionario/1/extrato-de-banco-de-horas/2015/12

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/relatorios/funcionario/1/extrato-de-banco-de-horas/2015/12" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario_uid (String) UID do funcionário.
dates (Array) Array de objetos para as datas de extrato.
date (Date) Data da movimentação.
credit (DateTime) Quantidade de horas de crédito.
debit (DateTime) Quantidade de horas de Débito.
total[] (Int). Saldo até a data (em segundos).
total (Int) Saldo total (em segundos).

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: c71178b5-f12c-42cc-905c-09cf644dca67
X-Runtime: 0.037083
Vary: Origin
Content-Length: 82

Body

{
  "message": "Validation Failed!",
  "errors": {
    "funcionario_uid": [
      "Record not found"
    ]
  }
}

Funcionários

Alterando o funcionário

Este método altera os dados cadastrais do funcionário.

Endpoint

PATCH /v1/funcionarios/:uid

Parameters

Name Description
uid required (String) UID do funcionário.
funcionario[pis] required (String) Identificador de PIS.
funcionario[cpf] (String) Identificador de CPF.
funcionario[data_admissao] required (Date) Data de admissão.
funcionario[data_demissao] (Date) Data de demissão.
funcionario[name] required (String) Nome do funcionário.
funcionario[empresa_id] required (String) UID da Empresa.
funcionario[departamento_id] (String) UID do Departamento.
funcionario[registro_folha] (String) Identificador de Registro de Folha de pagamento.
funcionario[rg] (String) Identificador de RG.
funcionario[nacionalidade] (String) Nacionalidade.
funcionario[nome_da_mae] (String) Nome da mãe.
funcionario[nome_do_pai] (String) Nome da pai.
funcionario[estado_civil] (String) Estado civil.
funcionario[conjuge] (String) Nome do conjuge.
funcionario[nascimento] (Date) Data de nascimento.
funcionario[ctps] (String) Identificador de CTPS.
funcionario[cnh] (String) Identificador de CNH.
funcionario[phone] (String) Celular do funcionario.
funcionario[email] (String) Email do funcionario.
funcionario[certidao_militar] (String) Identificador de Certidão Militar.
funcionario[tipo_sanguineo] (String) Tipo sanguíneo.
funcionario[etnico_racial] (String) Étnico racial.
funcionario[escolaridade] (String) Escolaridade.
funcionario[observacoes] (String) Observações.
funcionario[biometria] (String) Hash da biometria cadastrada em um equipamento.
funcionario[funcionario_cargos_attributes] (Array) Cargos do funcionário.
funcionario_cargos_attributes[data] (Date) Data de atribuição do cargo.
funcionario_cargos_attributes[funcao] (String) Nome da função.
funcionario_cargos_attributes[name] (String) Nome do cargo.
funcionario[funcionario_exames_attributes] (Array) Exames do funcionário.
funcionario_exames_attributes[data] (Date) Data de atribuição do cargo.
funcionario_exames_attributes[apto] (Boolean) Apto?
funcionario[funcionario_dependentes_attributes] (Array) Dependentes do funcionário.
funcionario_dependentes_attributes[name] (String) Nome do dependente.
funcionario_dependentes_attributes[birth] (Date) Data de nascimento.

Request

Route

PATCH /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "funcionario": {
    "name": "Katia"
  }
}

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0" -d '{"funcionario":{"name":"Katia"}}' -X PATCH \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
uid (String) Funcionário ID.
cpf (String) Identificador de CPF.
data_admissao (Date) Data de admissão.
data_demissao (Date) Data de demissão.
name (String) Nome do funcionário.
pis (String) Identificador de PIS.
registro_folha (String) Identificador de Registro de Folha de pagamento.
rg (String) Identificador de RG.
nacionalidade (String) Nacionalidade.
nome_da_mae (String) Nome da mãe.
nome_do_pai (String) Nome da pai.
estado_civil (String) Estado civil.
conjuge (String) Nome do conjuge.
nascimento (Date) Data de nascimento.
ctps (String) Identificador de CTPS.
cnh (String) Identificador de CNH.
phone (String) Celular do funcionario.
email (String) Email do funcionario.
certidao_militar (String) Identificador de Certidão Militar.
tipo_sanguineo (String) Tipo sanguíneo.
etnico_racial (String) Étnico racial.
escolaridade (String) Escolaridade.
observacoes (String) Observações.
biometria (String) Hash da biometria cadastrada em um equipamento.
cargos (Array) Cargos do funcionário.
cargos[data] (Date) Data de atribuição do cargo.
cargos[funcao] (String) Nome da função.
cargos[name] (String) Nome do cargo.
exames (Array) Exames do funcionário.
exames[data] (Date) Data de atribuição do cargo.
exames[apto] (Boolean) Apto?
dependentes (Array) Dependentes do funcionário.
dependentes[name] (String) Nome do dependente.
dependentes[birth] (Date) Data de nascimento.
errors[name] (Array) Mensagens de erros para o campo name.
errors[pis] (Array) Mensagens de erros para o campo PIS.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"745f00a57a5766129762107bc4595e85"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: f0ca8be8-921f-420c-b2b7-792c8888f847
X-Runtime: 0.067340
Vary: Origin
Content-Length: 1746

Body

{
  "cpf": "07155744989",
  "cracha": "1",
  "data_admissao": "2017-01-01",
  "data_demissao": null,
  "name": "Katia",
  "pis": "123929234315",
  "registro_folha": "123",
  "rg": null,
  "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
  "nacionalidade": null,
  "nome_da_mae": null,
  "nome_do_pai": null,
  "estado_civil": null,
  "conjuge": null,
  "nascimento": null,
  "ctps": null,
  "cnh": null,
  "certidao_militar": null,
  "tipo_sanguineo": null,
  "escolaridade": null,
  "observacoes": null,
  "cargos": [
    {
      "data": "2017-01-10",
      "funcao": "test",
      "name": "Auxiliar (123456)"
    },
    {
      "data": "2018-01-01",
      "funcao": "auxiliar",
      "name": null
    }
  ],
  "exames": [
    {
      "data": "2017-01-10",
      "apto": true,
      "tipo_exame": null,
      "observacoes": null,
      "arquivo": {
        "url": null
      }
    }
  ],
  "empresa": {
    "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
    "name": "Empresa03",
    "nome_fantasia": "EmpFantasia03",
    "cnpj": "00.000.000/0000-03",
    "cei": null,
    "cpf": null,
    "inscricao_estadual": null,
    "address": {
      "cep": "85555-222",
      "city": "Guarapuava",
      "complement": "Apto52",
      "country": "Brasil",
      "number": "101",
      "state": "PR",
      "street": "Rua Armando Ribas",
      "district": "Rua Armando Ribas"
    },
    "contact": null,
    "codigo_registro_folha": "23",
    "ativo": true
  },
  "departamento": {
    "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
    "name": "Departamento01",
    "empresa": {
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "cei": null,
      "cpf": null,
      "inscricao_estadual": null,
      "address": {
        "cep": "85555-222",
        "city": "Guarapuava",
        "complement": "Apto52",
        "country": "Brasil",
        "number": "101",
        "state": "PR",
        "street": "Rua Armando Ribas",
        "district": "Rua Armando Ribas"
      },
      "contact": null,
      "codigo_registro_folha": "23",
      "ativo": true
    },
    "ativo": true
  },
  "biometria": null,
  "email": null,
  "phone": null,
  "etnico_racial": null,
  "updated_at": "2026-04-06T22:37:28.757-03:00",
  "created_at": "2026-04-06T22:37:18.000-03:00"
}

Alterando o funcionário - erros

Este método mostra falhas na validação ao alterar o funcionário.

Endpoint

PATCH /v1/funcionarios/:uid

Parameters

Name Description
uid required (String) UID do funcionário.
funcionario[pis] required (String) Identificador de PIS.
funcionario[cpf] (String) Identificador de CPF.
funcionario[data_admissao] required (Date) Data de admissão.
funcionario[data_demissao] (Date) Data de demissão.
funcionario[name] required (String) Nome do funcionário.
funcionario[empresa_id] required (String) UID da Empresa.
funcionario[departamento_id] (String) UID do Departamento.
funcionario[registro_folha] (String) Identificador de Registro de Folha de pagamento.
funcionario[rg] (String) Identificador de RG.
funcionario[nacionalidade] (String) Nacionalidade.
funcionario[nome_da_mae] (String) Nome da mãe.
funcionario[nome_do_pai] (String) Nome da pai.
funcionario[estado_civil] (String) Estado civil.
funcionario[conjuge] (String) Nome do conjuge.
funcionario[nascimento] (Date) Data de nascimento.
funcionario[ctps] (String) Identificador de CTPS.
funcionario[cnh] (String) Identificador de CNH.
funcionario[phone] (String) Celular do funcionario.
funcionario[email] (String) Email do funcionario.
funcionario[certidao_militar] (String) Identificador de Certidão Militar.
funcionario[tipo_sanguineo] (String) Tipo sanguíneo.
funcionario[etnico_racial] (String) Étnico racial.
funcionario[escolaridade] (String) Escolaridade.
funcionario[observacoes] (String) Observações.
funcionario[biometria] (String) Hash da biometria cadastrada em um equipamento.
funcionario[funcionario_cargos_attributes] (Array) Cargos do funcionário.
funcionario_cargos_attributes[data] (Date) Data de atribuição do cargo.
funcionario_cargos_attributes[funcao] (String) Nome da função.
funcionario_cargos_attributes[name] (String) Nome do cargo.
funcionario[funcionario_exames_attributes] (Array) Exames do funcionário.
funcionario_exames_attributes[data] (Date) Data de atribuição do cargo.
funcionario_exames_attributes[apto] (Boolean) Apto?
funcionario[funcionario_dependentes_attributes] (Array) Dependentes do funcionário.
funcionario_dependentes_attributes[name] (String) Nome do dependente.
funcionario_dependentes_attributes[birth] (Date) Data de nascimento.

Request

Route

PATCH /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "funcionario": {
    "name": ""
  }
}

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0" -d '{"funcionario":{"name":""}}' -X PATCH \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
uid (String) Funcionário ID.
cpf (String) Identificador de CPF.
data_admissao (Date) Data de admissão.
data_demissao (Date) Data de demissão.
name (String) Nome do funcionário.
pis (String) Identificador de PIS.
registro_folha (String) Identificador de Registro de Folha de pagamento.
rg (String) Identificador de RG.
nacionalidade (String) Nacionalidade.
nome_da_mae (String) Nome da mãe.
nome_do_pai (String) Nome da pai.
estado_civil (String) Estado civil.
conjuge (String) Nome do conjuge.
nascimento (Date) Data de nascimento.
ctps (String) Identificador de CTPS.
cnh (String) Identificador de CNH.
phone (String) Celular do funcionario.
email (String) Email do funcionario.
certidao_militar (String) Identificador de Certidão Militar.
tipo_sanguineo (String) Tipo sanguíneo.
etnico_racial (String) Étnico racial.
escolaridade (String) Escolaridade.
observacoes (String) Observações.
biometria (String) Hash da biometria cadastrada em um equipamento.
cargos (Array) Cargos do funcionário.
cargos[data] (Date) Data de atribuição do cargo.
cargos[funcao] (String) Nome da função.
cargos[name] (String) Nome do cargo.
exames (Array) Exames do funcionário.
exames[data] (Date) Data de atribuição do cargo.
exames[apto] (Boolean) Apto?
dependentes (Array) Dependentes do funcionário.
dependentes[name] (String) Nome do dependente.
dependentes[birth] (Date) Data de nascimento.
errors[name] (Array) Mensagens de erros para o campo name.
errors[pis] (Array) Mensagens de erros para o campo PIS.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: a8465858-4030-4c1c-99e1-37e40dc5a063
X-Runtime: 0.066021
Vary: Origin
Content-Length: 69

Body

{
  "message": "Validation Failed!",
  "errors": {
    "name": [
      "can't be blank"
    ]
  }
}

Criando funcionário

Este método cria um funcionário.

Endpoint

POST /v1/funcionarios

Parameters

Name Description
funcionario[pis] required (String) Identificador de PIS.
funcionario[cpf] (String) Identificador de CPF.
funcionario[data_admissao] required (Date) Data de admissão.
funcionario[data_demissao] (Date) Data de demissão.
funcionario[name] required (String) Nome do funcionário.
funcionario[empresa_id] required (String) UID da Empresa.
funcionario[departamento_id] (String) UID do Departamento.
funcionario[registro_folha] (String) Identificador de Registro de Folha de pagamento.
funcionario[rg] (String) Identificador de RG.
funcionario[nacionalidade] (String) Nacionalidade.
funcionario[nome_da_mae] (String) Nome da mãe.
funcionario[nome_do_pai] (String) Nome da pai.
funcionario[estado_civil] (String) Estado civil.
funcionario[conjuge] (String) Nome do conjuge.
funcionario[nascimento] (Date) Data de nascimento.
funcionario[ctps] (String) Identificador de CTPS.
funcionario[cnh] (String) Identificador de CNH.
funcionario[certidao_militar] (String) Identificador de Certidão Militar.
funcionario[tipo_sanguineo] (String) Tipo sanguíneo.
funcionario[etnico_racial] (String) Étnico racial.
funcionario[escolaridade] (String) Escolaridade.
funcionario[observacoes] (String) Observações.
funcionario[biometria] (String) Hash da biometria cadastrada em um equipamento.
funcionario[funcionario_cargos_attributes] (Array) Cargos do funcionário.
funcionario_cargos_attributes[data] (Date) Data de atribuição do cargo.
funcionario_cargos_attributes[funcao] (String) Nome da função.
funcionario_cargos_attributes[name] (String) Nome do cargo.
funcionario[funcionario_exames_attributes] (Array) Exames do funcionário.
funcionario_exames_attributes[data] (Date) Data de atribuição do cargo.
funcionario_exames_attributes[apto] (Boolean) Apto?
funcionario[funcionario_dependentes_attributes] (Array) Dependentes do funcionário.
funcionario_dependentes_attributes[name] (String) Nome do dependente.
funcionario_dependentes_attributes[birth] (Date) Data de nascimento.

Request

Route

POST /v1/funcionarios

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "funcionario": {
    "name": "John Doe",
    "pis": "0182.21351.32-2",
    "empresa_id": "c43becdf-ba77-4062-97c0-58f3335dad92",
    "data_admissao": "2018-01-10",
    "funcionario_exames_attributes": [
      {
        "data": "2017-01-01",
        "apto": "1"
      }
    ]
  }
}

cURL

curl "https://api.ptrp.com.br/v1/funcionarios" -d '{"funcionario":{"name":"John Doe","pis":"0182.21351.32-2","empresa_id":"c43becdf-ba77-4062-97c0-58f3335dad92","data_admissao":"2018-01-10","funcionario_exames_attributes":[{"data":"2017-01-01","apto":"1"}]}}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
uid (String) Funcionário ID.
cpf (String) Identificador de CPF.
data_admissao (Date) Data de admissão.
data_demissao (Date) Data de demissão.
name (String) Nome do funcionário.
pis (String) Identificador de PIS.
registro_folha (String) Identificador de Registro de Folha de pagamento.
rg (String) Identificador de RG.
nacionalidade (String) Nacionalidade.
nome_da_mae (String) Nome da mãe.
nome_do_pai (String) Nome da pai.
estado_civil (String) Estado civil.
conjuge (String) Nome do conjuge.
nascimento (Date) Data de nascimento.
ctps (String) Identificador de CTPS.
cnh (String) Identificador de CNH.
phone (String) Celular do funcionario.
email (String) Email do funcionario.
phone (String) Celular do funcionario.
email (String) Email do funcionario.
certidao_militar (String) Identificador de Certidão Militar.
tipo_sanguineo (String) Tipo sanguíneo.
etnico_racial (String) Étnico racial.
escolaridade (String) Escolaridade.
observacoes (String) Observações.
biometria (String) Hash da biometria cadastrada em um equipamento.
created_at (Time) Data e hora da criação do registro.
updated_at (Time) Data e hora da última alteração do registro.
cargos (Array) Cargos do funcionário.
cargos[data] (Date) Data de atribuição do cargo.
cargos[funcao] (String) Nome da função.
cargos[name] (String) Nome do cargo.
exames (Array) Exames do funcionário.
exames[data] (Date) Data de atribuição do cargo.
exames[apto] (Boolean) Apto?
dependentes (Array) Dependentes do funcionário.
dependentes[name] (String) Nome do dependente.
dependentes[birth] (Date) Data de nascimento.
errors[name] (Array) Mensagens de erros para o campo name.
errors[pis] (Array) Mensagens de erros para o campo PIS.

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"bbc701490ffe65b61b8ca81d37163f26"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 2b898c6c-16f9-4c80-8f9a-897a49125da5
X-Runtime: 0.064721
Vary: Origin
Content-Length: 967

Body

{
  "cpf": null,
  "cracha": "3247929223",
  "data_admissao": "2018-01-10",
  "data_demissao": null,
  "name": "John Doe",
  "pis": "018221351322",
  "registro_folha": null,
  "rg": null,
  "uid": "073f6769-55bc-489c-ac90-d564af275f7d",
  "nacionalidade": null,
  "nome_da_mae": null,
  "nome_do_pai": null,
  "estado_civil": null,
  "conjuge": null,
  "nascimento": null,
  "ctps": null,
  "cnh": null,
  "certidao_militar": null,
  "tipo_sanguineo": null,
  "escolaridade": null,
  "observacoes": null,
  "cargos": [

  ],
  "exames": [
    {
      "data": "2017-01-01",
      "apto": true,
      "tipo_exame": null,
      "observacoes": null,
      "arquivo": {
        "url": null
      }
    }
  ],
  "empresa": {
    "uid": "c43becdf-ba77-4062-97c0-58f3335dad92",
    "name": "Empresa01",
    "nome_fantasia": "EmpFantasia01",
    "cnpj": "00.000.000/0000-01",
    "cei": null,
    "cpf": null,
    "inscricao_estadual": null,
    "address": null,
    "contact": null,
    "codigo_registro_folha": null,
    "ativo": true
  },
  "departamento": null,
  "biometria": null,
  "email": null,
  "phone": null,
  "etnico_racial": null,
  "updated_at": "2026-04-06T22:37:28.545-03:00",
  "created_at": "2026-04-06T22:37:28.545-03:00"
}

Criando funcionário - erros

Este método mostra falhas na validação do funcionário.

Endpoint

POST /v1/funcionarios

Parameters

Name Description
funcionario[pis] required (String) Identificador de PIS.
funcionario[cpf] (String) Identificador de CPF.
funcionario[data_admissao] required (Date) Data de admissão.
funcionario[data_demissao] (Date) Data de demissão.
funcionario[name] required (String) Nome do funcionário.
funcionario[empresa_id] required (String) UID da Empresa.
funcionario[departamento_id] (String) UID do Departamento.
funcionario[registro_folha] (String) Identificador de Registro de Folha de pagamento.
funcionario[rg] (String) Identificador de RG.
funcionario[nacionalidade] (String) Nacionalidade.
funcionario[nome_da_mae] (String) Nome da mãe.
funcionario[nome_do_pai] (String) Nome da pai.
funcionario[estado_civil] (String) Estado civil.
funcionario[conjuge] (String) Nome do conjuge.
funcionario[nascimento] (Date) Data de nascimento.
funcionario[ctps] (String) Identificador de CTPS.
funcionario[cnh] (String) Identificador de CNH.
funcionario[certidao_militar] (String) Identificador de Certidão Militar.
funcionario[tipo_sanguineo] (String) Tipo sanguíneo.
funcionario[etnico_racial] (String) Étnico racial.
funcionario[escolaridade] (String) Escolaridade.
funcionario[observacoes] (String) Observações.
funcionario[biometria] (String) Hash da biometria cadastrada em um equipamento.
funcionario[funcionario_cargos_attributes] (Array) Cargos do funcionário.
funcionario_cargos_attributes[data] (Date) Data de atribuição do cargo.
funcionario_cargos_attributes[funcao] (String) Nome da função.
funcionario_cargos_attributes[name] (String) Nome do cargo.
funcionario[funcionario_exames_attributes] (Array) Exames do funcionário.
funcionario_exames_attributes[data] (Date) Data de atribuição do cargo.
funcionario_exames_attributes[apto] (Boolean) Apto?
funcionario[funcionario_dependentes_attributes] (Array) Dependentes do funcionário.
funcionario_dependentes_attributes[name] (String) Nome do dependente.
funcionario_dependentes_attributes[birth] (Date) Data de nascimento.

Request

Route

POST /v1/funcionarios

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "funcionario": {
    "name": ""
  }
}

cURL

curl "https://api.ptrp.com.br/v1/funcionarios" -d '{"funcionario":{"name":""}}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
uid (String) Funcionário ID.
cpf (String) Identificador de CPF.
data_admissao (Date) Data de admissão.
data_demissao (Date) Data de demissão.
name (String) Nome do funcionário.
pis (String) Identificador de PIS.
registro_folha (String) Identificador de Registro de Folha de pagamento.
rg (String) Identificador de RG.
nacionalidade (String) Nacionalidade.
nome_da_mae (String) Nome da mãe.
nome_do_pai (String) Nome da pai.
estado_civil (String) Estado civil.
conjuge (String) Nome do conjuge.
nascimento (Date) Data de nascimento.
ctps (String) Identificador de CTPS.
cnh (String) Identificador de CNH.
phone (String) Celular do funcionario.
email (String) Email do funcionario.
phone (String) Celular do funcionario.
email (String) Email do funcionario.
certidao_militar (String) Identificador de Certidão Militar.
tipo_sanguineo (String) Tipo sanguíneo.
etnico_racial (String) Étnico racial.
escolaridade (String) Escolaridade.
observacoes (String) Observações.
biometria (String) Hash da biometria cadastrada em um equipamento.
created_at (Time) Data e hora da criação do registro.
updated_at (Time) Data e hora da última alteração do registro.
cargos (Array) Cargos do funcionário.
cargos[data] (Date) Data de atribuição do cargo.
cargos[funcao] (String) Nome da função.
cargos[name] (String) Nome do cargo.
exames (Array) Exames do funcionário.
exames[data] (Date) Data de atribuição do cargo.
exames[apto] (Boolean) Apto?
dependentes (Array) Dependentes do funcionário.
dependentes[name] (String) Nome do dependente.
dependentes[birth] (Date) Data de nascimento.
errors[name] (Array) Mensagens de erros para o campo name.
errors[pis] (Array) Mensagens de erros para o campo PIS.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: 0cc217a1-b310-4843-8c14-999e292da53f
X-Runtime: 0.056481
Vary: Origin
Content-Length: 133

Body

{
  "message": "Validation Failed!",
  "errors": {
    "name": [
      "can't be blank"
    ],
    "data_admissao": [
      "can't be blank"
    ],
    "empresa": [
      "can't be blank"
    ]
  }
}

Listando funcionários

Este método retorna um array de funcionarios.

Endpoint

GET /v1/funcionarios

Parameters

Name Description
per_page (Int) Número de registros por página. Padrão: 5.
page (Int) Número da página de referência da paginação. Padrão: 1.
include_last_quadro_de_horas (Boolean) "true" ou "1" para exibir com o último quadro de horas vinculado.
empresa_uid (Int) UID da empresa
departamento_uid (Int) UID da departamento
registro_folha (String) Registro da folha de pagamento
status (String) Status do funcionário (nao_desativados, ativos, inativos, sem_empresa, sem_cadastro e experiencia)
cracha (String) Crachá do funcionário
periodo (Date) Periodo de atividade
data_inicial (Date) Data inicial do Periodo de atividade
data_final (Date) Data final do Periodo de atividade
nome (String) Nome do funcionário (parte do nome para busca parcial)
cpf (String) Cpf do funcionário
phone (String) Celular do funcionario
email (String) Email do funcionario)

Request

Route

GET /v1/funcionarios

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/funcionarios" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
X-Current-Page (Int) [Header] Página atual da paginação.
X-Per-Page (Int) [Header] Número máximo de registros da resposta à requisição.
X-Total-Entries (Int) [Header] Total de registros da consulta.
X-Total-Pages (Int) [Header] Total de páginas da consulta.
[Objetos<Funcionario>] (Array) Coleção de Funcionários (Ver artigo objeto Funcionario).

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Per-Page: 5
X-Current-Page: 1
X-Total-Entries: 24
X-Total-Pages: 5
Content-Type: application/json; charset=utf-8
ETag: W/"2ddc2f3a4fb5b2e3b2c04749fc7bd275"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 4f4ed4fe-2ea5-4aa8-a7a5-48eac14bd849
X-Runtime: 0.110091
Vary: Origin
Content-Length: 7167

Body

[
  {
    "cpf": null,
    "cracha": "3241423821",
    "data_admissao": "2015-01-01",
    "data_demissao": null,
    "name": "Abraão Diz",
    "pis": "010815431066",
    "registro_folha": null,
    "rg": null,
    "uid": "51ba8bd1-1c65-40fa-8e11-7e2f4f1ff2d2",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [

    ],
    "exames": [

    ],
    "empresa": {
      "uid": "c43becdf-ba77-4063-97d0-18f3135d2d9a",
      "name": "Abraao",
      "nome_fantasia": "Abraao",
      "cnpj": "00.400.300/0200-11",
      "cei": null,
      "cpf": null,
      "inscricao_estadual": null,
      "address": null,
      "contact": null,
      "codigo_registro_folha": null,
      "ativo": true
    },
    "departamento": null,
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:18.000-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  },
  {
    "cpf": null,
    "cracha": "000128989",
    "data_admissao": "2015-08-01",
    "data_demissao": "2015-12-02",
    "name": "ACIR DIRCEU RIBEIRO PATRICIO ROBERTO GUIMARÃES DA SLVA",
    "pis": null,
    "registro_folha": null,
    "rg": null,
    "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d6",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [

    ],
    "exames": [

    ],
    "empresa": {
      "uid": "c43becdf-ba77-4063-97d0-58f3235d2d91",
      "name": "EMPRESA COM NOME MUITO MUITO MUITO MUITO GRANDE LTDA",
      "nome_fantasia": "EMPRESA COM NOME MUITO MUITO MUITO MUITO GRANDE",
      "cnpj": "00.000.000/0000-11",
      "cei": null,
      "cpf": null,
      "inscricao_estadual": null,
      "address": {
        "cep": "99999-999",
        "city": "São José do Vale do Rio Preto",
        "complement": "Complemento Complemento Complemento Complemento",
        "country": "Brasil",
        "number": "9999",
        "state": "RIO GRANDE DO NORTE",
        "street": "não existe não existe não existe",
        "district": "Jijoca de Jericoacoara"
      },
      "contact": null,
      "codigo_registro_folha": null,
      "ativo": true
    },
    "departamento": {
      "uid": "f43becdf-bb77-4022-97c0-58f3335dad55",
      "name": "dp1 COM NOME MUITO MUITO GRANDE QUE NÃO CABE NO CARTÃO",
      "empresa": {
        "uid": "c43becdf-ba77-4063-97d0-58f3235d2d91",
        "name": "EMPRESA COM NOME MUITO MUITO MUITO MUITO GRANDE LTDA",
        "nome_fantasia": "EMPRESA COM NOME MUITO MUITO MUITO MUITO GRANDE",
        "cnpj": "00.000.000/0000-11",
        "cei": null,
        "cpf": null,
        "inscricao_estadual": null,
        "address": {
          "cep": "99999-999",
          "city": "São José do Vale do Rio Preto",
          "complement": "Complemento Complemento Complemento Complemento",
          "country": "Brasil",
          "number": "9999",
          "state": "RIO GRANDE DO NORTE",
          "street": "não existe não existe não existe",
          "district": "Jijoca de Jericoacoara"
        },
        "contact": null,
        "codigo_registro_folha": null,
        "ativo": true
      },
      "ativo": true
    },
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:18.000-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  },
  {
    "cpf": null,
    "cracha": "022338195fw5",
    "data_admissao": "2000-01-01",
    "data_demissao": null,
    "name": "Claudia",
    "pis": null,
    "registro_folha": null,
    "rg": null,
    "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d5",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [

    ],
    "exames": [

    ],
    "empresa": {
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "cei": null,
      "cpf": null,
      "inscricao_estadual": null,
      "address": {
        "cep": "85555-222",
        "city": "Guarapuava",
        "complement": "Apto52",
        "country": "Brasil",
        "number": "101",
        "state": "PR",
        "street": "Rua Armando Ribas",
        "district": "Rua Armando Ribas"
      },
      "contact": null,
      "codigo_registro_folha": "23",
      "ativo": true
    },
    "departamento": {
      "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
      "name": "Departamento01",
      "empresa": {
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "cei": null,
        "cpf": null,
        "inscricao_estadual": null,
        "address": {
          "cep": "85555-222",
          "city": "Guarapuava",
          "complement": "Apto52",
          "country": "Brasil",
          "number": "101",
          "state": "PR",
          "street": "Rua Armando Ribas",
          "district": "Rua Armando Ribas"
        },
        "contact": null,
        "codigo_registro_folha": "23",
        "ativo": true
      },
      "ativo": true
    },
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:18.000-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  },
  {
    "cpf": null,
    "cracha": "32382329",
    "data_admissao": "2017-01-01",
    "data_demissao": null,
    "name": "Donald T.",
    "pis": "011811243066",
    "registro_folha": null,
    "rg": null,
    "uid": "51ba8bd1-1c65-40fa-8e11-7e2f4e1ff4d1",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [

    ],
    "exames": [

    ],
    "empresa": {
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "cei": null,
      "cpf": null,
      "inscricao_estadual": null,
      "address": {
        "cep": "85555-222",
        "city": "Guarapuava",
        "complement": "Apto52",
        "country": "Brasil",
        "number": "101",
        "state": "PR",
        "street": "Rua Armando Ribas",
        "district": "Rua Armando Ribas"
      },
      "contact": null,
      "codigo_registro_folha": "23",
      "ativo": true
    },
    "departamento": null,
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:18.000-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  },
  {
    "cpf": "07155744989",
    "cracha": "1",
    "data_admissao": "2017-01-01",
    "data_demissao": null,
    "name": "Func1",
    "pis": "123929234315",
    "registro_folha": "123",
    "rg": null,
    "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [
      {
        "data": "2017-01-10",
        "funcao": "test",
        "name": "Auxiliar (123456)"
      },
      {
        "data": "2018-01-01",
        "funcao": "auxiliar",
        "name": null
      }
    ],
    "exames": [
      {
        "data": "2017-01-10",
        "apto": true,
        "tipo_exame": null,
        "observacoes": null,
        "arquivo": {
          "url": null
        }
      }
    ],
    "empresa": {
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "cei": null,
      "cpf": null,
      "inscricao_estadual": null,
      "address": {
        "cep": "85555-222",
        "city": "Guarapuava",
        "complement": "Apto52",
        "country": "Brasil",
        "number": "101",
        "state": "PR",
        "street": "Rua Armando Ribas",
        "district": "Rua Armando Ribas"
      },
      "contact": null,
      "codigo_registro_folha": "23",
      "ativo": true
    },
    "departamento": {
      "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
      "name": "Departamento01",
      "empresa": {
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "cei": null,
        "cpf": null,
        "inscricao_estadual": null,
        "address": {
          "cep": "85555-222",
          "city": "Guarapuava",
          "complement": "Apto52",
          "country": "Brasil",
          "number": "101",
          "state": "PR",
          "street": "Rua Armando Ribas",
          "district": "Rua Armando Ribas"
        },
        "contact": null,
        "codigo_registro_folha": "23",
        "ativo": true
      },
      "ativo": true
    },
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:28.002-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  }
]

Procurando funcionário pelo crachá

Este método retorna um array de funcionarios.

Endpoint

GET /v1/funcionarios?cracha=0110

Parameters

Name Description
per_page (Int) Número de registros por página. Padrão: 5.
page (Int) Número da página de referência da paginação. Padrão: 1.
cracha (String) Crachá do funcionário.

Request

Route

GET /v1/funcionarios?cracha=0110

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Query Parameters

cracha=0110

cURL

curl -g "https://api.ptrp.com.br/v1/funcionarios?cracha=0110" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
X-Current-Page (Int) [Header] Página atual da paginação.
X-Per-Page (Int) [Header] Número máximo de registros da resposta à requisição.
X-Total-Entries (Int) [Header] Total de registros da consulta.
X-Total-Pages (Int) [Header] Total de páginas da consulta.
[Objetos<Funcionario>] (Array) Coleção de Funcionários (Ver artigo objeto Funcionario).

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Per-Page: 5
X-Current-Page: 1
X-Total-Entries: 1
X-Total-Pages: 1
Content-Type: application/json; charset=utf-8
ETag: W/"d706805760b7807cef238191229a31da"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 372a387f-0e70-4be0-8656-dcea10690e5c
X-Runtime: 0.055213
Vary: Origin
Content-Length: 1031

Body

[
  {
    "cpf": null,
    "cracha": "0110",
    "data_admissao": "2000-01-01",
    "data_demissao": null,
    "name": "Func4",
    "pis": "123456789012",
    "registro_folha": null,
    "rg": null,
    "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c3",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [

    ],
    "exames": [

    ],
    "empresa": {
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "cei": null,
      "cpf": null,
      "inscricao_estadual": null,
      "address": {
        "cep": "85555-222",
        "city": "Guarapuava",
        "complement": "Apto52",
        "country": "Brasil",
        "number": "101",
        "state": "PR",
        "street": "Rua Armando Ribas",
        "district": "Rua Armando Ribas"
      },
      "contact": null,
      "codigo_registro_folha": "23",
      "ativo": true
    },
    "departamento": null,
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:18.000-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  }
]

Procurando funcionário pelo registro de folha de pagamento

Este método retorna um array de funcionarios.

Endpoint

GET /v1/funcionarios?registro_folha=123

Parameters

Name Description
per_page (Int) Número de registros por página. Padrão: 5.
page (Int) Número da página de referência da paginação. Padrão: 1.
registro_folha (String) Identificador Registro de folha de pagamento do funcionário.

Request

Route

GET /v1/funcionarios?registro_folha=123

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Query Parameters

registro_folha=123

cURL

curl -g "https://api.ptrp.com.br/v1/funcionarios?registro_folha=123" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
X-Current-Page (Int) [Header] Página atual da paginação.
X-Per-Page (Int) [Header] Número máximo de registros da resposta à requisição.
X-Total-Entries (Int) [Header] Total de registros da consulta.
X-Total-Pages (Int) [Header] Total de páginas da consulta.
[Objetos<Funcionario>] (Array) Coleção de Funcionários (Ver artigo objeto Funcionario).

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Per-Page: 5
X-Current-Page: 1
X-Total-Entries: 1
X-Total-Pages: 1
Content-Type: application/json; charset=utf-8
ETag: W/"2fa4ed25b51a0816d9ba3c8364d71d70"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: d7de7bbf-7251-4f9e-b855-8942f6969122
X-Runtime: 0.060174
Vary: Origin
Content-Length: 1748

Body

[
  {
    "cpf": "07155744989",
    "cracha": "1",
    "data_admissao": "2017-01-01",
    "data_demissao": null,
    "name": "Func1",
    "pis": "123929234315",
    "registro_folha": "123",
    "rg": null,
    "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [
      {
        "data": "2017-01-10",
        "funcao": "test",
        "name": "Auxiliar (123456)"
      },
      {
        "data": "2018-01-01",
        "funcao": "auxiliar",
        "name": null
      }
    ],
    "exames": [
      {
        "data": "2017-01-10",
        "apto": true,
        "tipo_exame": null,
        "observacoes": null,
        "arquivo": {
          "url": null
        }
      }
    ],
    "empresa": {
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "cei": null,
      "cpf": null,
      "inscricao_estadual": null,
      "address": {
        "cep": "85555-222",
        "city": "Guarapuava",
        "complement": "Apto52",
        "country": "Brasil",
        "number": "101",
        "state": "PR",
        "street": "Rua Armando Ribas",
        "district": "Rua Armando Ribas"
      },
      "contact": null,
      "codigo_registro_folha": "23",
      "ativo": true
    },
    "departamento": {
      "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
      "name": "Departamento01",
      "empresa": {
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "cei": null,
        "cpf": null,
        "inscricao_estadual": null,
        "address": {
          "cep": "85555-222",
          "city": "Guarapuava",
          "complement": "Apto52",
          "country": "Brasil",
          "number": "101",
          "state": "PR",
          "street": "Rua Armando Ribas",
          "district": "Rua Armando Ribas"
        },
        "contact": null,
        "codigo_registro_folha": "23",
        "ativo": true
      },
      "ativo": true
    },
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:28.195-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  }
]

Procurando funcionário pelo status

Este método retorna um array de funcionarios.

Endpoint

GET /v1/funcionarios?status=inativos

Parameters

Name Description
per_page (Int) Número de registros por página. Padrão: 5.
page (Int) Número da página de referência da paginação. Padrão: 1.
status (String) Status atual do funcionário. Valores: "nao_desativados", "inativos", "sem_empresa", "sem_cadastro" e "experiencia".

Request

Route

GET /v1/funcionarios?status=inativos

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Query Parameters

status=inativos

cURL

curl -g "https://api.ptrp.com.br/v1/funcionarios?status=inativos" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
X-Current-Page (Int) [Header] Página atual da paginação.
X-Per-Page (Int) [Header] Número máximo de registros da resposta à requisição.
X-Total-Entries (Int) [Header] Total de registros da consulta.
X-Total-Pages (Int) [Header] Total de páginas da consulta.
[] (Array) Coleção de Funcionários. Ver objeto Funcionario.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Per-Page: 5
X-Current-Page: 1
X-Total-Entries: 2
X-Total-Pages: 1
Content-Type: application/json; charset=utf-8
ETag: W/"5785bd7b8f2f9d71ad2908c3fbac67a5"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: d3c14b5c-ff6b-44da-ac10-dbeb30da02eb
X-Runtime: 0.058456
Vary: Origin
Content-Length: 3029

Body

[
  {
    "cpf": null,
    "cracha": "000128989",
    "data_admissao": "2015-08-01",
    "data_demissao": "2015-12-02",
    "name": "ACIR DIRCEU RIBEIRO PATRICIO ROBERTO GUIMARÃES DA SLVA",
    "pis": null,
    "registro_folha": null,
    "rg": null,
    "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d6",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [

    ],
    "exames": [

    ],
    "empresa": {
      "uid": "c43becdf-ba77-4063-97d0-58f3235d2d91",
      "name": "EMPRESA COM NOME MUITO MUITO MUITO MUITO GRANDE LTDA",
      "nome_fantasia": "EMPRESA COM NOME MUITO MUITO MUITO MUITO GRANDE",
      "cnpj": "00.000.000/0000-11",
      "cei": null,
      "cpf": null,
      "inscricao_estadual": null,
      "address": {
        "cep": "99999-999",
        "city": "São José do Vale do Rio Preto",
        "complement": "Complemento Complemento Complemento Complemento",
        "country": "Brasil",
        "number": "9999",
        "state": "RIO GRANDE DO NORTE",
        "street": "não existe não existe não existe",
        "district": "Jijoca de Jericoacoara"
      },
      "contact": null,
      "codigo_registro_folha": null,
      "ativo": true
    },
    "departamento": {
      "uid": "f43becdf-bb77-4022-97c0-58f3335dad55",
      "name": "dp1 COM NOME MUITO MUITO GRANDE QUE NÃO CABE NO CARTÃO",
      "empresa": {
        "uid": "c43becdf-ba77-4063-97d0-58f3235d2d91",
        "name": "EMPRESA COM NOME MUITO MUITO MUITO MUITO GRANDE LTDA",
        "nome_fantasia": "EMPRESA COM NOME MUITO MUITO MUITO MUITO GRANDE",
        "cnpj": "00.000.000/0000-11",
        "cei": null,
        "cpf": null,
        "inscricao_estadual": null,
        "address": {
          "cep": "99999-999",
          "city": "São José do Vale do Rio Preto",
          "complement": "Complemento Complemento Complemento Complemento",
          "country": "Brasil",
          "number": "9999",
          "state": "RIO GRANDE DO NORTE",
          "street": "não existe não existe não existe",
          "district": "Jijoca de Jericoacoara"
        },
        "contact": null,
        "codigo_registro_folha": null,
        "ativo": true
      },
      "ativo": true
    },
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:18.000-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  },
  {
    "cpf": null,
    "cracha": "7",
    "data_admissao": "2000-01-01",
    "data_demissao": "2004-01-12",
    "name": "Func desligado",
    "pis": "055811243066",
    "registro_folha": null,
    "rg": null,
    "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c4",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [

    ],
    "exames": [

    ],
    "empresa": {
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "cei": null,
      "cpf": null,
      "inscricao_estadual": null,
      "address": {
        "cep": "85555-222",
        "city": "Guarapuava",
        "complement": "Apto52",
        "country": "Brasil",
        "number": "101",
        "state": "PR",
        "street": "Rua Armando Ribas",
        "district": "Rua Armando Ribas"
      },
      "contact": null,
      "codigo_registro_folha": "23",
      "ativo": true
    },
    "departamento": null,
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:18.000-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  }
]

Visualizar Funcionário

Este método retorna um objeto funcionário.

Endpoint

GET /v1/funcionarios/:uid

Parameters

Name Description
uid required (String) UID do funcionário.

Request

Route

GET /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario[uid] (String) Funcionário UID.
funcionario[cpf] (String) Identificador de CPF.
funcionario[data_admissao] (Date) Data de admissão.
funcionario[data_demissao] (Date) Data de demissão.
funcionario[name] (String) Nome do funcionário.
funcionario[pis] (String) Identificador de PIS.
funcionario[registro_folha] (String) Identificador de Registro de Folha de pagamento.
funcionario[rg] (String) Identificador de RG.
funcionario[nacionalidade] (String) Nacionalidade.
funcionario[nome_da_mae] (String) Nome da mãe.
funcionario[nome_do_pai] (String) Nome da pai.
funcionario[estado_civil] (String) Estado civil.
funcionario[conjuge] (String) Nome do conjuge.
funcionario[nascimento] (Date) Data de nascimento.
funcionario[ctps] (String) Identificador de CTPS.
funcionario[cnh] (String) Identificador de CNH.
funcionario[phone] (String) Telefone do funcionário
funcionario[email] (String) Email do funcionário.
funcionario[certidao_militar] (String) Identificador de Certidão Militar.
funcionario[tipo_sanguineo] (String) Tipo sanguíneo.
funcionario[etnico_racial] (String) Étnico racial.
funcionario[escolaridade] (String) Escolaridade.
funcionario[observacoes] (String) Observações.
funcionario[biometria] (String) Hash da biometria cadastrada em um equipamento.
funcionario[cargos] (Array) Cargos do funcionário.
cargos[data] (Date) Data de atribuição do cargo.
cargos[funcao] (String) Nome da função.
cargos[name] (String) Nome do cargo.
funcionario[exames] (Array) Exames do funcionário.
exames[data] (Date) Data de atribuição do cargo.
exames[apto] (Boolean) Apto?
funcionario[dependentes] (Array) Dependentes do funcionário.
dependentes[name] (String) Nome do dependente.
dependentes[birth] (Date) Data de nascimento.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"66a835492e602d856f93f10483a5b3cb"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 45fbd0e6-fc1e-4694-b337-e47c8bd08b00
X-Runtime: 0.065865
Vary: Origin
Content-Length: 1746

Body

{
  "cpf": "07155744989",
  "cracha": "1",
  "data_admissao": "2017-01-01",
  "data_demissao": null,
  "name": "Func1",
  "pis": "123929234315",
  "registro_folha": "123",
  "rg": null,
  "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
  "nacionalidade": null,
  "nome_da_mae": null,
  "nome_do_pai": null,
  "estado_civil": null,
  "conjuge": null,
  "nascimento": null,
  "ctps": null,
  "cnh": null,
  "certidao_militar": null,
  "tipo_sanguineo": null,
  "escolaridade": null,
  "observacoes": null,
  "cargos": [
    {
      "data": "2017-01-10",
      "funcao": "test",
      "name": "Auxiliar (123456)"
    },
    {
      "data": "2018-01-01",
      "funcao": "auxiliar",
      "name": null
    }
  ],
  "exames": [
    {
      "data": "2017-01-10",
      "apto": true,
      "tipo_exame": null,
      "observacoes": null,
      "arquivo": {
        "url": null
      }
    }
  ],
  "empresa": {
    "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
    "name": "Empresa03",
    "nome_fantasia": "EmpFantasia03",
    "cnpj": "00.000.000/0000-03",
    "cei": null,
    "cpf": null,
    "inscricao_estadual": null,
    "address": {
      "cep": "85555-222",
      "city": "Guarapuava",
      "complement": "Apto52",
      "country": "Brasil",
      "number": "101",
      "state": "PR",
      "street": "Rua Armando Ribas",
      "district": "Rua Armando Ribas"
    },
    "contact": null,
    "codigo_registro_folha": "23",
    "ativo": true
  },
  "departamento": {
    "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
    "name": "Departamento01",
    "empresa": {
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "cei": null,
      "cpf": null,
      "inscricao_estadual": null,
      "address": {
        "cep": "85555-222",
        "city": "Guarapuava",
        "complement": "Apto52",
        "country": "Brasil",
        "number": "101",
        "state": "PR",
        "street": "Rua Armando Ribas",
        "district": "Rua Armando Ribas"
      },
      "contact": null,
      "codigo_registro_folha": "23",
      "ativo": true
    },
    "ativo": true
  },
  "biometria": null,
  "email": null,
  "phone": null,
  "etnico_racial": null,
  "updated_at": "2026-04-06T22:37:28.342-03:00",
  "created_at": "2026-04-06T22:37:18.000-03:00"
}

Visualizar Funcionário - Com último Quadro de horas Vinculado

Este método retorna um objeto funcionário com o último quadro de horas vinculado.

Endpoint

GET /v1/funcionarios/:uid?include_last_quadro_de_horas=1

Parameters

Name Description
uid required (String) UID do funcionário.
include_last_quadro_de_horas (Boolean) "true" ou "1" para exibir o último quadro de horas vinculado.

Request

Route

GET /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0?include_last_quadro_de_horas=1

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Query Parameters

include_last_quadro_de_horas=1

cURL

curl -g "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0?include_last_quadro_de_horas=1" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
uid (String) Funcionário ID.
Objeto Funcionario ... (ver artigo Visualizar Funcionário)
last_quadro_de_horas[data_vigencia] (Date) Data de vigência do quadro de horas.
last_quadro_de_horas[quadro_de_hora] (Object) Dados do Objeto Quadro de horas (ver artigo Listando Quadro de Horas).

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"f9f195c599ef7d147d915efa068632a5"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 358745ca-b5b1-4c8c-9825-b5c8e78c9a66
X-Runtime: 0.054668
Vary: Origin
Content-Length: 2060

Body

{
  "cpf": "07155744989",
  "cracha": "1",
  "data_admissao": "2017-01-01",
  "data_demissao": null,
  "name": "Func1",
  "pis": "123929234315",
  "registro_folha": "123",
  "rg": null,
  "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
  "nacionalidade": null,
  "nome_da_mae": null,
  "nome_do_pai": null,
  "estado_civil": null,
  "conjuge": null,
  "nascimento": null,
  "ctps": null,
  "cnh": null,
  "certidao_militar": null,
  "tipo_sanguineo": null,
  "escolaridade": null,
  "observacoes": null,
  "cargos": [
    {
      "data": "2017-01-10",
      "funcao": "test",
      "name": "Auxiliar (123456)"
    },
    {
      "data": "2018-01-01",
      "funcao": "auxiliar",
      "name": null
    }
  ],
  "exames": [
    {
      "data": "2017-01-10",
      "apto": true,
      "tipo_exame": null,
      "observacoes": null,
      "arquivo": {
        "url": null
      }
    }
  ],
  "empresa": {
    "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
    "name": "Empresa03",
    "nome_fantasia": "EmpFantasia03",
    "cnpj": "00.000.000/0000-03",
    "cei": null,
    "cpf": null,
    "inscricao_estadual": null,
    "address": {
      "cep": "85555-222",
      "city": "Guarapuava",
      "complement": "Apto52",
      "country": "Brasil",
      "number": "101",
      "state": "PR",
      "street": "Rua Armando Ribas",
      "district": "Rua Armando Ribas"
    },
    "contact": null,
    "codigo_registro_folha": "23",
    "ativo": true
  },
  "departamento": {
    "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
    "name": "Departamento01",
    "empresa": {
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33",
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "cei": null,
      "cpf": null,
      "inscricao_estadual": null,
      "address": {
        "cep": "85555-222",
        "city": "Guarapuava",
        "complement": "Apto52",
        "country": "Brasil",
        "number": "101",
        "state": "PR",
        "street": "Rua Armando Ribas",
        "district": "Rua Armando Ribas"
      },
      "contact": null,
      "codigo_registro_folha": "23",
      "ativo": true
    },
    "ativo": true
  },
  "biometria": null,
  "email": null,
  "phone": null,
  "etnico_racial": null,
  "updated_at": "2026-04-06T22:37:28.422-03:00",
  "created_at": "2026-04-06T22:37:18.000-03:00",
  "last_quadro_de_horas": {
    "id": 980190962,
    "data_vigencia": "2014-03-26",
    "quadro_de_hora": {
      "hora_virada": "2000-01-01T00:00:00.000Z",
      "name": "Quadro Livre",
      "tipo": "livre",
      "use_holiday": true,
      "folgas_especiais": 0,
      "ativo": true,
      "ch": 11,
      "marcacao_automatica_intervalo": null,
      "tolerancia": null,
      "horario": null,
      "intervalo": null
    }
  }
}

Funcionários > Ausentes

Listando erros para requisição com data inválida

Este método retorna a reposta para parametros inválidos.

Endpoint

GET /v1/funcionarios/ausentes/:from/ate/:to

Parameters

Name Description
from required (Date) Data inicial do relatório.
to required (Date) Data final do relatório.

Request

Route

GET /v1/funcionarios/ausentes/2015-01-33/ate/2015-12-31

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/funcionarios/ausentes/2015-01-33/ate/2015-12-31" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario (Funcionario) Objeto Funcionário (ver artigo Funcionários).
dias (Array) Dias de ausência.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: c6ce3d96-1986-4540-ae66-f09c2cafb714
X-Runtime: 0.042915
Vary: Origin
Content-Length: 33

Body

{
  "message": "Invalid Date format"
}

Listando os funcionários ausentes entre as datas

Este método retorna uma coleção de funcionários ausentes dado um intervalo de datas.

Endpoint

GET /v1/funcionarios/ausentes/:from/ate/:to

Parameters

Name Description
from required (Date) Data inicial do relatório.
to required (Date) Data final do relatório.

Request

Route

GET /v1/funcionarios/ausentes/2015-12-01/ate/2015-12-31

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/funcionarios/ausentes/2015-12-01/ate/2015-12-31" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario (Funcionario) Objeto Funcionário (ver artigo Funcionários).
dias (Array) Dias de ausência.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"0c41ef56dcd6988553a5c855d1a1d370"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: bcdf6c85-e497-4993-b81e-d6cccff238d3
X-Runtime: 0.070384
Vary: Origin
Content-Length: 1509

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2015-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "ativo": true,
        "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
        "codigo_registro_folha": "1",
        "full_name": "Departamento01 (Empresa03)"
      },
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:24.898-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    },
    "days": [
      "2015-12-01"
    ]
  }
]

Funcionários > Cartão Ponto

Aprovando o cartão ponto

Este método aprova o cartão ponto com o usuário funcionário.

Endpoint

PATCH /v1/funcionarios/:funcionario_id/cartao_ponto/:year/:month/approve

Parameters

Name Description
funcionario_id required (String) UID do funcionário.
year required (Int) Ano do cartão ponto. Ex: 2018.
month required (Int) Mês do cartão ponto. Ex: 10.

Request

Route

PATCH /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2018/2/approve

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2018/2/approve" -d '' -X PATCH \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Cookie: "

Response

Simulated Response

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json
Cache-Control: no-cache
X-Request-Id: 9e76b8f5-91bf-4a5c-ab84-70fb0d4bfc63
X-Runtime: 0.026647
Vary: Origin
Content-Length: 0

Atualizando/Recalculando o cartão ponto

Este método recalcula o cartão ponto e retorna o objeto de cartão ponto do funcionário.

Endpoint

POST /v1/funcionarios/:funcionario_id/cartao_ponto/:year/:month/update

Parameters

Name Description
funcionario_id required (String) UID do funcionário.
year required (Int) Ano do cartão ponto. Ex: 2018.
month required (Int) Mês do cartão ponto. Ex: 10.

Request

Route

POST /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2018/2/update

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2018/2/update" -d '' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
[object] (Object) Cartão ponto (ver artigo Mostrando o cartão ponto do funcionário).
message (String) Mensagem de erro da requisição.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"9d931b680d553d5a9437d24055249ef8"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: b4421cae-887a-41a0-becb-92ac11b84acc
X-Runtime: 0.831593
Vary: Origin
Content-Length: 4367

Body

{
  "funcionario": {
    "cpf": "071.557.449-89",
    "cracha": "1",
    "data_admissao": "2000-01-01",
    "data_demissao": null,
    "name": "Func1",
    "pis": "1239.29234.31-5",
    "registro_folha": "123",
    "rg": null,
    "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [
      {
        "data": "2017-01-10",
        "funcao": "test",
        "name": "Auxiliar (123456)"
      },
      {
        "data": "2018-01-01",
        "funcao": "auxiliar",
        "name": null
      }
    ],
    "exames": [
      {
        "data": "2017-01-10",
        "apto": true,
        "tipo_exame": null,
        "observacoes": null,
        "arquivo": {
          "url": null
        }
      }
    ],
    "empresa": {
      "id": 471928375,
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "inscricao_estadual": null,
      "cpf": null,
      "created_at": "2026-04-06T22:37:18.000-03:00",
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "cliente_id": 571096427,
      "cei": null,
      "codigo_registro_folha": "23",
      "ativo": true,
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
    },
    "departamento": {
      "id": 980190962,
      "name": "Departamento01 (Empresa03)",
      "empresa_id": 471928375,
      "created_at": "2026-04-06T22:37:18.000-03:00",
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "ativo": true,
      "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
      "codigo_registro_folha": "1",
      "full_name": "Departamento01 (Empresa03)"
    },
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:26.078-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  },
  "ano": 2018,
  "mes": 2,
  "mensagem": null,
  "atualizado": true,
  "total_abonos": 0,
  "total_falta": 0,
  "total_trabalhado": 0,
  "total_extra": 0,
  "adicional_noturno": 0,
  "total_atrasado": 0,
  "total_antecipado": 0,
  "dias_de_falta": 0,
  "extra_noturno": 0,
  "semanal": {
    "semana_1": {
      "legenda": 0,
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 0,
      "falta_integral": 0
    },
    "semana_2": {
      "legenda": 0,
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 0,
      "falta_integral": 0
    },
    "semana_3": {
      "legenda": 0,
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 0,
      "falta_integral": 0
    },
    "semana_4": {
      "legenda": 0,
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 0,
      "falta_integral": 0
    },
    "semana_5": {
      "legenda": 0,
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 0,
      "falta_integral": 0
    },
    "semana_6": {
      "legenda": 0,
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 0,
      "falta_integral": 0
    },
    "has_semanal": false
  },
  "mensal": null,
  "politica_extra": {
    "semanal": {
      "segunda_a_sexta": {
      },
      "segunda_a_sabado": {
      },
      "domingo": {
      },
      "sabado": {
      },
      "feriado": {
      },
      "folga": {
      },
      "id": {
      }
    },
    "semanal_detail": {
    },
    "mensal": {
      "segunda_a_sexta": {
      },
      "segunda_a_sabado": {
      },
      "domingo": {
      },
      "sabado": {
      },
      "feriado": {
      },
      "folga": {
      },
      "id": {
      }
    },
    "diaria": {
      "segunda_a_sexta": {
      },
      "segunda_a_sabado": {
      },
      "domingo": {
      },
      "sabado": {
      },
      "feriado": {
      },
      "folga": {
      },
      "id": {
      }
    }
  },
  "locked": false,
  "acrescimo_noturno": 0,
  "trabalhadas_com_dsr": 105600,
  "trabalhadas_menos_extra": 0,
  "dsr_credit": 105600,
  "dsr_debit": 0,
  "quantidade_dsr_positivo": 4,
  "bh_credit": 0,
  "bh_debit": 0,
  "bh_total": 0,
  "bh_pago": 0,
  "bh_abonado": 0,
  "in_itinere_total": 0,
  "falta_integral": 0,
  "falta_parcial": 0,
  "adicional_noturno_sem_acrescimo": 0,
  "intervalo_intrajornada": 0,
  "interjornada": 0,
  "interjornada_faltante": 0,
  "dias_de_trabalho": 0,
  "cp_credit": 0,
  "cp_debit": 0,
  "cp_total": 0,
  "status": "pending_approval",
  "status_history": [

  ],
  "pontos_processados": [

  ],
  "tratamentos": [
    {
      "time": "07:20",
      "type": "I",
      "tratamento": {
        "data": "2018-02-04",
        "hora": "2000-01-01T07:20:00.000Z",
        "ordem": 0,
        "motivo": {
          "id": 367989381,
          "name": "D.S.R.(+)",
          "e_social_id": null
        },
        "category": "dsr"
      }
    },
    {
      "time": "07:20",
      "type": "I",
      "tratamento": {
        "data": "2018-02-11",
        "hora": "2000-01-01T07:20:00.000Z",
        "ordem": 0,
        "motivo": {
          "id": 367989381,
          "name": "D.S.R.(+)",
          "e_social_id": null
        },
        "category": "dsr"
      }
    },
    {
      "time": "07:20",
      "type": "I",
      "tratamento": {
        "data": "2018-02-18",
        "hora": "2000-01-01T07:20:00.000Z",
        "ordem": 0,
        "motivo": {
          "id": 367989381,
          "name": "D.S.R.(+)",
          "e_social_id": null
        },
        "category": "dsr"
      }
    },
    {
      "time": "07:20",
      "type": "I",
      "tratamento": {
        "data": "2018-02-25",
        "hora": "2000-01-01T07:20:00.000Z",
        "ordem": 0,
        "motivo": {
          "id": 367989381,
          "name": "D.S.R.(+)",
          "e_social_id": null
        },
        "category": "dsr"
      }
    }
  ]
}

Atualizando/Recalculando o cartão ponto atual

Este método recalcula o cartão ponto e retorna o objeto de cartão ponto atual (data de hoje) do funcionário.

Endpoint

PATCH /v1/funcionarios/:funcionario_id/cartao_ponto/update

Parameters

Name Description
funcionario_id required (String) UID do funcionário.

Request

Route

PATCH /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/update

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/update" -d '' -X PATCH \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
[object] (Object) Cartão ponto (ver artigo Mostrando o cartão ponto do funcionário).
message (String) Mensagem de erro da requisição.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"b378e26bccc87697533079fa43f5c936"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 6eead574-9cdd-4633-a63a-7e964f6991cb
X-Runtime: 0.169469
Vary: Origin
Content-Length: 3607

Body

{
  "funcionario": {
    "cpf": "071.557.449-89",
    "cracha": "1",
    "data_admissao": "2000-01-01",
    "data_demissao": null,
    "name": "Func1",
    "pis": "1239.29234.31-5",
    "registro_folha": "123",
    "rg": null,
    "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [
      {
        "data": "2017-01-10",
        "funcao": "test",
        "name": "Auxiliar (123456)"
      },
      {
        "data": "2018-01-01",
        "funcao": "auxiliar",
        "name": null
      }
    ],
    "exames": [
      {
        "data": "2017-01-10",
        "apto": true,
        "tipo_exame": null,
        "observacoes": null,
        "arquivo": {
          "url": null
        }
      }
    ],
    "empresa": {
      "id": 471928375,
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "inscricao_estadual": null,
      "cpf": null,
      "created_at": "2026-04-06T22:37:18.000-03:00",
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "cliente_id": 571096427,
      "cei": null,
      "codigo_registro_folha": "23",
      "ativo": true,
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
    },
    "departamento": {
      "id": 980190962,
      "name": "Departamento01 (Empresa03)",
      "empresa_id": 471928375,
      "created_at": "2026-04-06T22:37:18.000-03:00",
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "ativo": true,
      "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
      "codigo_registro_folha": "1",
      "full_name": "Departamento01 (Empresa03)"
    },
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:27.097-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  },
  "ano": 2023,
  "mes": 12,
  "mensagem": null,
  "atualizado": true,
  "total_abonos": 0,
  "total_falta": 0,
  "total_trabalhado": 0,
  "total_extra": 0,
  "adicional_noturno": 0,
  "total_atrasado": 0,
  "total_antecipado": 0,
  "dias_de_falta": 0,
  "extra_noturno": 0,
  "semanal": {
    "semana_1": {
      "legenda": 0,
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 0,
      "falta_integral": 0
    },
    "semana_2": {
      "legenda": 0,
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 0,
      "falta_integral": 0
    },
    "semana_3": {
      "legenda": 0,
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 0,
      "falta_integral": 0
    },
    "semana_4": {
      "legenda": 0,
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 0,
      "falta_integral": 0
    },
    "semana_5": {
      "legenda": 0,
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 0,
      "falta_integral": 0
    },
    "semana_6": {
      "legenda": 0,
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 0,
      "falta_integral": 0
    },
    "has_semanal": false
  },
  "mensal": null,
  "politica_extra": {
    "semanal": {
      "segunda_a_sexta": {
      },
      "segunda_a_sabado": {
      },
      "domingo": {
      },
      "sabado": {
      },
      "feriado": {
      },
      "folga": {
      },
      "id": {
      }
    },
    "semanal_detail": {
    },
    "mensal": {
      "segunda_a_sexta": {
      },
      "segunda_a_sabado": {
      },
      "domingo": {
      },
      "sabado": {
      },
      "feriado": {
      },
      "folga": {
      },
      "id": {
      }
    },
    "diaria": {
      "segunda_a_sexta": {
      },
      "segunda_a_sabado": {
      },
      "domingo": {
      },
      "sabado": {
      },
      "feriado": {
      },
      "folga": {
      },
      "id": {
      }
    }
  },
  "locked": false,
  "acrescimo_noturno": 0,
  "trabalhadas_com_dsr": 0,
  "trabalhadas_menos_extra": 0,
  "dsr_credit": 0,
  "dsr_debit": 0,
  "quantidade_dsr_positivo": 0,
  "bh_credit": 0,
  "bh_debit": 0,
  "bh_total": 0,
  "bh_pago": 0,
  "bh_abonado": 0,
  "in_itinere_total": 0,
  "falta_integral": 0,
  "falta_parcial": 0,
  "adicional_noturno_sem_acrescimo": 0,
  "intervalo_intrajornada": 0,
  "interjornada": 0,
  "interjornada_faltante": 0,
  "dias_de_trabalho": 0,
  "cp_credit": 0,
  "cp_debit": 0,
  "cp_total": 0,
  "status": "pending_approval",
  "status_history": [

  ],
  "pontos_processados": [

  ],
  "tratamentos": [

  ]
}

Mostrando o cartão ponto atual do funcionário

Este método retorna um objeto com os dados do cartão ponto atual (data de hoje) do funcionário.

Endpoint

GET /v1/funcionarios/:funcionario_id/cartao_ponto

Parameters

Name Description
funcionario_id required (String) UID do funcionário.

Request

Route

GET /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
[object] (Object) Cartão ponto (ver artigo Mostrando o cartão ponto do funcionário).

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"e6edb7542cf76479d7d4a805fd170108"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: b2b2c034-7cb4-4d3f-ae60-b3d353cbb65d
X-Runtime: 0.060435
Vary: Origin
Content-Length: 3761

Body

{
  "funcionario": {
    "cpf": "07155744989",
    "cracha": "1",
    "data_admissao": "2000-01-01",
    "data_demissao": null,
    "name": "Func1",
    "pis": "123929234315",
    "registro_folha": "123",
    "rg": null,
    "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [
      {
        "data": "2017-01-10",
        "funcao": "test",
        "name": "Auxiliar (123456)"
      },
      {
        "data": "2018-01-01",
        "funcao": "auxiliar",
        "name": null
      }
    ],
    "exames": [
      {
        "data": "2017-01-10",
        "apto": true,
        "tipo_exame": null,
        "observacoes": null,
        "arquivo": {
          "url": null
        }
      }
    ],
    "empresa": {
      "id": 471928375,
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "inscricao_estadual": null,
      "cpf": null,
      "created_at": "2026-04-06T22:37:18.000-03:00",
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "cliente_id": 571096427,
      "cei": null,
      "codigo_registro_folha": "23",
      "ativo": true,
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
    },
    "departamento": {
      "id": 980190962,
      "name": "Departamento01 (Empresa03)",
      "empresa_id": 471928375,
      "created_at": "2026-04-06T22:37:18.000-03:00",
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "ativo": true,
      "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
      "codigo_registro_folha": "1",
      "full_name": "Departamento01 (Empresa03)"
    },
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:26.975-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  },
  "ano": 2018,
  "mes": 1,
  "mensagem": null,
  "atualizado": true,
  "total_abonos": 0,
  "total_falta": 489600,
  "total_trabalhado": 44000,
  "total_extra": 14400,
  "adicional_noturno": 0,
  "total_atrasado": 0,
  "total_antecipado": 0,
  "dias_de_falta": 17,
  "extra_noturno": 0,
  "semanal": {
    "semana_1": {
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 7,
      "falta_integral": 201600
    },
    "semana_2": {
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 7,
      "falta_integral": 201600
    },
    "semana_3": {
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 3,
      "falta_integral": 86400
    }
  },
  "mensal": null,
  "politica_extra": {
    "semanal": {
      "segunda_a_sexta": {
      },
      "segunda_a_sabado": {
      },
      "domingo": {
      },
      "sabado": {
      },
      "feriado": {
      },
      "folga": {
      },
      "id": {
      }
    },
    "semanal_detail": {
    },
    "mensal": {
      "segunda_a_sexta": {
        "50": 14400
      },
      "segunda_a_sabado": {
      },
      "domingo": {
        "100": 0
      },
      "sabado": {
        "50": 0
      },
      "feriado": {
        "100": 0
      },
      "folga": {
      }
    },
    "diaria": {
      "segunda_a_sexta": {
      },
      "segunda_a_sabado": {
      },
      "domingo": {
      },
      "sabado": {
      },
      "feriado": {
      },
      "folga": {
      }
    }
  },
  "locked": false,
  "acrescimo_noturno": 0,
  "trabalhadas_com_dsr": 0,
  "trabalhadas_menos_extra": 29600,
  "dsr_credit": 0,
  "dsr_debit": 0,
  "quantidade_dsr_positivo": 0,
  "bh_credit": 0,
  "bh_debit": 0,
  "bh_total": 0,
  "bh_pago": 0,
  "bh_abonado": 0,
  "in_itinere_total": 0,
  "falta_integral": 489600,
  "falta_parcial": 0,
  "adicional_noturno_sem_acrescimo": 0,
  "intervalo_intrajornada": null,
  "interjornada": null,
  "interjornada_faltante": null,
  "dias_de_trabalho": null,
  "cp_credit": 3600,
  "cp_debit": 1800,
  "cp_total": 1800,
  "status": "approved",
  "status_history": [
    {
      "datetime": "2026-04-06T22:37:26-03:00",
      "status": "rejected",
      "message": "teste"
    },
    {
      "datetime": "2026-04-06T22:37:27-03:00",
      "status": "approved"
    }
  ],
  "pontos_processados": [
    {
      "data": "2018-01-01",
      "hora": "2000-01-01T08:00:00.000Z",
      "ordem": 0,
      "motivo": null,
      "category": "incluido"
    },
    {
      "data": "2018-01-01",
      "hora": "2000-01-01T12:00:00.000Z",
      "ordem": 1,
      "motivo": null,
      "category": "incluido"
    }
  ],
  "tratamentos": [
    {
      "time": "08:00",
      "type": "I",
      "tratamento": {
        "data": "2018-01-01",
        "hora": "2000-01-01T08:00:00.000Z",
        "ordem": 0,
        "motivo": null,
        "category": "incluido"
      }
    },
    {
      "time": "12:00",
      "type": "I",
      "tratamento": {
        "data": "2018-01-01",
        "hora": "2000-01-01T12:00:00.000Z",
        "ordem": 1,
        "motivo": null,
        "category": "incluido"
      }
    }
  ]
}

Mostrando o cartão ponto do funcionário

Este método retorna um objeto com os dados do cartão ponto do funcionário.

Endpoint

GET /v1/funcionarios/:funcionario_id/cartao_ponto/:year/:month

Parameters

Name Description
funcionario_id required (String) UID do funcionário.
year required (Int) Ano do cartão ponto. Ex: 2018.
month required (Int) Mês do cartão ponto. Ex: 10.

Request

Route

GET /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2018/1

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2018/1" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario (Funcionario) Objeto Funcionário (ver artigo Funcionários).
ano (Int) Ano do cartão ponto.
mes (Int) Mês do cartão ponto.
mensagem (String) Notas do cartão do funcionário.
atualizado (Boolean) Se o cartão está atualmente processado.
total_abonos (Int) Quantidade de segundos abonados.
total_falta (Int) Quantidade de segundos de faltas.
total_trabalhado (Int) Quantidade de segundos de trabalho.
total_extra (Int) Quantidade de segundos de extra.
adicional_noturno (Int) Quantidade de segundos de adicional noturno.
total_atrasado (Int) Quantidade de segundos de atraso.
dias_de_falta (Int) Quantidade de dias de falta.
extra_noturno (Int) Quantidade de segundos de extra noturno.
semanal (Object) Coleção de dados de semana a semana.
semanal[semana_1] (Object) Dados da primeira semana.
semana_1[trabalhada] (Int) Quantidade de segundos de trabalho na semana.
semana_1[extra] (Int) Quantidade de segundos de extra na semana.
semana_1[falta] (Int) Quantidade de segundos de falta na semana.
semana_1[adicional_noturno] (Int) Quantidade de segundos de adicional noturno na semana.
semana_1[abonos] (Int) Quantidade de segundos de abono na semana.
semana_1[in_itinere] (Int) Quantidade de segundos de In Itinere na semana.
semana_1[dias_de_falta] (Int) Quantidade de dias de falta na semana.
semana_1[falta_integral] (Int) Quantidade de segundos de falta integral na semana.
semanal[semana_2] (Object) Dados da segunda semana.
semanal[semana_N] (Object) Dados da semana seguinte...
politica_extra (Object) Detalhes sobre as horas extras do período.
politica_extra[mensal] (Extra) Dados sobre as horas extras para configuração de horário mensal.
mensal[segunda_a_sexta] (ExtraPercentual) Objeto composto por chave e valor. Ex: "50": 3600. Onde a chave é a porcentagem de hora extra e o valor é a quantidade de segundos.
mensal[segunda_a_sabado] (ExtraPercentual) Objeto [ExtraPercentual] para segunda a sábado.
mensal[domingo] (ExtraPercentual) Objeto [ExtraPercentual] para domingo.
mensal[sabado] (ExtraPercentual) Objeto [ExtraPercentual] para sábado.
mensal[feriado] (ExtraPercentual) Objeto [ExtraPercentual] para feriado.
mensal[folga] (ExtraPercentual) Objeto [ExtraPercentual] para folga.
politica_extra[semanal] (Extra) Objeto [Extra] para horas extras para configuração de horário semanal.
politica_extra[diaria] (Extra) Objeto [Extra] para horas extras para configuração de horário diário.
locked (Boolean) Se o cartão ponto está bloqueado pelo usuário.
acrescimo_noturno (Int) Quantidade de segundos de acréscimos noturno.
trabalhadas_com_dsr (Int) Quantidade de segundos da soma de trabalhadas com D.S.R.
trabalhadas_menos_extra (Int) Quantidade de segundos da subtração de trabalhadas com Extra.
dsr_credit (Int) Quantidade de segundos de D.S.R. positivo (DSR +).
dsr_debit (Int) Quantidade de segundos de D.S.R. negativo (DSR -).
quantidade_dsr_positivo (Int) Quantidade de D.S.R. positivo (DSR +).
bh_credit (Int) Quantidade de segundos de Banco de Horas positivo (BH +).
bh_debit (Int) Quantidade de segundos de Banco de Horas negativo (BH -).
bh_total (Int) Quantidade de segundos de total de Banco de Horas no período.
bh_abonado (Int) Quantidade de segundos de Banco de Horas abonado no período.
bh_pago (Int) Quantidade de segundos de Banco de Horas pago no período.
cp_credit (Int) Quantidade de segundos de Compensação positivo (CP +).
cp_debit (Int) Quantidade de segundos de Compensação negativo (CP -).
cp_total (Int) Quantidade de segundos de total de Compensação no período.
in_itinere_total (Int) Quantidade de segundos de In Itinere.
falta_integral (Int) Quantidade de segundos de falta integral.
falta_parcial (Int) Quantidade de segundos de falta parcial.
adicional_noturno_sem_acrescimo (Int) Quantidade de segundos de adicional noturno sem acréscimo noturno.
intervalo_intrajornada (Int) Quantidade de segundos de intervalo intrajornada no periodo.
interjornada (Int) Quantidade de segundos de interjornada no período.
interjornada_faltante (Int) Quantidade de segundos de interjornada faltante obrigatória no período.
dias_de_trabalho (Int) Quantidade de dias que contém pontos registrados.
status (String) Status de avaliação do cartão. Valores: "pending_approval", "approved" e "rejected".
status_history (Array) Lista de historico de avaliações. Atributos: "status", "datetime" e "message".
tratamentos (Array) Lista de Tratamentos (ver artigo sobre tratamentos em Ponto Diário).
pontos_processados (Array) Lista de Pontos Processados no período.
ponto_processado[data] (Date) Data de registro do ponto.
ponto_processado[hora] (DateTime) Hora do registro do ponto.
ponto_processado[ordem] (Int) Ordem do registro (0-N).
ponto_processado[motivo] (Object) Objeto Motivo (ver artigo Motivos).
ponto_processado[category] (String) Categoria do registro. Ex: Incluido, Desconsiderado, Original, Pre-Assinalado.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"ed87c897e8939f8558981c5d76a68136"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 0ccc79e9-e111-4939-8a9d-66f83602aecb
X-Runtime: 0.078377
Vary: Origin
Content-Length: 3761

Body

{
  "funcionario": {
    "cpf": "07155744989",
    "cracha": "1",
    "data_admissao": "2000-01-01",
    "data_demissao": null,
    "name": "Func1",
    "pis": "123929234315",
    "registro_folha": "123",
    "rg": null,
    "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [
      {
        "data": "2017-01-10",
        "funcao": "test",
        "name": "Auxiliar (123456)"
      },
      {
        "data": "2018-01-01",
        "funcao": "auxiliar",
        "name": null
      }
    ],
    "exames": [
      {
        "data": "2017-01-10",
        "apto": true,
        "tipo_exame": null,
        "observacoes": null,
        "arquivo": {
          "url": null
        }
      }
    ],
    "empresa": {
      "id": 471928375,
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "inscricao_estadual": null,
      "cpf": null,
      "created_at": "2026-04-06T22:37:18.000-03:00",
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "cliente_id": 571096427,
      "cei": null,
      "codigo_registro_folha": "23",
      "ativo": true,
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
    },
    "departamento": {
      "id": 980190962,
      "name": "Departamento01 (Empresa03)",
      "empresa_id": 471928375,
      "created_at": "2026-04-06T22:37:18.000-03:00",
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "ativo": true,
      "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
      "codigo_registro_folha": "1",
      "full_name": "Departamento01 (Empresa03)"
    },
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:25.596-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  },
  "ano": 2018,
  "mes": 1,
  "mensagem": null,
  "atualizado": true,
  "total_abonos": 0,
  "total_falta": 489600,
  "total_trabalhado": 44000,
  "total_extra": 14400,
  "adicional_noturno": 0,
  "total_atrasado": 0,
  "total_antecipado": 0,
  "dias_de_falta": 17,
  "extra_noturno": 0,
  "semanal": {
    "semana_1": {
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 7,
      "falta_integral": 201600
    },
    "semana_2": {
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 7,
      "falta_integral": 201600
    },
    "semana_3": {
      "trabalhada": 0,
      "extra": 0,
      "falta": 0,
      "adicional_noturno": 0,
      "abonos": 0,
      "excecoes": 0,
      "in_itinere": 0,
      "dias_de_falta": 3,
      "falta_integral": 86400
    }
  },
  "mensal": null,
  "politica_extra": {
    "semanal": {
      "segunda_a_sexta": {
      },
      "segunda_a_sabado": {
      },
      "domingo": {
      },
      "sabado": {
      },
      "feriado": {
      },
      "folga": {
      },
      "id": {
      }
    },
    "semanal_detail": {
    },
    "mensal": {
      "segunda_a_sexta": {
        "50": 14400
      },
      "segunda_a_sabado": {
      },
      "domingo": {
        "100": 0
      },
      "sabado": {
        "50": 0
      },
      "feriado": {
        "100": 0
      },
      "folga": {
      }
    },
    "diaria": {
      "segunda_a_sexta": {
      },
      "segunda_a_sabado": {
      },
      "domingo": {
      },
      "sabado": {
      },
      "feriado": {
      },
      "folga": {
      }
    }
  },
  "locked": false,
  "acrescimo_noturno": 0,
  "trabalhadas_com_dsr": 0,
  "trabalhadas_menos_extra": 29600,
  "dsr_credit": 0,
  "dsr_debit": 0,
  "quantidade_dsr_positivo": 0,
  "bh_credit": 0,
  "bh_debit": 0,
  "bh_total": 0,
  "bh_pago": 0,
  "bh_abonado": 0,
  "in_itinere_total": 0,
  "falta_integral": 489600,
  "falta_parcial": 0,
  "adicional_noturno_sem_acrescimo": 0,
  "intervalo_intrajornada": null,
  "interjornada": null,
  "interjornada_faltante": null,
  "dias_de_trabalho": null,
  "cp_credit": 3600,
  "cp_debit": 1800,
  "cp_total": 1800,
  "status": "approved",
  "status_history": [
    {
      "datetime": "2026-04-06T22:37:25-03:00",
      "status": "rejected",
      "message": "teste"
    },
    {
      "datetime": "2026-04-06T22:37:25-03:00",
      "status": "approved"
    }
  ],
  "pontos_processados": [
    {
      "data": "2018-01-01",
      "hora": "2000-01-01T08:00:00.000Z",
      "ordem": 0,
      "motivo": null,
      "category": "incluido"
    },
    {
      "data": "2018-01-01",
      "hora": "2000-01-01T12:00:00.000Z",
      "ordem": 1,
      "motivo": null,
      "category": "incluido"
    }
  ],
  "tratamentos": [
    {
      "time": "08:00",
      "type": "I",
      "tratamento": {
        "data": "2018-01-01",
        "hora": "2000-01-01T08:00:00.000Z",
        "ordem": 0,
        "motivo": null,
        "category": "incluido"
      }
    },
    {
      "time": "12:00",
      "type": "I",
      "tratamento": {
        "data": "2018-01-01",
        "hora": "2000-01-01T12:00:00.000Z",
        "ordem": 1,
        "motivo": null,
        "category": "incluido"
      }
    }
  ]
}

Mostrando o cartão ponto do funcionário - não processado

Este método retorna um objeto para cartão ponto do funcionário não processado.

Endpoint

GET /v1/funcionarios/:funcionario_id/cartao_ponto/:year/:month

Parameters

Name Description
funcionario_id required (String) UID do funcionário.
year required (Int) Ano do cartão ponto. Ex: 2018.
month required (Int) Mês do cartão ponto. Ex: 10.

Request

Route

GET /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2018/2

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2018/2" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
message (String) Mensagem de erro da requisição.

Status

423

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: 247d7723-af7c-4859-aa04-ce0ac1b5d38a
X-Runtime: 0.036108
Vary: Origin
Content-Length: 56

Body

{
  "message": "Resource not processed. Unable to view it."
}

Reprovando o cartão ponto

Este método reprova o cartão ponto com o usuário funcionário.

Endpoint

PATCH /v1/funcionarios/:funcionario_id/cartao_ponto/:year/:month/reject

Parameters

Name Description
funcionario_id required (String) UID do funcionário.
year required (Int) Ano do cartão ponto. Ex: 2018.
month required (Int) Mês do cartão ponto. Ex: 10.
message required (String) Motivo da reprovação

Request

Route

PATCH /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2018/2/reject

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

Body

{
  "message": "Horas extras incorretas"
}

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2018/2/reject" -d '{"message":"Horas extras incorretas"}' -X PATCH \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Cookie: "

Response

Simulated Response

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json
Cache-Control: no-cache
X-Request-Id: 40559e0b-9a7a-48f5-8843-96c2b47f0664
X-Runtime: 0.027739
Vary: Origin
Content-Length: 0

Funcionários > Ponto Diário

Filtrando funcionários por departamento

Este método retorna uma coleção de objetos para o dia do cartão ponto.

Endpoint

GET /v1/relatorios/funcionarios/ponto_diario/:date

Parameters

Name Description
date (Date) Data do dia do cartão ponto. Ex: "01-01-2019"
departamento_uid (String) UID do departamento.

Request

Route

GET /v1/relatorios/funcionarios/ponto_diario/2015-04-29?departamento_uid=c43becdf-bb77-4062-97c0-58f3335dad91

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Query Parameters

departamento_uid=c43becdf-bb77-4062-97c0-58f3335dad91

cURL

curl -g "https://api.ptrp.com.br/v1/relatorios/funcionarios/ponto_diario/2015-04-29?departamento_uid=c43becdf-bb77-4062-97c0-58f3335dad91" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario (Funcionario) Objeto funcionário (ver artigo funcionarios).
pontos_originais (Array) Lista de marcações originais do dia.
pontos_processados (Array) Lista de marcações processadas do dia.
total (Int) Total trabalhado em segundos.
extra (Int) Total de extra em segundos.
falta (Int) Total de falta em segundos.
atraso (Int) Total de atraso em segundos.
saida_antecipada (Int) Total de atraso em segundos.
adicional_noturno (Int) Total de adicional noturno em segundos.
extra_noturno (Int) Total de extra noturna em segundos.
ch (Int) Código do horário.
tratamentos[time] (Time) Hora ou Quantidade de hora total do tratamento.
tratamentos[type] (String) Tipo da Ocorrência. Ex: I = Inclusão.
tratamentos[tratamento] (Object) Objeto de Tratamento. Ex: Feriado, DSR, Banco de Horas, Inclusão de Ponto etc.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"e4782c867670d094685c754bedc5cdc6"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: f7d513d6-ff37-445b-a0cb-75763d96d468
X-Runtime: 0.075677
Vary: Origin
Content-Length: 1750

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2000-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "1",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "ativo": true,
        "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
        "codigo_registro_folha": "1",
        "full_name": "Departamento01 (Empresa03)"
      },
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    },
    "pontos_originais": [

    ],
    "pontos_processados": [

    ],
    "total": null,
    "extra": 0,
    "falta": 0,
    "atraso": null,
    "saida_atecipada": null,
    "adicional_noturno": null,
    "extra_noturno": null,
    "ch": "",
    "tratamentos": [
      {
        "time": null,
        "type": "P",
        "tratamento": {
          "name": "Feriado01",
          "date": "2015-04-29"
        }
      }
    ]
  }
]

Filtrando funcionários por empresa

Este método retorna uma coleção de objetos para o dia do cartão ponto.

Endpoint

GET /v1/relatorios/funcionarios/ponto_diario/:date

Parameters

Name Description
date (Date) Data do dia do cartão ponto. Ex: "01-01-2019"
empresa_uid (String) UID da empresa

Request

Route

GET /v1/relatorios/funcionarios/ponto_diario/2015-04-29?empresa_uid=a43bedds-ba77-4062-46c0-58f4444ded33

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Query Parameters

empresa_uid=a43bedds-ba77-4062-46c0-58f4444ded33

cURL

curl -g "https://api.ptrp.com.br/v1/relatorios/funcionarios/ponto_diario/2015-04-29?empresa_uid=a43bedds-ba77-4062-46c0-58f4444ded33" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario (Funcionario) Objeto funcionário (ver artigo funcionarios).
pontos_originais (Array) Lista de marcações originais do dia.
pontos_processados (Array) Lista de marcações processadas do dia.
total (Int) Total trabalhado em segundos.
extra (Int) Total de extra em segundos.
falta (Int) Total de falta em segundos.
atraso (Int) Total de atraso em segundos.
saida_antecipada (Int) Total de atraso em segundos.
adicional_noturno (Int) Total de adicional noturno em segundos.
extra_noturno (Int) Total de extra noturna em segundos.
ch (Int) Código do horário.
tratamentos[time] (Time) Hora ou Quantidade de hora total do tratamento.
tratamentos[type] (String) Tipo da Ocorrência. Ex: I = Inclusão.
tratamentos[tratamento] (Object) Objeto de Tratamento. Ex: Feriado, DSR, Banco de Horas, Inclusão de Ponto etc.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"e4782c867670d094685c754bedc5cdc6"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 6e2503b6-2f4c-4142-acac-a5140c750ed9
X-Runtime: 0.061532
Vary: Origin
Content-Length: 1750

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2000-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "1",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "ativo": true,
        "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
        "codigo_registro_folha": "1",
        "full_name": "Departamento01 (Empresa03)"
      },
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    },
    "pontos_originais": [

    ],
    "pontos_processados": [

    ],
    "total": null,
    "extra": 0,
    "falta": 0,
    "atraso": null,
    "saida_atecipada": null,
    "adicional_noturno": null,
    "extra_noturno": null,
    "ch": "",
    "tratamentos": [
      {
        "time": null,
        "type": "P",
        "tratamento": {
          "name": "Feriado01",
          "date": "2015-04-29"
        }
      }
    ]
  }
]

Listando cartão ponto por dia com Feriado

Este método retorna uma coleção de objetos para o dia do cartão ponto.

Endpoint

GET /v1/relatorios/funcionarios/ponto_diario/:date

Parameters

Name Description
date (Date) Data do dia do cartão ponto. Ex: "01-01-2019"

Request

Route

GET /v1/relatorios/funcionarios/ponto_diario/2015-04-29

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/relatorios/funcionarios/ponto_diario/2015-04-29" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario (Funcionario) Objeto funcionário (ver artigo funcionarios).
pontos_originais (Array) Lista de marcações originais do dia.
pontos_processados (Array) Lista de marcações processadas do dia.
total (Int) Total trabalhado em segundos.
extra (Int) Total de extra em segundos.
falta (Int) Total de falta em segundos.
atraso (Int) Total de atraso em segundos.
saida_antecipada (Int) Total de atraso em segundos.
adicional_noturno (Int) Total de adicional noturno em segundos.
extra_noturno (Int) Total de extra noturna em segundos.
ch (Int) Código do horário.
tratamentos[time] (Time) Hora ou Quantidade de hora total do tratamento.
tratamentos[type] (String) Tipo da Ocorrência. Ex: I = Inclusão.
tratamentos[tratamento] (Object) Objeto de Tratamento. Ex: Feriado, DSR, Banco de Horas, Inclusão de Ponto etc.
tratamento[name] (String) Nome do feriado.
tratamento[date] (Date) Data do feriado.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"e4782c867670d094685c754bedc5cdc6"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 02fdfef5-1dc3-43ef-9d95-7aeb064649f3
X-Runtime: 0.076301
Vary: Origin
Content-Length: 1750

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2000-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "1",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "ativo": true,
        "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
        "codigo_registro_folha": "1",
        "full_name": "Departamento01 (Empresa03)"
      },
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    },
    "pontos_originais": [

    ],
    "pontos_processados": [

    ],
    "total": null,
    "extra": 0,
    "falta": 0,
    "atraso": null,
    "saida_atecipada": null,
    "adicional_noturno": null,
    "extra_noturno": null,
    "ch": "",
    "tratamentos": [
      {
        "time": null,
        "type": "P",
        "tratamento": {
          "name": "Feriado01",
          "date": "2015-04-29"
        }
      }
    ]
  }
]

Listando cartão ponto por dia com Feriado Regional

Este método retorna uma coleção de objetos para o dia do cartão ponto.

Endpoint

GET /v1/relatorios/funcionarios/ponto_diario/:date

Parameters

Name Description
date (Date) Data do dia do cartão ponto. Ex: "01-01-2019"

Request

Route

GET /v1/relatorios/funcionarios/ponto_diario/2015-04-29

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/relatorios/funcionarios/ponto_diario/2015-04-29" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario (Funcionario) Objeto funcionário (ver artigo funcionarios).
pontos_originais (Array) Lista de marcações originais do dia.
pontos_processados (Array) Lista de marcações processadas do dia.
total (Int) Total trabalhado em segundos.
extra (Int) Total de extra em segundos.
falta (Int) Total de falta em segundos.
atraso (Int) Total de atraso em segundos.
saida_antecipada (Int) Total de atraso em segundos.
adicional_noturno (Int) Total de adicional noturno em segundos.
extra_noturno (Int) Total de extra noturna em segundos.
ch (Int) Código do horário.
tratamentos[time] (Time) Hora ou Quantidade de hora total do tratamento.
tratamentos[type] (String) Tipo da Ocorrência. Ex: I = Inclusão.
tratamentos[tratamento] (Object) Objeto de Tratamento. Ex: Feriado, DSR, Banco de Horas, Inclusão de Ponto etc.
tratamento[name] (String) Nome do feriado.
tratamento[facultativo] (Boolean) Se o feriado é facultativo.
tratamento[date] (Date) Data do feriado.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"20a5b6c2cffc92a109fa6a78e9528eb2"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 6c1f8fe4-b839-4c4f-acce-7ceacceef570
X-Runtime: 0.050178
Vary: Origin
Content-Length: 1780

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2000-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "1",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "ativo": true,
        "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
        "codigo_registro_folha": "1",
        "full_name": "Departamento01 (Empresa03)"
      },
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    },
    "pontos_originais": [

    ],
    "pontos_processados": [

    ],
    "total": null,
    "extra": 0,
    "falta": 0,
    "atraso": null,
    "saida_atecipada": null,
    "adicional_noturno": null,
    "extra_noturno": null,
    "ch": "",
    "tratamentos": [
      {
        "time": null,
        "type": "P",
        "tratamento": {
          "date": "2015-04-29",
          "facultativo": false,
          "name": "Feriado de Teste 01"
        }
      }
    ]
  }
]

Listando cartão ponto por dia com Ponto incluido manualmente.

Este método retorna uma coleção de objetos para o dia do cartão ponto.

Endpoint

GET /v1/relatorios/funcionarios/ponto_diario/:date

Parameters

Name Description
date (Date) Data do dia do cartão ponto. Ex: "01-01-2019"

Request

Route

GET /v1/relatorios/funcionarios/ponto_diario/2015-04-29

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/relatorios/funcionarios/ponto_diario/2015-04-29" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario (Funcionario) Objeto funcionário (ver artigo funcionarios).
pontos_originais (Array) Lista de marcações originais do dia.
pontos_processados (Array) Lista de marcações processadas do dia.
total (Int) Total trabalhado em segundos.
extra (Int) Total de extra em segundos.
falta (Int) Total de falta em segundos.
atraso (Int) Total de atraso em segundos.
saida_antecipada (Int) Total de atraso em segundos.
adicional_noturno (Int) Total de adicional noturno em segundos.
extra_noturno (Int) Total de extra noturna em segundos.
ch (Int) Código do horário.
tratamentos[time] (Time) Hora ou Quantidade de hora total do tratamento.
tratamentos[type] (String) Tipo da Ocorrência. Ex: I = Inclusão.
tratamentos[tratamento] (Object) Objeto de Tratamento. Ex: Feriado, DSR, Banco de Horas, Inclusão de Ponto etc.
tratamento[data] (Date) Data do ponto.
tratamento[hora] (Time) Hora do ponto.
tratamento[ordem] (Int) Posição do ponto no dia.
tratamento[tipo] (String) Tipo do tratamento. Ex: I = Incluído.
tratamento[motivo] (Motivo) Objeto Motivo (ver artigo Motivos).

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"0039459043f23813618002ffea1e68d0"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 3dd3628c-3747-435e-8f55-4495dd1a7927
X-Runtime: 0.077300
Vary: Origin
Content-Length: 1900

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2000-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "1",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "ativo": true,
        "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
        "codigo_registro_folha": "1",
        "full_name": "Departamento01 (Empresa03)"
      },
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    },
    "pontos_originais": [

    ],
    "pontos_processados": [
      "2000-01-01T06:45:00.000Z"
    ],
    "total": null,
    "extra": 0,
    "falta": 0,
    "atraso": null,
    "saida_atecipada": null,
    "adicional_noturno": null,
    "extra_noturno": null,
    "ch": "",
    "tratamentos": [
      {
        "time": "06:45",
        "type": "I",
        "tratamento": {
          "data": "2015-04-29",
          "hora": "2000-01-01T06:45:00.000Z",
          "ordem": 0,
          "motivo": {
            "id": 267869265,
            "name": "Afastado(+de15dias)",
            "e_social_id": null
          },
          "category": "incluido"
        }
      }
    ]
  }
]

Listando cartão ponto por dia com banco de horas

Este método retorna uma coleção de objetos para o dia do cartão ponto.

Endpoint

GET /v1/relatorios/funcionarios/ponto_diario/:date

Parameters

Name Description
date (Date) Data do dia do cartão ponto. Ex: "01-01-2019"

Request

Route

GET /v1/relatorios/funcionarios/ponto_diario/2015-04-29

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/relatorios/funcionarios/ponto_diario/2015-04-29" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario (Funcionario) Objeto funcionário (ver artigo funcionarios).
pontos_originais (Array) Lista de marcações originais do dia.
pontos_processados (Array) Lista de marcações processadas do dia.
total (Int) Total trabalhado em segundos.
extra (Int) Total de extra em segundos.
falta (Int) Total de falta em segundos.
atraso (Int) Total de atraso em segundos.
saida_antecipada (Int) Total de atraso em segundos.
adicional_noturno (Int) Total de adicional noturno em segundos.
extra_noturno (Int) Total de extra noturna em segundos.
ch (Int) Código do horário.
tratamentos[time] (Time) Hora ou Quantidade de hora total do tratamento.
tratamentos[type] (String) Tipo da Ocorrência. Ex: I = Inclusão.
tratamentos[tratamento] (Object) Objeto de Tratamento. Ex: Feriado, DSR, Banco de Horas, Inclusão de Ponto etc.
tratamento[data] (Date) Data da operação do banco de horas.
tratamento[hora] (Time) Quantidade de horas da operação.
tratamento[motivo] (Motivo) Objeto Motivo (ver artigo Motivos).
tratamento[forced] (Boolean) Se a operação foi incluida ou modificada manualmente.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"e63143d9aa15d7a0acaedceb4c0755f6"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: be8111ab-e2af-4a73-b926-91de382afe44
X-Runtime: 0.053312
Vary: Origin
Content-Length: 1823

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2000-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "1",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "ativo": true,
        "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
        "codigo_registro_folha": "1",
        "full_name": "Departamento01 (Empresa03)"
      },
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    },
    "pontos_originais": [

    ],
    "pontos_processados": [

    ],
    "total": null,
    "extra": 0,
    "falta": 0,
    "atraso": null,
    "saida_atecipada": null,
    "adicional_noturno": null,
    "extra_noturno": null,
    "ch": "",
    "tratamentos": [
      {
        "time": "01:00",
        "type": "I",
        "tratamento": {
          "data": "2015-04-29",
          "hora": null,
          "motivo": {
            "id": 603690436,
            "name": "B.H.(-)",
            "e_social_id": null
          },
          "forced": false
        }
      }
    ]
  }
]

Listando cartão ponto por dia com compensação

Este método retorna uma coleção de objetos para o dia do cartão ponto.

Endpoint

GET /v1/relatorios/funcionarios/ponto_diario/:date

Parameters

Name Description
date (Date) Data do dia do cartão ponto. Ex: "01-01-2019"

Request

Route

GET /v1/relatorios/funcionarios/ponto_diario/2015-04-29

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/relatorios/funcionarios/ponto_diario/2015-04-29" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario (Funcionario) Objeto funcionário (ver artigo funcionarios).
pontos_originais (Array) Lista de marcações originais do dia.
pontos_processados (Array) Lista de marcações processadas do dia.
total (Int) Total trabalhado em segundos.
extra (Int) Total de extra em segundos.
falta (Int) Total de falta em segundos.
atraso (Int) Total de atraso em segundos.
saida_antecipada (Int) Total de atraso em segundos.
adicional_noturno (Int) Total de adicional noturno em segundos.
extra_noturno (Int) Total de extra noturna em segundos.
ch (Int) Código do horário.
tratamentos[time] (Time) Hora ou Quantidade de hora total do tratamento.
tratamentos[type] (String) Tipo da Ocorrência. Ex: I = Inclusão.
tratamentos[tratamento] (Object) Objeto de Tratamento. Ex: Feriado, DSR, Banco de Horas, Inclusão de Ponto etc.
tratamento[data] (Date) Data da compensação.
tratamento[hora] (Time) Quantidade de horas da compensação.
tratamento[tipo] (String) Tipo da compensação.
tratamento[forced] (Boolean) Se a compensação foi incluida manualmente.
tratamento[motivo] (Motivo) Objeto Motivo (ver artigo Motivos).

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"d0e9d35b3292b9960cf59a3321a8e197"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: e2ae7e1c-b974-4e2d-b8a0-ee033362d53e
X-Runtime: 0.054858
Vary: Origin
Content-Length: 1853

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2000-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "1",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "ativo": true,
        "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
        "codigo_registro_folha": "1",
        "full_name": "Departamento01 (Empresa03)"
      },
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    },
    "pontos_originais": [

    ],
    "pontos_processados": [

    ],
    "total": 0,
    "extra": 0,
    "falta": 0,
    "atraso": 0,
    "saida_atecipada": 0,
    "adicional_noturno": 0,
    "extra_noturno": null,
    "ch": 11,
    "tratamentos": [
      {
        "time": "03:00",
        "type": "I",
        "tratamento": {
          "data": "2015-04-29",
          "hora": "2000-01-01T03:00:00.000Z",
          "tipo": "A",
          "forced": false,
          "motivo": {
            "id": 144349274,
            "name": "Auxílio Doença",
            "e_social_id": null
          }
        }
      }
    ]
  }
]

Listando cartão ponto por dia com justificativa

Este método retorna uma coleção de objetos para o dia do cartão ponto.

Endpoint

GET /v1/relatorios/funcionarios/ponto_diario/:date

Parameters

Name Description
date (Date) Data do dia do cartão ponto. Ex: "01-01-2019"

Request

Route

GET /v1/relatorios/funcionarios/ponto_diario/2015-04-29

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/relatorios/funcionarios/ponto_diario/2015-04-29" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario (Funcionario) Objeto funcionário (ver artigo funcionarios).
pontos_originais (Array) Lista de marcações originais do dia.
pontos_processados (Array) Lista de marcações processadas do dia.
total (Int) Total trabalhado em segundos.
extra (Int) Total de extra em segundos.
falta (Int) Total de falta em segundos.
atraso (Int) Total de atraso em segundos.
saida_antecipada (Int) Total de atraso em segundos.
adicional_noturno (Int) Total de adicional noturno em segundos.
extra_noturno (Int) Total de extra noturna em segundos.
ch (Int) Código do horário.
tratamentos[time] (Time) Hora ou Quantidade de hora total do tratamento.
tratamentos[type] (String) Tipo da Ocorrência. Ex: I = Inclusão.
tratamentos[tratamento] (Object) Objeto de Tratamento. Ex: Feriado, DSR, Banco de Horas, Inclusão de Ponto etc.
tratamento[id] (Int) Id da justificativa.
tratamento[data] (Date) Data da justificativa.
tratamento[hora] (Time) Quantidade de horas da justificativa.
tratamento[descontar_dsr] (Boolean) Descontar D.S.R.?
tratamento[abonar] (Boolean) Justificar com abono de horas trabalhadas?
tratamento[motivo] (Motivo) Objeto Motivo (ver artigo Motivos).
tratamento[motivo_personalizado] (Motivo) Objeto Motivo (ver artigo Motivos).

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"39ab88cd39b8f2f4859a7775cc407799"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: c02c7149-4f77-4757-87f6-3ce2494c81b7
X-Runtime: 0.050854
Vary: Origin
Content-Length: 1904

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2000-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "1",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "ativo": true,
        "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
        "codigo_registro_folha": "1",
        "full_name": "Departamento01 (Empresa03)"
      },
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    },
    "pontos_originais": [

    ],
    "pontos_processados": [

    ],
    "total": null,
    "extra": 0,
    "falta": 0,
    "atraso": null,
    "saida_atecipada": null,
    "adicional_noturno": null,
    "extra_noturno": null,
    "ch": "",
    "tratamentos": [
      {
        "time": "08:00",
        "type": "I",
        "tratamento": {
          "id": 516301284,
          "data": "2015-04-29",
          "hora": "2000-01-01T08:00:00.000Z",
          "desconta_dsr": false,
          "abonar": true,
          "motivo": {
            "id": 385748469,
            "name": "APS",
            "e_social_id": null
          },
          "motivo_personalizado": null
        }
      }
    ]
  }
]

Listando cartão ponto por dia com mudança de carga horária

Este método retorna uma coleção de objetos para o dia do cartão ponto.

Endpoint

GET /v1/relatorios/funcionarios/ponto_diario/:date

Parameters

Name Description
date (Date) Data do dia do cartão ponto. Ex: "01-01-2019"

Request

Route

GET /v1/relatorios/funcionarios/ponto_diario/2015-04-29

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/relatorios/funcionarios/ponto_diario/2015-04-29" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario (Funcionario) Objeto funcionário (ver artigo funcionarios).
pontos_originais (Array) Lista de marcações originais do dia.
pontos_processados (Array) Lista de marcações processadas do dia.
total (Int) Total trabalhado em segundos.
extra (Int) Total de extra em segundos.
falta (Int) Total de falta em segundos.
atraso (Int) Total de atraso em segundos.
saida_antecipada (Int) Total de atraso em segundos.
adicional_noturno (Int) Total de adicional noturno em segundos.
extra_noturno (Int) Total de extra noturna em segundos.
ch (Int) Código do horário.
tratamentos[time] (Time) Hora ou Quantidade de hora total do tratamento.
tratamentos[type] (String) Tipo da Ocorrência. Ex: I = Inclusão.
tratamentos[tratamento] (Object) Objeto de Tratamento. Ex: Feriado, DSR, Banco de Horas, Inclusão de Ponto etc.
tratamento[data] (Date) Data da mudança.
tratamento[carga_horaria] (Time) Carga horária do dia
tratamento[extra_total] (Boolean) Aplica carga horária para extra?
tratamento[sem_extra] (Boolean) Não gerar extra para a nova carga horária.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"748d9c9074c0c431a02094f39b934aa7"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 2660e484-f3dd-49a0-a38a-36d89a2399c0
X-Runtime: 0.061712
Vary: Origin
Content-Length: 1815

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2000-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "1",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "ativo": true,
        "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
        "codigo_registro_folha": "1",
        "full_name": "Departamento01 (Empresa03)"
      },
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    },
    "pontos_originais": [

    ],
    "pontos_processados": [

    ],
    "total": null,
    "extra": 0,
    "falta": 0,
    "atraso": null,
    "saida_atecipada": null,
    "adicional_noturno": null,
    "extra_noturno": null,
    "ch": "MH",
    "tratamentos": [
      {
        "time": "08:00",
        "type": "P",
        "tratamento": {
          "carga_horaria": "1970-01-01T08:00:00.000Z",
          "data": "2015-04-29",
          "extra_total": null,
          "sem_extra": null
        }
      }
    ]
  }
]

Funcionários > Presentes

Listando erros para requisição com data inválida

Este método retorna a reposta para parametros inválidos.

Endpoint

GET /v1/funcionarios/presentes/:from/ate/:to

Parameters

Name Description
from required (Date) Data inicial do relatório.
to required (Date) Data final do relatório.

Request

Route

GET /v1/funcionarios/presentes/2015-01-33/ate/2015-01-31

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/funcionarios/presentes/2015-01-33/ate/2015-01-31" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario (Funcionario) Objeto Funcionário (ver artigo Funcionários).
dias (Array) Dias de presença.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: 71deba8a-9fdf-4580-b9a1-3db5d86eb4ac
X-Runtime: 0.033891
Vary: Origin
Content-Length: 33

Body

{
  "message": "Invalid Date format"
}

Listando os funcionários presentes entre as datas

Este método retorna uma coleção de funcionários presentes dado um intervalo de datas.

Endpoint

GET /v1/funcionarios/presentes/:from/ate/:to

Parameters

Name Description
from required (Date) Data inicial do relatório.
to required (Date) Data final do relatório.

Request

Route

GET /v1/funcionarios/presentes/2015-01-01/ate/2015-01-31

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/funcionarios/presentes/2015-01-01/ate/2015-01-31" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario (Funcionario) Objeto Funcionário (ver artigo Funcionários).
dias (Array) Dias de presença.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"74396a0e40583693ed3b372a98805e17"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: e942042b-87dd-4bb8-a79b-66d799cfe5c5
X-Runtime: 0.066211
Vary: Origin
Content-Length: 1509

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2015-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "ativo": true,
        "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
        "codigo_registro_folha": "1",
        "full_name": "Departamento01 (Empresa03)"
      },
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:27.563-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    },
    "days": [
      "2015-01-01"
    ]
  }
]

Funcionários > Quadros de Horas

Desvinculando um Quadro de Horas

Este método desvincula um Quadro de Horas do funcionário num determinado histórico.

Endpoint

DELETE /v1/funcionarios/:funcionario_uid/quadros_de_horas/:id

Parameters

Name Description
funcionario_uid required (String) UID do funcionário.
id required (Int) ID do histórico do vinculo do Quadro de horas (ver artigo Historico de Quadro de Horas).

Request

Route

DELETE /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/quadros_de_horas/980190962

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/quadros_de_horas/980190962" -d '' -X DELETE \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Status

204

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Cache-Control: no-cache
X-Request-Id: 53ee6521-b42d-413d-aa4f-726ac15f237e
X-Runtime: 0.043041
Vary: Origin

Listando Histórico de Quadros de Horas

Este método retorna um array de quadros de horas vinculados.

Endpoint

GET /v1/funcionarios/:funcionario_uid/quadros_de_horas

Parameters

Name Description
funcionario_uid required (String) UID do funcionário.

Request

Route

GET /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d6/quadros_de_horas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d6/quadros_de_horas" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Int) ID do registro do histórico de vinculo do quadro de horas.
data_vigencia (Date) Data de vigência do quadro de horas.
quadro_de_hora (Object) Dados do Objeto Quadro de horas.
quadro_de_hora[hora_virada] (Time) Hora da virada do quadro de horas.
quadro_de_hora[name] (String) Nome do quadro de horas.
quadro_de_hora[tipo] (String) Tipo do quadro de horas.
quadro_de_hora[use_holiday] (Boolean) Se o quadro de horas utiliza feriados nacionais.
quadro_de_hora[folgas_especiais] (Int) Número de folgas especiais.
quadro_de_hora[ativo] (Boolean) Se o quadro de horas está atualmente ativo.
quadro_de_hora[ch] (Int) Código do Horário.
quadro_de_hora[marcacao_automatica_intervalo] (Object) Configurações de Marcações Automaticas de Intervalo.
marcacao_automatica_intervalo[hora_inicio] (Time) Hora de inicio do intervalo.
marcacao_automatica_intervalo[hora_fim] (Time) Hora de término do intervalo.
marcacao_automatica_intervalo[tolerancia] (Int) Tolerância em segundos.
marcacao_automatica_intervalo[domingo] (Boolean) Marcação para válida para domingo.
marcacao_automatica_intervalo[segunda] (Boolean) Marcação para válida para segunda.
marcacao_automatica_intervalo[terca] (Boolean) Marcação para válida para terça.
marcacao_automatica_intervalo[quarta] (Boolean) Marcação para válida para quarta.
marcacao_automatica_intervalo[quinta] (Boolean) Marcação para válida para quinta.
marcacao_automatica_intervalo[sexta] (Boolean) Marcação para válida para sexta.
marcacao_automatica_intervalo[sabado] (Boolean) Marcação para válida para sábado.
marcacao_automatica_intervalo[feriado] (Boolean) Marcação para válida para feriado.
quadro_de_hora[tolerancia] (Object) Configurações de Tolerância.
tolerancia[tolerancia_fixa] (Boolean) Se utiliza tolerância fixa.
tolerancia[tolerancia_fixa_entrada] (Int) Tolerância fixa para entradas em minutos.
tolerancia[tolerancia_fixa_saida] (Int) Tolerância fixa para saidas em minutos.
tolerancia[tolerancia_global_extra] (Int) Tolerância global para extra em minutos.
tolerancia[tolerancia_global_falta] (Int) Tolerância global para falta em minutos.
quadro_de_hora[horario] (Mixed) Configurações do quadro de horários de entradas e saídas. O valor pode ser string ou um objeto.
horario[tipo_periodo] (String) Nome do tipo do período.
horario[carga_horaria] (Int) Carga horária total em segundos.
horario[carga_horaria_faixa] (Object) Detalhes da faixa de dias que abrange a carga horária.
carga_horaria_faixa[domingo] (Time) Carga horária para domingo.
carga_horaria_faixa[segunda] (Time) Carga horária para segunda.
carga_horaria_faixa[terca] (Time) Carga horária para terça.
carga_horaria_faixa[quarta] (Time) Carga horária para quarta.
carga_horaria_faixa[quinta] (Time) Carga horária para quinta.
carga_horaria_faixa[sexta] (Time) Carga horária para sexta.
carga_horaria_faixa[sabado] (Time) Carga horária para sábado.
carga_horaria_faixa[feriado] (Time) Carga horária para feriado.
horario[carga_horaria_folga] (Object) Detalhes da faixa de dias para folga.
carga_horaria_folga[domingo] (Boolean) Se a carga horária é válida para domingo.
carga_horaria_folga[segunda] (Boolean) Se a carga horária é válida para segunda.
carga_horaria_folga[terca] (Boolean) Se a carga horária é válida para terça.
carga_horaria_folga[quarta] (Boolean) Se a carga horária é válida para quarta.
carga_horaria_folga[quinta] (Boolean) Se a carga horária é válida para quinta.
carga_horaria_folga[sexta] (Boolean) Se a carga horária é válida para sexta.
carga_horaria_folga[sabado] (Boolean) Se a carga horária é válida para sábado.
carga_horaria_folga[feriado] (Boolean) Se a carga horária é válida para feriado.
horario[wdays] (Array) Array de objetos [Wday]. Quadro de horário dia a dia. Cada objeto representa um par de entrada e saída do dia.
wdays[entrada] (Time) Hora de entrada.
wdays[retorno] (Time) Hora de saída.
wdays[total] (Time) Total de horas do dia.
wdays[wday] (Int) Dia da semana da configuração. Começando em 0 = domingo, até 6 = sábado. E 7 é feriado.
quadro_de_hora[intervalo] (Object) Configurações de Intervalos (café).
intervalo[motivo_id] (Int) ID do Motivo.
intervalo[tolerancia] (Int) Tolerância do intervalo em segundos.
intervalo[wdays] (Array) Array de objetos [Wday]. Quadro de intervalos dia a dia. Cada objeto representa um par de intervalo e retorno do dia.
wdays[intervalo] (Time) Hora de entrada no intervalo.
wdays[retorno] (Time) Hora de retorno do intervalo.
wdays[total] (Time) Total de horas do intervalo.
wdays[wday] (Int) Dia da semana da configuração. Começando em 0 = domingo, até 6 = sábado. E 7 é feriado.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"d68650055b9ca4fcdc2df6c637931106"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: efb6b187-4496-435c-ab3f-c58bd349919e
X-Runtime: 0.093068
Vary: Origin
Content-Length: 1211

Body

[
  {
    "id": 800153120,
    "data_vigencia": "2016-02-25",
    "quadro_de_hora": {
      "hora_virada": "2000-01-01T00:00:00.000Z",
      "name": "Quadro Carga Faixa",
      "tipo": "carga_horaria",
      "use_holiday": true,
      "folgas_especiais": 0,
      "ativo": true,
      "ch": null,
      "marcacao_automatica_intervalo": null,
      "tolerancia": null,
      "horario": {
        "tipo_periodo": "faixas",
        "carga_horaria": 0,
        "carga_horaria_faixa": {
          "domingo": "2000-01-01T00:00:00.000Z",
          "segunda": "2000-01-01T08:30:00.000Z",
          "terca": "2000-01-01T08:30:00.000Z",
          "quarta": "2000-01-01T08:30:00.000Z",
          "quinta": "2000-01-01T08:30:00.000Z",
          "sexta": "2000-01-01T08:30:00.000Z",
          "sabado": "2000-01-01T03:30:00.000Z",
          "feriado": "2000-01-01T00:00:00.000Z"
        },
        "carga_horaria_folga": null
      },
      "intervalo": null
    }
  },
  {
    "id": 281110143,
    "data_vigencia": "2015-08-01",
    "quadro_de_hora": {
      "hora_virada": "2000-01-01T00:00:00.000Z",
      "name": "Quadro Craga Semanal",
      "tipo": "carga_horaria",
      "use_holiday": true,
      "folgas_especiais": 0,
      "ativo": true,
      "ch": null,
      "marcacao_automatica_intervalo": null,
      "tolerancia": null,
      "horario": {
        "tipo_periodo": "semanal",
        "carga_horaria": 158400,
        "carga_horaria_faixa": null,
        "carga_horaria_folga": {
          "domingo": true,
          "segunda": false,
          "terca": false,
          "quarta": false,
          "quinta": false,
          "sexta": false,
          "sabado": false,
          "feriado": true
        }
      },
      "intervalo": null
    }
  }
]

Vinculando um Quadro de Horas

Este método vincula o quadro de horas (ch) ao funcionário numa data de vigência.

Endpoint

POST /v1/funcionarios/:funcionario_uid/quadros_de_horas

Parameters

Name Description
funcionario_uid required (String) UID do funcionário.
funcionario_quadro_de_hora[data_vigencia] required (Date) Data de vigência.
funcionario_quadro_de_hora[ch] required (Int) Código do Horário.

Request

Route

POST /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d6/quadros_de_horas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "funcionario_quadro_de_hora": {
    "data_vigencia": "2018-01-10",
    "ch": 11
  }
}

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d6/quadros_de_horas" -d '{"funcionario_quadro_de_hora":{"data_vigencia":"2018-01-10","ch":11}}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Int) ID do histórico criado do vinculo.
data_vigencia (Date) Data de vigência.
ch (Int) Código do Horário.
quadro_de_hora (Object) Objeto Quadro de Horas.
errors[name] Array of error messages of field name.
errors[apelido] Array of error messages of field apelido.
errors[data_lancamento] Array of error messages of field data_lancamento.
errors[descricao] Array of error messages of field descricao.

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"ad392d91a9c125874b5a8c3a994e9702"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: f144a156-e626-45c9-a294-dc7fed022e82
X-Runtime: 0.064634
Vary: Origin
Content-Length: 291

Body

{
  "id": 1056999340,
  "data_vigencia": "2018-01-10",
  "quadro_de_hora": {
    "hora_virada": "2000-01-01T00:00:00.000Z",
    "name": "Quadro Livre",
    "tipo": "livre",
    "use_holiday": true,
    "folgas_especiais": 0,
    "ativo": true,
    "ch": 11,
    "marcacao_automatica_intervalo": null,
    "tolerancia": null,
    "horario": null,
    "intervalo": null
  }
}

Vinculando um Quadro de Horas - erros

Este método mostra falhas na validação do vinculo do quadro de horas ao funcionário.

Endpoint

POST /v1/funcionarios/:funcionario_uid/quadros_de_horas

Parameters

Name Description
funcionario_uid required (String) UID do funcionário.
funcionario_quadro_de_hora[data_vigencia] required (Date) Data de vigência.
funcionario_quadro_de_hora[ch] required (Int) Código do Horário.

Request

Route

POST /v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d6/quadros_de_horas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "funcionario_quadro_de_hora": {
    "data_vigencia": ""
  }
}

cURL

curl "https://api.ptrp.com.br/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d6/quadros_de_horas" -d '{"funcionario_quadro_de_hora":{"data_vigencia":""}}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
message (String) Mensagem da requisição.
errors[data_vigencia] (Array) Erros do parâmetro Data Vigência.
errors[ch] (Array) Erros do parâmetro CH.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: ade74f5c-bfdf-46aa-8818-5e5a57ef7022
X-Runtime: 0.046935
Vary: Origin
Content-Length: 124

Body

{
  "message": "Validation Failed!",
  "errors": {
    "data_vigencia": [
      "can't be blank",
      "Invalid Date format"
    ],
    "ch": [
      "can't be blank"
    ]
  }
}

Justificativas Pendentes

Aceitando uma Justificativa Pendente

Este método aceita uma justificativa pendente e a processa como justificativa ou marcação de ponto.

Endpoint

PATCH /v1/justificativas-pendentes/:id/accept

Parameters

Name Description
data required (Date) Data em que a justificativa será registrada.
data_final (Date) Data final da justificativa (para justificativas com período).
hora (String) Hora da justificativa no formato HH:MM.
desconta_dsr (Boolean) Indica se desconta DSR.
marcacao (Boolean) Indica se é uma marcação de ponto.
abonar (Boolean) Indica se a justificativa será abonada.
include_comment (Boolean) Indica se deve incluir o comentário da justificativa pendente.
motivo_id (Integer) ID do motivo da justificativa.
motivo_personalizado_id (Integer) ID do motivo personalizado.
id required (Integer) ID da justificativa pendente.

Request

Route

PATCH /v1/justificativas-pendentes/962157260/accept

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "data": "2020-01-01",
  "hora": "2000-01-01T08:20:00.000Z",
  "motivo_id": 569982306
}

cURL

curl "https://api.ptrp.com.br/v1/justificativas-pendentes/962157260/accept" -d '{"data":"2020-01-01","hora":"2000-01-01T08:20:00.000Z","motivo_id":569982306}' -X PATCH \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json
Cache-Control: no-cache
X-Request-Id: c6ada0f6-8122-4253-b64b-275a664ce449
X-Runtime: 0.052789
Vary: Origin
Content-Length: 0

Exibindo uma Justificativa Pendente

Este método retorna os detalhes de uma justificativa pendente específica.

Endpoint

GET /v1/justificativas-pendentes/:id

Parameters

Name Description
id required (Integer) ID da justificativa pendente.

Request

Route

GET /v1/justificativas-pendentes/962157260

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/justificativas-pendentes/962157260" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Integer) ID da justificativa pendente.
data (Date) Data em que a justificativa será registrada.
hora (String) Hora da justificativa no formato HH:MM (pode ser null).
motivo (Object) Objeto contendo informações do motivo da justificativa.
motivo[motivo] (Integer) ID do motivo.
motivo[name] (String) Nome do motivo.
motivo[e_social_id] (Integer) ID do e-Social (pode ser null).
status (String) Status da justificativa (ex: "pending", "accepted", "rejected").
description (String) Descrição da justificativa.
file (String) Caminho do arquivo anexado.
rejection_motivation (String) Motivo da rejeição (null se não rejeitado).
data_final (Date) Data final da justificativa no formato (pode ser null).
created_at (DateTime) Data e hora de criação.
updated_at (DateTime) Data e hora da última atualização.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"10bade4e3cb39114203a0cb6b375fc98"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 96984031-fd28-4d16-8aed-cf5bfa5575a4
X-Runtime: 0.044413
Vary: Origin
Content-Length: 340

Body

{
  "id": 962157260,
  "data": "2020-01-01",
  "hora": "2000-01-01T08:20:00.000Z",
  "motivo": {
    "id": 569982306,
    "name": "Atestado Médico",
    "e_social_id": null
  },
  "status": "pending",
  "description": "atestado medico",
  "file": null,
  "rejection_motivation": null,
  "data_final": null,
  "created_at": "2026-04-06T22:37:18.000-03:00",
  "updated_at": "2026-04-06T22:37:18.000-03:00"
}

Falha ao aceitar uma Justificativa Pendente

Este método retorna erro quando os parâmetros são inválidos ou a operação não pode ser completada.

Endpoint

PATCH /v1/justificativas-pendentes/:id/accept

Parameters

Name Description
data required (Date) Data em que a justificativa será registrada.
data_final (Date) Data final da justificativa (para justificativas com período).
hora (String) Hora da justificativa no formato HH:MM.
desconta_dsr (Boolean) Indica se desconta DSR.
marcacao (Boolean) Indica se é uma marcação de ponto.
abonar (Boolean) Indica se a justificativa será abonada.
include_comment (Boolean) Indica se deve incluir o comentário da justificativa pendente.
motivo_id (Integer) ID do motivo da justificativa.
motivo_personalizado_id (Integer) ID do motivo personalizado.
id required (Integer) ID da justificativa pendente.

Request

Route

PATCH /v1/justificativas-pendentes/962157260/accept

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "data": "2020-01-01",
  "hora": "01:99",
  "motivo_id": 569982306
}

cURL

curl "https://api.ptrp.com.br/v1/justificativas-pendentes/962157260/accept" -d '{"data":"2020-01-01","hora":"01:99","motivo_id":569982306}' -X PATCH \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: 21799a89-ff99-4798-9a0b-8c9c6fefd6d5
X-Runtime: 0.048196
Vary: Origin
Content-Length: 74

Body

{
  "message": "Validation Failed!",
  "errors": {
    "hora": [
      "Invalid Time format"
    ]
  }
}

Listando Justificativas Pendentes

Este método retorna um array de justificativas pendentes.

Endpoint

GET /v1/justificativas-pendentes

Request

Route

GET /v1/justificativas-pendentes

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/justificativas-pendentes" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Integer) ID da justificativa pendente.
data (Date) Data em que a justificativa será registrada.
hora (String) Hora da justificativa no formato HH:MM (pode ser null).
motivo (Object) Objeto contendo informações do motivo da justificativa.
motivo[motivo] (Integer) ID do motivo.
motivo[name] (String) Nome do motivo.
motivo[e_social_id] (Integer) ID do e-Social (pode ser null).
status (String) Status da justificativa (ex: "pending", "accepted", "rejected").
description (String) Descrição da justificativa.
file (String) Caminho do arquivo anexado.
rejection_motivation (String) Motivo da rejeição (null se não rejeitado).
data_final (Date) Data final da justificativa no formato (pode ser null).
created_at (DateTime) Data e hora de criação.
updated_at (DateTime) Data e hora da última atualização.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Per-Page: 5
X-Current-Page: 1
X-Total-Entries: 1
X-Total-Pages: 1
Content-Type: application/json; charset=utf-8
ETag: W/"2adca328407010fe638550cae8d971e2"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 9ca04143-a6d5-4c5b-806c-891cbd022fdc
X-Runtime: 0.076449
Vary: Origin
Content-Length: 342

Body

[
  {
    "id": 962157260,
    "data": "2020-01-01",
    "hora": "2000-01-01T08:20:00.000Z",
    "motivo": {
      "id": 569982306,
      "name": "Atestado Médico",
      "e_social_id": null
    },
    "status": "pending",
    "description": "atestado medico",
    "file": null,
    "rejection_motivation": null,
    "data_final": null,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "updated_at": "2026-04-06T22:37:18.000-03:00"
  }
]

Rejeitando uma Justificativa Pendente

Este método rejeita uma justificativa pendente e registra o motivo da rejeição.

Endpoint

PATCH /v1/justificativas-pendentes/:id/reject

Parameters

Name Description
id required (Integer) ID da justificativa pendente.
message (String) Motivo da rejeição da justificativa.

Request

Route

PATCH /v1/justificativas-pendentes/962157260/reject

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Body

{
  "message": "Documentação insuficiente"
}

cURL

curl "https://api.ptrp.com.br/v1/justificativas-pendentes/962157260/reject" -d '{"message":"Documentação insuficiente"}' -X PATCH \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json
Cache-Control: no-cache
X-Request-Id: 7a488d65-9086-4af9-9416-b14e3cd11ff5
X-Runtime: 0.044403
Vary: Origin
Content-Length: 0

Motivos

Listando Motivos E-Social

Este método retorna os motivos previstos na tabela E-Social.

Endpoint

GET /v1/motivos/common

Request

Route

GET /v1/motivos/common

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/motivos/common" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Int) ID do Motivo.
name (String) Nome do motivo.
e_social_id (Int) Código E-social do motivo.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"1e858bb19b96b9a27446f130974dae63"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: c2a61f01-1c40-43a1-8908-5830ff739981
X-Runtime: 0.057179
Vary: Origin
Content-Length: 882

Body

[
  {
    "id": 267869265,
    "name": "Afastado(+de15dias)",
    "e_social_id": null
  },
  {
    "id": 385748469,
    "name": "APS",
    "e_social_id": null
  },
  {
    "id": 569982306,
    "name": "Atestado Médico",
    "e_social_id": null
  },
  {
    "id": 1067296963,
    "name": "Atestado Médico - Acompanhamento",
    "e_social_id": null
  },
  {
    "id": 144349274,
    "name": "Auxílio Doença",
    "e_social_id": null
  },
  {
    "id": 294898158,
    "name": "Aviso Prévio",
    "e_social_id": null
  },
  {
    "id": 603690436,
    "name": "B.H.(-)",
    "e_social_id": null
  },
  {
    "id": 621492253,
    "name": "B.H.(+)",
    "e_social_id": null
  },
  {
    "id": 650723652,
    "name": "Compensado Extra",
    "e_social_id": null
  },
  {
    "id": 522203626,
    "name": "CP.(+)",
    "e_social_id": null
  },
  {
    "id": 138563155,
    "name": "D.S.R.(-)",
    "e_social_id": null
  },
  {
    "id": 367989381,
    "name": "D.S.R.(+)",
    "e_social_id": null
  },
  {
    "id": 270258126,
    "name": "Falta Marcação",
    "e_social_id": null
  },
  {
    "id": 377277181,
    "name": "Folga",
    "e_social_id": null
  },
  {
    "id": 228619110,
    "name": "Intervalo café",
    "e_social_id": null
  }
]

Listando Motivos Personalizados

Este método retorna os motivos personalizados criados pelo usuário.

Endpoint

GET /v1/motivos/personalizados

Request

Route

GET /v1/motivos/personalizados

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/motivos/personalizados" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Int) ID do Motivo.
name (String) Nome do motivo.
e_social_id (Int) Código E-social do motivo.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"4c0527bfe3c7b6196c155f7ca6a7c09a"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: a585d271-a1ce-43ae-bf24-b56e4644db99
X-Runtime: 0.043222
Vary: Origin
Content-Length: 127

Body

[
  {
    "id": 3656553,
    "name": "Intervalo café",
    "e_social_id": null
  },
  {
    "id": 1067296971,
    "name": "Motivo Personalizado",
    "e_social_id": null
  }
]

Quadros de Horas

Listando quadros de horas

Este método retorna um array de Quadros de Horas.

Endpoint

GET /v1/quadro_de_horas

Request

Route

GET /v1/quadro_de_horas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/quadro_de_horas" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
hora_virada (Time) Hora da virada do quadro de horas.
name (String) Nome do quadro de horas.
tipo (String) Tipo do quadro de horas.
use_holiday (Boolean) Se o quadro de horas utiliza feriados nacionais.
folgas_especiais (Int) Número de folgas especiais.
ativo (Boolean) Se o quadro de horas está atualmente ativo.
ch (Int) Código do Horário.
marcacao_automatica_intervalo (Object) Configurações de Marcações Automaticas de Intervalo.
marcacao_automatica_intervalo[hora_inicio] (Time) Hora de inicio do intervalo.
marcacao_automatica_intervalo[hora_fim] (Time) Hora de término do intervalo.
marcacao_automatica_intervalo[tolerancia] (Int) Tolerância em segundos.
marcacao_automatica_intervalo[domingo] (Boolean) Marcação para válida para domingo.
marcacao_automatica_intervalo[segunda] (Boolean) Marcação para válida para segunda.
marcacao_automatica_intervalo[terca] (Boolean) Marcação para válida para terça.
marcacao_automatica_intervalo[quarta] (Boolean) Marcação para válida para quarta.
marcacao_automatica_intervalo[quinta] (Boolean) Marcação para válida para quinta.
marcacao_automatica_intervalo[sexta] (Boolean) Marcação para válida para sexta.
marcacao_automatica_intervalo[sabado] (Boolean) Marcação para válida para sábado.
marcacao_automatica_intervalo[feriado] (Boolean) Marcação para válida para feriado.
tolerancia (Object) Configurações de Tolerância.
tolerancia[tolerancia_fixa] (Boolean) Se utiliza tolerância fixa.
tolerancia[tolerancia_fixa_entrada] (Int) Tolerância fixa para entradas em minutos.
tolerancia[tolerancia_fixa_saida] (Int) Tolerância fixa para saidas em minutos.
tolerancia[tolerancia_global_extra] (Int) Tolerância global para extra em minutos.
tolerancia[tolerancia_global_falta] (Int) Tolerância global para falta em minutos.
horario (Mixed) Configurações do quadro de horários de entradas e saídas. O valor pode ser string ou um objeto.
horario[tipo_periodo] (String) Nome do tipo do período.
horario[carga_horaria] (Int) Carga horária total em segundos.
horario[carga_horaria_faixa] (Object) Detalhes da faixa de dias que abrange a carga horária.
carga_horaria_faixa[domingo] (Time) Carga horária para domingo.
carga_horaria_faixa[segunda] (Time) Carga horária para segunda.
carga_horaria_faixa[terca] (Time) Carga horária para terça.
carga_horaria_faixa[quarta] (Time) Carga horária para quarta.
carga_horaria_faixa[quinta] (Time) Carga horária para quinta.
carga_horaria_faixa[sexta] (Time) Carga horária para sexta.
carga_horaria_faixa[sabado] (Time) Carga horária para sábado.
carga_horaria_faixa[feriado] (Time) Carga horária para feriado.
horario[carga_horaria_folga] (Object) Detalhes da faixa de dias para folga.
carga_horaria_folga[domingo] (Boolean) Se a carga horária é válida para domingo.
carga_horaria_folga[segunda] (Boolean) Se a carga horária é válida para segunda.
carga_horaria_folga[terca] (Boolean) Se a carga horária é válida para terça.
carga_horaria_folga[quarta] (Boolean) Se a carga horária é válida para quarta.
carga_horaria_folga[quinta] (Boolean) Se a carga horária é válida para quinta.
carga_horaria_folga[sexta] (Boolean) Se a carga horária é válida para sexta.
carga_horaria_folga[sabado] (Boolean) Se a carga horária é válida para sábado.
carga_horaria_folga[feriado] (Boolean) Se a carga horária é válida para feriado.
horario[wdays] (Array) Array de objetos [Wday]. Quadro de horário dia a dia. Cada objeto representa um par de entrada e saída do dia.
wdays[entrada] (Time) Hora de entrada.
wdays[retorno] (Time) Hora de saída.
wdays[total] (Time) Total de horas do dia.
wdays[wday] (Int) Dia da semana da configuração. Começando em 0 = domingo, até 6 = sábado. E 7 é feriado.
intervalo (Object) Configurações de Intervalos (café).
intervalo[motivo_id] (Int) ID do Motivo.
intervalo[tolerancia] (Int) Tolerância do intervalo em segundos.
intervalo[wdays] (Array) Array de objetos [Wday]. Quadro de intervalos dia a dia. Cada objeto representa um par de intervalo e retorno do dia.
wdays[intervalo] (Time) Hora de entrada no intervalo.
wdays[retorno] (Time) Hora de retorno do intervalo.
wdays[total] (Time) Total de horas do intervalo.
wdays[wday] (Int) Dia da semana da configuração. Começando em 0 = domingo, até 6 = sábado. E 7 é feriado.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"9be9867700da0966abfacb5b09fca2d8"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 69674aca-989b-4709-8aca-bb575bb9d6ba
X-Runtime: 0.142444
Vary: Origin
Content-Length: 7718

Body

[
  {
    "hora_virada": "2000-01-01T00:00:00.000Z",
    "name": "Quadro Livre",
    "tipo": "livre",
    "use_holiday": true,
    "folgas_especiais": 0,
    "ativo": true,
    "ch": 11,
    "marcacao_automatica_intervalo": null,
    "tolerancia": null,
    "horario": null,
    "intervalo": null
  },
  {
    "hora_virada": "2000-01-01T00:00:00.000Z",
    "name": "Quadro Livre 2",
    "tipo": "livre",
    "use_holiday": true,
    "folgas_especiais": 0,
    "ativo": true,
    "ch": null,
    "marcacao_automatica_intervalo": null,
    "tolerancia": null,
    "horario": null,
    "intervalo": null
  },
  {
    "hora_virada": "2000-01-01T00:00:00.000Z",
    "name": "Quadro Flexivel",
    "tipo": "flexivel",
    "use_holiday": true,
    "folgas_especiais": 0,
    "ativo": true,
    "ch": null,
    "marcacao_automatica_intervalo": null,
    "tolerancia": {
      "tolerancia_fixa": false,
      "tolerancia_fixa_entrada": 5,
      "tolerancia_fixa_saida": 5,
      "tolerancia_global_extra": 10,
      "tolerancia_global_falta": 10
    },
    "horario": {
      "tipo_periodo": "mensal",
      "wdays": [
        {
          "entrada": "2000-01-01T08:30:00.000Z",
          "saida": "2000-01-01T11:30:00.000Z",
          "total": "2000-01-01T03:00:00.000Z",
          "wday": 1
        },
        {
          "entrada": "2000-01-01T13:00:00.000Z",
          "saida": "2000-01-01T18:00:00.000Z",
          "total": "2000-01-01T05:00:00.000Z",
          "wday": 1
        }
      ]
    },
    "intervalo": null
  },
  {
    "hora_virada": "2000-01-01T00:00:00.000Z",
    "name": "Quadro Carga Faixa",
    "tipo": "carga_horaria",
    "use_holiday": true,
    "folgas_especiais": 0,
    "ativo": true,
    "ch": null,
    "marcacao_automatica_intervalo": null,
    "tolerancia": null,
    "horario": {
      "tipo_periodo": "faixas",
      "carga_horaria": 0,
      "carga_horaria_faixa": {
        "domingo": "2000-01-01T00:00:00.000Z",
        "segunda": "2000-01-01T08:30:00.000Z",
        "terca": "2000-01-01T08:30:00.000Z",
        "quarta": "2000-01-01T08:30:00.000Z",
        "quinta": "2000-01-01T08:30:00.000Z",
        "sexta": "2000-01-01T08:30:00.000Z",
        "sabado": "2000-01-01T03:30:00.000Z",
        "feriado": "2000-01-01T00:00:00.000Z"
      },
      "carga_horaria_folga": null
    },
    "intervalo": null
  },
  {
    "hora_virada": "2000-01-01T00:00:00.000Z",
    "name": "Quadro Craga Semanal",
    "tipo": "carga_horaria",
    "use_holiday": true,
    "folgas_especiais": 0,
    "ativo": true,
    "ch": null,
    "marcacao_automatica_intervalo": null,
    "tolerancia": null,
    "horario": {
      "tipo_periodo": "semanal",
      "carga_horaria": 158400,
      "carga_horaria_faixa": null,
      "carga_horaria_folga": {
        "domingo": true,
        "segunda": false,
        "terca": false,
        "quarta": false,
        "quinta": false,
        "sexta": false,
        "sabado": false,
        "feriado": true
      }
    },
    "intervalo": null
  },
  {
    "hora_virada": "2000-01-01T00:00:00.000Z",
    "name": "Semanal",
    "tipo": "fixo",
    "use_holiday": true,
    "folgas_especiais": 0,
    "ativo": true,
    "ch": null,
    "marcacao_automatica_intervalo": null,
    "tolerancia": {
      "tolerancia_fixa": true,
      "tolerancia_fixa_entrada": 5,
      "tolerancia_fixa_saida": 5,
      "tolerancia_global_extra": 10,
      "tolerancia_global_falta": 10
    },
    "horario": {
      "tipo_periodo": "semanal",
      "wdays": [
        {
          "entrada": "2000-01-01T08:00:00.000Z",
          "saida": "2000-01-01T12:00:00.000Z",
          "total": "2000-01-01T04:00:00.000Z",
          "wday": 1
        },
        {
          "entrada": "2000-01-01T14:00:00.000Z",
          "saida": "2000-01-01T18:00:00.000Z",
          "total": "2000-01-01T04:00:00.000Z",
          "wday": 1
        }
      ]
    },
    "intervalo": null
  },
  {
    "hora_virada": "2000-01-01T00:00:00.000Z",
    "name": "Mensal fixo almoco",
    "tipo": "fixo_com_almoco_flexivel",
    "use_holiday": true,
    "folgas_especiais": 0,
    "ativo": true,
    "ch": null,
    "marcacao_automatica_intervalo": null,
    "tolerancia": {
      "tolerancia_fixa": true,
      "tolerancia_fixa_entrada": 5,
      "tolerancia_fixa_saida": 5,
      "tolerancia_global_extra": 10,
      "tolerancia_global_falta": 10
    },
    "horario": {
      "tipo_periodo": "mensal",
      "wdays": [
        {
          "entrada": "2000-01-01T08:30:00.000Z",
          "saida": "2000-01-01T11:30:00.000Z",
          "total": "2000-01-01T03:00:00.000Z",
          "wday": 1
        },
        {
          "entrada": "2000-01-01T13:00:00.000Z",
          "saida": "2000-01-01T18:00:00.000Z",
          "total": "2000-01-01T05:00:00.000Z",
          "wday": 1
        }
      ]
    },
    "intervalo": null
  },
  {
    "hora_virada": null,
    "name": "Revezamento",
    "tipo": "revezamento",
    "use_holiday": true,
    "folgas_especiais": 0,
    "ativo": true,
    "ch": null,
    "marcacao_automatica_intervalo": null,
    "tolerancia": null,
    "horario": {
      "escalas": [
        {
          "tipo": "folga",
          "hora_virada": "2000-01-01T00:00:00.000Z",
          "ordem": 1
        },
        {
          "tipo": "livre",
          "hora_virada": "2000-01-01T00:00:00.000Z",
          "ordem": 2
        },
        {
          "tipo": "carga_horaria",
          "hora_virada": "2000-01-01T00:00:00.000Z",
          "ordem": 3
        }
      ]
    },
    "intervalo": null
  },
  {
    "hora_virada": null,
    "name": "flexivel_com_almoco_fixo",
    "tipo": "flexivel_com_almoco_fixo",
    "use_holiday": true,
    "folgas_especiais": 0,
    "ativo": true,
    "ch": null,
    "marcacao_automatica_intervalo": null,
    "tolerancia": null,
    "horario": "livre",
    "intervalo": null
  },
  {
    "hora_virada": null,
    "name": "flexivel tolerancia",
    "tipo": "flexivel",
    "use_holiday": true,
    "folgas_especiais": 0,
    "ativo": true,
    "ch": null,
    "marcacao_automatica_intervalo": null,
    "tolerancia": {
      "tolerancia_fixa": false,
      "tolerancia_fixa_entrada": 1,
      "tolerancia_fixa_saida": 1,
      "tolerancia_global_extra": 1,
      "tolerancia_global_falta": 1
    },
    "horario": {
      "tipo_periodo": "semanal",
      "wdays": [
        {
          "entrada": "2000-01-01T08:00:00.000Z",
          "saida": "2000-01-01T12:00:00.000Z",
          "total": "2000-01-01T04:00:00.000Z",
          "wday": 1
        },
        {
          "entrada": "2000-01-01T14:00:00.000Z",
          "saida": "2000-01-01T18:00:00.000Z",
          "total": "2000-01-01T04:00:00.000Z",
          "wday": 1
        }
      ]
    },
    "intervalo": null
  },
  {
    "hora_virada": null,
    "name": "Revezamento 12x36",
    "tipo": "revezamento",
    "use_holiday": true,
    "folgas_especiais": 0,
    "ativo": true,
    "ch": null,
    "marcacao_automatica_intervalo": null,
    "tolerancia": null,
    "horario": {
      "escalas": [
        {
          "tipo": "carga_horaria",
          "hora_virada": "2000-01-01T00:00:00.000Z",
          "ordem": 1
        },
        {
          "tipo": "folga",
          "hora_virada": "2000-01-01T00:00:00.000Z",
          "ordem": 2
        }
      ]
    },
    "intervalo": null
  },
  {
    "hora_virada": "2000-01-01T00:00:00.000Z",
    "name": "Quadro Flexivel com Marcacao Automatica",
    "tipo": "flexivel",
    "use_holiday": true,
    "folgas_especiais": 2,
    "ativo": true,
    "ch": null,
    "marcacao_automatica_intervalo": {
      "hora_inicio": "2000-01-01T12:00:00.000Z",
      "hora_fim": "2000-01-01T13:00:00.000Z",
      "tolerancia": 900,
      "domingo": true,
      "segunda": true,
      "terca": true,
      "quarta": true,
      "quinta": true,
      "sexta": true,
      "sabado": true,
      "feriado": true
    },
    "tolerancia": null,
    "horario": {
      "tipo_periodo": "mensal",
      "wdays": [
        {
          "entrada": "2000-01-01T08:30:00.000Z",
          "saida": "2000-01-01T11:30:00.000Z",
          "total": "2000-01-01T03:00:00.000Z",
          "wday": 1
        },
        {
          "entrada": "2000-01-01T13:00:00.000Z",
          "saida": "2000-01-01T18:00:00.000Z",
          "total": "2000-01-01T05:00:00.000Z",
          "wday": 1
        }
      ]
    },
    "intervalo": null
  },
  {
    "hora_virada": "2000-01-01T08:00:00.000Z",
    "name": "Quadro Flexivel para Giovana",
    "tipo": "flexivel",
    "use_holiday": true,
    "folgas_especiais": 0,
    "ativo": true,
    "ch": null,
    "marcacao_automatica_intervalo": null,
    "tolerancia": null,
    "horario": {
      "tipo_periodo": "mensal",
      "wdays": [
        {
          "entrada": "2000-01-01T08:30:00.000Z",
          "saida": "2000-01-01T11:30:00.000Z",
          "total": "2000-01-01T03:00:00.000Z",
          "wday": 1
        },
        {
          "entrada": "2000-01-01T13:00:00.000Z",
          "saida": "2000-01-01T18:00:00.000Z",
          "total": "2000-01-01T05:00:00.000Z",
          "wday": 1
        }
      ]
    },
    "intervalo": null
  },
  {
    "hora_virada": "2000-01-01T00:00:00.000Z",
    "name": "Quadro Carga Horaria Diaria de 8 horas",
    "tipo": "carga_horaria",
    "use_holiday": true,
    "folgas_especiais": 0,
    "ativo": true,
    "ch": null,
    "marcacao_automatica_intervalo": null,
    "tolerancia": null,
    "horario": {
      "tipo_periodo": "diaria",
      "carga_horaria": 28800,
      "carga_horaria_faixa": null,
      "carga_horaria_folga": {
        "domingo": true,
        "segunda": false,
        "terca": false,
        "quarta": false,
        "quinta": false,
        "sexta": false,
        "sabado": false,
        "feriado": true
      }
    },
    "intervalo": null
  },
  {
    "hora_virada": "2000-01-01T00:00:00.000Z",
    "name": "Quadro Flexivel 8h por dia",
    "tipo": "flexivel",
    "use_holiday": true,
    "folgas_especiais": 0,
    "ativo": true,
    "ch": null,
    "marcacao_automatica_intervalo": null,
    "tolerancia": null,
    "horario": {
      "tipo_periodo": "mensal",
      "wdays": [
        {
          "entrada": "2000-01-01T00:00:00.000Z",
          "saida": "2000-01-01T08:00:00.000Z",
          "total": "2000-01-01T08:00:00.000Z",
          "wday": 3
        },
        {
          "entrada": "2000-01-01T00:00:00.000Z",
          "saida": "2000-01-01T08:00:00.000Z",
          "total": "2000-01-01T08:00:00.000Z",
          "wday": 4
        },
        {
          "entrada": "2000-01-01T00:00:00.000Z",
          "saida": "2000-01-01T08:00:00.000Z",
          "total": "2000-01-01T08:00:00.000Z",
          "wday": 5
        },
        {
          "entrada": "2000-01-01T00:00:00.000Z",
          "saida": "2000-01-01T08:00:00.000Z",
          "total": "2000-01-01T08:00:00.000Z",
          "wday": 1
        },
        {
          "entrada": "2000-01-01T00:00:00.000Z",
          "saida": "2000-01-01T08:00:00.000Z",
          "total": "2000-01-01T08:00:00.000Z",
          "wday": 2
        }
      ]
    },
    "intervalo": null
  }
]

Resumo Cartões Ponto

Mostrando erros de validação da requisição

Este método retorna um objeto com erros da requisição.

Endpoint

GET /v1/cartoes-ponto/resumo/:year/:month

Parameters

Name Description
year required (Int) Ano do cartão ponto. Ex: 2018.
month required (Int) Mês do cartão ponto. Ex: 10.

Request

Route

GET /v1/cartoes-ponto/resumo/2018/22

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/cartoes-ponto/resumo/2018/22" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
message (String) Mensagem de erro de validação.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: dc2d7332-f5fe-4549-8494-c7f6f30cb775
X-Runtime: 0.036120
Vary: Origin
Content-Length: 33

Body

{
  "message": "Invalid Date format"
}

Mostrando os cartões ponto

Este método retorna uma coleção de objetos com cartões ponto.

Endpoint

GET /v1/cartoes-ponto/resumo/:year/:month

Parameters

Name Description
year required (Int) Ano do cartão ponto. Ex: 2018.
month required (Int) Mês do cartão ponto. Ex: 10.

Request

Route

GET /v1/cartoes-ponto/resumo/2018/1

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/cartoes-ponto/resumo/2018/1" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
resumo (Object) Objeto cartão ponto (ver artigo Funcionários > Cartão Ponto).

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"7aa9c0737714942931f41fdb39e724bd"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: e3e72f4a-148a-4435-8e4d-904f04708174
X-Runtime: 0.071407
Vary: Origin
Content-Length: 3118

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2000-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "ativo": true,
        "uid": "c43becdf-bb77-4062-97c0-58f3335dad91",
        "codigo_registro_folha": "1",
        "full_name": "Departamento01 (Empresa03)"
      },
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:20.904-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    },
    "ano": 2018,
    "mes": 1,
    "mensagem": null,
    "atualizado": true,
    "total_abonos": 0,
    "total_falta": 489600,
    "total_trabalhado": 43200,
    "total_extra": 14400,
    "adicional_noturno": 0,
    "total_atrasado": 0,
    "total_antecipado": 0,
    "dias_de_falta": 17,
    "extra_noturno": 0,
    "semanal": {
      "semana_1": {
        "trabalhada": 0,
        "extra": 0,
        "falta": 0,
        "adicional_noturno": 0,
        "abonos": 0,
        "excecoes": 0,
        "in_itinere": 0,
        "dias_de_falta": 7,
        "falta_integral": 201600
      },
      "semana_2": {
        "trabalhada": 0,
        "extra": 0,
        "falta": 0,
        "adicional_noturno": 0,
        "abonos": 0,
        "excecoes": 0,
        "in_itinere": 0,
        "dias_de_falta": 7,
        "falta_integral": 201600
      },
      "semana_3": {
        "trabalhada": 0,
        "extra": 0,
        "falta": 0,
        "adicional_noturno": 0,
        "abonos": 0,
        "excecoes": 0,
        "in_itinere": 0,
        "dias_de_falta": 3,
        "falta_integral": 86400
      }
    },
    "mensal": null,
    "politica_extra": {
      "semanal": {
        "segunda_a_sexta": {
        },
        "segunda_a_sabado": {
        },
        "domingo": {
        },
        "sabado": {
        },
        "feriado": {
        },
        "folga": {
        },
        "id": {
        }
      },
      "semanal_detail": {
      },
      "mensal": {
        "segunda_a_sexta": {
          "50": 14400
        },
        "segunda_a_sabado": {
        },
        "domingo": {
          "100": 0
        },
        "sabado": {
          "50": 0
        },
        "feriado": {
          "100": 0
        },
        "folga": {
        }
      },
      "diaria": {
        "segunda_a_sexta": {
        },
        "segunda_a_sabado": {
        },
        "domingo": {
        },
        "sabado": {
        },
        "feriado": {
        },
        "folga": {
        }
      }
    },
    "locked": false,
    "acrescimo_noturno": 0,
    "trabalhadas_com_dsr": 0,
    "trabalhadas_menos_extra": 28800,
    "dsr_credit": 0,
    "dsr_debit": 0,
    "quantidade_dsr_positivo": 0,
    "bh_credit": 0,
    "bh_debit": 0,
    "bh_total": 0,
    "bh_pago": 0,
    "bh_abonado": 0,
    "in_itinere_total": 0,
    "falta_integral": 489600,
    "falta_parcial": 0,
    "adicional_noturno_sem_acrescimo": 0,
    "intervalo_intrajornada": null,
    "interjornada": null,
    "interjornada_faltante": null,
    "dias_de_trabalho": null,
    "cp_credit": 0,
    "cp_debit": 0,
    "cp_total": 0,
    "status": "pending_approval",
    "status_history": [

    ],
    "pontos_processados": [

    ]
  }
]

TC > Ponto Diário

Listando ponto diário

Este método retorna uma coleção de objetos para o dia do cartão ponto.

Endpoint

GET /tc/ponto_diario

Parameters

Name Description
date (Date) Data do dia do cartão ponto. Ex: "01-01-2019"

Request

Route

GET /tc/ponto_diario?data=2014-01-12

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Query Parameters

data=2014-01-12

cURL

curl -g "https://api.ptrp.com.br/tc/ponto_diario?data=2014-01-12" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
nome (String) Nome do funcionário.
hora_entrada_manha (Time) Hora de entrada de manhã do quadro de horas.
hora_saida_manha (Time) Hora de saida de manhã do quadro de horas.
hora_entrada_tarde (Time) Hora de entrada a tarde do quadro de horas.
hora_saida_tarde (Time) Hora de saida a tarde do quadro de horas.
atraso (Time) Total de atraso.
saida_antecipada (Time) Total de atraso.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"4d32874a561ad5ff05f499d1882ced85"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 01e3b616-3e94-4ef8-a676-4633163dc4ef
X-Runtime: 0.489331
Content-Length: 174

Body

[
  {
    "nome": "Func1",
    "hora_entrada_manha": "06:45",
    "hora_saida_manha": "09:53",
    "hora_entrada_tarde": "13:01",
    "hora_saida_tarde": "16:09",
    "atraso": "00:00",
    "saida_antecipada": "00:00"
  }
]

Listando ponto diário de funcionarios de hoje

Este método retorna uma coleção de objetos para o dia do cartão ponto.

Endpoint

GET /tc/ponto_diario

Parameters

Name Description
date (Date) Data do dia do cartão ponto. Ex: "01-01-2019"

Request

Route

GET /tc/ponto_diario

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/tc/ponto_diario" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
nome (String) Nome do funcionário.
hora_entrada_manha (Time) Hora de entrada de manhã do quadro de horas.
hora_saida_manha (Time) Hora de saida de manhã do quadro de horas.
hora_entrada_tarde (Time) Hora de entrada a tarde do quadro de horas.
hora_saida_tarde (Time) Hora de saida a tarde do quadro de horas.
atraso (Time) Total de atraso.
saida_antecipada (Time) Total de atraso.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"4d32874a561ad5ff05f499d1882ced85"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: c61fa8d8-a6b0-42d3-b1ef-01687043c92e
X-Runtime: 0.054653
Content-Length: 174

Body

[
  {
    "nome": "Func1",
    "hora_entrada_manha": "06:45",
    "hora_saida_manha": "09:53",
    "hora_entrada_tarde": "13:01",
    "hora_saida_tarde": "16:09",
    "atraso": "00:00",
    "saida_antecipada": "00:00"
  }
]

User

Showing User Profile

Show user profile

Endpoint

GET /v1/user/profile

Request

Route

GET /v1/user/profile

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/user/profile" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
first_name (String) Primeiro nome do usuário.
last_name (String) Sobrenome do usuário.
cpf (String) CPF do usuário.
username (String) Nome de acesso do usuário.
station_type (String) Tipo de usuário.
roles (Array<String>) Funções do usuário.
created_at (Date) Data de criação.
updated_at (Date) Última data de atualização.
auth_token (String) Token configurável.
funcionario_uid (String) UID do Funcionário quando station_type for funcionário. (Obsoleto: Utilizar o campo station)
temporary_password (Bool) Verdadeira se a senha não foi atualizada ainda.
empresa (Object<Empresa>) Objeto Empresa. Objeto presente quando o usuário pertence a uma empresa. (Obsoleto: Utilizar o campo station)
franquia (Object) Dados da franquia que o usuário pertence. (Obsoleto: Utilizar o campo station)
station (Object) Objeto variável de acordo com o campo station_type (Ex: Franquia, Cliente, Empresa e Funcionario)
timezone (String) Fuso horário configurado para aplicações de registro de ponto.
permissions (Array) Lista de permissões adicionais do usuário.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"4fa9825f5a109254b45e122d8837b57c"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 3952e554-e4ce-4766-8db0-7f2cf6a8fb36
X-Runtime: 0.052889
Vary: Origin
Content-Length: 1932

Body

{
  "first_name": "User03",
  "last_name": "LastName",
  "cpf": "000.000.000-03",
  "username": "user03",
  "station_type": "Cliente",
  "roles": [
    "cliente"
  ],
  "created_at": "2026-04-06T22:37:18.000-03:00",
  "updated_at": "2026-04-06T22:37:18.000-03:00",
  "funcionario_uid": null,
  "temporary_password": false,
  "empresa": null,
  "franquia": {
    "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe3f0",
    "name": "Franquia01",
    "nome_fantasia": "FranquiaFantasia01",
    "cnpj": "00.000.000/0000-00",
    "inscricao_estadual": null,
    "cpf": null,
    "logo": "/uploads/franquia/879004013/logo/879004013/logo.png",
    "clausula_aceite": null,
    "address": {
      "cep": "85555-222",
      "city": "Guarapuava",
      "complement": "Apto52",
      "country": "Brasil",
      "number": "101",
      "state": "PR",
      "street": "Rua Armando Ribas",
      "district": "Rua Armando Ribas"
    },
    "condicoes_comerciais": null,
    "contacts": [
      {
        "email": "[email protected]",
        "name": "My Contact",
        "phone": "(42) 05555-4444",
        "cpf": null,
        "whatsapp": null,
        "site": null,
        "instagram": null
      },
      {
        "email": "[email protected]",
        "name": "My Contact Legal",
        "phone": "(42) 05555-4444",
        "cpf": null,
        "whatsapp": null,
        "site": null,
        "instagram": null
      },
      {
        "email": "[email protected]",
        "name": "My Contact Tecnico",
        "phone": "(42) 05555-4444",
        "cpf": null,
        "whatsapp": null,
        "site": null,
        "instagram": null
      }
    ]
  },
  "email": "[email protected]",
  "station": {
    "name": "CLIENTE01",
    "nome_fantasia": "FANTASIACLIENTE01",
    "cnpj": "00.000.000/0000-01",
    "cei": null,
    "cpf": null,
    "inscricao_estadual": null,
    "address": {
      "cep": "85555-222",
      "city": "Guarapuava",
      "complement": "Apto52",
      "country": "Brasil",
      "number": "101",
      "state": "PR",
      "street": "Rua Armando Ribas",
      "district": "Rua Armando Ribas"
    },
    "contact": {
      "email": "[email protected]",
      "name": "Contact2",
      "phone": "(42) 05555-4444",
      "cpf": null,
      "whatsapp": null,
      "site": null,
      "instagram": null
    }
  },
  "blocked": false,
  "avatar": {
    "url": "/assets/default-avatar.svg"
  },
  "accepted_terms": true,
  "uid": null,
  "platform_auth": "hora_do_ponto_platform_auth",
  "timezone": "America/Sao_Paulo",
  "permissions": [
    {
      "subject_class": "Ponto",
      "action": "create"
    }
  ]
}

Usuário > Cartão Ponto > Totais Diário

Obter os totais do dia

Este método retorna um objeto com os totais de um dia do cartão ponto do usuário atual.Somente é possível obter quando o usuário atual for do tipo “Funcionário”.

Endpoint

GET /v1/user/cartao_ponto/diario/:date

Parameters

Name Description
date (Date) Data do total do dia. Ex: "2012-01-01".

Request

Route

GET /v1/user/cartao_ponto/diario/2015-12-01

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/user/cartao_ponto/diario/2015-12-01" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
funcionario (Funcionario) Objeto funcionário (ver artigo funcionarios).
pontos_originais (Array) Lista de marcações originais do dia.
pontos_processados (Array) Lista de marcações processadas do dia.
total_trabalhado (Int) Total trabalhado em segundos.
extra (Int) Total de extra em segundos.
falta (Int) Total de falta em segundos.
atraso (Int) Total de atraso em segundos.
saida_antecipada (Int) Total de atraso em segundos.
adicional_noturno (Int) Total de adicional noturno em segundos.
extra_noturno (Int) Total de extra noturna em segundos.
ch (Int) Código do horário.
tratamentos[time] (Time) Hora ou Quantidade de hora total do tratamento.
tratamentos[type] (String) Tipo da Ocorrência. Ex: I = Inclusão.
tratamentos[tratamento] (Object) Objeto de Tratamento. Ex: Feriado, DSR, Banco de Horas, Inclusão de Ponto etc.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"2703eebcaa53abb6cf711bd74df3651d"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 5c90644f-4b48-4b5d-987c-0e9d7c7d2b6a
X-Runtime: 0.087331
Vary: Origin
Content-Length: 1758

Body

{
  "funcionario": {
    "cpf": "07155744989",
    "cracha": "1",
    "data_admissao": "2000-01-01",
    "data_demissao": null,
    "name": "Func1",
    "pis": "123929234315",
    "registro_folha": "1",
    "rg": null,
    "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [
      {
        "data": "2017-01-10",
        "funcao": "test",
        "name": "Auxiliar (123456)"
      },
      {
        "data": "2018-01-01",
        "funcao": "auxiliar",
        "name": null
      }
    ],
    "exames": [
      {
        "data": "2017-01-10",
        "apto": true,
        "tipo_exame": null,
        "observacoes": null,
        "arquivo": {
          "url": null
        }
      }
    ],
    "empresa": {
      "id": 471928375,
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "inscricao_estadual": null,
      "cpf": null,
      "created_at": "2026-04-06T22:37:18.000-03:00",
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "cliente_id": 571096427,
      "cei": null,
      "codigo_registro_folha": "23",
      "ativo": true,
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
    },
    "departamento": null,
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:18.000-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  },
  "pontos_originais": [
    "2000-01-01T07:45:00.000Z",
    "2000-01-01T08:45:00.000Z"
  ],
  "pontos_processados": [
    "2000-01-01T09:00:00.000Z"
  ],
  "total_trabalhado": 0,
  "extra": 0,
  "falta": 1800,
  "atraso": 0,
  "saida_antecipada": 0,
  "adicional_noturno": 0,
  "extra_noturno": null,
  "ch": 11,
  "tratamentos": [
    {
      "time": "09:00",
      "type": "I",
      "tratamento": {
        "data": "2015-12-01",
        "hora": "2000-01-01T09:00:00.000Z",
        "ordem": 0,
        "motivo": null,
        "category": "incluido"
      }
    },
    {
      "time": "01:00",
      "type": "I",
      "tratamento": {
        "data": "2015-12-01",
        "hora": null,
        "motivo": {
          "id": 621492253,
          "name": "B.H.(+)",
          "e_social_id": null
        },
        "forced": false
      }
    }
  ]
}

Usuário > Justificativas

Excluindo Justificativa não encontrada

Tentativa de exclusão de justificativa não encontrada como pendente.

Endpoint

DELETE /v1/user/justificativas/:id

Parameters

Name Description
id (Id) Id da justificativa.

Request

Route

DELETE /v1/user/justificativas/-1

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/user/justificativas/-1" -d '' -X DELETE \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
message (String) Mensagem de erro em caso de falha.

Status

404

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: 7ed85848-d03e-40c4-8f03-28a975058b1c
X-Runtime: 0.026723
Vary: Origin
Content-Length: 30

Body

{
  "message": "Record not found"
}

Excluindo Justificativa pendente

Este método serve para excluir uma justificativa com status pendente do usuário atual.

Endpoint

DELETE /v1/user/justificativas/:id

Parameters

Name Description
id (Id) Id da justificativa.

Request

Route

DELETE /v1/user/justificativas/962157260

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/user/justificativas/962157260" -d '' -X DELETE \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
message (String) Mensagem de erro em caso de falha.

Status

204

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Cache-Control: no-cache
X-Request-Id: 302c9d11-a36c-4245-9aa6-a885aa4d459d
X-Runtime: 0.027373
Vary: Origin

Listando as últimas Justificativas

Este método retorna uma coleção das Justificativas registradas.

Endpoint

GET /v1/user/justificativas

Parameters

Name Description
per_page (Int) Número de registros por página. Padrão: 5.
page (Int) Número da página de referência da paginação. Padrão: 1.

Request

Route

GET /v1/user/justificativas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/user/justificativas" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Int) ID da Justificativa.
data (Date) Data do requerimento.
data_final (Date) Data final do requerimento.
hora (DateTime) Quantidade de hora a justificar quando houver.
motivo (Motivo) Objeto Motivo [ver artigo sobre Motivos].
status (String) Estado da Justificativa Pendente.
rejection_motivation (String) Descrição do motivo da rejeição quando o processo é rejeitado.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Per-Page: 5
X-Current-Page: 1
X-Total-Entries: 11
X-Total-Pages: 3
Content-Type: application/json; charset=utf-8
ETag: W/"ff1d715df6ad281f53281d646d0a1797"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: d6ff57a4-90ac-462d-af98-61ce11a5d24f
X-Runtime: 0.054309
Vary: Origin
Content-Length: 1654

Body

[
  {
    "id": 962157260,
    "data": "2020-01-01",
    "hora": "2000-01-01T08:20:00.000Z",
    "motivo": {
      "id": 569982306,
      "name": "Atestado Médico",
      "e_social_id": null
    },
    "status": "pending",
    "description": "atestado medico",
    "file": null,
    "rejection_motivation": null,
    "data_final": null,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "updated_at": "2026-04-06T22:37:18.000-03:00"
  },
  {
    "id": 962157262,
    "data": "2000-01-01",
    "hora": "2000-01-01T01:00:00.000Z",
    "motivo": {
      "id": 569982306,
      "name": "Atestado Médico",
      "e_social_id": null
    },
    "status": "pending",
    "description": null,
    "file": null,
    "rejection_motivation": null,
    "data_final": null,
    "created_at": "2026-04-06T22:37:31.049-03:00",
    "updated_at": "2026-04-06T22:37:31.049-03:00"
  },
  {
    "id": 962157263,
    "data": "2000-01-01",
    "hora": "2000-01-01T01:00:00.000Z",
    "motivo": {
      "id": 569982306,
      "name": "Atestado Médico",
      "e_social_id": null
    },
    "status": "pending",
    "description": null,
    "file": null,
    "rejection_motivation": null,
    "data_final": null,
    "created_at": "2026-04-06T22:37:31.054-03:00",
    "updated_at": "2026-04-06T22:37:31.054-03:00"
  },
  {
    "id": 962157264,
    "data": "2000-01-01",
    "hora": "2000-01-01T01:00:00.000Z",
    "motivo": {
      "id": 569982306,
      "name": "Atestado Médico",
      "e_social_id": null
    },
    "status": "pending",
    "description": null,
    "file": null,
    "rejection_motivation": null,
    "data_final": null,
    "created_at": "2026-04-06T22:37:31.058-03:00",
    "updated_at": "2026-04-06T22:37:31.058-03:00"
  },
  {
    "id": 962157261,
    "data": "2000-01-01",
    "hora": "2000-01-01T01:00:00.000Z",
    "motivo": {
      "id": 569982306,
      "name": "Atestado Médico",
      "e_social_id": null
    },
    "status": "pending",
    "description": null,
    "file": null,
    "rejection_motivation": null,
    "data_final": null,
    "created_at": "2026-04-06T22:37:31.044-03:00",
    "updated_at": "2026-04-06T22:37:31.044-03:00"
  }
]

Listando os últimos 10 registros

Este método retorna uma coleção dos últimos 10 registros.

Endpoint

GET /v1/user/justificativas

Parameters

Name Description
per_page (Int) Número de registros por página. Padrão: 5.
page (Int) Número da página de referência da paginação. Padrão: 1.

Request

Route

GET /v1/user/justificativas?per_page=10

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

Query Parameters

per_page=10

cURL

curl -g "https://api.ptrp.com.br/v1/user/justificativas?per_page=10" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Int) ID da Justificativa.
data (Date) Data do requerimento.
data_final (Date) Data final do requerimento.
hora (DateTime) Quantidade de hora a justificar quando houver.
motivo (Motivo) Objeto Motivo [ver artigo sobre Motivos].
status (String) Estado da Justificativa Pendente.
rejection_motivation (String) Descrição do motivo da rejeição quando o processo é rejeitado.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Per-Page: 10
X-Current-Page: 1
X-Total-Entries: 11
X-Total-Pages: 2
Content-Type: application/json; charset=utf-8
ETag: W/"419674be2a3194f5330f4403dde44ab5"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 051ea4bf-eb5a-4ae9-8e3d-f5e8a0253109
X-Runtime: 0.053427
Vary: Origin
Content-Length: 3294

Body

[
  {
    "id": 962157260,
    "data": "2020-01-01",
    "hora": "2000-01-01T08:20:00.000Z",
    "motivo": {
      "id": 569982306,
      "name": "Atestado Médico",
      "e_social_id": null
    },
    "status": "pending",
    "description": "atestado medico",
    "file": null,
    "rejection_motivation": null,
    "data_final": null,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "updated_at": "2026-04-06T22:37:18.000-03:00"
  },
  {
    "id": 962157271,
    "data": "2000-01-01",
    "hora": "2000-01-01T01:00:00.000Z",
    "motivo": {
      "id": 569982306,
      "name": "Atestado Médico",
      "e_social_id": null
    },
    "status": "pending",
    "description": null,
    "file": null,
    "rejection_motivation": null,
    "data_final": null,
    "created_at": "2026-04-06T22:37:31.154-03:00",
    "updated_at": "2026-04-06T22:37:31.154-03:00"
  },
  {
    "id": 962157272,
    "data": "2000-01-01",
    "hora": "2000-01-01T01:00:00.000Z",
    "motivo": {
      "id": 569982306,
      "name": "Atestado Médico",
      "e_social_id": null
    },
    "status": "pending",
    "description": null,
    "file": null,
    "rejection_motivation": null,
    "data_final": null,
    "created_at": "2026-04-06T22:37:31.159-03:00",
    "updated_at": "2026-04-06T22:37:31.159-03:00"
  },
  {
    "id": 962157273,
    "data": "2000-01-01",
    "hora": "2000-01-01T01:00:00.000Z",
    "motivo": {
      "id": 569982306,
      "name": "Atestado Médico",
      "e_social_id": null
    },
    "status": "pending",
    "description": null,
    "file": null,
    "rejection_motivation": null,
    "data_final": null,
    "created_at": "2026-04-06T22:37:31.163-03:00",
    "updated_at": "2026-04-06T22:37:31.163-03:00"
  },
  {
    "id": 962157274,
    "data": "2000-01-01",
    "hora": "2000-01-01T01:00:00.000Z",
    "motivo": {
      "id": 569982306,
      "name": "Atestado Médico",
      "e_social_id": null
    },
    "status": "pending",
    "description": null,
    "file": null,
    "rejection_motivation": null,
    "data_final": null,
    "created_at": "2026-04-06T22:37:31.168-03:00",
    "updated_at": "2026-04-06T22:37:31.168-03:00"
  },
  {
    "id": 962157275,
    "data": "2000-01-01",
    "hora": "2000-01-01T01:00:00.000Z",
    "motivo": {
      "id": 569982306,
      "name": "Atestado Médico",
      "e_social_id": null
    },
    "status": "pending",
    "description": null,
    "file": null,
    "rejection_motivation": null,
    "data_final": null,
    "created_at": "2026-04-06T22:37:31.172-03:00",
    "updated_at": "2026-04-06T22:37:31.172-03:00"
  },
  {
    "id": 962157276,
    "data": "2000-01-01",
    "hora": "2000-01-01T01:00:00.000Z",
    "motivo": {
      "id": 569982306,
      "name": "Atestado Médico",
      "e_social_id": null
    },
    "status": "pending",
    "description": null,
    "file": null,
    "rejection_motivation": null,
    "data_final": null,
    "created_at": "2026-04-06T22:37:31.176-03:00",
    "updated_at": "2026-04-06T22:37:31.176-03:00"
  },
  {
    "id": 962157277,
    "data": "2000-01-01",
    "hora": "2000-01-01T01:00:00.000Z",
    "motivo": {
      "id": 569982306,
      "name": "Atestado Médico",
      "e_social_id": null
    },
    "status": "pending",
    "description": null,
    "file": null,
    "rejection_motivation": null,
    "data_final": null,
    "created_at": "2026-04-06T22:37:31.180-03:00",
    "updated_at": "2026-04-06T22:37:31.180-03:00"
  },
  {
    "id": 962157278,
    "data": "2000-01-01",
    "hora": "2000-01-01T01:00:00.000Z",
    "motivo": {
      "id": 569982306,
      "name": "Atestado Médico",
      "e_social_id": null
    },
    "status": "pending",
    "description": null,
    "file": null,
    "rejection_motivation": null,
    "data_final": null,
    "created_at": "2026-04-06T22:37:31.183-03:00",
    "updated_at": "2026-04-06T22:37:31.183-03:00"
  },
  {
    "id": 962157279,
    "data": "2000-01-01",
    "hora": "2000-01-01T01:00:00.000Z",
    "motivo": {
      "id": 569982306,
      "name": "Atestado Médico",
      "e_social_id": null
    },
    "status": "pending",
    "description": null,
    "file": null,
    "rejection_motivation": null,
    "data_final": null,
    "created_at": "2026-04-06T22:37:31.185-03:00",
    "updated_at": "2026-04-06T22:37:31.185-03:00"
  }
]

Registrando Justificativa

Este método registra a justificativa para o usuário atual.

Endpoint

POST /v1/user/justificativas

Parameters

Name Description
justificativa[data] required (Date) Data da justificativa.
justificativa[data_final] (Date) A data estabelece um período para inserção de justificativas, sendo a data inicial o campo "data".
justificativa[hora] (Time) Hora da justificativa.
justificativa[motivo_id] required (String) Tipo da operação (2 valores possiveis). "atestado" para justificativa de Atestado médico e "falta_marcacao" para marcações de correção.
justificativa[description] (String) Descrição livre para a justificativa.
justificativa[file] (String) Nome do arquivo.

Request

Route

POST /v1/user/justificativas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

Body

{
  "justificativa": {
    "data": "2019-1-2",
    "motivo_id": "atestado",
    "description": "livre"
  }
}

cURL

curl "https://api.ptrp.com.br/v1/user/justificativas" -d '{"justificativa":{"data":"2019-1-2","motivo_id":"atestado","description":"livre"}}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Int) ID da Justificativa.
data (Date) Data do requerimento.
data_final (Date) Data final do requerimento.
hora (DateTime) Quantidade de hora a justificar quando houver.
motivo (Motivo) Objeto Motivo [ver artigo sobre Motivos].
message (String) Mensagem de erro da requisição.
file (String) Caminho do arquivo.
errors (Object) Objeto de erros de validação.

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"1d13b920d298e044fa79daac049eb2ea"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 0a14d2cf-dcc9-4988-a56a-fc4471d24493
X-Runtime: 0.035888
Vary: Origin
Content-Length: 308

Body

{
  "id": 962157291,
  "data": "2019-01-02",
  "hora": null,
  "motivo": {
    "id": 569982306,
    "name": "Atestado Médico",
    "e_social_id": null
  },
  "status": "pending",
  "description": "livre",
  "file": null,
  "rejection_motivation": null,
  "data_final": null,
  "created_at": "2026-04-06T22:37:31.328-03:00",
  "updated_at": "2026-04-06T22:37:31.328-03:00"
}

Registrando Justificativa - Erro de validação

Este método mostra falha no registro da Justificativa.

Endpoint

POST /v1/user/justificativas

Parameters

Name Description
justificativa[data] required (Date) Data da justificativa.
justificativa[data_final] (Date) A data estabelece um período para inserção de justificativas, sendo a data inicial o campo "data".
justificativa[hora] (Time) Hora da justificativa.
justificativa[motivo_id] required (String) Tipo da operação (2 valores possiveis). "atestado" para justificativa de Atestado médico e "falta_marcacao" para marcações de correção.
justificativa[description] (String) Descrição livre para a justificativa.
justificativa[file] (String) Nome do arquivo.

Request

Route

POST /v1/user/justificativas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/user/justificativas" -d '' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Int) ID da Justificativa.
data (Date) Data do requerimento.
data_final (Date) Data final do requerimento.
hora (DateTime) Quantidade de hora a justificar quando houver.
motivo (Motivo) Objeto Motivo [ver artigo sobre Motivos].
message (String) Mensagem de erro da requisição.
file (String) Caminho do arquivo.
errors (Object) Objeto de erros de validação.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: 9c4d1335-aed8-42bc-b5f6-654fcb174a60
X-Runtime: 0.032155
Vary: Origin
Content-Length: 175

Body

{
  "message": "An error occurred while creating Justificativa.",
  "errors": {
    "data": [
      "can't be blank",
      "Invalid Date format"
    ],
    "motivo_id": [
      "can't be blank",
      "Resource not allowed."
    ]
  }
}

Registrando Justificativa com foto

Este método registra a justificativa com foto.

Endpoint

POST /v1/user/justificativas

Parameters

Name Description
justificativa[data] required (Date) Data da justificativa.
justificativa[data_final] (Date) A data estabelece um período para inserção de justificativas, sendo a data inicial o campo "data".
justificativa[hora] (Time) Hora da justificativa.
justificativa[motivo_id] required (String) Tipo da operação (2 valores possiveis). "atestado" para justificativa de Atestado médico e "falta_marcacao" para marcações de correção.
justificativa[description] (String) Descrição livre para a justificativa.
justificativa[file] (String) Nome do arquivo.

Request

Route

POST /v1/user/justificativas

Headers

Host: api.ptrp.com.br
Content-Type: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

Body

------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="justificativa[data]"

2019-1-3
------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="justificativa[motivo_id]"

atestado
------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="justificativa[file]"; filename="atestado.png"
Content-Type: image/png
Content-Length: 23244

[uploaded data]
------------XnJLe9ZIbbGUYtzPQJ16u1--

cURL

curl "https://api.ptrp.com.br/v1/user/justificativas" -d '------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="justificativa[data]"

2019-1-3
------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="justificativa[motivo_id]"

atestado
------------XnJLe9ZIbbGUYtzPQJ16u1
Content-Disposition: form-data; name="justificativa[file]"; filename="atestado.png"
Content-Type: image/png
Content-Length: 23244

[uploaded data]
------------XnJLe9ZIbbGUYtzPQJ16u1--
' -X POST \
	-H "Content-Type: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Int) ID da Justificativa.
data (Date) Data do requerimento.
data_final (Date) Data final do requerimento.
hora (DateTime) Quantidade de hora a justificar quando houver.
motivo (Motivo) Objeto Motivo [ver artigo sobre Motivos].
message (String) Mensagem de erro da requisição.
file (String) Caminho do arquivo.
errors (Object) Objeto de erros de validação.

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"7fb00c04401e477cd586769c0938477d"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 80fab3a4-f1dd-4030-8683-c421ba1b427c
X-Runtime: 0.039667
Vary: Origin
Content-Length: 393

Body

{
  "id": 962157313,
  "data": "2019-01-03",
  "hora": null,
  "motivo": {
    "id": 569982306,
    "name": "Atestado Médico",
    "e_social_id": null
  },
  "status": "pending",
  "description": null,
  "file": "/uploads/cartao_ponto_justificativa_pendente/file/2026/04/600348341/962157313/atestado.png",
  "rejection_motivation": null,
  "data_final": null,
  "created_at": "2026-04-06T22:37:31.503-03:00",
  "updated_at": "2026-04-06T22:37:31.503-03:00"
}

Registrando Justificativa para várias datas

Este método registra a justificativa para várias datas, entre a data inicial e data final.

Endpoint

POST /v1/user/justificativas

Parameters

Name Description
justificativa[data] required (Date) Data da justificativa.
justificativa[data_final] (Date) A data estabelece um período para inserção de justificativas, sendo a data inicial o campo "data".
justificativa[hora] (Time) Hora da justificativa.
justificativa[motivo_id] required (String) Tipo da operação (2 valores possiveis). "atestado" para justificativa de Atestado médico e "falta_marcacao" para marcações de correção.
justificativa[description] (String) Descrição livre para a justificativa.
justificativa[file] (String) Nome do arquivo.

Request

Route

POST /v1/user/justificativas

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

Body

{
  "justificativa": {
    "data": "2019-1-2",
    "data_final": "2019-1-3",
    "motivo_id": "atestado",
    "description": "livre"
  }
}

cURL

curl "https://api.ptrp.com.br/v1/user/justificativas" -d '{"justificativa":{"data":"2019-1-2","data_final":"2019-1-3","motivo_id":"atestado","description":"livre"}}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id (Int) ID da Justificativa.
data (Date) Data do requerimento.
data_final (Date) Data final do requerimento.
hora (DateTime) Quantidade de hora a justificar quando houver.
motivo (Motivo) Objeto Motivo [ver artigo sobre Motivos].
message (String) Mensagem de erro da requisição.
file (String) Caminho do arquivo.
errors (Object) Objeto de erros de validação.

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"5ed7b474d800034d5cd6ca38de7f712f"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 7cf6a5f0-6fa6-4f1e-8f77-1bb302e7b5be
X-Runtime: 0.029681
Vary: Origin
Content-Length: 316

Body

{
  "id": 962157302,
  "data": "2019-01-02",
  "hora": null,
  "motivo": {
    "id": 569982306,
    "name": "Atestado Médico",
    "e_social_id": null
  },
  "status": "pending",
  "description": "livre",
  "file": null,
  "rejection_motivation": null,
  "data_final": "2019-01-03",
  "created_at": "2026-04-06T22:37:31.411-03:00",
  "updated_at": "2026-04-06T22:37:31.411-03:00"
}

Usuário > Pontos

Filtrando pontos por data

Este método retorna uma coleção dos Pontos filtrados por data.

Endpoint

GET /v1/user/pontos

Parameters

Name Description
data (Date) Filtro por data. Ex: "01/02/2014".
per_page (Int) Número de registros por página. Padrão: 5.
page (Int) Número da página de referência da paginação. Padrão: 1.

Request

Route

GET /v1/user/pontos?data=01%2F02%2F2014&per_page=10

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Cookie:

Query Parameters

data=01/02/2014
per_page=10

cURL

curl -g "https://api.ptrp.com.br/v1/user/pontos?data=01%2F02%2F2014&per_page=10" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Platform-Auth: mobile" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
data (Date) Data de registro do ponto.
hora (DateTime) Hora do registro do ponto.
equipamento_id (Int) Id do equipamento que foi registrado o ponto.
processado (Boolean) Se a coleta que pertence o ponto já foi processada.
nsr (Int) Número sequencial de registro.
registro_inpi (String) Número do registro INPI.
coletor_id (Int) Identificação do equipamento de coleta. Valores: 1 - Mobile, 2 - Web.
offline (Bool) Se o ponto foi registrado offline.
cpf (Int) CPF do funcionário.
codigo_hash (String) SHA-256 dos dados registrados.
utc_offset (String) Deslocamento UTC da marcação.
ponto_geo_locale[latitude] (Float) Latitude do registro do Ponto (quando disponível).
ponto_geo_locale[longitude] (Float) Longitude do registro do Ponto (quando disponível).
X-Current-Page (Int) [Header] Página atual da paginação.
X-Per-Page (Int) [Header] Número máximo de registros da resposta à requisição.
X-Total-Entries (Int) [Header] Total de registros da consulta.
X-Total-Pages (Int) [Header] Total de páginas da consulta.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Per-Page: 10
X-Current-Page: 1
X-Total-Entries: 6
X-Total-Pages: 1
Content-Type: application/json; charset=utf-8
ETag: W/"790fedf7d4f0b9494fabdca59c21a9d2"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 706785ec-7ed2-4ca7-a1c8-fc35f84ff5e9
X-Runtime: 0.097213
Vary: Origin
Content-Length: 8881

Body

[
  {
    "id": 352529519,
    "data": "2014-02-01",
    "hora": "06:45",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.262-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 202014167,
    "data": "2014-02-01",
    "hora": "09:53",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.262-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 990727490,
    "data": "2014-02-01",
    "hora": "13:01",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.262-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 627693797,
    "data": "2014-02-01",
    "hora": "16:09",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.262-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 309258358,
    "data": "2014-02-01",
    "hora": "19:17",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.262-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 191347150,
    "data": "2014-02-01",
    "hora": "22:25",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.262-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  }
]

Listando os 10 últimos pontos da segunda página

Este método retorna uma coleção dos últimos 10 Pontos registrados da segunda página.

Endpoint

GET /v1/user/pontos

Parameters

Name Description
data (Date) Filtro por data. Ex: "01/02/2014".
per_page (Int) Número de registros por página. Padrão: 5.
page (Int) Número da página de referência da paginação. Padrão: 1.

Request

Route

GET /v1/user/pontos?per_page=10&page=2

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Cookie:

Query Parameters

per_page=10
page=2

cURL

curl -g "https://api.ptrp.com.br/v1/user/pontos?per_page=10&page=2" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Platform-Auth: mobile" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
data (Date) Data de registro do ponto.
hora (DateTime) Hora do registro do ponto.
equipamento_id (Int) Id do equipamento que foi registrado o ponto.
processado (Boolean) Se a coleta que pertence o ponto já foi processada.
nsr (Int) Número sequencial de registro.
registro_inpi (String) Número do registro INPI.
coletor_id (Int) Identificação do equipamento de coleta. Valores: 1 - Mobile, 2 - Web.
offline (Bool) Se o ponto foi registrado offline.
cpf (Int) CPF do funcionário.
codigo_hash (String) SHA-256 dos dados registrados.
utc_offset (String) Deslocamento UTC da marcação.
ponto_geo_locale[latitude] (Float) Latitude do registro do Ponto (quando disponível).
ponto_geo_locale[longitude] (Float) Longitude do registro do Ponto (quando disponível).
X-Current-Page (Int) [Header] Página atual da paginação.
X-Per-Page (Int) [Header] Número máximo de registros da resposta à requisição.
X-Total-Entries (Int) [Header] Total de registros da consulta.
X-Total-Pages (Int) [Header] Total de páginas da consulta.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Per-Page: 10
X-Current-Page: 2
X-Total-Entries: 175
X-Total-Pages: 18
Content-Type: application/json; charset=utf-8
ETag: W/"27f4030abc99b79ccf88b538304e0511"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 6e2f77f6-d2d3-4bde-a5f0-aa56654800f2
X-Runtime: 0.144796
Vary: Origin
Content-Length: 14800

Body

[
  {
    "id": 611529108,
    "data": "2014-02-28",
    "hora": "16:09",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.101-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 326369541,
    "data": "2014-02-28",
    "hora": "19:17",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.101-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 175984833,
    "data": "2014-02-28",
    "hora": "22:25",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.101-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 524648993,
    "data": "2014-02-27",
    "hora": "06:45",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.101-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 105698205,
    "data": "2014-02-27",
    "hora": "09:53",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.101-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 827056912,
    "data": "2014-02-27",
    "hora": "13:01",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.101-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 791639727,
    "data": "2014-02-27",
    "hora": "16:09",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.101-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 405292600,
    "data": "2014-02-27",
    "hora": "19:17",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.101-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 18945924,
    "data": "2014-02-27",
    "hora": "22:25",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.101-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 512223254,
    "data": "2014-02-26",
    "hora": "06:45",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.101-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  }
]

Listando os últimos 10 pontos

Este método retorna uma coleção dos últimos 10 Pontos registrados.

Endpoint

GET /v1/user/pontos

Parameters

Name Description
data (Date) Filtro por data. Ex: "01/02/2014".
per_page (Int) Número de registros por página. Padrão: 5.
page (Int) Número da página de referência da paginação. Padrão: 1.

Request

Route

GET /v1/user/pontos?per_page=10

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Cookie:

Query Parameters

per_page=10

cURL

curl -g "https://api.ptrp.com.br/v1/user/pontos?per_page=10" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Platform-Auth: mobile" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
data (Date) Data de registro do ponto.
hora (DateTime) Hora do registro do ponto.
equipamento_id (Int) Id do equipamento que foi registrado o ponto.
processado (Boolean) Se a coleta que pertence o ponto já foi processada.
nsr (Int) Número sequencial de registro.
registro_inpi (String) Número do registro INPI.
coletor_id (Int) Identificação do equipamento de coleta. Valores: 1 - Mobile, 2 - Web.
offline (Bool) Se o ponto foi registrado offline.
cpf (Int) CPF do funcionário.
codigo_hash (String) SHA-256 dos dados registrados.
utc_offset (String) Deslocamento UTC da marcação.
ponto_geo_locale[latitude] (Float) Latitude do registro do Ponto (quando disponível).
ponto_geo_locale[longitude] (Float) Longitude do registro do Ponto (quando disponível).
X-Current-Page (Int) [Header] Página atual da paginação.
X-Per-Page (Int) [Header] Número máximo de registros da resposta à requisição.
X-Total-Entries (Int) [Header] Total de registros da consulta.
X-Total-Pages (Int) [Header] Total de páginas da consulta.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Per-Page: 10
X-Current-Page: 1
X-Total-Entries: 175
X-Total-Pages: 18
Content-Type: application/json; charset=utf-8
ETag: W/"b2ca29ca4cad725ed8832daf699e5c15"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: b549f8b6-e80e-4d67-9838-c1daa303f385
X-Runtime: 0.134351
Vary: Origin
Content-Length: 15034

Body

[
  {
    "id": 762123699,
    "data": "2022-04-01",
    "hora": "12:00",
    "equipamento_id": 51636476,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": 3,
    "registro_inpi": "BR512022000771-1",
    "coletor_id": 1,
    "offline": true,
    "created_at": "2022-03-01T12:00:00.000-03:00",
    "cpf": "07155744989",
    "codigo_hash": "eaefbae245c609cf2bdb02a320dfdc30e1d7dbd0b390512b91315a3cdf54c23a",
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:31.953-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 215362412,
    "data": "2022-03-01",
    "hora": "08:00",
    "equipamento_id": 51636476,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": 1,
    "registro_inpi": "BR512022000771-1",
    "coletor_id": 2,
    "offline": false,
    "created_at": "2022-03-01T08:00:00.000-03:00",
    "cpf": "07155744989",
    "codigo_hash": "faefbae245c609cf2bdb07a320dfdc30e1d7dbd0b390512b95059a3cdf64c25c",
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:31.953-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 192303549,
    "data": "2022-03-01",
    "hora": "12:00",
    "equipamento_id": 51636476,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": 2,
    "registro_inpi": "BR512022000771-1",
    "coletor_id": 2,
    "offline": false,
    "created_at": "2022-03-01T12:00:00.000-03:00",
    "cpf": "07155744989",
    "codigo_hash": "eaefbae245c609cf2bdb02a320dfdc30e1d7dbd0b390512b91345a3cdf64c23c",
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:31.953-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 729814102,
    "data": "2015-12-01",
    "hora": "07:45",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:31.953-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 478618823,
    "data": "2015-12-01",
    "hora": "08:45",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:31.953-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 762265178,
    "data": "2015-11-01",
    "hora": "07:45",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:31.953-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 443027153,
    "data": "2015-11-01",
    "hora": "10:45",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:31.953-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 337233180,
    "data": "2014-02-28",
    "hora": "06:45",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:31.953-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 219190440,
    "data": "2014-02-28",
    "hora": "09:53",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:31.953-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 974627891,
    "data": "2014-02-28",
    "hora": "13:01",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:31.953-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  }
]

Listando os últimos 5 pontos

Este método retorna uma coleção dos últimos 5 Pontos registrados.

Endpoint

GET /v1/user/pontos

Parameters

Name Description
data (Date) Filtro por data. Ex: "01/02/2014".
per_page (Int) Número de registros por página. Padrão: 5.
page (Int) Número da página de referência da paginação. Padrão: 1.

Request

Route

GET /v1/user/pontos

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/user/pontos" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Platform-Auth: mobile" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
data (Date) Data de registro do ponto.
hora (DateTime) Hora do registro do ponto.
equipamento_id (Int) Id do equipamento que foi registrado o ponto.
processado (Boolean) Se a coleta que pertence o ponto já foi processada.
nsr (Int) Número sequencial de registro.
registro_inpi (String) Número do registro INPI.
coletor_id (Int) Identificação do equipamento de coleta. Valores: 1 - Mobile, 2 - Web.
offline (Bool) Se o ponto foi registrado offline.
cpf (Int) CPF do funcionário.
codigo_hash (String) SHA-256 dos dados registrados.
utc_offset (String) Deslocamento UTC da marcação.
ponto_geo_locale[latitude] (Float) Latitude do registro do Ponto (quando disponível).
ponto_geo_locale[longitude] (Float) Longitude do registro do Ponto (quando disponível).
X-Current-Page (Int) [Header] Página atual da paginação.
X-Per-Page (Int) [Header] Número máximo de registros da resposta à requisição.
X-Total-Entries (Int) [Header] Total de registros da consulta.
X-Total-Pages (Int) [Header] Total de páginas da consulta.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Per-Page: 5
X-Current-Page: 1
X-Total-Entries: 172
X-Total-Pages: 35
Content-Type: application/json; charset=utf-8
ETag: W/"2eae1e3ff4a015c42a8f78b3e1285bc8"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: abb15a8e-9303-42cf-924d-3e933a90cf80
X-Runtime: 0.095382
Vary: Origin
Content-Length: 7401

Body

[
  {
    "id": 729814102,
    "data": "2015-12-01",
    "hora": "07:45",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:31.845-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 478618823,
    "data": "2015-12-01",
    "hora": "08:45",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:31.845-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 762265178,
    "data": "2015-11-01",
    "hora": "07:45",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:31.845-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 443027153,
    "data": "2015-11-01",
    "hora": "10:45",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:31.845-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  },
  {
    "id": 337233180,
    "data": "2014-02-28",
    "hora": "06:45",
    "equipamento_id": 193764514,
    "processado": false,
    "ponto_geo_locale": null,
    "nsr": null,
    "registro_inpi": null,
    "coletor_id": null,
    "offline": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "cpf": null,
    "codigo_hash": null,
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:31.845-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  }
]

Obtendo o comprovante em formato pdf do ponto

Este método retorna o arquivo do comprovante do ponto em formato pdf.

Endpoint

GET /v1/user/pontos/:id.pdf

Parameters

Name Description
id (Int) ID do Ponto.

Request

Route

GET /v1/user/pontos/215362412.pdf?logo=%23%3CRack%3A%3ATest%3A%3AUploadedFile%3A0x00006250ab2b5850%3E

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Cookie:

Query Parameters

logo=#<Rack::Test::UploadedFile:0x00006250ab2b5850>

cURL

curl -g "https://api.ptrp.com.br/v1/user/pontos/215362412.pdf?logo=%23%3CRack%3A%3ATest%3A%3AUploadedFile%3A0x00006250ab2b5850%3E" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Platform-Auth: mobile" \
	-H "Cookie: "

Response

Simulated Response

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Disposition: attachment; filename="comprovante-1.pdf"
Content-Transfer-Encoding: binary
Content-Type: application/pdf
Cache-Control: private
X-Request-Id: 6a9e1704-6955-4a13-9c4d-739be376f8b9
X-Runtime: 0.520611
Vary: Origin
Content-Length: 291298

Body

[binary data]

Registrando Ponto

Este método registra o ponto para o usuário atual.

Endpoint

POST /v1/user/pontos

Parameters

Name Description
platform-auth (String) [Header] Cabeçalho responsável por identificação da plataforma logada. Valores possíveis: "web" e "mobile". Valor padrão: "web".
ponto[latitude] (Float) Latitude do registro do Ponto (quando disponível).
ponto[longitude] (Float) Longitude do registro do Ponto (quando disponível).

Request

Route

POST /v1/user/pontos

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Cookie:

Body

{
  "ponto": {
    "latitude": 10,
    "longitude": 15
  }
}

cURL

curl "https://api.ptrp.com.br/v1/user/pontos" -d '{"ponto":{"latitude":10,"longitude":15}}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Platform-Auth: mobile" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
data (Date) Data de registro do ponto.
hora (DateTime) Hora do registro do ponto.
equipamento_id (Int) Id do equipamento que foi registrado o ponto.
processado (Boolean) Se a coleta que pertence o ponto já foi processada.
nsr (Int) Número sequencial de registro.
registro_inpi (String) Número do registro INPI.
coletor_id (Int) Identificação do equipamento de coleta. Valores: 1 - Mobile, 2 - Web.
offline (Bool) Se o ponto foi registrado offline.
cpf (Int) CPF do funcionário.
codigo_hash (String) SHA-256 dos dados registrados.
utc_offset (String) Deslocamento UTC da marcação.
ponto_geo_locale[latitude] (Float) Latitude do registro do Ponto (quando disponível).
ponto_geo_locale[longitude] (Float) Longitude do registro do Ponto (quando disponível).
message (String) Mensagem de reposta da requisição.

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"260d05064a6dcf3ebd2ec5bc5f5cf591"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 8336ec87-af70-44bb-8143-6cab6e431740
X-Runtime: 0.053084
Vary: Origin
Content-Length: 1588

Body

{
  "id": 1071408925,
  "data": "2026-04-06",
  "hora": "22:37",
  "equipamento_id": 51636476,
  "processado": false,
  "ponto_geo_locale": {
    "latitude": 10.0,
    "longitude": 15.0
  },
  "nsr": 1,
  "registro_inpi": "BR512022000771-1",
  "coletor_id": 1,
  "offline": false,
  "created_at": "2026-04-06T22:37:32.422-03:00",
  "cpf": "07155744989",
  "codigo_hash": "b357e56d7366e2dcbf7d469fad5d9a1c8b47f699a46e08f853eacac2d27743a7",
  "utc_offset": "-0300",
  "funcionario": {
    "cpf": "07155744989",
    "cracha": "1",
    "data_admissao": "2017-01-01",
    "data_demissao": null,
    "name": "Func1",
    "pis": "123929234315",
    "registro_folha": "123",
    "rg": null,
    "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
    "nacionalidade": null,
    "nome_da_mae": null,
    "nome_do_pai": null,
    "estado_civil": null,
    "conjuge": null,
    "nascimento": null,
    "ctps": null,
    "cnh": null,
    "certidao_militar": null,
    "tipo_sanguineo": null,
    "escolaridade": null,
    "observacoes": null,
    "cargos": [
      {
        "data": "2017-01-10",
        "funcao": "test",
        "name": "Auxiliar (123456)"
      },
      {
        "data": "2018-01-01",
        "funcao": "auxiliar",
        "name": null
      }
    ],
    "exames": [
      {
        "data": "2017-01-10",
        "apto": true,
        "tipo_exame": null,
        "observacoes": null,
        "arquivo": {
          "url": null
        }
      }
    ],
    "empresa": {
      "id": 471928375,
      "name": "Empresa03",
      "nome_fantasia": "EmpFantasia03",
      "cnpj": "00.000.000/0000-03",
      "inscricao_estadual": null,
      "cpf": null,
      "created_at": "2026-04-06T22:37:18.000-03:00",
      "updated_at": "2026-04-06T22:37:18.000-03:00",
      "cliente_id": 571096427,
      "cei": null,
      "codigo_registro_folha": "23",
      "ativo": true,
      "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
    },
    "departamento": null,
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2026-04-06T22:37:32.377-03:00",
    "created_at": "2026-04-06T22:37:18.000-03:00"
  }
}

Registrando Ponto - Equipamento não permitido

Este método mostra falha no registro quando o equipamento do tipo App não está criado.

Endpoint

POST /v1/user/pontos

Parameters

Name Description
platform-auth (String) [Header] Cabeçalho responsável por identificação da plataforma logada. Valores possíveis: "web" e "mobile". Valor padrão: "web".
ponto[latitude] (Float) Latitude do registro do Ponto (quando disponível).
ponto[longitude] (Float) Longitude do registro do Ponto (quando disponível).

Request

Route

POST /v1/user/pontos

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/user/pontos" -d '' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Platform-Auth: mobile" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
data (Date) Data de registro do ponto.
hora (DateTime) Hora do registro do ponto.
equipamento_id (Int) Id do equipamento que foi registrado o ponto.
processado (Boolean) Se a coleta que pertence o ponto já foi processada.
nsr (Int) Número sequencial de registro.
registro_inpi (String) Número do registro INPI.
coletor_id (Int) Identificação do equipamento de coleta. Valores: 1 - Mobile, 2 - Web.
offline (Bool) Se o ponto foi registrado offline.
cpf (Int) CPF do funcionário.
codigo_hash (String) SHA-256 dos dados registrados.
utc_offset (String) Deslocamento UTC da marcação.
ponto_geo_locale[latitude] (Float) Latitude do registro do Ponto (quando disponível).
ponto_geo_locale[longitude] (Float) Longitude do registro do Ponto (quando disponível).
message (String) Mensagem de reposta da requisição.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: f817e124-4f6c-45c3-abd1-9717a2545499
X-Runtime: 0.031824
Vary: Origin
Content-Length: 101

Body

{
  "message": "Something went wrong while creating the Ponto. Equipamento não cadastrado.",
  "errors": {
  }
}

Registrando Ponto offline inválido

Este método tenta registrar uma lista de os pontos offline inválidos.

Endpoint

POST /v1/user/pontos/offline

Parameters

Name Description
pontos (Array) Coleção de objetos de ponto a serem inseridos.
ponto[data] (Date) Data de registro do ponto.
ponto[hora] (DateTime) Hora do registro do ponto.
ponto[latitude] (Float) Latitude do registro do Ponto (quando disponível).
ponto[longitude] (Float) Longitude do registro do Ponto (quando disponível).

Request

Route

POST /v1/user/pontos/offline

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Cookie:

Body

{
  "pontos": [
    {
      "data": "",
      "hora": "10:00"
    }
  ]
}

cURL

curl "https://api.ptrp.com.br/v1/user/pontos/offline" -d '{"pontos":[{"data":"","hora":"10:00"}]}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Platform-Auth: mobile" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
data (Date) Data de registro do ponto.
hora (DateTime) Hora do registro do ponto.
equipamento_id (Int) Id do equipamento que foi registrado o ponto.
processado (Boolean) Se a coleta que pertence o ponto já foi processada.
nsr (Int) Número sequencial de registro.
registro_inpi (String) Número do registro INPI.
coletor_id (Int) Identificação do equipamento de coleta. Valores: 1 - Mobile, 2 - Web.
offline (Bool) Se o ponto foi registrado offline.
cpf (Int) CPF do funcionário.
codigo_hash (String) SHA-256 dos dados registrados.
utc_offset (String) Deslocamento UTC da marcação.
ponto_geo_locale[latitude] (Float) Latitude do registro do Ponto (quando disponível).
ponto_geo_locale[longitude] (Float) Longitude do registro do Ponto (quando disponível).

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: 63da33b7-2677-43e6-ac2f-7d2a2414f81d
X-Runtime: 0.038563
Vary: Origin
Content-Length: 85

Body

{
  "message": "Something went wrong while creating the Ponto. invalid date",
  "errors": {
  }
}

Registrando Pontos offline

Este método registra uma lista de os pontos offline para o usuário atual.

Endpoint

POST /v1/user/pontos/offline

Parameters

Name Description
pontos (Array) Coleção de objetos de ponto a serem inseridos.
ponto[data] (Date) Data de registro do ponto.
ponto[hora] (DateTime) Hora do registro do ponto.
ponto[latitude] (Float) Latitude do registro do Ponto (quando disponível).
ponto[longitude] (Float) Longitude do registro do Ponto (quando disponível).

Request

Route

POST /v1/user/pontos/offline

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Cookie:

Body

{
  "pontos": [
    {
      "latitude": 10,
      "longitude": 15,
      "data": "2020-01-01",
      "hora": "10:00"
    }
  ]
}

cURL

curl "https://api.ptrp.com.br/v1/user/pontos/offline" -d '{"pontos":[{"latitude":10,"longitude":15,"data":"2020-01-01","hora":"10:00"}]}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Platform-Auth: mobile" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
data (Date) Data de registro do ponto.
hora (DateTime) Hora do registro do ponto.
equipamento_id (Int) Id do equipamento que foi registrado o ponto.
processado (Boolean) Se a coleta que pertence o ponto já foi processada.
nsr (Int) Número sequencial de registro.
registro_inpi (String) Número do registro INPI.
coletor_id (Int) Identificação do equipamento de coleta. Valores: 1 - Mobile, 2 - Web.
offline (Bool) Se o ponto foi registrado offline.
cpf (Int) CPF do funcionário.
codigo_hash (String) SHA-256 dos dados registrados.
utc_offset (String) Deslocamento UTC da marcação.
ponto_geo_locale[latitude] (Float) Latitude do registro do Ponto (quando disponível).
ponto_geo_locale[longitude] (Float) Longitude do registro do Ponto (quando disponível).

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"5636bc41d9830744d25534784b83b42e"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 6d3314fe-7d35-4b5a-b8ee-22197a6efe48
X-Runtime: 0.065362
Vary: Origin
Content-Length: 1589

Body

[
  {
    "id": 1071408931,
    "data": "2020-01-01",
    "hora": "10:00",
    "equipamento_id": 51636476,
    "processado": false,
    "ponto_geo_locale": {
      "latitude": 10.0,
      "longitude": 15.0
    },
    "nsr": 1,
    "registro_inpi": "BR512022000771-1",
    "coletor_id": 1,
    "offline": true,
    "created_at": "2026-04-06T22:37:32.886-03:00",
    "cpf": "07155744989",
    "codigo_hash": "06a68d52ca0e992b8d4e0d5373ae5b2c5881cc20baa6445cd9579a69a5a936b1",
    "utc_offset": "-0300",
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": "2017-01-01",
      "data_demissao": null,
      "name": "Func1",
      "pis": "123929234315",
      "registro_folha": "123",
      "rg": null,
      "uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
      "nacionalidade": null,
      "nome_da_mae": null,
      "nome_do_pai": null,
      "estado_civil": null,
      "conjuge": null,
      "nascimento": null,
      "ctps": null,
      "cnh": null,
      "certidao_militar": null,
      "tipo_sanguineo": null,
      "escolaridade": null,
      "observacoes": null,
      "cargos": [
        {
          "data": "2017-01-10",
          "funcao": "test",
          "name": "Auxiliar (123456)"
        },
        {
          "data": "2018-01-01",
          "funcao": "auxiliar",
          "name": null
        }
      ],
      "exames": [
        {
          "data": "2017-01-10",
          "apto": true,
          "tipo_exame": null,
          "observacoes": null,
          "arquivo": {
            "url": null
          }
        }
      ],
      "empresa": {
        "id": 471928375,
        "name": "Empresa03",
        "nome_fantasia": "EmpFantasia03",
        "cnpj": "00.000.000/0000-03",
        "inscricao_estadual": null,
        "cpf": null,
        "created_at": "2026-04-06T22:37:18.000-03:00",
        "updated_at": "2026-04-06T22:37:18.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444ded33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2026-04-06T22:37:32.831-03:00",
      "created_at": "2026-04-06T22:37:18.000-03:00"
    }
  }
]

Versions

Creating a version

This method creates a new version.

Endpoint

POST /v1/versions

Parameters

Name Description
version[name] required String name.
version[apelido] required String label.
version[data_lancamento] required Date of release.
version[descricao] required String for description.
version[versao_atual] Boolean indicates if version is in use.
version[branch_url] String with url of the integration branch. Only for admin user.

Request

Route

POST /v1/versions

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: ye8dx4vyN3__i4ku-gm_
Cookie:

Body

{
  "version": {
    "name": "v1",
    "apelido": "v one",
    "data_lancamento": "2017-01-01",
    "descricao": "Description"
  }
}

cURL

curl "https://api.ptrp.com.br/v1/versions" -d '{"version":{"name":"v1","apelido":"v one","data_lancamento":"2017-01-01","descricao":"Description"}}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: ye8dx4vyN3__i4ku-gm_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id Id of version.
apelido String label.
data_lancamento Date of release.
descricao String for description.
name String name.
versao_atual Boolean indicates if version is in use.
created_at Date of creation.
updated_at Date of update.
branch_url String with url of the integration branch. Only for admin user.
message String alert about response.
errors Object with field names that contain validation errors.
errors[name] Array of error messages of field name.
errors[apelido] Array of error messages of field apelido.
errors[data_lancamento] Array of error messages of field data_lancamento.
errors[descricao] Array of error messages of field descricao.

Status

201

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"700e04282dedd50a3a96fc0a7fd99f02"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 5e28511f-8e3e-425e-992b-5e8dea6ab0df
X-Runtime: 0.030332
Vary: Origin
Content-Length: 231

Body

{
  "id": 980190963,
  "apelido": "v one",
  "data_lancamento": "2017-01-01",
  "descricao": "Description",
  "name": "v1",
  "versao_atual": null,
  "created_at": "2026-04-06T22:37:33.934-03:00",
  "updated_at": "2026-04-06T22:37:33.934-03:00",
  "branch_url": null
}

Creating a version - errors

This method shows validation fails.

Endpoint

POST /v1/versions

Parameters

Name Description
version[name] required String name.
version[apelido] required String label.
version[data_lancamento] required Date of release.
version[descricao] required String for description.
version[versao_atual] Boolean indicates if version is in use.
version[branch_url] String with url of the integration branch. Only for admin user.

Request

Route

POST /v1/versions

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: ye8dx4vyN3__i4ku-gm_
Cookie:

Body

{
  "version": {
    "name": ""
  }
}

cURL

curl "https://api.ptrp.com.br/v1/versions" -d '{"version":{"name":""}}' -X POST \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: ye8dx4vyN3__i4ku-gm_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id Id of version.
apelido String label.
data_lancamento Date of release.
descricao String for description.
name String name.
versao_atual Boolean indicates if version is in use.
created_at Date of creation.
updated_at Date of update.
branch_url String with url of the integration branch. Only for admin user.
message String alert about response.
errors Object with field names that contain validation errors.
errors[name] Array of error messages of field name.
errors[apelido] Array of error messages of field apelido.
errors[data_lancamento] Array of error messages of field data_lancamento.
errors[descricao] Array of error messages of field descricao.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: f81d9fd0-8b14-443d-aa99-4bc77abc9e64
X-Runtime: 0.047282
Vary: Origin
Content-Length: 166

Body

{
  "message": "Validation Failed!",
  "errors": {
    "name": [
      "can't be blank"
    ],
    "apelido": [
      "can't be blank"
    ],
    "data_lancamento": [
      "can't be blank"
    ],
    "descricao": [
      "can't be blank"
    ]
  }
}

Deleting a version

This method deletes a version.

Endpoint

DELETE /v1/versions/:id

Request

Route

DELETE /v1/versions/980190962

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: ye8dx4vyN3__i4ku-gm_
Cookie:

cURL

curl "https://api.ptrp.com.br/v1/versions/980190962" -d '' -X DELETE \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: ye8dx4vyN3__i4ku-gm_" \
	-H "Cookie: "

Response

Simulated Response

Status

204

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Cache-Control: no-cache
X-Request-Id: 8d03cfae-6edf-4065-b122-3ab585c5cb31
X-Runtime: 0.027492
Vary: Origin

Get a version

This method returns an object of version.

Endpoint

GET /v1/versions/:id

Request

Route

GET /v1/versions/980190962

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: ye8dx4vyN3__i4ku-gm_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/versions/980190962" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: ye8dx4vyN3__i4ku-gm_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id Id of version.
apelido String label.
data_lancamento Date of release.
descricao String for description.
name String name.
versao_atual Boolean indicates if version is in use.
created_at Date of creation.
updated_at Date of update.
branch_url String with url of the integration branch. Only for admin user.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"ca412201dd4f5fc7f33c0a86aa76e6ee"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: e772fb2b-e989-4be2-9fb7-d6d6903bb179
X-Runtime: 0.032384
Vary: Origin
Content-Length: 242

Body

{
  "id": 980190962,
  "apelido": "MyString",
  "data_lancamento": "2013-06-17",
  "descricao": "MyText",
  "name": "V3.0.2-1",
  "versao_atual": false,
  "created_at": "2026-04-06T22:37:18.000-03:00",
  "updated_at": "2026-04-06T22:37:18.000-03:00",
  "branch_url": "MyString"
}

Listing versions

This method returns an array of versions.

Endpoint

GET /v1/versions

Request

Route

GET /v1/versions

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: ye8dx4vyN3__i4ku-gm_
Cookie:

cURL

curl -g "https://api.ptrp.com.br/v1/versions" -X GET \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: ye8dx4vyN3__i4ku-gm_" \
	-H "Cookie: "

Response

Simulated Response

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"2964b4d279c9a55d24738d5227ed6fa1"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: ce42d18d-7714-475c-b149-9f8cebdbd667
X-Runtime: 0.080579
Vary: Origin
Content-Length: 719

Body

[
  {
    "id": 113629430,
    "apelido": "test",
    "data_lancamento": "2015-11-09",
    "descricao": "test",
    "name": "V3.0.2-3",
    "versao_atual": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "updated_at": "2026-04-06T22:37:18.000-03:00",
    "branch_url": "test"
  },
  {
    "id": 298486374,
    "apelido": "MyString",
    "data_lancamento": "2014-05-09",
    "descricao": "MyText",
    "name": "V3.0.2-2",
    "versao_atual": true,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "updated_at": "2026-04-06T22:37:18.000-03:00",
    "branch_url": "MyString"
  },
  {
    "id": 980190962,
    "apelido": "MyString",
    "data_lancamento": "2013-06-17",
    "descricao": "MyText",
    "name": "V3.0.2-1",
    "versao_atual": false,
    "created_at": "2026-04-06T22:37:18.000-03:00",
    "updated_at": "2026-04-06T22:37:18.000-03:00",
    "branch_url": "MyString"
  }
]

Updating a version

This method updates a version.

Endpoint

PATCH /v1/versions/:id

Parameters

Name Description
version[name] required String name.
version[apelido] required String label.
version[data_lancamento] required Date of release.
version[descricao] required String for description.
version[versao_atual] Boolean indicates if version is in use.
version[branch_url] String with url of the integration branch. Only for admin user.

Request

Route

PATCH /v1/versions/980190962

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: ye8dx4vyN3__i4ku-gm_
Cookie:

Body

{
  "version": {
    "descricao": "good version"
  }
}

cURL

curl "https://api.ptrp.com.br/v1/versions/980190962" -d '{"version":{"descricao":"good version"}}' -X PATCH \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: ye8dx4vyN3__i4ku-gm_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id Id of version.
apelido String label.
data_lancamento Date of release.
descricao String for description.
name String name.
versao_atual Boolean indicates if version is in use.
created_at Date of creation.
updated_at Date of update.
branch_url String with url of the integration branch. Only for admin user.
message String alert about response.
errors Object with field names that contain validation errors.
errors[name] Array of error messages of field name.
errors[apelido] Array of error messages of field apelido.
errors[data_lancamento] Array of error messages of field data_lancamento.
errors[descricao] Array of error messages of field descricao.

Status

200

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
ETag: W/"cd32be7113675d056e348ef746cbb968"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: f628f1f6-632a-439f-ae95-7078de640fcb
X-Runtime: 0.034337
Vary: Origin
Content-Length: 248

Body

{
  "id": 980190962,
  "apelido": "MyString",
  "data_lancamento": "2013-06-17",
  "descricao": "good version",
  "name": "V3.0.2-1",
  "versao_atual": false,
  "created_at": "2026-04-06T22:37:18.000-03:00",
  "updated_at": "2026-04-06T22:37:34.023-03:00",
  "branch_url": "MyString"
}

Updating a version - errors

This method shows validation fails on update.

Endpoint

PATCH /v1/versions/:id

Parameters

Name Description
version[name] required String name.
version[apelido] required String label.
version[data_lancamento] required Date of release.
version[descricao] required String for description.
version[versao_atual] Boolean indicates if version is in use.
version[branch_url] String with url of the integration branch. Only for admin user.

Request

Route

PATCH /v1/versions/980190962

Headers

Host: api.ptrp.com.br
Content-Type: application/json
Accept: application/json
X-Auth-Token: ye8dx4vyN3__i4ku-gm_
Cookie:

Body

{
  "version": {
    "name": ""
  }
}

cURL

curl "https://api.ptrp.com.br/v1/versions/980190962" -d '{"version":{"name":""}}' -X PATCH \
	-H "Content-Type: application/json" \
	-H "Accept: application/json" \
	-H "X-Auth-Token: ye8dx4vyN3__i4ku-gm_" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

Name Description
id Id of version.
apelido String label.
data_lancamento Date of release.
descricao String for description.
name String name.
versao_atual Boolean indicates if version is in use.
created_at Date of creation.
updated_at Date of update.
branch_url String with url of the integration branch. Only for admin user.
message String alert about response.
errors Object with field names that contain validation errors.
errors[name] Array of error messages of field name.
errors[apelido] Array of error messages of field apelido.
errors[data_lancamento] Array of error messages of field data_lancamento.
errors[descricao] Array of error messages of field descricao.

Status

422

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: 78a4681d-4a3a-4e70-b47d-cefbf3a703af
X-Runtime: 0.032449
Vary: Origin
Content-Length: 69

Body

{
  "message": "Validation Failed!",
  "errors": {
    "name": [
      "can't be blank"
    ]
  }
}