greytHR 数据 API：休假、打卡与工资单

Greytip Software · 企业办公 4.5 ★

greytHR 是 Greytip Software 面向在 greytHR 租户上运行人事栈的企业员工的官方 Android HR 客户端。工人输入公司网址后，用 identity-server 登录或 OTP（短信或 WhatsApp）进入，随后以地理围栏、人脸或门禁码打卡、请假、补刷卡、查看谁在岗、下载工资单与 Form 16 / Form 12BB、申报个税、填写工时表并开具服务台工单。开发商位于印度卡纳塔克邦班加罗尔科拉曼加拉 6th Block 17th H Main Grape Garden 29&30，邮编 560095；Play 上约 9.1 万条评价给出 4.5 分，下载量 100 万+。它是全套员工自助应用而不是单一打卡钟，与 Darwinbox、Workday、ADP Mobile Solutions、Paylocity、Dayforce 同属印度企业发给员工、通勤打开的 HRIS。

进出刷卡记下 inSwipe 对 outSwipe，含 swipeTime、swipeCaptureType 与 shiftName。休假芯片列出 leaveName，旁为 leaveTypeBalance、openingBalance 与 availed。谁在岗卡片统计 whoIsIn 对 employeesWhoNeedToBeIn。工资单文件以 netPay、grossPay 与 netPayInWords 为键；登录名片是 employeeCode 加 designation、department 与 joiningDate。

劳动力机器人提交科拉曼加拉租户已经展示的同一 leaveTypeId；工时任务把 latitude/longitude 打卡写进 ERP 花名册；薪酬归档把 netPay 与 Form 16 放在一起——openData Studio 把这条 ESS 闭环变成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

解析公司网址
POST /v1/greythr/tenant osint
把公司网址解析为 companyName 与下一步 OAuth 使用的 issuer。
认证方式：无需登录。请求体为首页输入的公司网址 domainName。
- domainName
- companyName
- issuer
```
POST /v1/greythr/tenant HTTP/1.1
Content-Type: application/json

{
  "domainName": "acme"
}
```
```
{
  "domainName": "acme",
  "companyName": "Acme Foods",
  "issuer": "acme-ess"
}
```
登录换取 access token
POST /v1/greythr/session osint
用公司网址加 identity-server 登录换取 accessToken 与 refreshToken。
认证方式：无需登录。请求体为 domainName 与 identity-server 登录。返回 accessToken 与 refreshToken；之后请求使用 Authorization Bearer accessToken。
- domainName
- username
- password
- accessToken
- refreshToken
- employeeId
```
POST /v1/greythr/session HTTP/1.1
Content-Type: application/json

{
  "domainName": "acme",
  "username": "anita.rao",
  "password": "••••"
}
```
```
{
  "accessToken": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9",
  "refreshToken": "rt-88c1",
  "employeeId": "44102"
}
```
请求登录 OTP
POST /v1/greythr/otp osint
在指定租户上通过 ott（短信或 WhatsApp）发送一次性登录码。
认证方式：无需登录。请求体为 domainName 与 ott 通道（短信或 WhatsApp）。
- domainName
- ott
- otp
- status
```
POST /v1/greythr/otp HTTP/1.1
Content-Type: application/json

{
  "domainName": "acme",
  "ott": "sms"
}
```
```
{
  "status": true,
  "otp": "sent"
}
```

登录员工资料

GET /v1/greythr/me osint

返回登录员工名片：employeeCode、designation、department 与 joiningDate。

认证方式： POST /v1/greythr/session 签发的 Bearer accessToken。

employeeId
employeeCode
employeeName
employeeNo
designation
department
joiningDate

GET /v1/greythr/me HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9
Accept: application/json

{
  "employeeId": "44102",
  "employeeCode": "EMP-1024",
  "employeeName": "Anita Rao",
  "employeeNo": "1024",
  "designation": "Analyst",
  "department": "Finance",
  "joiningDate": "2021-04-12"
}

休假余额

GET /v1/greythr/leave opendata

分页休假类型行，含 leaveTypeBalance、openingBalance 与 availed。

认证方式： POST /v1/greythr/session 签发的 Bearer accessToken。

employeeId
items
leaveTypeId
leaveName
leaveTypeBalance
openingBalance
availed

GET /v1/greythr/leave?employeeId=44102 HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9
Accept: application/json

{
  "items": [{
    "leaveTypeId": "CL",
    "leaveName": "Casual Leave",
    "leaveTypeBalance": "8.5",
    "openingBalance": "12",
    "availed": "3.5"
  }]
}

申请休假

POST /v1/greythr/leave/apply opendata

提交 leaveTypeId 在 fromDate 与 toDate 之间、带 dayType 的休假申请。

认证方式： POST /v1/greythr/session 签发的 Bearer accessToken。

leaveTypeId
employeeId
fromDate
toDate
dayType
status
message

