API 레퍼런스
급여 기초정보
급여 산정에 필요한 매장·직원 설정값이다. 계산 결과가 아니라 기초정보이며, 현재 설정값만 제공한다.
급여 기초정보
GET
/stores/{store_id}/payroll-basis payroll_basis:read매장 직원별 급여 설정을 조회한다.
!
소급 계산에 쓰지 마시오
as_of 는 조회 시각이며, 시점별 급여 이력은 제공되지 않는다. 과거 기간의 인건비는 근무 기록의 hourly_wage 스냅샷으로 계산한다.
경로 파라미터
| 이름 | 타입 | 설명 |
|---|---|---|
| store_id 필수 | string | 매장 식별자 |
응답 필드
| 이름 | 타입 | 설명 |
|---|---|---|
| as_of | datetime | 응답을 만든 시각. 적용 시점이 아니다 |
| pay_cycle | enum | unspecified | daily | weekly | monthly | custom |
| base_amount | int | 기본 급여액 |
알아둘 것
- pay_cycle 에 "시급" 값이 없다. 기그의 매장 설정에는 시급이라는 정산 유형이 존재하지 않으며, 시급은 근무 기록 단위로만 드러난다.
- 따라서 "이 매장은 시급제다" 를 매장 단위로 판단하지 말 것. 근무 기록의 stamp_type 을 보아야 한다.
cURL
curl -sS "https://developer.openapi.giig.app/api/v1/stores//payroll-basis" \
-H "Authorization: Bearer $GIG_ACCESS_TOKEN"200 OK · application/json
{
"store_id": "",
"as_of": "2026-09-02T14:00:00+09:00",
"currency": "KRW",
"staff": [
{
"staff_id": "",
"pay_cycle": "unspecified",
"base_amount": 10800,
"pay_day": 10,
"night_pay_enabled": true,
"night_pay_multiplier": 1.5,
"overtime_pay_enabled": true,
"overtime_pay_multiplier": 1.5,
"holiday_allowance_enabled": true,
"weekly_contract_hours": null,
"insurance": {
"national_pension": true,
"health": true,
"employment": true,
"industrial_accident": true
},
"income_tax_type": "simplified"
}
]
}에러 · application/json
{
"error": {
"code": "store_not_found",
"message": "...",
"request_id": "req_01J8XQ4M2N7P"
}
}