change_labor_ledger_user_wage (노임대장 사용자 단가/수수료 변경)
노임대장의 특정 사용자 단가와 수수료를 변경합니다.
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/change_labor_ledger_user_wage |
| Method |
POST |
| 인증 |
Firebase ID Token 필요 |
| 권한 |
해당 회사의 멤버 |
요청
Body
| 필드 |
타입 |
필수 |
설명 |
검증 |
| token |
string |
O |
Firebase ID Token |
- |
| company_id |
string |
O |
회사 ID |
- |
| site_id |
string |
O |
현장 ID |
- |
| year |
number |
O |
연도 (예: 2024) |
- |
| month |
number |
O |
월 (1-12) |
- |
| UID |
string |
O |
대상 사용자 UID |
- |
| field |
string |
O |
직종 |
- |
| labor_supplier |
string |
O |
소속 업체명 |
- |
| new_wage_rate |
number |
O |
새로운 단가 |
- |
| new_commission |
number |
O |
새로운 수수료 |
-1이면 자동 계산 모드 |
요청 예시
{
"token": "eyJhbGci...",
"company_id": "abc123",
"site_id": "site456",
"year": 2024,
"month": 3,
"UID": "user789",
"field": "목공",
"labor_supplier": "삼성건설",
"new_wage_rate": 200000,
"new_commission": -1
}
응답
성공 (200)
{
"message": "노동 대장 사용자 단가 변경 완료"
}
실패
| 코드 |
message |
원인 |
| 500 |
"해당 회사의 멤버가 아닙니다." |
요청자가 해당 회사의 멤버가 아닌 경우 |
| 500 |
"해당 노동 대장이 없습니다." |
해당 연/월의 노임대장이 존재하지 않는 경우 |
| 500 |
"해당 사용자가 없습니다." |
노임대장에 해당 UID의 사용자가 없는 경우 |
참고
new_commission이 -1이면 자동 계산 모드(auto_commission: true)로 설정되며, 업체별 수수료 설정에 따라 자동 계산됩니다.new_commission이 0 이상의 값이면 수동 입력 모드(auto_commission: false)로 설정됩니다.- 관련 API: [[change_labor_ledger_user_data]], [[change_labor_ledger_tag_data]]