프로젝트 상세 조회 API

프로젝트 상세 정보를 조회할 수 있는 API입니다. 목록 조회 응답에 재무정보가 추가됩니다.

GET kit-api/v1/deals/{deal uuid}

Method: GET Endpoint: kit-api/v1/deals/{deal uuid}

Example

...kit-api/v1/deals/38432ad8-a21f-43b3-9912-44295e3ecca1

Response

• accountingRecords의 supplyAmount(공급가액), taxAmount(세액)는 총액과 VAT 유형으로 계산된 값입니다.

• 계약서, 영업문서, 세금계산서, 커스텀테이블, 일정은 각 목록 조회 API의 dealUuids 파라미터로 조회해 주세요.

{
  "ok": true, // api 성공
  "data": {
    "deal": {
      // ...프로젝트 목록 조회 응답과 동일한 필드 (id, uuid, customKey, name, status, memo, startDate, endDate, customers, managers, tags, columnItems, createdAt, updatedAt)
      "accountingRecords": [
        // 재무정보
        {
          "id": 11,
          "name": "1차 자문료", // 항목명
          "type": "REVENUE", // 매출(REVENUE), 매입(COST)
          "currency": "WON", // 통화 (WON, USD, EUR, JPY)
          "vat": "EXCLUSIVE", // VAT 유형 (EXCLUSIVE 별도, TAX_FREE 면세)
          "amount": 1100000, // 총액 (VAT 포함)
          "supplyAmount": 1000000, // 공급가액
          "taxAmount": 100000, // 세액
          "doneAmount": 1100000, // 입금/수금액 (없으면 null)
          "accrualDate": null, // 인식일 (없으면 null)
          "note": null, // 메모
          "counterpart": { "id": 1, "title": "A컴퍼니", "customKey": "A5-k159402" }, // 거래처
          "schedule": {
            // 연결된 일정 (없으면 null)
            "id": 21,
            "title": "1차 청구",
            "scheduleTime": "2026-02-01T00:00:00.000Z", // 일정일
            "isDone": true, // 완료 여부
            "doneDate": "2026-02-03T00:00:00.000Z" // 완료일 (입금일로 활용)
          }
        }
      ]
    }
  }
}

{
  "ok": false, // api 실패
  "message": "error message", // Error가 존재하면 message(string)로 전달
  "errorCode": "ERROR_CODE"
}

Error Codes

Status Code	Error Code	Description
404	NOT_FOUND_DEAL	프로젝트가 없거나 삭제되었거나 연결된 멤버에게 조회 권한이 없는 경우