12 Marcações
12.1 Consultar uma marcação
Endpoint
https://integracao.topponto.com.br/marcacoes/idMarcacao
Estrutura
| Método | Cabeçalho | Path Variable |
| GET | Content-Type: application/json X-Auth-Token: “token”X-Api-Version: 1 | Integer |
Requisição (URL)
https://integracao.topponto.com.br/marcacoes/11
Resposta
{
"message": "Consulta realizada com sucesso.",
"body": {
"idMarcacao": 11,
"dataHora": "2025-09-12 14:08",
"status": "Original",
"motivo": null,
"coletor": {
"numeroSerie": null,
"tipoEquipamento": "REP-P:Mobile",
"local": "Rodovia Curitiba - Ponta Grossa Br-277, 2070 - Santo Inácio, Curitiba - Paraná, 82010-470, Brasil",
"latitude": "-25.4300052",
"longitude": "-49.333424699999995"
},
"funcionario": {
"idFuncionario": 1,
"matricula": null,
"cpf": "11144477735",
"nome": "Funcionario 1",
"empresa": "Topdata Sistemas de Automação Ltda",
"idEmpresa": 1
},
"nsr": "4"
},
"status": 200
}Erros catalogados
| Mensagem | Código Http |
| O id não pode ser nulo ou zero. | 400 – Bad Request |
| O id informado deve ser um número inteiro. | 400 – Bad Request |
| O id informado não foi encontrado. | 404 – Not Found |
12.2 Consultar marcações de um período
Consultar marcações de um período.
Endpoint
https://integracao.topponto.com.br/marcacoes
Estrutura
| Método | Cabeçalho | Path Variable |
| POST | Content-Type: application/json X-Auth-Token: “token”X-Api-Version: 1 | Integer |
Parâmetros
| Campo | Tipo | Restrição | Obrigatório | Descrição |
| idFuncionario | Number | 1 a N (Número Positivo) ou NULL | Não | Identificador único do funcionario. |
| periodoInicio | String | Exatos 10 caracteres | Sim | Data de inicio do dados (formato DD/MM/AAAA). |
| periodoFim | String | Exatos 10 caracteres | Sim | Data final do dados (formato DD/MM/AAAA). |
| originais | Boolean | true ou false | Sim | true para buscar marcações originais. |
| incluidas | Boolean | true ou false | Sim | true para buscar marcações incluídas. |
| desconsideradas | Boolean | true ou false | Sim | true para buscar marcações desconsideradas. |
| preAssinaladas | Boolean | true ou false | Sim | true para buscar marcações pré-assinaladas. |
Requisição (JSON)
{
"idFuncionario": null,
"dataInicio": "08/09/2025",
"dataFim": "09/09/2025",
"originais": true,
"incluidas":true,
"desconsideradas": true,
"preAssinaladas": true
}Resposta
{
"message": "Consulta realizada com sucesso.",
"body": [
{
"idMarcacao": 33,
"dataHora": "2025-09-08 08:00",
"status": "Incluída",
"motivo": "Acabou a bobina da impressora",
"coletor": null,
"funcionario": {
"idFuncionario": 1,
"matricula": null,
"cpf": "11144477735",
"nome": "Funcionario 1",
"empresa": "Topdata Sistemas de Automação Ltda",
"idEmpresa": 1
},
"nsr": null
},
{
"idMarcacao": 34,
"dataHora": "2025-09-08 18:00",
"status": "Incluída",
"motivo": "Acabou a bobina da impressora",
"coletor": null,
"funcionario": {
"idFuncionario": 1,
"matricula": null,
"cpf": "11144477735",
"nome": "Funcionario 1",
"empresa": "Topdata Sistemas de Automação Ltda",
"idEmpresa": 1
},
"nsr": null
},
{
"idMarcacao": 35,
"dataHora": "2025-09-08 12:00",
"status": "Pré-assinalada",
"motivo": null,
"coletor": null,
"funcionario": {
"idFuncionario": 1,
"matricula": null,
"cpf": "11144477735",
"nome": "Funcionario 1",
"empresa": "Topdata Sistemas de Automação Ltda",
"idEmpresa": 1
},
"nsr": null
},
{
"idMarcacao": 36,
"dataHora": "2025-09-08 13:00",
"status": "Pré-assinalada",
"motivo": null,
"coletor": null,
"funcionario": {
"idFuncionario": 1,
"matricula": null,
"cpf": "11144477735",
"nome": "Funcionario 1",
"empresa": "Topdata Sistemas de Automação Ltda",
"idEmpresa": 1
},
"nsr": null
},
{
"idMarcacao": 37,
"dataHora": "2025-09-09 08:00",
"status": "Incluída",
"motivo": "Acabou a bobina da impressora",
"coletor": null,
"funcionario": {
"idFuncionario": 2,
"matricula": null,
"cpf": "00000000000",
"nome": "Funcionario 2",
"empresa": "Topdata Sistemas de Automação Ltda",
"idEmpresa": 1
},
"nsr": null
},
{
"idMarcacao": 38,
"dataHora": "2025-09-09 12:00",
"status": "Incluída",
"motivo": "Acabou a bobina da impressora",
"coletor": null,
"funcionario": {
"idFuncionario": 2,
"matricula": null,
"cpf": "00000000000",
"nome": "Funcionario 2",
"empresa": "Topdata Sistemas de Automação Ltda",
"idEmpresa": 1
},
"nsr": null
}
],
"status": 200
}| Campo | Mensagem | Código Http |
| idFuncionario | O id do funcionário deve ser maior que 0. | 400 – Bad Request |
| dataInicio | A data de início deve estar no formato dd/MM/yyyy e ser uma data válida. | 400 – Bad Request |
| O data de início ultrapassou o limite definido. | 400 – Bad Request | |
| A data de início não pode ser vazia. | 400 – Bad Request | |
| dataFim | A data de fim deve estar no formato dd/MM/yyyy e ser uma data válida. | 400 – Bad Request |
| A data de fim não pode ser vazia. | 400 – Bad Request | |
| A data de fim ultrapassou o limite definido. | 400 – Bad Request | |
| A data de fim não pode ser menor à data inicial. | 400 – Bad Request | |
| dataInicio dataFim | O intervalo entre as datas excede o limite permitido de meses para consulta de marcações. | 400 – Bad Request |