> For the complete documentation index, see [llms.txt](https://api-kit.prix.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-kit.prix.im/platform/get-deal.md).

# 프로젝트 상세 조회 API

프로젝트 상세 정보(재무정보 포함)를 조회할 수 있는 API를 제공합니다.

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

<br>

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

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

<br>

## Example

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

<br>

## Response

* `accountingRecords`의 `supplyAmount`(공급가액), `taxAmount`(세액)는 총액과 VAT 유형으로 계산된 값입니다.
* 계약서, 영업문서, 세금계산서, 커스텀테이블, 일정은 각 목록 조회 API의 `dealUuids` 파라미터로 조회해 주세요.

```json
{
  "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" // 완료일 (입금일로 활용)
          }
        }
      ]
    }
  }
}
```

<br>

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

<br>

## Error Codes

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

<br>