견적서 생성

POST /v2/quote

특정 딜의 견적서를 생생합니다.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body parameters

Name	Type	Description
name	string	생성할 견적서의 이름 Required
dealId	string	생성할 견적서의 딜 Id Required
memo	string	견적서 생성 시 작성할 메모
fieldList	array	견적서의 데이터 필드
isMainQuote	boolean	메인 견적으로 설정할 지 여부
quoteProductList	array	견적서의 상품 목록
quoteProductList[].name	string	견적서 상품의 이름 Required
quoteProductList[].productId	string	견적서 상품의 id Required (quoteProduct가 있다면)
quoteProductList[].price	number	견적서 상품의 가격 Required (quoteProduct가 있다면)
quoteProductList[].amount	number	견적서 상품의 수량 Required (quoteProduct가 있다면)
quoteProductList[].paymentCount	number	견적서 상품의 결제 횟수 Required (단, 견적서 구성상품의 유형이 구독 상품인 경우에 한함)
quoteProductList[].paymentStartAt	date	견적서 상품의 시작 결제일 Required (단, 견적서 구성상품의 유형이 구독 상품인 경우에 한함)
quoteProductList[].fieldList	array	견적서 상품의 데이터 필드

2025년 4월 23일부터 quoteProduct대신 quoteProductList를 지원합니다. 이전에는 견적서 생성 시 하나의 상품만 입력할 수 있었는데, 이제 여러 상품을 입력할 수 있습니다. 다만, 기존 사용자들을 위해 2025년 11월 1일까지는 quoteProduct도 동시에 지원할 예정입니다. quoteProductList 대신 quoteProduct를 body에 입력해도 정상적으로 견적서가 생성됩니다.

Response

200

{
    "success": true,
    "data": {
        "quote": [
            {
                "id": "<quoteId>",
                "name": "견적서 이름",
                "createdAt": "2024-04-16T07:18:17.516Z"
            },
        ]
    }
}

40x

{
    "success": false,
    "message": "에러 메세지"
}