加班費計算機API¶
使用 Google App Script,以Web API的方式提供一例一休新制加班費計算功能。本版API使用與手機版加班費計算機相同的Javascript Library。(版本:20161229)
API網址:¶
https://script.google.com/macros/s/AKfycbwmt2Z4GLwNsEncFJRC0vcl9WMF2yAmlUlzeh_IFvNOkGavXT7C/exec
輸入參數:¶
參數名稱 | 預設值 | 說明 |
---|---|---|
salary | 36000 | 月薪 |
type | 1 | 1 工作日 2 休息日 3 例假日 4 特休 5 國定假日 |
clock_in | 08:00 | 上班時間(打卡時間);格式: hh:mm |
clock_out | 18:00 | 下班時間(打卡時間);格式: hh:mm |
break_duration | 60 | 中間休息時間(分鐘) |
ot_unit | 60 | 加班計算單位(分鐘) |
ot_min | 30 | 超過多少分鐘便可算一個加班單位(分鐘)。例如預設是60/30的話,則 1小時35分,可算兩個小時。 |
所有參數都是選擇性的,缺乏的參數使用預設值。
JSON輸出:¶
Key | Value Type | 說明 |
---|---|---|
version | string | API版本 |
warning | [string] | 警告事項,目前只有一個。若加班時間超過四小時,顯示警告。 |
daily_pay | { value:(float), title:”時薪” } |
月薪/240 |
type_name | { value:(float), title:”性質” } |
工作日、休息日、例假日、休假日四種之一 |
work_hours | { value:(float), title:”實際工時” } |
下班時間-上班時間-休息時間 |
work_hours_law | { value:(float), title:”法定工時” } |
休息日以四小時為加班單位、休假日與例假日至少八小時。 |
extra_pay_1to8 | { value:(float), title:”前八小時額外工資” } |
當日工作前八小時的額外給付工資 |
extra_pay_9to12 | { value:(float), title:”後四小時加班工資” } |
當日工作第九到十二小時的額外給付工資 |
extra_pay_1to12 | { value:(float), title:”當日額外工資” } |
當日工作額外給付工資的總額(口語上的「加班費」) |
total_pay | { value:(float), title:”當日總工資” } |
當日底薪+額外給付工資總額 |
測試:¶
# dump to stdout
$ wget -qO- "https://script.google.com/macros/s/AKfycbwmt2Z4GLwNsEncFJRC0vcl9WMF2yAmlUlzeh_IFvNOkGavXT7C/exec" 2>/dev/null
# dump to stdout
$ curl -Lvs "https://script.google.com/macros/s/AKfycbwmt2Z4GLwNsEncFJRC0vcl9WMF2yAmlUlzeh_IFvNOkGavXT7C/exec" 2>/dev/null
範例:¶
範例 | 參數內容 |
工作日0900-1900 | ?type=1&clock_in=9:00&clock_out=19:00 |
休息日0900-1900,薪22K | ?type=2&clock_in=09:00&clock_out=19:00&salary=22000 |
例假日0900-2200,薪22K | ?type=3&clock_in=09:00&clock_out=22:00&salary=22000 |
特休0800-2200,薪22K,中間休息2小時 | ?type=4&clock_in=08:00&clock_out=22:00&salary=22000&break_duration=120 |
國定假日0900-21:46,薪22K;以30分鐘為一個加班單位,超過15分鐘可算一個加班單位 | ?type=5&clock_in=09:00&clock_out=22:00&salary=22000&ot_unit=30&ot_min=15 |