create_labor_ledger_excel (노임대장 엑셀 파일 생성)
노임대장 데이터를 엑셀 파일로 생성하고 다운로드 URL을 반환합니다.
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/create_labor_ledger_excel |
| 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) |
- |
요청 예시
{
"token": "eyJhbGci...",
"company_id": "abc123",
"site_id": "site456",
"year": 2024,
"month": 3
}
응답
성공 (200)
{
"message": "노임대장 생성 성공",
"url": "https://storage.googleapis.com/construction24-test.firebasestorage.app/companies/abc123/sites/site456/labor_ledger/강남역현장_202403.xlsx?..."
}
실패
| 코드 |
message |
원인 |
| 500 |
"해당 회사의 멤버가 아닙니다." |
요청자가 해당 회사의 멤버가 아닌 경우 |
| 500 |
"해당 노임 대장이 없습니다." |
해당 연/월의 노임대장이 존재하지 않는 경우 |
참고
- 생성된 URL은 10분간 유효한 서명된 URL입니다.
- 엑셀 파일은 업체(태그)별로 시트가 분리되어 생성됩니다.
- 각 시트에는 노무비 지급명세서 형식으로 데이터가 출력됩니다.
- 포함 정보: 순서, 성명, 주민등록번호(마스킹), 연락처, 주소, 직종, 일별 공수, 공수합계, 단가, 금액, 수수료, 실수령액
- 관련 API: [[change_labor_ledger_meta_data]]