change_labor_ledger_tag_data (노임대장 태그(업체) 설정 변경)
노임대장의 업체(태그) 목록과 각 업체별 수수료 설정을 변경합니다.
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/change_labor_ledger_tag_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) |
- |
| tags |
array |
O |
업체명 배열 |
commissions 배열과 길이가 같아야 함 |
| commissions |
array |
O |
수수료 설정 배열 |
각 요소는 {type, value} 형태의 객체 |
commissions 배열 요소 형식
| 필드 |
타입 |
설명 |
검증 |
| type |
string |
수수료 계산 방식 |
"amount" 또는 "percent" |
| value |
number |
수수료 값 |
숫자 타입만 허용 |
type: "amount": 고정 금액 방식 (수수료 = value x 공수)type: "percent": 비율 방식 (수수료 = value x 공수 x 단가)
요청 예시
{
"token": "eyJhbGci...",
"company_id": "abc123",
"site_id": "site456",
"year": 2024,
"month": 3,
"tags": ["삼성건설", "현대건설", "대우건설"],
"commissions": [
{ "type": "amount", "value": 10000 },
{ "type": "percent", "value": 0.05 },
{ "type": "amount", "value": 15000 }
]
}
응답
성공 (200)
{
"message": "노동 대장 태그 데이터 변경 완료"
}
실패
| 코드 |
message |
원인 |
| 400 |
"tags와 commissions의 길이가 같아야 합니다." |
두 배열의 길이가 다른 경우 |
| 400 |
"commissions은 배열이어야 합니다." |
commissions가 배열이 아닌 경우 |
| 400 |
"commissions[i]는 dict 형태여야 합니다." |
배열 요소가 객체가 아닌 경우 |
| 400 |
"commissions[i]는 'type'과 'value' 키를 가져야 합니다." |
필수 키가 누락된 경우 |
| 400 |
"commissions[i].type은 'amount' 또는 'percent'여야 합니다." |
type 값이 올바르지 않은 경우 |
| 400 |
"commissions[i].value는 숫자여야 합니다." |
value가 숫자가 아닌 경우 |
| 500 |
"해당 회사의 멤버가 아닙니다." |
요청자가 해당 회사의 멤버가 아닌 경우 |
| 500 |
"해당 노동 대장이 없습니다." |
해당 연/월의 노임대장이 존재하지 않는 경우 |
참고
- 태그 설정이 변경되면 auto_commission이 True인 모든 사용자의 수수료가 자동으로 재계산됩니다.
- 관련 API: [[change_labor_ledger_user_wage]]