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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

password=test12&password_confirmation=test12

cURL

curl "http://api.lvh.me:3000/v1/auth/password" -d 'password=test12&password_confirmation=test12' -X PATCH \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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/"ccc1c33c15c03b806f025f0b8d69d932"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: db6b2160-25ca-4ff8-9aa0-6ed84b203748
X-Runtime: 0.114834
Vary: Origin
Content-Length: 3705

Body

{
  "success": true,
  "data": "{\"first_name\":\"funcionario1\",\"last_name\":\"\",\"cpf\":\"010.333.111-22\",\"username\":\"funcionario1\",\"station_user\":\"Funcionario\",\"roles\":[\"funcionario\"],\"created_at\":\"2025-08-25T14:23:39.000-03:00\",\"updated_at\":\"2025-08-25T14:23:39.735-03:00\",\"funcionario_uid\":\"71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0\",\"temporary_password\":false,\"empresa\":{\"uid\":\"a43bedds-ba77-4062-46c0-58f4444dad33\",\"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\":null,\"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-58f4444dad33\",\"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\":\"2025-08-25T14:23:38.000-03:00\",\"created_at\":\"2025-08-25T14:23:38.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.lvh.me
Access-Token: wh4pwbORpQfSTk1zPz7ayQ
Token-Type: Bearer
Client: z_SOYlxgeT8Ii8SA6yIyoQ
Expiry: 1757352219
Uid: [email protected]
Content-Type: application/x-www-form-urlencoded
Cookie:

cURL

curl "http://api.lvh.me:3000/v1/auth" -d '' -X DELETE \
	-H "Host: api.lvh.me" \
	-H "Access-Token: wh4pwbORpQfSTk1zPz7ayQ" \
	-H "Token-Type: Bearer" \
	-H "Client: z_SOYlxgeT8Ii8SA6yIyoQ" \
	-H "Expiry: 1757352219" \
	-H "Uid: [email protected]" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

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

Status

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=cG05QWprVTE4Tm9zdGlKWWR4OHA2M2ZGUXgxSjAzaWNFanR3SERRaklaRytKS2R4VExkS0p0NzlGLzR1M3RBVm5JN2N4V1pGa2NnbUJSZFN6aDNId3dNQlhUK1Evd1NhY1o2TmhhWWZNa2RrUVpRQWRDeUkyTlZZQ3RCekljaDJSRW80TVhGSUo2TEhtTU1EdkpvTE5PU3ZBaXlJckVOL0g3RVFHTlhVNUhOTE1EM3l5NkRiaS9aaml2V2tYU0s3LS1mOEdoejhDeE1qZEJrWGJWbThqcUdRPT0%3D--0ea0e3a0e7dc4fe7b8b1ce761f0af07abd56fbe0; domain=.api.lvh.me; path=/; HttpOnly
X-Request-Id: 06756b92-3aa7-4bb3-a824-1e4180a00237
X-Runtime: 0.094798
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.lvh.me
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

login=funcionario%40email.com&password=teste123

cURL

curl "http://api.lvh.me:3000/v1/auth/sign_in" -d 'login=funcionario%40email.com&password=teste123' -X POST \
	-H "Host: api.lvh.me" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
access-token: hhwTMikBzrpEDzEakeODyg
token-type: Bearer
client: jBv6pgP8L0nvS7RJR8WSbw
expiry: 1757352220
uid: [email protected]
Content-Type: application/json; charset=utf-8
ETag: W/"a831903f73c208c9a4c1384f86b769d3"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: c42c6cf5-8a45-4539-838b-3fb19d909054
X-Runtime: 0.252992
Vary: Origin
Content-Length: 3684

Body

{
  "data": {
    "first_name": "funcionario1",
    "last_name": "",
    "cpf": "010.333.111-22",
    "username": "funcionario1",
    "station_type": "Funcionario",
    "roles": [
      "funcionario"
    ],
    "created_at": "2025-08-25T14:23:39.000-03:00",
    "updated_at": "2025-08-25T14:23:40.198-03:00",
    "funcionario_uid": "71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0",
    "temporary_password": false,
    "empresa": {
      "uid": "a43bedds-ba77-4062-46c0-58f4444dad33",
      "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": null,
      "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-58f4444dad33",
        "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-58f4444dad33",
          "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": "2025-08-25T14:23:38.000-03:00",
      "created_at": "2025-08-25T14:23:38.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.lvh.me
Access-Token: VDeVqdRN48wjf2zw7y81fw
Client: xz_z_1ID_lwLghwcNUINXg
Uid: [email protected]
Token-Type: Bearer
Content-Type: application/x-www-form-urlencoded
Cookie:

cURL

curl "http://api.lvh.me:3000/v1/auth/sign_out" -d '' -X DELETE \
	-H "Host: api.lvh.me" \
	-H "Access-Token: VDeVqdRN48wjf2zw7y81fw" \
	-H "Client: xz_z_1ID_lwLghwcNUINXg" \
	-H "Uid: [email protected]" \
	-H "Token-Type: Bearer" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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=d1VXbjY5QzVVOThhK3hMQUVsU0RxWlc4MlJjZTBSM1ZicWF5Y1UweVBRYzFzZXVCV1VISlUzTm5rOEN2c0Y3WllxZjNXRzhSZDliMzlLYi9lb0pZNVE9PS0tRVpUeUZkdVVEdnhUeHhsNkNiNFY5UT09--eabe0be8ca2e9d4ec6e4585973f014e1db47f229; domain=.api.lvh.me; path=/; HttpOnly
X-Request-Id: 406ec48b-4ac5-4131-b8d9-21105a18fbe0
X-Runtime: 0.180956
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.lvh.me
Content-Type: application/x-www-form-urlencoded
Cookie:

cURL

curl "http://api.lvh.me:3000/v1/auth/refresh" -d '' -X PATCH \
	-H "Access-Token: IB-3X2_WT6fhF0jMBD73BA" \
	-H "Client: AIWePENTMAuYdGNhqmqY8B" \
	-H "Uid: [email protected]" \
	-H "Token-Type: Bearer" \
	-H "Host: api.lvh.me" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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/"07ef98670251e0d7f8198d3ea3cb9e36"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: e8a71b17-a984-4f60-8b15-84202c578946
X-Runtime: 0.189468
Vary: Origin
Content-Length: 147

Body

{
  "access-token": "oLW_IuuX8kK86XWGTy1pVA",
  "token-type": "Bearer",
  "client": "EofhjrFd2q3QjNUH4Lz-ZA",
  "expiry": "1757352220",
  "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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

justificativas[start_date]=2019-01-01&justificativas[end_date]=2019-01-09&justificativas[hora]=01%3A00&justificativas[motivo_id]=267869265&justificativas[funcionario_uids][]=71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0

cURL

curl "http://api.lvh.me:3000/v1/acoes-em-massa/justificativas" -d 'justificativas[start_date]=2019-01-01&justificativas[end_date]=2019-01-09&justificativas[hora]=01%3A00&justificativas[motivo_id]=267869265&justificativas[funcionario_uids][]=71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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/"2dc87e139b13623c996b203efca67877"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: c32579aa-930e-4e9c-9042-f3e20a995ab4
X-Runtime: 0.082558
Vary: Origin
Content-Length: 1873

Body

[
  {
    "id": 1070701488,
    "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": 1070701489,
    "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": 1070701490,
    "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": 1070701491,
    "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": 1070701492,
    "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": 1070701493,
    "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": 1070701494,
    "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": 1070701495,
    "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": 1070701496,
    "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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

justificativas[start_date]=&justificativas[end_date]=&justificativas[hora]=&justificativas[motivo_id]=0&justificativas[funcionario_uids][]=23

cURL

curl "http://api.lvh.me:3000/v1/acoes-em-massa/justificativas" -d 'justificativas[start_date]=&justificativas[end_date]=&justificativas[hora]=&justificativas[motivo_id]=0&justificativas[funcionario_uids][]=23' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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: 5c7758e1-e03e-4613-953c-09474ac5eaf8
X-Runtime: 0.032676
Vary: Origin
Content-Length: 239

Body

{
  "message": "Validation Failed!",
  "errors": {
    "start_date": [
      "can't be blank",
      "Invalid Date",
      "Invalid Date"
    ],
    "end_date": [
      "can't be blank",
      "Invalid Date",
      "Invalid Date",
      "Invalid Date"
    ],
    "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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

justificativas[start_date]=2014-01-10&justificativas[end_date]=2014-01-13&justificativas[motivo_id]=267869265&justificativas[funcionario_uids][]=71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0

cURL

curl "http://api.lvh.me:3000/v1/acoes-em-massa/justificativas" -d 'justificativas[start_date]=2014-01-10&justificativas[end_date]=2014-01-13&justificativas[motivo_id]=267869265&justificativas[funcionario_uids][]=71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0' -X DELETE \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Cache-Control: no-cache
X-Request-Id: 1e095aa9-c11f-49fb-af96-d062a2741b18
X-Runtime: 0.031622
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

justificativas[start_date]=2014-01-10&justificativas[end_date]=2014-05-13&justificativas[motivo_id]=267869265&justificativas[funcionario_uids][]=71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0

cURL

curl "http://api.lvh.me:3000/v1/acoes-em-massa/justificativas" -d 'justificativas[start_date]=2014-01-10&justificativas[end_date]=2014-05-13&justificativas[motivo_id]=267869265&justificativas[funcionario_uids][]=71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0' -X DELETE \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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: e3511a39-01de-44e3-ac3f-da8ed825d451
X-Runtime: 0.027819
Vary: Origin
Content-Length: 91

Body

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

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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

cartao_ponto_justificativa[data]=2014-01-01&cartao_ponto_justificativa[hora]=04%3A00&cartao_ponto_justificativa[motivo_id]=267869265

cURL

curl "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2014/1/justificativas" -d 'cartao_ponto_justificativa[data]=2014-01-01&cartao_ponto_justificativa[hora]=04%3A00&cartao_ponto_justificativa[motivo_id]=267869265' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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: 96ba1df6-0508-4b5b-aab5-af93be621440
X-Runtime: 0.034898
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

cartao_ponto_justificativa[data]=2014-01-01

cURL

curl "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2014/1/justificativas" -d 'cartao_ponto_justificativa[data]=2014-01-01' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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: e726d120-d229-4213-a726-a7a6a74e8506
X-Runtime: 0.030290
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

cURL

curl "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2014/1/justificativas/516301284" -d '' -X DELETE \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Simulated Response

Status

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Cache-Control: no-cache
X-Request-Id: ea78246d-12bd-49f9-bb26-69bd908449da
X-Runtime: 0.052312
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2014/1/justificativas" -X GET \
	-H "Host: api.lvh.me" \
	-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

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: b8762e6e-ad25-4288-a35e-880c8530e4e9
X-Runtime: 0.057317
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
  }
]

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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Content-Type: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1
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 "http://api.lvh.me:3000/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 "Host: api.lvh.me" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Content-Type: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1" \
	-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

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/"fb7d4f3df9e8db971c9799254a65fad9"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: b4a9d877-f4fd-4aec-a1bb-42619d660f33
X-Runtime: 0.349869
Vary: Origin
Content-Length: 1129

Body

{
  "arquivo": "AFD_func_1_parcial.txt",
  "processado": true,
  "equipamento": {
    "id": 51636476,
    "name": "app",
    "fabricante": null,
    "modelo_equipamento": null,
    "ip": "192.168.254.40",
    "nequipamento": null,
    "nserie_rep": "598f491b841d2bfab12d54f0e9ef12d99f8a8500c827904d3828a11daaa5",
    "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-58f4444dad33",
    "user": null,
    "password": null
  },
  "created_at": "2025-08-25T14:23:41.153-03:00",
  "updated_at": "2025-08-25T14:23:41.467-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": [
    "NSR error, line 2, verify equipment port communication and try again. If the issue persists contact us.",
    " This \"coleta\" has \"marcações\" until Tue, 03 Sep 2019 17:08:00 +0000. After this date will not be possible to see the \"marcações\" in the system. If you want actual \"marcações\" then try to import again.",
    "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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Content-Type: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1
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 "http://api.lvh.me:3000/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 "Host: api.lvh.me" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Content-Type: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1" \
	-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

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/"406daec1306a24ee9e70011ae23c037b"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 69d10357-a54c-4ca4-82cd-f0dc39acf233
X-Runtime: 0.072918
Vary: Origin
Content-Length: 1057

Body

{
  "arquivo": "AFD_func_1_parcial.txt",
  "processado": false,
  "equipamento": {
    "id": 51636476,
    "name": "app",
    "fabricante": null,
    "modelo_equipamento": null,
    "ip": "192.168.254.40",
    "nequipamento": null,
    "nserie_rep": "241edab893b67413721b4146a9d4dbcf3518adc500ba2a99ae63d0c165ec",
    "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-58f4444dad33",
    "user": null,
    "password": null
  },
  "created_at": "2025-08-25T14:23:41.104-03:00",
  "updated_at": "2025-08-25T14:23:41.113-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": [
    "NSR error, line 2, verify equipment port communication and try again. If the issue persists contact us.",
    " This \"coleta\" has \"marcações\" until Tue, 03 Sep 2019 17:08:00 +0000. After this date will not be possible to see the \"marcações\" in the system. If you want actual \"marcações\" then try to import again."
  ],
  "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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1
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 "http://api.lvh.me:3000/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 "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1" \
	-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

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/"033aca01fecdd16132d8cf19a35c57c5"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 9e84b10e-91f0-4a73-8f0f-cb7de382a466
X-Runtime: 0.092664
Vary: Origin
Content-Length: 896

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
  },
  "created_at": "2025-08-25T14:23:40.988-03:00",
  "updated_at": "2025-08-25T14:23:40.988-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": [
    " This \"coleta\" has \"marcações\" until Mon, 10 Nov 2014 16:37:00 +0000. After this date will not be possible to see the \"marcações\" in the system. If you want actual \"marcações\" then try to import again."
  ],
  "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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/json
Cookie:

cURL

curl "http://api.lvh.me:3000/v1/coletas" -d '' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/json" \
	-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

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: 4c9eb442-ee41-4678-bbab-ca4d65fc926a
X-Runtime: 0.033281
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/departamentos" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"6ae76f217f3735519b33c4d928c67b14"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: b5aaf419-3517-4270-b971-117b8a2d34cc
X-Runtime: 0.049260
Vary: Origin
Content-Length: 347

Body

[
  {
    "uid": "5c3303d2-dba9-4b5f-bf13-f0965cfd1207",
    "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

Listando Empresas

Este método retorna um array de empresas.

Endpoint

GET /v1/empresas

Request

Route

GET /v1/empresas

Headers

Host: api.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/empresas" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"b523728f94b67aed86a2454b1943986f"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: ce80469a-d30e-40f2-8d63-ea0492bc2e0f
X-Runtime: 0.037168
Vary: Origin
Content-Length: 489

Body

[
  {
    "uid": "8120c885-82df-49e5-a979-7d23fbee9346",
    "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
  }
]

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/51636476/usuarios/07155744989

Headers

Host: api.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

cURL

curl "http://api.lvh.me:3000/v1/equipamentos/51636476/usuarios/07155744989" -d '' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

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

Status

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/"c9afd47b43781547a866ab562605392a"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 97706085-1481-4bd7-bbd1-4cce01c49b25
X-Runtime: 0.206082
Vary: Origin
Content-Length: 41

Body

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

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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/equipamentos" -X GET \
	-H "Host: api.lvh.me" \
	-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".
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

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: 9
X-Total-Pages: 2
Content-Type: application/json; charset=utf-8
ETag: W/"bedcec1da21874f73deaa1b37af82a0c"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 28814779-fc29-48eb-8f4a-691ecb4ae02c
X-Runtime: 0.051149
Vary: Origin
Content-Length: 1905

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-58f4444dad33",
    "user": null,
    "password": 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
  },
  {
    "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
  },
  {
    "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
  },
  {
    "id": 51636476,
    "name": "app",
    "fabricante": null,
    "modelo_equipamento": null,
    "ip": "192.168.254.40",
    "nequipamento": null,
    "nserie_rep": "1234567891234567834232323sadfsdf2332r",
    "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-58f4444dad33",
    "user": null,
    "password": 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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/equipamentos/51636476/pontos/215362412.pdf" -X GET \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Cookie: "

Response

Simulated Response

Status

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: ede71c30-a262-439a-aec5-19aa4289dc68
X-Runtime: 0.591149
Vary: Origin
Content-Length: 291336

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	(Int) Id do equipamento virtual (Apenas equipamentos do tipo "app").
password	(String) Senha de registro do usuário do equipamento.

Request

Route

POST /v1/equipamentos/51636476/pontos

Headers

Host: api.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

password=610175

cURL

curl "http://api.lvh.me:3000/v1/equipamentos/51636476/pontos" -d 'password=610175' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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/"0eaa46f9464d97a3dd5fe30d0d000418"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 807a74d5-8ea1-4654-a588-79ff3ab5b7a5
X-Runtime: 0.228731
Vary: Origin
Content-Length: 1855

Body

{
  "id": 1071408923,
  "data": "2025-08-25",
  "hora": "14:23",
  "equipamento_id": 51636476,
  "processado": false,
  "ponto_geo_locale": null,
  "nsr": 1,
  "registro_inpi": "BR512022000771-1 e BR512022000798-3",
  "coletor_id": 2,
  "offline": false,
  "created_at": "2025-08-25T14:23:45.508-03:00",
  "cpf": "07155744989",
  "codigo_hash": "908afc0de929750fe078c0f8ccfc47eebb6ec9411320ca5117926edc93498042",
  "utc_offset": "-0300",
  "funcionario": {
    "cpf": "07155744989",
    "cracha": "1",
    "data_admissao": null,
    "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": "2025-08-25T14:23:38.000-03:00",
      "updated_at": "2025-08-25T14:23:38.000-03:00",
      "cliente_id": 571096427,
      "cei": null,
      "codigo_registro_folha": "23",
      "ativo": true,
      "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
    },
    "departamento": {
      "id": 980190962,
      "name": "Departamento01 (Empresa03)",
      "empresa_id": 471928375,
      "created_at": "2025-08-25T14:23:38.000-03:00",
      "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
    "created_at": "2025-08-25T14:23:38.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	(Int) Id do equipamento virtual (Apenas equipamentos do tipo "app").
password	(String) Senha de registro do usuário do equipamento.

Request

Route

POST /v1/equipamentos/51636476/pontos

Headers

Host: api.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

password=1234

cURL

curl "http://api.lvh.me:3000/v1/equipamentos/51636476/pontos" -d 'password=1234' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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: e0b5abaa-3a50-4107-bb60-ae2c8876194f
X-Runtime: 0.195619
Vary: Origin
Content-Length: 75

Body

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

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/51636476/usuarios/3

Headers

Host: api.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

cURL

curl "http://api.lvh.me:3000/v1/equipamentos/51636476/usuarios/3" -d '' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

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

Status

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: d058e9be-d850-4eb6-80e5-619ef488a470
X-Runtime: 0.029050
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

periodo=2015-06-01&event_config_id=712054099

cURL

curl "http://api.lvh.me:3000/v1/folhas-de-pagamento/exportacao" -d 'periodo=2015-06-01&event_config_id=712054099' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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: 23
X-Total-Pages: 5
Content-Type: application/json; charset=utf-8
ETag: W/"0a87f4d0d34c1991767c327ef2e0b59a"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: a0e79ad8-f0f2-4f0d-b1ce-57abbdc0cd3f
X-Runtime: 0.093677
Vary: Origin
Content-Length: 1569

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": null,
      "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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
      "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

cURL

curl "http://api.lvh.me:3000/v1/folhas-de-pagamento/exportacao" -d '' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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: 23
X-Total-Pages: 5
Content-Type: application/json; charset=utf-8
Cache-Control: no-cache
X-Request-Id: 348df06d-e95b-4187-96d4-5b9e4b4607dc
X-Runtime: 0.030341
Vary: Origin
Content-Length: 87

Body

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

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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/folhas-de-pagamento/configuracoes-eventos" -X GET \
	-H "Host: api.lvh.me" \
	-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

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: 523ea6f0-b5f0-453d-b582-2e28fb9bb3b2
X-Runtime: 0.035264
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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/relatorios/funcionario/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d1/extrato-de-banco-de-horas/2015/12" -X GET \
	-H "Host: api.lvh.me" \
	-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

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: 1541d369-4d5e-46b3-b9c0-27177acba2eb
X-Runtime: 0.042277
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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/relatorios/funcionario/1/extrato-de-banco-de-horas/2015/12" -X GET \
	-H "Host: api.lvh.me" \
	-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

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: 71a89059-7930-4c7d-953b-7d7b5c7824b4
X-Runtime: 0.025587
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

funcionario[name]=Katia

cURL

curl "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0" -d 'funcionario[name]=Katia' -X PATCH \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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/"1ffd57a8b36755a81433921bb5ee580a"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 96ea5211-e4dc-46e7-9b0f-c1d141f62ecb
X-Runtime: 0.035465
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-58f4444dad33",
    "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-58f4444dad33",
      "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": "2025-08-25T14:23:49.076-03:00",
  "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

funcionario[name]=

cURL

curl "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0" -d 'funcionario[name]=' -X PATCH \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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: aa0564e8-b620-47b8-8a88-e9a716117222
X-Runtime: 0.032100
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

funcionario[name]=John+Doe&funcionario[pis]=0182.21351.32-2&funcionario[empresa_id]=c43becdf-ba77-4062-97c0-58f3335dad92&funcionario[data_admissao]=2018-01-10&funcionario[funcionario_exames_attributes][][data]=2017-01-01&funcionario[funcionario_exames_attributes][][apto]=1

cURL

curl "http://api.lvh.me:3000/v1/funcionarios" -d 'funcionario[name]=John+Doe&funcionario[pis]=0182.21351.32-2&funcionario[empresa_id]=c43becdf-ba77-4062-97c0-58f3335dad92&funcionario[data_admissao]=2018-01-10&funcionario[funcionario_exames_attributes][][data]=2017-01-01&funcionario[funcionario_exames_attributes][][apto]=1' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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/"37a4412cc5718a558cf7507ccd69e1e6"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: ee4e2bce-8407-46a6-8ebe-1d9eabcb8be6
X-Runtime: 0.042412
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": "81749f03-7ab5-4e39-aef9-7d3e2eb63678",
  "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": "2025-08-25T14:23:48.936-03:00",
  "created_at": "2025-08-25T14:23:48.936-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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

funcionario[name]=

cURL

curl "http://api.lvh.me:3000/v1/funcionarios" -d 'funcionario[name]=' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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: 8e542524-f153-413d-988f-2e17782bee49
X-Runtime: 0.036147
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/funcionarios" -X GET \
	-H "Host: api.lvh.me" \
	-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

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: 23
X-Total-Pages: 5
Content-Type: application/json; charset=utf-8
ETag: W/"2f6501868f296246f9ac99df77034f50"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 4648c8c4-4d80-4de0-909e-719bcf8c1ee3
X-Runtime: 0.059360
Vary: Origin
Content-Length: 7057

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": null,
      "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": "2025-08-25T14:23:38.000-03:00",
    "created_at": "2025-08-25T14:23:38.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": null,
      "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": null,
        "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": "2025-08-25T14:23:38.000-03:00",
    "created_at": "2025-08-25T14:23:38.000-03:00"
  },
  {
    "cpf": null,
    "cracha": "022338195fw5",
    "data_admissao": null,
    "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-58f4444dad33",
      "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-58f4444dad33",
        "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": "2025-08-25T14:23:38.000-03:00",
    "created_at": "2025-08-25T14:23:38.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-58f4444dad33",
      "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": "2025-08-25T14:23:38.000-03:00",
    "created_at": "2025-08-25T14:23:38.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-58f4444dad33",
      "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-58f4444dad33",
        "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": "2025-08-25T14:23:48.612-03:00",
    "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Query Parameters

cracha=0110

cURL

curl -g "http://api.lvh.me:3000/v1/funcionarios?cracha=0110" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"6fc9020f4635827d7ffc2d97593add97"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 1ce3489d-6b8e-4985-b38b-6101db66013a
X-Runtime: 0.032000
Vary: Origin
Content-Length: 1023

Body

[
  {
    "cpf": null,
    "cracha": "0110",
    "data_admissao": null,
    "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-58f4444dad33",
      "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": "2025-08-25T14:23:38.000-03:00",
    "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Query Parameters

registro_folha=123

cURL

curl -g "http://api.lvh.me:3000/v1/funcionarios?registro_folha=123" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"138ced6d82249316734e2ed52466b826"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 4a1a229a-0ba9-41f6-a44e-48c10a70e4c8
X-Runtime: 0.034002
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-58f4444dad33",
      "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-58f4444dad33",
        "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": "2025-08-25T14:23:48.722-03:00",
    "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Query Parameters

status=inativos

cURL

curl -g "http://api.lvh.me:3000/v1/funcionarios?status=inativos" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"41eb38aab29ae124915c2ba55c471fa1"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 11563904-2b5a-4783-8664-df39b6bba606
X-Runtime: 0.034874
Vary: Origin
Content-Length: 2953

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": null,
      "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": null,
        "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": "2025-08-25T14:23:38.000-03:00",
    "created_at": "2025-08-25T14:23:38.000-03:00"
  },
  {
    "cpf": null,
    "cracha": "7",
    "data_admissao": null,
    "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-58f4444dad33",
      "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": "2025-08-25T14:23:38.000-03:00",
    "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"3ba2ab96ae51471833b1d05633b6ad76"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 1c1eb1db-0062-48e9-b234-027b0362f212
X-Runtime: 0.036680
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-58f4444dad33",
    "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-58f4444dad33",
      "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": "2025-08-25T14:23:48.810-03:00",
  "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Query Parameters

include_last_quadro_de_horas=1

cURL

curl -g "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0?include_last_quadro_de_horas=1" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"09fabf0cfb7179fa3b46ea8bf3611301"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 550a850f-0ad6-4d3f-a65b-6b685a25f04d
X-Runtime: 0.034381
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-58f4444dad33",
    "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-58f4444dad33",
      "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": "2025-08-25T14:23:48.856-03:00",
  "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/funcionarios/ausentes/2015-01-33/ate/2015-12-31" -X GET \
	-H "Host: api.lvh.me" \
	-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

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: 90867788-80af-442e-83c0-95b7faa22855
X-Runtime: 0.025564
Vary: Origin
Content-Length: 26

Body

{
  "message": "Invalid Date"
}

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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/funcionarios/ausentes/2015-12-01/ate/2015-12-31" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"1e2a09dc518394625b24ec0474297759"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 62fd0151-1a14-47ad-be54-f661ad353f1f
X-Runtime: 0.042071
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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:47.136-03:00",
      "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Content-Type: application/x-www-form-urlencoded
Cookie:

cURL

curl "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2018/2/approve" -d '' -X PATCH \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Simulated Response

Status

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: 982d6745-33e1-48bc-9051-0883b1af1f2c
X-Runtime: 0.023845
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

cURL

curl "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2018/2/update" -d '' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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/"3ab088271df6c35a2faf28ae741a7a42"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: a6805a1e-3605-455e-83ca-1cde58a238d0
X-Runtime: 0.426449
Vary: Origin
Content-Length: 3567

Body

{
  "funcionario": {
    "cpf": "071.557.449-89",
    "cracha": "1",
    "data_admissao": null,
    "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": "2025-08-25T14:23:38.000-03:00",
      "updated_at": "2025-08-25T14:23:38.000-03:00",
      "cliente_id": 571096427,
      "cei": null,
      "codigo_registro_folha": "23",
      "ativo": true,
      "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
    },
    "departamento": {
      "id": 980190962,
      "name": "Departamento01 (Empresa03)",
      "empresa_id": 471928375,
      "created_at": "2025-08-25T14:23:38.000-03:00",
      "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:47.712-03:00",
    "created_at": "2025-08-25T14:23:38.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": [

  ]
}

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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2018/1" -X GET \
	-H "Host: api.lvh.me" \
	-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".

Status

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/"e72050d164e4ffcd8300a20dbff271ce"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: c1aa06e2-78f6-4e04-9a82-d5cd66302c86
X-Runtime: 0.039271
Vary: Origin
Content-Length: 3224

Body

{
  "funcionario": {
    "cpf": "07155744989",
    "cracha": "1",
    "data_admissao": null,
    "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": "2025-08-25T14:23:38.000-03:00",
      "updated_at": "2025-08-25T14:23:38.000-03:00",
      "cliente_id": 571096427,
      "cei": null,
      "codigo_registro_folha": "23",
      "ativo": true,
      "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
    },
    "departamento": {
      "id": 980190962,
      "name": "Departamento01 (Empresa03)",
      "empresa_id": 471928375,
      "created_at": "2025-08-25T14:23:38.000-03:00",
      "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:47.414-03:00",
    "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:47-03:00",
      "status": "rejected",
      "message": "teste"
    },
    {
      "datetime": "2025-08-25T14:23:47-03:00",
      "status": "approved"
    }
  ]
}

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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2018/2" -X GET \
	-H "Host: api.lvh.me" \
	-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

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: ac0d1731-710a-4cf7-b47b-9726fdc19f2e
X-Runtime: 0.028936
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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

message=Horas+extras+incorretas

cURL

curl "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/cartao_ponto/2018/2/reject" -d 'message=Horas+extras+incorretas' -X PATCH \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Simulated Response

Status

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: d50d084d-955d-49a6-b5f3-2bbc9ac31420
X-Runtime: 0.023483
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Query Parameters

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

cURL

curl -g "http://api.lvh.me:3000/v1/relatorios/funcionarios/ponto_diario/2015-04-29?departamento_uid=c43becdf-bb77-4062-97c0-58f3335dad91" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"217665bac32aa7e48684df382010e69b"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 91143736-346b-4841-afbc-12ef69f9d8ea
X-Runtime: 0.044830
Vary: Origin
Content-Length: 1742

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": null,
      "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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
      "created_at": "2025-08-25T14:23:38.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-58f4444dad33

Headers

Host: api.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Query Parameters

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

cURL

curl -g "http://api.lvh.me:3000/v1/relatorios/funcionarios/ponto_diario/2015-04-29?empresa_uid=a43bedds-ba77-4062-46c0-58f4444dad33" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"217665bac32aa7e48684df382010e69b"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 88e9851d-6084-4628-9a5c-bb95e817f0b3
X-Runtime: 0.040212
Vary: Origin
Content-Length: 1742

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": null,
      "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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
      "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/relatorios/funcionarios/ponto_diario/2015-04-29" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"217665bac32aa7e48684df382010e69b"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 6f6b78e1-096a-41a9-95d8-14c792e2778c
X-Runtime: 0.053566
Vary: Origin
Content-Length: 1742

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": null,
      "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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
      "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/relatorios/funcionarios/ponto_diario/2015-04-29" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"4ebc4d01f164b8e25025ade5ebbe5fbe"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 1776ef8e-66ad-4f0f-a1d8-41a9df7e8416
X-Runtime: 0.038658
Vary: Origin
Content-Length: 1772

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": null,
      "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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
      "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/relatorios/funcionarios/ponto_diario/2015-04-29" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"3ced8105d550f689f341ab70aa570ce8"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 7308274f-0b3c-4307-a5d6-f5aa7016dc4d
X-Runtime: 0.041156
Vary: Origin
Content-Length: 1882

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": null,
      "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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
      "created_at": "2025-08-25T14:23:38.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,
          "tipo": null,
          "motivo": {
            "id": 267869265,
            "name": "Afastado(+de15dias)",
            "e_social_id": null
          }
        }
      }
    ]
  }
]

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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/relatorios/funcionarios/ponto_diario/2015-04-29" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"bea4ec7903b087da2a2827618a130c7d"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: b7bfd2a2-3603-4c07-8c89-ff625f353b32
X-Runtime: 0.046383
Vary: Origin
Content-Length: 1815

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": null,
      "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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
      "created_at": "2025-08-25T14:23:38.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": {
          "date": "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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/relatorios/funcionarios/ponto_diario/2015-04-29" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"c379bf49ac07c2e86ea01c4c5120ac5e"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 3127ab82-8fe0-483f-9b44-da329a4c51bc
X-Runtime: 0.042466
Vary: Origin
Content-Length: 1845

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": null,
      "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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
      "created_at": "2025-08-25T14:23:38.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": {
          "date": "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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/relatorios/funcionarios/ponto_diario/2015-04-29" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"a133af841c66a5e638cb23122ae11fce"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: e1381030-1a75-45a5-81f1-9343d9ff64e0
X-Runtime: 0.040981
Vary: Origin
Content-Length: 1896

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": null,
      "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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
      "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/relatorios/funcionarios/ponto_diario/2015-04-29" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"94b5249b41166df1742c934c230507f1"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 83895029-1a55-44a6-8d9a-1ca46e7d02f1
X-Runtime: 0.038640
Vary: Origin
Content-Length: 1807

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": null,
      "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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
      "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/funcionarios/presentes/2015-01-33/ate/2015-01-31" -X GET \
	-H "Host: api.lvh.me" \
	-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

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: cd8e77c5-79af-45c7-9c4c-56ba4fcf40f2
X-Runtime: 0.022967
Vary: Origin
Content-Length: 26

Body

{
  "message": "Invalid Date"
}

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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/funcionarios/presentes/2015-01-01/ate/2015-01-31" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"dbbc2537efdfc7dc5560d98edaecb57c"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: c523955f-f4cc-4b0a-9049-58ca8c4cf44f
X-Runtime: 0.043051
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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:48.308-03:00",
      "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

cURL

curl "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2c0/quadros_de_horas/980190962" -d '' -X DELETE \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Simulated Response

Status

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Cache-Control: no-cache
X-Request-Id: fe268d46-35b7-4191-8461-869a772c83c0
X-Runtime: 0.048100
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d6/quadros_de_horas" -X GET \
	-H "Host: api.lvh.me" \
	-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

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: 997908aa-98f9-471c-b5e1-2d83357767c5
X-Runtime: 0.057236
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

funcionario_quadro_de_hora[data_vigencia]=2018-01-10&funcionario_quadro_de_hora[ch]=11

cURL

curl "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d6/quadros_de_horas" -d 'funcionario_quadro_de_hora[data_vigencia]=2018-01-10&funcionario_quadro_de_hora[ch]=11' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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: 52426006-7db8-45f2-b9e0-aa9553038689
X-Runtime: 0.042324
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

funcionario_quadro_de_hora[data_vigencia]=

cURL

curl "http://api.lvh.me:3000/v1/funcionarios/71ba8bd7-3b65-40fa-8e11-7daf5f0fe2d6/quadros_de_horas" -d 'funcionario_quadro_de_hora[data_vigencia]=' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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: 10699e0b-4e06-4768-9170-fe12a41c94f3
X-Runtime: 0.031558
Vary: Origin
Content-Length: 117

Body

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

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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/motivos/common" -X GET \
	-H "Host: api.lvh.me" \
	-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

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: bf1b85d0-bd7f-4f76-83a3-61d663689e91
X-Runtime: 0.057681
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/motivos/personalizados" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"3aa5c2e9c26822fad766526d14d6037c"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 31f71da8-3b90-4d14-91b4-2d81466d2e50
X-Runtime: 0.026151
Vary: Origin
Content-Length: 127

Body

[
  {
    "id": 3656553,
    "name": "Intervalo café",
    "e_social_id": null
  },
  {
    "id": 1067296968,
    "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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/quadro_de_horas" -X GET \
	-H "Host: api.lvh.me" \
	-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

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: 54d8e546-81f6-42f6-9b5c-2facaf047bda
X-Runtime: 0.073744
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/cartoes-ponto/resumo/2018/22" -X GET \
	-H "Host: api.lvh.me" \
	-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

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: 2d7bf2c0-0c6b-46c9-8d9e-8c6eb6cc648b
X-Runtime: 0.027090
Vary: Origin
Content-Length: 26

Body

{
  "message": "Invalid Date"
}

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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/cartoes-ponto/resumo/2018/1" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"d1ef2649338d699aa584798aaadde67e"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: b13d36fc-795e-4144-8d94-a19be6daf75e
X-Runtime: 0.057955
Vary: Origin
Content-Length: 3086

Body

[
  {
    "funcionario": {
      "cpf": "07155744989",
      "cracha": "1",
      "data_admissao": null,
      "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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": {
        "id": 980190962,
        "name": "Departamento01 (Empresa03)",
        "empresa_id": 471928375,
        "created_at": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:40.790-03:00",
      "created_at": "2025-08-25T14:23:38.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": [

    ]
  }
]

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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

Query Parameters

data=2014-01-12

cURL

curl -g "http://api.lvh.me:3000/tc/ponto_diario?data=2014-01-12" -X GET \
	-H "Host: api.lvh.me" \
	-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

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: c6a3489a-a57f-446e-a5ef-133ba80ca3c5
X-Runtime: 0.408966
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/tc/ponto_diario" -X GET \
	-H "Host: api.lvh.me" \
	-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

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: eefa3e62-9577-4d3e-9a8e-b6bd5e0f1255
X-Runtime: 0.034274
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.lvh.me
X-Auth-Token: oe4dx4vyN3__i4ku-gc_
Content-Type: application/json
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/user/profile" -X GET \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: oe4dx4vyN3__i4ku-gc_" \
	-H "Content-Type: application/json" \
	-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

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/"9b24857e4c7952d191c63f6d80781bb1"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 8ce7978c-4f08-4979-aa95-c562275fd931
X-Runtime: 0.031157
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": "2025-08-25T14:23:39.000-03:00",
  "updated_at": "2025-08-25T14:23:39.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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/user/cartao_ponto/diario/2015-12-01" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"04e2ea75e2ac7fda48fc3a9e47f08b53"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 773ba42d-413d-4b90-a184-e4d39aa65275
X-Runtime: 0.061905
Vary: Origin
Content-Length: 1740

Body

{
  "funcionario": {
    "cpf": "07155744989",
    "cracha": "1",
    "data_admissao": null,
    "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": "2025-08-25T14:23:38.000-03:00",
      "updated_at": "2025-08-25T14:23:38.000-03:00",
      "cliente_id": 571096427,
      "cei": null,
      "codigo_registro_folha": "23",
      "ativo": true,
      "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
    },
    "departamento": null,
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2025-08-25T14:23:38.000-03:00",
    "created_at": "2025-08-25T14:23:38.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,
        "tipo": null,
        "motivo": null
      }
    },
    {
      "time": "01:00",
      "type": "I",
      "tratamento": {
        "date": "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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Content-Type: application/x-www-form-urlencoded
Cookie:

cURL

curl "http://api.lvh.me:3000/v1/user/justificativas/-1" -d '' -X DELETE \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

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

Status

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: f28af6c6-859c-4f82-b337-495983f8c128
X-Runtime: 0.022835
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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Content-Type: application/x-www-form-urlencoded
Cookie:

cURL

curl "http://api.lvh.me:3000/v1/user/justificativas/962157260" -d '' -X DELETE \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Simulated Response

Response Fields

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

Status

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Cache-Control: no-cache
X-Request-Id: ec176f0c-4bd3-4136-939f-9f6941ab0500
X-Runtime: 0.021826
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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/user/justificativas" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"862ae8e428b9f16f292b93bfdf3b6266"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 44d97f88-cbf7-4b61-84d4-d6ae97abfb99
X-Runtime: 0.035964
Vary: Origin
Content-Length: 1204

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
  },
  {
    "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
  },
  {
    "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
  },
  {
    "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
  },
  {
    "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
  }
]

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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Cookie:

Query Parameters

per_page=10

cURL

curl -g "http://api.lvh.me:3000/v1/user/justificativas?per_page=10" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"7a40a5fa63d7427578ad7558f345ae0b"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: ef248e34-5720-4404-b5bf-4d2e5ee8402e
X-Runtime: 0.028578
Vary: Origin
Content-Length: 2394

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
  },
  {
    "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
  },
  {
    "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
  },
  {
    "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
  },
  {
    "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
  },
  {
    "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
  },
  {
    "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
  },
  {
    "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
  },
  {
    "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
  },
  {
    "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
  }
]

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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

justificativa[data]=2019-1-2&justificativa[motivo_id]=atestado&justificativa[description]=livre

cURL

curl "http://api.lvh.me:3000/v1/user/justificativas" -d 'justificativa[data]=2019-1-2&justificativa[motivo_id]=atestado&justificativa[description]=livre' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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/"fd8a9b67e08e94479ffe7ef1082f76bc"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 94312be6-2a4f-448a-94ea-6a557cad12ff
X-Runtime: 0.026333
Vary: Origin
Content-Length: 218

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
}

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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Content-Type: application/x-www-form-urlencoded
Cookie:

cURL

curl "http://api.lvh.me:3000/v1/user/justificativas" -d '' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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: 2e907587-14f3-4605-b2e5-c7fb920f5623
X-Runtime: 0.025552
Vary: Origin
Content-Length: 168

Body

{
  "message": "An error occurred while creating Justificativa.",
  "errors": {
    "data": [
      "can't be blank",
      "Invalid Date"
    ],
    "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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Content-Type: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1
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 "http://api.lvh.me:3000/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 "Host: api.lvh.me" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Content-Type: multipart/form-data; boundary=----------XnJLe9ZIbbGUYtzPQJ16u1" \
	-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

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/"48b5931256b743e1ad84aa54c4ed5175"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 188441ac-a257-4a09-94df-950acf49dbf1
X-Runtime: 0.026613
Vary: Origin
Content-Length: 303

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/2025/08/600348341/962157313/atestado.png",
  "rejection_motivation": null,
  "data_final": null
}

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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

justificativa[data]=2019-1-2&justificativa[data_final]=2019-1-3&justificativa[motivo_id]=atestado&justificativa[description]=livre

cURL

curl "http://api.lvh.me:3000/v1/user/justificativas" -d 'justificativa[data]=2019-1-2&justificativa[data_final]=2019-1-3&justificativa[motivo_id]=atestado&justificativa[description]=livre' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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/"93692e4339312c4a3bbe37f74fd4a879"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 5af261d1-16cf-42ae-b58e-728852905e45
X-Runtime: 0.026273
Vary: Origin
Content-Length: 226

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

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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Cookie:

Query Parameters

data=01/02/2014
per_page=10

cURL

curl -g "http://api.lvh.me:3000/v1/user/pontos?data=01%2F02%2F2014&per_page=10" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"23b24ff89970e9f4a1a9ddee65af5e23"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 544a8c74-c0b9-4d76-a3ea-702638569c3d
X-Runtime: 0.054386
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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.226-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.226-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.226-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.226-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.226-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.226-03:00",
      "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Cookie:

Query Parameters

per_page=10
page=2

cURL

curl -g "http://api.lvh.me:3000/v1/user/pontos?per_page=10&page=2" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"84d21de7783b16d2a4bd07e781744737"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: c4d462f8-a2c1-4fe0-92da-2ec7ad41ff12
X-Runtime: 0.068121
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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.147-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.147-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.147-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.147-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.147-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.147-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.147-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.147-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.147-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.147-03:00",
      "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Cookie:

Query Parameters

per_page=10

cURL

curl -g "http://api.lvh.me:3000/v1/user/pontos?per_page=10" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"4d17497f50cd8e3957e95c89ed9eb34a"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 597c909b-b119-4cfa-a224-b5e777502828
X-Runtime: 0.069591
Vary: Origin
Content-Length: 15091

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 e BR512022000798-3",
    "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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.067-03:00",
      "created_at": "2025-08-25T14:23:38.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 e BR512022000798-3",
    "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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.067-03:00",
      "created_at": "2025-08-25T14:23:38.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 e BR512022000798-3",
    "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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.067-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.067-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.067-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.067-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.067-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.067-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.067-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.067-03:00",
      "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/user/pontos" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"4bb47c9fca79f8f71f805ff95566f391"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 8df562ee-1109-4dce-b0e5-0314f2b35a8e
X-Runtime: 0.055849
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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.001-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.001-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.001-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.001-03:00",
      "created_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.001-03:00",
      "created_at": "2025-08-25T14:23:38.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%3A0x000060ff83238640%3E

Headers

Host: api.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Cookie:

Query Parameters

logo=#<Rack::Test::UploadedFile:0x000060ff83238640>

cURL

curl -g "http://api.lvh.me:3000/v1/user/pontos/215362412.pdf?logo=%23%3CRack%3A%3ATest%3A%3AUploadedFile%3A0x000060ff83238640%3E" -X GET \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Platform-Auth: mobile" \
	-H "Cookie: "

Response

Simulated Response

Status

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: 8d3b3ef2-ccb8-4447-b05e-114461863624
X-Runtime: 0.426203
Vary: Origin
Content-Length: 291336

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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

ponto[latitude]=10&ponto[longitude]=15

cURL

curl "http://api.lvh.me:3000/v1/user/pontos" -d 'ponto[latitude]=10&ponto[longitude]=15' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Platform-Auth: mobile" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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/"d3a7a647c575119a9a2ba88ff3fb2c19"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: a96c2dcd-4a5e-448c-8d36-fb29be15434d
X-Runtime: 0.038539
Vary: Origin
Content-Length: 1607

Body

{
  "id": 1071408924,
  "data": "2025-08-25",
  "hora": "14:23",
  "equipamento_id": 51636476,
  "processado": false,
  "ponto_geo_locale": {
    "latitude": 10.0,
    "longitude": 15.0
  },
  "nsr": 1,
  "registro_inpi": "BR512022000771-1 e BR512022000798-3",
  "coletor_id": 1,
  "offline": false,
  "created_at": "2025-08-25T14:23:51.323-03:00",
  "cpf": "07155744989",
  "codigo_hash": "401699ceadcb81fb94fbddd3bcd7269dc55930c54f4b372d57075b81b13ab3e3",
  "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": "2025-08-25T14:23:38.000-03:00",
      "updated_at": "2025-08-25T14:23:38.000-03:00",
      "cliente_id": 571096427,
      "cei": null,
      "codigo_registro_folha": "23",
      "ativo": true,
      "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
    },
    "departamento": null,
    "biometria": null,
    "email": null,
    "phone": null,
    "etnico_racial": null,
    "updated_at": "2025-08-25T14:23:51.291-03:00",
    "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Content-Type: application/x-www-form-urlencoded
Cookie:

cURL

curl "http://api.lvh.me:3000/v1/user/pontos" -d '' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Platform-Auth: mobile" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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: ce531cc5-1c4b-4930-be4c-92e1b513a6b2
X-Runtime: 0.019507
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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

pontos[][data]=&pontos[][hora]=10%3A00

cURL

curl "http://api.lvh.me:3000/v1/user/pontos/offline" -d 'pontos[][data]=&pontos[][hora]=10%3A00' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Platform-Auth: mobile" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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: 65cbb613-b377-482e-96d1-895159e92cbd
X-Runtime: 0.023810
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.lvh.me
X-Auth-Token: te8dx4vyN355i4ku-gm3
Platform-Auth: mobile
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

pontos[][latitude]=10&pontos[][longitude]=15&pontos[][data]=2020-01-01&pontos[][hora]=10%3A00

cURL

curl "http://api.lvh.me:3000/v1/user/pontos/offline" -d 'pontos[][latitude]=10&pontos[][longitude]=15&pontos[][data]=2020-01-01&pontos[][hora]=10%3A00' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: te8dx4vyN355i4ku-gm3" \
	-H "Platform-Auth: mobile" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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/"10da0957eef7ed0aeeff42690b9f3fa0"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 2718d5c8-82fb-4b54-8b1d-83478ede8d67
X-Runtime: 0.039191
Vary: Origin
Content-Length: 1608

Body

[
  {
    "id": 1071408930,
    "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 e BR512022000798-3",
    "coletor_id": 1,
    "offline": true,
    "created_at": "2025-08-25T14:23:51.613-03:00",
    "cpf": "07155744989",
    "codigo_hash": "882aa6121d4a1ae20c05d87738dfc5318cbab4d511b224b0a94b084fd801751d",
    "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": "2025-08-25T14:23:38.000-03:00",
        "updated_at": "2025-08-25T14:23:38.000-03:00",
        "cliente_id": 571096427,
        "cei": null,
        "codigo_registro_folha": "23",
        "ativo": true,
        "uid": "a43bedds-ba77-4062-46c0-58f4444dad33"
      },
      "departamento": null,
      "biometria": null,
      "email": null,
      "phone": null,
      "etnico_racial": null,
      "updated_at": "2025-08-25T14:23:51.580-03:00",
      "created_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: ye8dx4vyN3__i4ku-gm_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

version[name]=v1&version[apelido]=v+one&version[data_lancamento]=2017-01-01&version[descricao]=Description

cURL

curl "http://api.lvh.me:3000/v1/versions" -d 'version[name]=v1&version[apelido]=v+one&version[data_lancamento]=2017-01-01&version[descricao]=Description' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: ye8dx4vyN3__i4ku-gm_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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/"a526a405a0307c50a7354a63c96adaed"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: a588b8ac-9343-41ed-89bf-6a6e98ce8ad5
X-Runtime: 0.025439
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": "2025-08-25T14:23:52.416-03:00",
  "updated_at": "2025-08-25T14:23:52.416-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.lvh.me
X-Auth-Token: ye8dx4vyN3__i4ku-gm_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

version[name]=

cURL

curl "http://api.lvh.me:3000/v1/versions" -d 'version[name]=' -X POST \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: ye8dx4vyN3__i4ku-gm_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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: 49b87443-e42b-451f-858f-7bf232c63991
X-Runtime: 0.026092
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.lvh.me
X-Auth-Token: ye8dx4vyN3__i4ku-gm_
Content-Type: application/x-www-form-urlencoded
Cookie:

cURL

curl "http://api.lvh.me:3000/v1/versions/980190962" -d '' -X DELETE \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: ye8dx4vyN3__i4ku-gm_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-H "Cookie: "

Response

Simulated Response

Status

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Cache-Control: no-cache
X-Request-Id: 13ce5788-e6f7-4f70-968c-f9aa23a13dc6
X-Runtime: 0.024479
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.lvh.me
X-Auth-Token: ye8dx4vyN3__i4ku-gm_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/versions/980190962" -X GET \
	-H "Host: api.lvh.me" \
	-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

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/"12286ee45a63bd10ed28d596d410a67b"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 47634e2a-78a0-4c55-9ea7-2570ef8e6bfa
X-Runtime: 0.027503
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": "2025-08-25T14:23:38.000-03:00",
  "updated_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: ye8dx4vyN3__i4ku-gm_
Cookie:

cURL

curl -g "http://api.lvh.me:3000/v1/versions" -X GET \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: ye8dx4vyN3__i4ku-gm_" \
	-H "Cookie: "

Response

Simulated Response

Status

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/"3849f3a407ff15557d8745be5363ac8e"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 61e9aced-866a-4372-8221-cbf078eea532
X-Runtime: 0.074200
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": "2025-08-25T14:23:38.000-03:00",
    "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
    "updated_at": "2025-08-25T14:23:38.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": "2025-08-25T14:23:38.000-03:00",
    "updated_at": "2025-08-25T14:23:38.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.lvh.me
X-Auth-Token: ye8dx4vyN3__i4ku-gm_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

version[descricao]=good+version

cURL

curl "http://api.lvh.me:3000/v1/versions/980190962" -d 'version[descricao]=good+version' -X PATCH \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: ye8dx4vyN3__i4ku-gm_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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/"0a2de6f33b2efd72104dd744a26dcafe"
Cache-Control: max-age=0, private, must-revalidate
X-Request-Id: 44090347-2e98-48b5-b963-abbade858006
X-Runtime: 0.028264
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": "2025-08-25T14:23:38.000-03:00",
  "updated_at": "2025-08-25T14:23:52.477-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.lvh.me
X-Auth-Token: ye8dx4vyN3__i4ku-gm_
Content-Type: application/x-www-form-urlencoded
Cookie:

Body

version[name]=

cURL

curl "http://api.lvh.me:3000/v1/versions/980190962" -d 'version[name]=' -X PATCH \
	-H "Host: api.lvh.me" \
	-H "X-Auth-Token: ye8dx4vyN3__i4ku-gm_" \
	-H "Content-Type: application/x-www-form-urlencoded" \
	-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

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: a38701a4-3f0e-4795-974c-55ab176bad1b
X-Runtime: 0.026716
Vary: Origin
Content-Length: 69

Body

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

API PTRP - Documentação

Obter suas chaves de acesso (Token)

Como obter seu token manualmente

Como obter suas chaves de acesso por login

Níveis de Acesso

Documentação

Suporte

Auth

Alterando a senha

Endpoint

Parameters

Request

Route

Headers

Body

cURL

Response

Response Fields

Status

Headers

Body

Encerrando a conta

Endpoint

Request

Route

Headers

cURL

Response

Response Fields

Status

Headers

Body

Login

Endpoint

Parameters

Request

Route

Headers

Body

cURL

Response

Response Fields

Status

Headers

Body

Logout

Endpoint

Request

Route

Headers

cURL

Response

Response Fields

Status

Headers

Body

Renovar token

Endpoint

Request

Route

Headers

cURL

Response

Response Fields

Status

Headers

Body

Ações em Massa

Criando Justificativas

Endpoint

Parameters

Request

Route

Headers

Body

cURL

Response

Response Fields

Status

Headers