change_labor_ledger_user_data (노임대장 사용자 정보 변경)
노임대장의 특정 사용자 정보(직종, 업체, 연락처, 주소)를 변경합니다.
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/change_labor_ledger_user_data |
| 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 |
- |
| new_field |
string |
O |
새로운 직종 |
빈 값이면 "없음"으로 저장 |
| new_labor_supplier |
string |
O |
새로운 업체명 |
빈 값이면 "없음"으로 저장, string 타입만 허용 |
| new_phone |
string |
O |
새로운 연락처 |
- |
| new_sub_address |
string |
O |
새로운 상세 주소 |
- |
| new_main_address |
string |
O |
새로운 기본 주소 |
- |
요청 예시
{
"token": "eyJhbGci...",
"company_id": "abc123",
"site_id": "site456",
"year": 2024,
"month": 3,
"UID": "user789",
"new_field": "목공",
"new_labor_supplier": "삼성건설",
"new_phone": "01012345678",
"new_sub_address": "101동 202호",
"new_main_address": "서울시 강남구 테헤란로 123"
}
응답
성공 (200)
{
"message": "노동 대장 사용자 정보 변경 완료"
}
실패
| 코드 |
message |
원인 |
| 500 |
"해당 회사의 멤버가 아닙니다." |
요청자가 해당 회사의 멤버가 아닌 경우 |
| 500 |
"labor_supplier는 string 형태여야 합니다." |
new_labor_supplier가 string이 아닌 경우 |
| 500 |
"해당 노동 대장이 없습니다." |
해당 연/월의 노임대장이 존재하지 않는 경우 |
| 500 |
"해당 사용자가 없습니다." |
노임대장에 해당 UID의 사용자가 없는 경우 |
참고
- 연락처(new_phone)는 AES 암호화되어 저장됩니다.
- 상세 주소(new_sub_address)도 AES 암호화되어 저장됩니다.
- 업체(labor_supplier)가 변경되면 수수료가 자동으로 재계산됩니다 (auto_commission이 True인 경우).
- 관련 API: [[get_labor_ledger_user_data]], [[change_labor_ledger_user_wage]]