HR & PAYROLL

인사·급여

급여는 티켓과 분리된 독립 도메인이에요. 지급, 공제·수당, 근태, 연차 별도 관리.

급여·근태·연차 데이터

급여 내역 생성은 제공되지만 수정·삭제 API는 아직 공개되지 않았어요. 인원 관리는 people API 기준.

  • POST/api/public-docs/salary-histories
    직원별 급여 내역, 지급 상태, 공제·수당 상세를 조회해요.
  • POST/api/public-docs/salary-histories-create
    외부 시스템에서 확정한 급여 내역을 생성해요.
  • POST/api/public-docs/attendances
    기간 기준 근태 데이터를 조회해요.
  • POST/api/public-docs/leave-balances
    기준일 기준 잔여 연차를 조회해요.
  • POST/api/public-docs/leave-histories
    기간 기준 연차 사용 이력을 조회해요.
  • POST/api/public-docs/holidays
    기간 기준 공휴일을 조회해요.
  • GET/api/public-docs/people
    워크스페이스 인원을 조회해요.
  • POST/api/public-docs/people
    외부 시스템 기준 인원을 초대해요.

주요 요청 필드

파라미터타입필수설명
startDatestring (YYYY-MM-DD)required조회 시작일. 기간 기반 조회는 1회 최대 31일 기준.
endDatestring (YYYY-MM-DD)required조회 종료일. 더 긴 기간은 31일 이하 분할 호출.
baseDatestring (YYYY-MM-DD)optional잔여 연차 계산 기준일.
employeeId / employeeNamenumber / stringrequired급여 내역 생성 대상 직원 정보.
paymentDatestring (YYYY-MM-DD)required급여 지급일.
POST /api/public-docs/salary-histories
$ curl -X POST https://app.granter.biz/api/public-docs/salary-histories \
-H "Content-Type: application/json" \
-H "Authorization: Basic <BASE64(API_KEY:)>" \
-d '{"startDate":"2026-02-01","endDate":"2026-02-28"}'
{ "data": [{ "employeeName": "직원 A" }] }

예시를 복사해
첫 요청을 보내세요

API 키는 Basic 인증으로 넣어요. 필요한 필드와 응답은 문서에서 확인.