set_custom (업체 목록 설정)
회사의 업체 목록(labor_suppliers)과 수수료(commission) 설정을 관리합니다.
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/set_custom |
| Method |
POST |
| 인증 |
Firebase ID Token 필요 |
요청
Body
| 필드 |
타입 |
필수 |
설명 |
검증 |
| token |
string |
O |
Firebase ID Token |
- |
| company_id |
string |
O |
회사 ID |
- |
| labor_suppliers |
string[] |
O |
업체명 목록 |
- |
| commission |
object[] |
O |
수수료 설정 목록 |
labor_suppliers와 길이 일치 필요 |
commission 객체 구조
| 필드 |
타입 |
필수 |
설명 |
검증 |
| type |
string |
O |
수수료 타입 |
"amount" 또는 "percent" |
| value |
number |
O |
수수료 값 |
숫자 타입 |
요청 예시
{
"token": "eyJhbGci...",
"company_id": "company123",
"labor_suppliers": ["A건설", "B공사", "C토목"],
"commission": [
{ "type": "percent", "value": 5 },
{ "type": "amount", "value": 10000 },
{ "type": "percent", "value": 3 }
]
}
응답
성공 (200)
{
"message": "커스텀 설정이 성공적으로 업데이트되었습니다."
}
실패
| 코드 |
message |
원인 |
| 400 |
"labor_suppliers와 commission의 길이가 같아야 합니다." |
labor_suppliers 배열과 commission 배열의 길이가 다름 |
| 400 |
"commission은 배열이어야 합니다." |
commission이 배열 타입이 아님 |
| 400 |
"commission[{i}]는 dict 형태여야 합니다." |
commission의 각 요소가 객체가 아님 |
| 400 |
"commission[{i}]는 'type'과 'value' 키를 가져야 합니다." |
필수 키 누락 |
| 400 |
"commission[{i}].type은 'amount' 또는 'percent'여야 합니다." |
잘못된 type 값 |
| 400 |
"commission[{i}].value는 숫자여야 합니다." |
value가 숫자가 아님 |
| 500 |
"오류 발생: {에러 내용}" |
서버 오류 |
참고
- 관련 API: [[set_fields]], [[set_positions]]
- 데이터 저장 경로:
companies/{company_id}/settings/tags
- commission type별 의미:
amount: 고정 금액 수수료percent: 비율 기반 수수료 (%)