add_equipment_contract (장비 계약 추가)
장비에 새로운 계약 정보를 추가합니다.
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/add_equipment_contract |
| Method |
POST |
| 인증 |
Firebase ID Token 필요 |
| 권한 |
해당 회사의 멤버 |
요청
Body
| 필드 |
타입 |
필수 |
설명 |
검증 |
| token |
string |
O |
Firebase ID Token |
- |
| company_id |
string |
O |
회사 ID |
- |
| site_id |
string |
O |
현장 ID |
- |
| equipment_id |
string |
O |
장비 ID |
- |
| start_date |
string/timestamp |
O |
계약 시작일 |
end_date보다 이전이어야 함 |
| end_date |
string/timestamp |
O |
계약 종료일 |
start_date보다 이후여야 함 |
| amount |
number |
O |
계약 금액 |
- |
| is_tax_included |
boolean |
O |
부가세 포함 여부 |
- |
요청 예시
{
"token": "eyJhbGci...",
"company_id": "abc123",
"site_id": "site456",
"equipment_id": "equip789",
"start_date": "2024-03-01",
"end_date": "2024-06-30",
"amount": 11000000,
"is_tax_included": true
}
응답
성공 (200)
{
"message": "장비 계약 정보가 성공적으로 추가되었습니다."
}
실패
| 코드 |
message |
원인 |
| 400 |
"권한이 없습니다." |
요청자가 해당 회사의 멤버가 아닌 경우 |
| 400 |
"시작일이 종료일보다 이전일 수 없습니다." |
start_date >= end_date인 경우 |
| 500 |
"장비 계약 정보 추가 실패" |
서버 오류 |
참고
is_tax_included가 true이면: 세액 = amount / 11, 공급가액 = amount - 세액is_tax_included가 false이면: 세액 = amount * 0.1, 공급가액 = amount- 생성 시 created_at, created_by 필드가 자동으로 기록됩니다.
- 관련 API: [[edit_equipment_contract]], [[delete_equipment_contract]]