참고
용어집
이 API 의 용어는 사장님이 앱과 웹에서 보는 말과 맞춰 두었습니다. 표기가 갈리는 곳은 양쪽을 병기합니다.
용어 대응표
사장님과 같은 말로 대화할 수 있도록, API 용어 옆에 앱·웹의 실제 화면 문구를 함께 적습니다.
| API 용어 | 앱·웹 화면 문구 | 비고 |
|---|---|---|
| 매장 · store | 매장 (설정 화면에서는 사업장) | 사업자등록번호 1개 = 사장님 계정 1개 |
| 직원 · staff | 직원 (근로계약서 문맥에서는 근로자) | "알바생"·"스태프"는 앱에 없는 말이다 |
| 출퇴근 기록 · attendance record | 앱은 출퇴근 내역, 웹은 출퇴근 기록 | 직원이 실제로 찍은 것 |
| 근무 기록 · work record | 앱은 근무 내역, 웹은 근무 기록 | 급여에 반영되는 기록 |
| 근무 스케줄 · schedule | 스케줄 | "근무표"는 거의 쓰지 않는다 |
| 사장님 | 사장님 (계약서 목록 열 제목만 고용주) | "사업자"는 사업자번호 등에서만 |
| 정산 · settled | 정산 · 정산 대기 · 정산 완료 | 상태어는 웹에만 있다 |
| 휴게시간 · break | 정책은 휴게, 실시간 상태는 휴식 중 | 아래 참조 |
| 지각 · late | 지각 | |
| 조퇴 · early_leave | 조퇴 | |
| 대타 · substitute | 대타 · 대타근무 | 스케줄 없는 날 근무 |
| 결근 · absence | 결근 | |
| 시급 · hourly_wage | 시급 | |
| 주휴수당 · holiday allowance | 주휴수당 | |
| 야간 · 연장 · 특근 | 야간 · 연장 · 특근 | 항상 셋이 한 묶음으로 다닌다 |
| 근로계약서 · contract | 근로계약서 | |
| 입사일 · 퇴사일 | 입사일 · 퇴사일 |
고용형태
!
'아르바이트'라는 값은 없습니다
흔히 쓰는 말이지만 기그의 고용형태에는 그 항목이 없습니다. 시간제 근무자는 보통 일용직 또는 기타소득자로 등록됩니다.
| API 값 | 화면 문구 |
|---|---|
| none | 없음 |
| full_time | 정규직 |
| daily | 일용직 |
| freelance | 프리랜서 |
| other_income | 기타소득자 |
사장님 앱의 일부 화면에는 다섯 번째 값이 아직 미설정으로 표시됩니다. 서버 기준 정식 명칭은 기타소득자이며, 이 API 도 그쪽을 따릅니다.
출퇴근 상태
사장님 앱의 출퇴근 화면은 아래 상태로 기록을 거릅니다.
출근 예정근무 중휴식 중퇴근지각조퇴대타
이 중 지각·조퇴·대타는 출퇴근 기록의 flags 로 제공됩니다. 근무 중·휴식 중·퇴근은 진행 상태이며, status 가 open 인 기록이 근무 중이거나 휴식 중인 세션입니다.
헷갈리는 말
휴게 vs 휴식
같은 시간을 가리키지만 문맥이 다릅니다. 휴게는 정책·계약 문맥 (휴게시간 설정, 근로계약서), 휴식은 실시간 상태 문맥(지금 휴식 중)입니다. 앱과 웹 모두 이렇게 구분합니다.
기록 vs 내역
앱은 출퇴근 내역·근무 내역, 웹은 출퇴근 기록·근무 기록이라 부릅니다. 같은 것을 가리키는 다른 표기입니다. 이 문서는 웹 쪽 표기를 따릅니다.
근무지
×
이 API 는 '근무지'라는 말을 쓰지 않습니다
기그 안에서 이 단어가 세 가지를 가리키기 때문입니다. 근로자 앱에서는 매장,
사장님 앱에서는 사실상 직원, 사장님 웹 급여 화면에서는 급여 필터 단위입니다. 혼동을 피하려고 이 문서는 매장과 직원만 씁니다.
출퇴근 기록 vs 근무 기록
가장 중요한 구분입니다. 핵심 개념에서 자세히 설명합니다 — 인건비는 근무 기록으로 계산해야 합니다.