POST /v1/greythr/leave/apply HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9
Content-Type: application/json

{
  "leaveTypeId": "CL",
  "employeeId": "44102",
  "fromDate": "2026-10-14",
  "toDate": "2026-10-16",
  "dayType": "FULL"
}

{
  "status": true,
  "message": "submitted"
}

当日考勤明细

GET /v1/greythr/attendance opendata

返回当天刷卡对：inSwipe、outSwipe、totalHours 与 shiftName。

认证方式： POST /v1/greythr/session 签发的 Bearer accessToken。

employeeId
attendanceDate
shiftName
shiftId
inSwipe
outSwipe
totalHours
swipeTime

GET /v1/greythr/attendance?employeeId=44102&attendanceDate=2026-10-02 HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9
Accept: application/json

{
  "attendanceDate": "2026-10-02",
  "shiftName": "General",
  "shiftId": "S-1",
  "inSwipe": "09:12",
  "outSwipe": "18:40",
  "totalHours": "09:28",
  "swipeTime": "09:12"
}

提交考勤刷卡

POST /v1/greythr/attendance/punch opendata

用 swipeCaptureType（地理围栏、人脸或 accessCode）加经纬度记录一次进或出刷卡。

认证方式： POST /v1/greythr/session 签发的 Bearer accessToken。

employeeId
latitude
longitude
swipeCaptureType
accessCode
swipeTime
status

POST /v1/greythr/attendance/punch HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9
Content-Type: application/json

{
  "employeeId": "44102",
  "latitude": 12.9352,
  "longitude": 77.6245,
  "swipeCaptureType": "GEO",
  "accessCode": "A1"
}

{
  "status": true,
  "swipeTime": "09:12",
  "swipeCaptureType": "GEO"
}

谁在岗

GET /v1/greythr/who-is-in opendata

统计 whoIsIn 对 employeesWhoNeedToBeIn，并列出当日已刷入员工。

认证方式： POST /v1/greythr/session 签发的 Bearer accessToken。

attendanceDate
whoIsIn
employeesWhoNeedToBeIn
items
employeeId
employeeName
inSwipe

GET /v1/greythr/who-is-in?attendanceDate=2026-10-02 HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9
Accept: application/json

{
  "whoIsIn": 42,
  "employeesWhoNeedToBeIn": 50,
  "items": [{
    "employeeId": "44102",
    "employeeName": "Anita Rao",
    "inSwipe": "09:12"
  }]
}

列出工资单

GET /v1/greythr/payslips openfinance

列出已发布工资单月份，含 netPay 与 grossPay。

认证方式： POST /v1/greythr/session 签发的 Bearer accessToken。

items
month
netPay
grossPay

GET /v1/greythr/payslips HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9
Accept: application/json

{
  "items": [{
    "month": "2026-09",
    "netPay": "84250.00",
    "grossPay": "110000.00"
  }]
}

下载工资单

GET /v1/greythr/payslips/{month} openfinance

返回单月工资单：netPay、grossPay、deductions 与 netPayInWords。

认证方式： POST /v1/greythr/session 签发的 Bearer accessToken。

month
netPay
grossPay
deductions
netPayInWords

GET /v1/greythr/payslips/2026-09 HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9
Accept: application/json

{
  "month": "2026-09",
  "netPay": "84250.00",
  "grossPay": "110000.00",
  "deductions": "25750.00",
  "netPayInWords": "Eighty four thousand two hundred fifty"
}

假日日历

GET /v1/greythr/holidays opendata

返回租户假日日历：holidayDate、holidayName 与 restrictedHoliday。

认证方式： POST /v1/greythr/session 签发的 Bearer accessToken。

year
items
holidayDate
holidayName
restrictedHoliday

GET /v1/greythr/holidays?year=2026 HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9
Accept: application/json

{
  "items": [{
    "holidayDate": "2026-10-02",
    "holidayName": "Gandhi Jayanti",
    "restrictedHoliday": false
  }]
}

个税申报窗口
GET /v1/greythr/tax openfinance
返回个税申报窗口以及 form16 与 form12BBDownload 开关。
认证方式： POST /v1/greythr/session 签发的 Bearer accessToken。
- declarationId
- declarationStatus
- form16
- form12BBDownload
- itStatement
```
GET /v1/greythr/tax HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9
Accept: application/json
```
```
{
  "declarationId": "FY26-1",
  "declarationStatus": "open",
  "form16": true,
  "form12BBDownload": true,
  "itStatement": "2026"
}
```

数据类别

员工资料
休假余额
考勤刷卡
谁在岗
工资单
假日
个税申报
登录会话

数据使用场景与案例

