POST/api/v1/time-recordsPortaria 671 MTE

Registrar Ponto (REP-P Imutável)

Registra a marcação de ponto de forma atômica no banco de dados. Emite o NSR sequencial exclusivo da empresa, calcula o Hash SHA-256 encadeado e devolve o comprovante digital oficial.

Exemplo de Requisição

Terminal / cURL

curl -X POST https://opontoup.vercel.app/api/v1/time-records \
  -H "Content-Type: application/json" \
  -H "X-Opontoup-Key: opu_live_sua_chave_secreta" \
  -d '{
    "employee_cpf": "123.456.789-00",
    "company_cnpj": "54.892.102/0001-99",
    "record_type": "ENTRY",
    "source": "APP_MOBILE",
    "latitude": -23.55052,
    "longitude": -46.633308,
    "accuracy_meters": 8.5,
    "idempotency_key": "punch_uuid_7f8c9b"
  }'

Resposta de Exemplo (HTTP 200 / 201)

{
  "message": "Marcação de ponto registrada com sucesso.",
  "is_idempotent_replay": false,
  "data": {
    "id": "c138fa09-8d76-4762-b91c-736f1c4ee3a1",
    "nsr": 1042,
    "recorded_at": "2026-10-09T13:40:00.000Z",
    "record_type": "ENTRY",
    "source": "APP_MOBILE",
    "sha256_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "employee": {
      "id": "e8d1234a-9999-4cde-8101-aa11bb22cc33",
      "name": "Maria Silva",
      "cpf": "12345678900"
    },
    "company": {
      "id": "a1b2c3d4-1111-2222-3333-444455556666",
      "trade_name": "opontoup Tecnologia",
      "cnpj": "54892102000199"
    },
    "receipt_text": "COMPROVANTE DE REGISTRO DE PONTO DO TRABALHADOR\nNSR: 000001042\nHASH SHA-256: e3b0c442..."
  }
}