劳动力机器人休假叠加
助手轮询 GET /v1/greythr/leave（leaveTypeBalance、openingBalance、availed）再 POST /v1/greythr/leave/apply，让经理机器人无需打开应用即可提交 Casual Leave。
刷卡对进 ERP 打卡日志
工时任务读取 GET /v1/greythr/attendance（inSwipe、outSwipe、shiftName）并 POST /v1/greythr/attendance/punch（latitude、longitude、swipeCaptureType），让每次地理刷卡落在 ERP 花名册旁。
谁在岗看板加假日日历
楼层看板把 GET /v1/greythr/who-is-in（whoIsIn、employeesWhoNeedToBeIn）与 GET /v1/greythr/holidays（holidayDate、restrictedHoliday）接在一起，让在岗人数挨着租户日历。
工资单与 Form 16 归档
薪酬归档把 GET /v1/greythr/payslips（netPay、grossPay）与 GET /v1/greythr/payslips/{month}（netPayInWords、deductions）以及 GET /v1/greythr/tax（form16、form12BBDownload）接在一起。

常见问题

greytHR 如何认证 API 调用？

POST /v1/greythr/tenant 把公司网址解析为 companyName 与 issuer。POST /v1/greythr/session 用该 domainName 加 identity-server 登录换取 accessToken、refreshToken 与 employeeId。POST /v1/greythr/otp 可先发一次性验证码。之后的请求携带 Authorization Bearer accessToken。

哪些端点暴露休假、刷卡与谁在岗？

GET /v1/greythr/leave 返回 leaveTypeBalance、openingBalance 与 availed。POST /v1/greythr/leave/apply 提交申请。GET /v1/greythr/attendance 返回 inSwipe、outSwipe 与 shiftName。POST /v1/greythr/attendance/punch 记录地理或人脸刷卡。GET /v1/greythr/who-is-in 返回 whoIsIn 对 employeesWhoNeedToBeIn。

返回哪些员工资料字段？

GET /v1/greythr/me 返回 employeeId、employeeCode、employeeName、employeeNo、designation、department 与 joiningDate。

API 是否覆盖工资单、假日与个税？

覆盖。GET /v1/greythr/payslips 列出 netPay 与 grossPay。GET /v1/greythr/payslips/{month} 返回 deductions 与 netPayInWords。GET /v1/greythr/holidays 返回 holidayDate 与 restrictedHoliday。GET /v1/greythr/tax 返回 declarationStatus、form16 与 form12BBDownload。

与 greytHR 相似的应用

Darwinbox — Darwinbox 是海德拉巴自研 HCM 员工端（休假、打卡、CTC）；greytHR 是班加罗尔自研 ESS，带公司网址登录、谁在岗与 Form 12BB。
Workday — Workday 是美系 HCM 套件（工时、缺勤、薪酬）；greytHR 是印度自研对照，员工用它处理刷卡、休假与工资单。
ADP Mobile Solutions — ADP Mobile Solutions 是美系薪酬与工时客户端；greytHR 为 greytHR 租户覆盖同一套刷卡、休假与工资单闭环。
Paylocity — Paylocity 是美国中端 HCM 应用（打卡与发薪）；greytHR 是科拉曼加拉运营、印度企业发给员工的套件。
Dayforce — Dayforce（Ceridian）是面向发薪与排班的劳动力管理客户端；greytHR 则以租户刷卡、谁在岗与 Form 16 为中心。
Keka HR — Keka 是另一款印度自研 HRMS（休假、考勤、薪酬），与 greytHR 在班加罗尔市场的员工端重叠。
Zoho People — Zoho People 是 Zoho 的 HR 模块；greytHR 是带地理围栏刷卡、谁在岗与 Form 12BB 下载的专用 ESS 租户。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

greytHR 数据 API：休假、打卡与工资单

应用截图

API 端点一览

解析公司网址

登录换取 access token

请求登录 OTP

登录员工资料

休假余额

申请休假

当日考勤明细

提交考勤刷卡

谁在岗

列出工资单

下载工资单

假日日历

个税申报窗口

数据类别

数据使用场景与案例

劳动力机器人休假叠加

刷卡对进 ERP 打卡日志

谁在岗看板加假日日历

工资单与 Form 16 归档

常见问题

与 greytHR 相似的应用

更多企业办公类应用

ADP Mobile Solutions

Box

CryptoRush: Crypto Simulator

Darwinbox

相关主题

需要集成这个 App 的数据 API？

greytHR 数据 API：休假、打卡与工资单

应用截图

API 端点一览

解析公司网址

登录换取 access token

请求登录 OTP

登录员工资料

休假余额

申请休假

当日考勤明细

提交考勤刷卡

谁在岗

列出工资单

下载工资单

假日日历

个税申报窗口

数据类别

数据使用场景与案例

劳动力机器人休假叠加

刷卡对进 ERP 打卡日志

谁在岗看板加假日日历

工资单与 Form 16 归档

常见问题

相关应用

与 greytHR 相似的应用

更多企业办公类应用

ADP Mobile Solutions

Box

CryptoRush: Crypto Simulator

Darwinbox

相关主题

需要集成这个 App 的数据 API？