报价单 API | 订阅蜂帮助中心

所有文章

报价单 API

最后更新于 2023/09/22 阅读数 349

POST 创建报价单

接口地址 /bee/api/v1/quotes

请求方式 POST

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	schema
createQuotesVo	createQuotesVo	body	true	创建报价单	创建报价单

schema属性说明

创建报价单

参数名称	参数说明	请求类型	是否必须	数据类型	schema
adhocItems	自定义产品	body	false	array	AdhocItemVo
basicInformation	报价基本信息	body	false	BasicInformationVo	BasicInformationVo
discounts	折扣信息	body	false	array	ApiDiscountVo
fees	费用信息	body	false	array	ApiFeeVo
productItems	产品明细	body	false	array	ProductItemVo

AdhocItemVo

自定义产品

参数名称	参数说明	请求类型	是否必须	数据类型
chargeAmount	报价金额	body	false	number
chargeDiscountAmount	折扣金额	body	false	number
chargeDiscountPercentage	折扣百分比	body	false	number
chargeFrequency	定价周期	body	false	string
chargeName	明细项名称	body	false	string
chargePrice	价格	body	false	number
chargeQuantity	单位数量	body	false	number
chargeTerm	周期数量	body	false	integer(int32)
description	描述	body	false	string

BasicInformationVo

报价基本信息

参数名称	参数说明	请求类型	是否必须	数据类型
expirationDate	报价失效日期	body	false	string(date-time)
interInfo	内部信息	body	false	string
notes	备注	body	false	string
opportunityId	商机ID	body	false	integer(int64)
priceBookId	价格表	body	false	integer(int64)
quoteCustomerId	报价客户ID	body	false	integer(int64)
quoteName	报价单名称	body	false	string
quoteOwnerId	报价人	body	false	integer(int64)
quoteTemplateId	模版ID	body	false	integer(int64)
serviceCustomerId	终端客户ID	body	false	integer(int64)
terms	条款	body	false	string

ApiDiscountVo

折扣信息

参数名称	参数说明	请求类型	是否必须	数据类型
amount	折扣金额	body	false	number
associatedId	关联销售折扣发放记录id	body	false	integer(int64)
description	描述	body	false	string
percentage	折扣百分比	body	false	number
valueType	值类型（“金额 \| 百分比”）	body	false	string

ApiFeeVo

费用明细

参数名称	参数说明	请求类型	是否必须	数据类型
amount	费用金额	body	false	number
~~associatedId~~		~~body~~	~~false~~	~~integer(int64)~~
description	描述	body	false	string
percentage	费用百分比	body	false	number
valueType	值类型（“金额 \| 百分比”）	body	false	string

ProductItemVo

产品明细

参数名称	参数说明	请求类型	是否必须	数据类型	schema
edition	产品版本	body	false	string
productAttributes	产品属性	body	false	string
productChargePlan	产品定价计划	body	false	ProductApiChargePlanVo	ProductApiChargePlanVo
productId	产品ID	body	false	integer(int64)

ProductApiChargePlanVo

产品定价计划

参数名称	参数说明	请求类型	是否必须	数据类型	schema
chargeItems	产品明细项	body	false	array	ApiChargeItemVo
chargePlanId	产品定价计划Id	body	false	integer(int64)

ApiChargeItemVo

产品明细项

参数名称	参数说明	请求类型	是否必须	数据类型
chargeDiscountAmount	折扣金额	body	false	number
chargeDiscountPercentage	折扣百分比	body	false	number
chargePrice	单价	body	false	number
chargeQuantity	数量	body	false	number
chargeTerm	周期	body	false	integer(int32)
description	描述	body	false	string
productChargeId	产品明细项id	body	false	integer(int64)
promoteIds	促销明细项id	body	false	array

请求示例

{
  "basicInformation": {
    "opportunityId": "3495837482928372700",
    "quoteCustomerId": "3495837482928372700",
    "serviceCustomerId": "3495837482928372700",
    "quoteName": "订阅蜂云服务报价单",
    "quoteOwnerId": "6495837482928373000",
    "quoteTemplateId": "6495837482928373000",
    "priceBookId": "6495837482928373000",
    "expirationDate": "2022-09-01",
    "notes": "这是一个示例备注",
    "terms": "这是一个示例协议条款"
  },
  "productItems": [
    {
      "productId": "1595948530592854302",
      "edition": "基础版",
      "productAtrributes": "应用场景：B2C; 活跃用户数：100人定价计划；",
      "productChargePlan": {
        "chargePlanId": "1595948530592854302",
        "chargeItems": [
          {
            "productChargeId": "1595948530592854302",
            "promoteIds": [
              "1590403923849282800"
            ],
            "chargePrice": 2000,
            "chargeTerm": 18,
            "chargeQuantity": 1,
            "chargeDiscountAmount": 3600,
            "chargeDiscountPercentage": "10",
            "description": "订阅蜂订阅年费"
          }
        ]
      }
    }
  ],
  "adhocItems": [
    {
      "chargeName": "其它费用",
      "description": "临时附加项费用",
      "chargeFrequency": "月",
      "chargePrice": 2000,
      "chargeTerm": 18,
      "chargeQuantity": 1,
      "chargeAmount": 36000,
      "chargeDiscountAmount": 3600,
      "chargeDiscountPercentage": "10"
    }
  ],
  "discounts": [
    {
      "valueType": "金额 | 百分比",
      "amount": 100,
      "percentage": "2",
      "associateId": "3495837482928372700",
      "description": "销售经理折扣"
    }
  ],
  "fees": [
    {
      "valueType": "金额 | 百分比",
      "amount": 100,
      "percentage": "2",
      "associateId": "3495837482928372700",
      "description": "其他费用"
    }
  ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

json

响应状态

状态码	说明	schema
200	OK	ResponseData«QuotesApiResultVo»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数

参数名称	参数说明	类型	schema
code	响应状态码	integer(int32)	integer(int32)
data	通用返回数据	QuotesApiResultVo	QuotesApiResultVo
message	状态描述信息	string
success	是否成功	boolean

schema属性说明

QuotesApiResultVo

参数名称	参数说明	类型	schema
arr	Annual Recurring Revenue 年持续性收入	number
createdBy	创建人	string
createdOn	创建时间	string(date-time)
currency	币别	CurrencyVo	CurrencyVo
expirationDate	报价失效日期	string(date-time)
id	主键id	integer(int64)
lastUpdatedBy	最后一次更新人	string
lastUpdatedOn	最后一次更新时间	string(date-time)
mrr	Monthly Recurring Revenue 月持续性收入	number
netQuoteAmount	报价金额（折扣后）	number
notes	备注	string
opportunityId	商机id	integer(int64)
opportunityName	商机名称	string
quoteCustomerId	报价客户id	integer(int64)
quoteCustomerName	报价客户名称	string
quoteName	报价单名称	string
quoteOwnerId	报价人id	integer(int64)
quoteOwnerName	报价人	string
quotePDFUrl	在线报价单URL	QuotePDFURLVo	QuotePDFURLVo
quoteTemplateId	报价单模版id	integer(int64)
quoteTemplateName	报价单模版名称	string
serviceCustomerId	终端客户id	integer(int64)
serviceCustomerName	终端客户名称	string
status	状态	string
tcv	Total Contract Value 合同总价	number
terms	条款	string
totalQuoteAmount	报价单金额（折扣前）	number
totalQuoteDiscountAmount	折扣金额	number
totalQuoteDiscountPercentage	折扣百分比	number
totalQuoteFeeAmount	费用	number
totalQuoteFeePercentage	费用百分比	number

CurrencyVo

参数名称	参数说明	类型
currencyCode	币别代码	string
currencyDecimal	币别小数位（人民币：2）	integer(int32)
currencyLabel	币别名称	string
roundingModel	舍入模式（人民币：四舍五入）	string

QuotePDFURLVo

参数名称	参数说明	类型
externalUrl	外部查看URL	string
internalUrl	内部查看URL	string
name	报价单名称	string
number	报价单编号	string

响应示例

{
  "code": 200,
  "data": {
    "id": "3495837482928372700",
    "opportunityId": "3495837482928372700",
    "opportunityName": "this is a opportunity",
    "quoteCustomerId": "3495837482928372700",
    "quoteCustomerName": "北京阅丰科技有限公司",
    "serviceCustomerId": "3495837482928372700",
    "serviceCustomerName": "北京阅丰科技有限公司",
    "quoteName": "订阅蜂云服务报价单",
    "quoteOwnerId": "6495837482928373000",
    "quoteOwnerName": "Ella",
    "quoteTemplateId": "6495837482928373000",
    "quoteTemplateName": "订阅蜂报价模版",
    "expirationDate": "2022-09-01",
    "status": "已接受",
    "quotePDFUrl": {
      "internalUrl": "https://dev.dingyuefeng.com/quotePreview?quoteId=202207251142438730001&amp;version=1",
      "externalUrl": "https://dev.dingyuefeng.com/quotePreview?quoteId=202207251142438730001&amp;version=1",
      "name": "订阅蜂报价单",
      "number": "Q-00000001"
    },
    "notes": "备注",
    "terms": "条款",
    "totalQuoteAmount": 36000,
    "totalQuoteDiscountAmount": 3600,
    "totalQuoteDiscountPercentage": "10",
    "totalQuoteFeeAmount": 0,
    "totalQuoteFeePercentage": "0",
    "netQuoteAmount": 32400,
    "mrr": 1800,
    "arr": 21600,
    "tcv": 32400,
    "currency": {
      "currencyCode": "CNY",
      "currencyLabel": "元",
      "currencyDecimal": 2,
      "roundingModel": "half_up"
    },
    "createdBy": "Ella",
    "createdOn": "2022-08-01 18:43:25",
    "lastUpdatedBy": "Michael",
    "lastUpdatedOn": "2022-08-10 13:22:12"
  },
  "message": "请求成功",
  "success": true
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

json

GET 获取报价单列表信息

返回当前用户的报价单列表

接口地址 /bee/api/v1/quotes

请求方式 GET

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型
page	页码	query	否	integer
pageSize	每页条数默认：50 条记录	query	否	integer
opportunityId	商机Id	query	否	integer

响应状态

状态码	说明	schema
200	OK	ResponseData
401	Unauthorized
403	Forbidden
404	Not Found

响应参数

参数名称	参数说明	类型	schema
code	响应状态码	integer(int32)	integer(int32)
data	通用返回数据	object	报价单对象
message	状态描述信息	string
success	是否成功	boolean

响应示例

{
    "code": 200,
    "data": {
        "currPage": 1,
        "list": [
            {
                  "arr": 1287.00,
                "createdBy": "Ella",
                "createdOn": "2022-09-22 09:06:05",
                "currency": {
                    "currencyCode": "CNY",
                    "currencyDecimal": 2,
                    "currencyLabel": "人民币",
                    "roundingModel": "halfUp"
                },
                "expirationDate": "2022-10-22",
                "id": "1572754067767410689",
                "lastUpdatedBy": "李白",
                "lastUpdatedOn": "2022-09-22 17:08:53",
                "mrr": 107.25,
                "netQuoteAmount": 365.70,
                "nodes": "this is comments",
                "opportunityId": null,
                "opportunityName": null,
                "quoteCustomerId": "1572414358893592577",
                "quoteCustomerName": "订阅蜂",
                "quoteName": "我的报价单",
                "quoteOwnerId": "1569615418695487489",
                "quoteOwnerName": "李白",
                "quotePDFUrl": {
                    "externalUrl": "https://www.dingyuefeng.com/downloadPDF?quoteId=1572754067eeee7410689&amp;tenantId=157e397307365822465",
                    "internalUrl": "https://www.dingyuefeng.com/quotePreview?quoteId=1572r54067767410689&amp;rounds=1",
                    "name": "报价单示例",
                    "number": "Q-00000001"
                },
                "quoteTemplateId": "1572397308003356674",
                "quoteTemplateName": "商务",
                "serviceCustomerId": "1572414358893592577",
                "serviceCustomerName": "订阅蜂",
                "status": "已创建",
                "tcv": 1287.00,
                "terms": "this is purchase terms",
                "totalQuoteAmount": 865.70,
                "totalQuoteDiscountAmount": 500.00,
                "totalQuoteDiscountPercentage": null,
                "totalQuoteFeeAmount": 100.00,
                "totalQuoteFeePercentage": null
            }
        ],
        "pageSize": 50,
        "totalCount": 1,
        "totalPage": 1
    },
    "message": "请求成功",
    "success": true	

}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

json

GET 获取报价单详情

接口地址 /bee/api/v1/quotes/{quote-id}

请求方式 GET

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	schema
quote-id	报价单Id	path	是	string

响应状态

状态码	说明	schema
200	OK	ResponseData
401	Unauthorized
403	Forbidden
404	Not Found

响应参数

参数名称	参数说明	类型	schema
code	响应状态码	integer(int32)	integer(int32)
data	通用返回数据	object
message	状态描述信息	string
success	是否成功	boolean

schema属性说明

QuotesByIdResult

参数名称	参数说明	类型	schema
basicInformation	报价单基本信息	BasicInformation	BasicInformation
customerInformation	客户信息	CustomerInformation	CustomerInformation
yourInformation	公司信息	YourInformation	YourInformation
chargePlans	产品信息（定价计划）	array	ChargePlan
adhocItems	自定义产品信息	array	AdhocItems
adjustments	调整项信息	array	Adjustments

BasicInformation

报价基本信息

参数名称	参数说明	类型	schema
arr	Annual Recurring Revenue 年持续性收入	number
cost	成本	number
createdBy	创建人	string
createdOn	创建时间	string(date-time)
currency	币别	Currency	Currency
expirationDate	失效日期	string
id	主键	integer(int64)
lastUpdatedBy	最后更新人	string
lastUpdatedOn	最后更新时间	string(date-time)
mrr	Monthly Recurring Revenue 月持续性收入	number
netQuoteAmount	报价金额（折后）	number
nodes	备注	string
opportunityId	销售机会id	integer(int64)
opportunityName	销售机会名字	string
quoteCustomerId	报价客户id	integer(int64)
quoteCustomerName	报价客户名字	string
quoteName	报价单名称	string
quoteOwnerId	报价单所有者Id	integer(int64)
quoteOwnerName	报价单所有者名字	string
quotePDFUrl	在线报价单预览URL	QuotePdfUrl	QuotePdfUrl
quoteTemplateId	报价单模板id	integer(int64)
quoteTemplateName	报价单模板名字	string
serviceCustomerId	最终客户id	integer(int64)
serviceCustomerName	最终客户名字	string
status	状态 (草稿，已创建，审批中，审批通过，审批驳回，已发送，已接受，已拒绝）	string
tcv	Total Contract Value 合同总额	number
terms	协议条款	string 500 字
totalQuoteAmount	报价单总金额（折扣前）	number
totalQuoteDiscountAmount	折扣金额	number
totalQuoteDiscountPercentage	折扣百分比	number
totalQuoteFeeAmount	费用金额	number
totalQuoteFeePercentage	费用百分比	number

QuotePdfUrl

在线报价单预览URL

参数名称	参数说明	类型
externalUrl	发送给客户报价单路径url	string
internalUrl	内部打开报价单路径url	string
name	报价单名字	string
number	报价单编码	string

CustomerInformation

客户基本信息

参数名称	参数说明	类型	schema
contacts	联系人信息	array	Contacts
crmId	对外 crmId	string
customerId	客户公司 id	string
customerName	客户公司名称	string
keyContact	负责人信息	KeyContact	KeyContact

Contacts

联系人

参数名称	参数说明	类型
createdBy	创建人	string
createdOn	创建时间	string
emailAddress	联系人邮箱	string
id	联系人id	string
lastUpdatedBy	最后更新人	string
lastUpdatedOn	最后更新时间	string（data-time)
name	联系人名字	string
phoneNumber	联系人手机号	string
title	联系人职位	string

KeyContact

参数名称	参数说明	类型
emailAddress	联系人邮箱	string
name	联系人名字	string
phoneNumber	联系人手机号	string
title	联系人职位	string

YourInformation

公司信息

参数名称	参数说明	类型	schema
contact	公司联系人	Contact	Contact
tenantId	公司 ID	string
tenantName	公司名称	string

Contact

联系人

参数名称	参数说明	类型
emailAddress	邮件地址	string
name	联系人名字	string
phoneNumber	联系人电话	string
title	联系人职位	string

Product

产品

参数名称	参数说明	类型	schema
arr	Annual Recurring Revenue 年持续性收入	number
createdBy	创建人	string
createdOn	创建时间	string(date-time)
currency	币别	Currency	Currency
description	描述	string
edition	版本（产品版本）	string
id	主键	string
lastUpdatedBy	最后更新人	string
lastUpdatedOn	最后更新时间	string(date-time)
mrr	Monthly Recurring Revenue 月持续性收入	number
name	产品名称	string
productAttributes	产品属性	string

ChargePlan

定价计划

参数名称	参数说明	类型	schema
arr	Annual Recurring Revenue 年持续性收入	number
charges	产品明细项	array	ChargeItems
createdBy	创建人	string
createdOn	创建时间	string(date-time)
currency	币别	Currency	Currency
description	描述	string
edition	版本（产品版本）	string
id	主键	string
lastUpdatedBy	最后更新人	string
lastUpdatedOn	最后更新时间	string(date-time)
mrr	Monthly Recurring Revenue 月持续性收入	number
planName	定价计划名称	string
product	产品	Product	Product
productAttributes	产品属性	string
productChargePlanId	产品定价计划Id	string

ChargeItems

产品明细项

参数名称	参数说明	类型	schema
arr	Annual Recurring Revenue 年持续性收入	number
chargeAmount	报价金额	number
chargeDiscountAmount	折扣金额	number
chargeDiscountPercentage	折扣百分比	string
chargeFrequency	定价周期（一次性，年，月）	string
chargeModel	定价模式（固定定价，按单位定价，阶梯定价，分层定价）	string
chargeName	明细项名称	string
chargePrice	单价	number
chargeQuantity	单位数量	number
chargeTerm	周期数量	integer(int32)
cost	成本	number
createdBy	创建人	string
createdOn	创建时间	string(date-time)
currency	币别	Currency	Currency
description	描述	string
id	主键	string
lastUpdatedBy	最后更新人	string
lastUpdatedOn	最后更新时间	string(date-time)
mrr	Monthly Recurring Revenue 月持续性收入	number
netChargeAmount	报价金额（折扣后）	number
productChargeId	产品明细项Id	string
tcv	Total Contract Value 合同总额	number
unitCost	单位成本	number

AdhocItems

自定义产品项

参数名称	参数说明	类型	schema
arr	Annual Recurring Revenue 年持续性收入	number
chargeAmount	报价金额（折扣前）	number
chargeDiscountAmount	折扣金额	number
chargeDiscountPercentage	折扣百分比	string
chargeFrequency	定价周期（一次性，年，月）	string
chargeName	产品项名称	string 长度:100
chargePrice	单价	number
chargeQuantity	单位数量	number
chargeTerm	周期数量	integer(int32)
createdBy	创建人	string
createdOn	创建时间	string(date-time)
currency	币别	Currency	Currency
description	描述	string
id	主键	string
lastUpdatedBy	最后更新人	string
lastUpdatedOn	最后更新时间	string(date-time)
mrr	Monthly Recurring Revenue 月持续性收入	number
netChargeAmount	报价总额（折扣后）	number
tcv	Total Contract Value 合同总额	number

Currency

币别

参数名称	参数说明	类型
currencyCode	代号(例:CNY）	string
currencyDecimal	精度	integer(int32)
currencyLabel	币别(例:人民币)	string
roundingModel	舍入模式(1down;2up;3half up)	string

Adjustments

调整项（折扣/费用调整）

参数名称	参数说明	类型	schema
adjustmentDate	调整日期	string
adjustmentType	调整类型（折扣，费用）	string
amount	调整金额	number
createdBy	创建人	string
createdOn	创建时间	string
currency	币别	Currency	Currency
description	描述	string
id	主键	string
lastUpdatedBy	最后更新人	string
lastUpdatedOn	最后更新时间	string
number	调整编号（ADJ-00000001, 自增编号）	string
percentage	调整百分比	string
valueType	值类型（金额，百分比）	string

响应示例

{
    "code": 200,
    "data": {
        "adhocItems": [],
        "adjustments": [
            {
                "adjustmentDate": "2023-01-31",
                "adjustmentType": "折扣",
                "amount": null,
                "createdBy": "Ella",
                "createdOn": "Tue Jan 31 11:37:57 CST 2023",
                "currency": {
                    "currencyCode": "CNY",
                    "currencyDecimal": 2,
                    "currencyLabel": "人民币",
                    "roundingModel": "halfUp"
                },
                "description": "新客户优惠",
                "id": "1620265099154640898",
                "lastUpdatedBy": "",
                "lastUpdatedOn": "null",
                "number": "A-00000002",
                "percentage": "15.00000",
                "valueType": "百分比"
            },
            {
                "adjustmentDate": "2023-01-31",
                "adjustmentType": "费用",
                "amount": 100,
                "createdBy": "Ella",
                "createdOn": "Tue Jan 31 11:37:57 CST 2023",
                "currency": {
                    "currencyCode": "CNY",
                    "currencyDecimal": 2,
                    "currencyLabel": "人民币",
                    "roundingModel": "halfUp"
                },
                "description": "其他费用",
                "id": "1620265099234332674",
                "lastUpdatedBy": "",
                "lastUpdatedOn": "null",
                "number": "A-00000002",
                "percentage": "",
                "valueType": "金额"
            }
        ],
        "basicInformation": {
            "arr": 7490,
            "cost": 0,
            "createdBy": "Ella",
            "createdOn": "2023-01-31 11:37:57",
            "currency": {
                "currencyCode": "CNY",
                "currencyDecimal": 2,
                "currencyLabel": "人民币",
                "roundingModel": "halfUp"
            },
            "expirationDate": "2024-01-31",
            "id": "1620265098361917441",
            "lastUpdatedBy": "",
            "lastUpdatedOn": null,
            "mrr": 624.16,
            "netQuoteAmount": 1534.5,
            "nodes": "<p>这是一条示例数据</p>",
            "opportunityId": "1620265097338507265",
            "opportunityName": "璀璨未来CPQ项目",
            "quoteCustomerId": "1620265097317535746",
            "quoteCustomerName": "璀璨未来科技有限公司",
            "quoteName": "示例报价单",
            "quoteOwnerId": "1590147555353919490",
            "quoteOwnerName": "Ella",
            "quotePDFUrl": {
                "externalUrl": "https://dev.dingyuefeng.cn/downloadPDF?quoteId=1620265098361917441&amp;tenantId=1620265096533200898",
                "internalUrl": "https://dev.dingyuefeng.cn/quotePreview?quoteId=1620265098361917441&amp;rounds=1",
                "name": "示例报价单",
                "number": "Q-00000001"
            },
            "quoteTemplateId": "1620265097116209154",
            "quoteTemplateName": "商务",
            "serviceCustomerId": "1620265097317535746",
            "serviceCustomerName": "璀璨未来科技有限公司",
            "status": "已创建",
            "tcv": 10230,
            "terms": "<p>这是一条示例数据</p>",
            "totalQuoteAmount": 8795.5,
            "totalQuoteDiscountAmount": 1534.5,
            "totalQuoteDiscountPercentage": 0.15,
            "totalQuoteFeeAmount": 100,
            "totalQuoteFeePercentage": 0.01
        },
        "chargePlans": [
            {
                "arr": 5390,
                "charges": [
                    {
                        "arr": 4900,
                        "chargeAmount": 4900,
                        "chargeDiscountAmount": 0,
                        "chargeDiscountPercentage": "0.000000",
                        "chargeFrequency": "年",
                        "chargeModel": "固定",
                        "chargeName": "订阅",
                        "chargePrice": 4900,
                        "chargeQuantity": 1,
                        "chargeTerm": 1,
                        "cost": 0,
                        "createdBy": "Ella",
                        "createdOn": "2023-01-31 11:37:57",
                        "currency": {
                            "currencyCode": "CNY",
                            "currencyDecimal": 2,
                            "currencyLabel": "人民币",
                            "roundingModel": "halfUp"
                        },
                        "description": "",
                        "id": "1620265098731016194",
                        "lastUpdatedBy": "",
                        "lastUpdatedOn": null,
                        "mrr": 408.33,
                        "netChargeAmount": null,
                        "productChargeId": "1620265098731016195",
                        "tcv": 4900,
                        "unitCost": 0
                    },
                    {
                        "arr": 490,
                        "chargeAmount": 490,
                        "chargeDiscountAmount": 0,
                        "chargeDiscountPercentage": "0.000000",
                        "chargeFrequency": "年",
                        "chargeModel": "固定",
                        "chargeName": "客户成功服务",
                        "chargePrice": 490,
                        "chargeQuantity": 1,
                        "chargeTerm": 1,
                        "cost": 0,
                        "createdBy": "Ella",
                        "createdOn": "2023-01-31 11:37:57",
                        "currency": {
                            "currencyCode": "CNY",
                            "currencyDecimal": 2,
                            "currencyLabel": "人民币",
                            "roundingModel": "halfUp"
                        },
                        "description": "",
                        "id": "1620265098793930754",
                        "lastUpdatedBy": "",
                        "lastUpdatedOn": null,
                        "mrr": 40.83,
                        "netChargeAmount": null,
                        "productChargeId": "1620265098793930755",
                        "tcv": 490,
                        "unitCost": 0
                    },
                    {
                        "arr": null,
                        "chargeAmount": 300,
                        "chargeDiscountAmount": null,
                        "chargeDiscountPercentage": "20.000000",
                        "chargeFrequency": "一次性",
                        "chargeModel": "按单位",
                        "chargeName": "上线实施",
                        "chargePrice": 300,
                        "chargeQuantity": 1,
                        "chargeTerm": 1,
                        "cost": 0,
                        "createdBy": "Ella",
                        "createdOn": "2023-01-31 11:37:57",
                        "currency": {
                            "currencyCode": "CNY",
                            "currencyDecimal": 2,
                            "currencyLabel": "人民币",
                            "roundingModel": "halfUp"
                        },
                        "description": "",
                        "id": "1620265098844262402",
                        "lastUpdatedBy": "",
                        "lastUpdatedOn": null,
                        "mrr": null,
                        "netChargeAmount": null,
                        "productChargeId": "1620265098844262403",
                        "tcv": 240,
                        "unitCost": 0
                    }
                ],
                "createdBy": "Ella",
                "createdOn": "2023-01-31 11:37:57",
                "currency": {
                    "currencyCode": "CNY",
                    "currencyDecimal": 2,
                    "currencyLabel": "人民币",
                    "roundingModel": "halfUp"
                },
                "description": "这是一个示例定价计划",
                "edition": "",
                "id": "1620265098634547202",
                "lastUpdatedBy": "",
                "lastUpdatedOn": null,
                "mrr": 449.16,
                "planName": "专业版",
                "product": {
                    "arr": null,
                    "createdBy": "Ella",
                    "createdOn": "2023-01-31 11:37:57",
                    "currency": {
                        "currencyCode": "CNY",
                        "currencyDecimal": 2,
                        "currencyLabel": "人民币",
                        "roundingModel": "halfUp"
                    },
                    "description": "这是一个是示例产品",
                    "edition": "",
                    "id": "1620265098525495298",
                    "lastUpdatedBy": "",
                    "lastUpdatedOn": null,
                    "mrr": null,
                    "name": "订阅蜂 CPQ",
                    "productAttributes": "{\"1620265097434976258\":\"专业版\"}"
                },
                "productAttributes": "{\"1620265097434976258\":\"专业版\"}",
                "productChargePlanId": ""
            },
            {
                "arr": 5390,
                "charges": [
                    {
                        "arr": null,
                        "chargeAmount": 3000,
                        "chargeDiscountAmount": 500,
                        "chargeDiscountPercentage": "null",
                        "chargeFrequency": "一次性",
                        "chargeModel": "按单位",
                        "chargeName": "数据迁移定制程序开发",
                        "chargePrice": 3000,
                        "chargeQuantity": 1,
                        "chargeTerm": 1,
                        "cost": 0,
                        "createdBy": "Ella",
                        "createdOn": "2023-01-31 11:37:57",
                        "currency": {
                            "currencyCode": "CNY",
                            "currencyDecimal": 2,
                            "currencyLabel": "人民币",
                            "roundingModel": "halfUp"
                        },
                        "description": "",
                        "id": "1620265098965897217",
                        "lastUpdatedBy": "",
                        "lastUpdatedOn": null,
                        "mrr": null,
                        "netChargeAmount": null,
                        "productChargeId": "1620265098965897218",
                        "tcv": 2500,
                        "unitCost": 0
                    }
                ],
                "createdBy": "Ella",
                "createdOn": "2023-01-31 11:37:57",
                "currency": {
                    "currencyCode": "CNY",
                    "currencyDecimal": 2,
                    "currencyLabel": "人民币",
                    "roundingModel": "halfUp"
                },
                "description": "这是一个示例定价计划",
                "edition": "",
                "id": "1620265098668101633",
                "lastUpdatedBy": "",
                "lastUpdatedOn": null,
                "mrr": 449.16,
                "planName": "专业版",
                "product": {
                    "arr": null,
                    "createdBy": "Ella",
                    "createdOn": "2023-01-31 11:37:57",
                    "currency": {
                        "currencyCode": "CNY",
                        "currencyDecimal": 2,
                        "currencyLabel": "人民币",
                        "roundingModel": "halfUp"
                    },
                    "description": "这是一个是示例产品",
                    "edition": "",
                    "id": "1620265098559049730",
                    "lastUpdatedBy": "",
                    "lastUpdatedOn": null,
                    "mrr": null,
                    "name": "数据迁移服务",
                    "productAttributes": "{\"1620265097434976258\":\"专业版\"}"
                },
                "productAttributes": "{\"1620265097434976258\":\"专业版\"}",
                "productChargePlanId": ""
            },
            {
                "arr": 2100,
                "charges": [
                    {
                        "arr": 2100,
                        "chargeAmount": 2100,
                        "chargeDiscountAmount": 0,
                        "chargeDiscountPercentage": "0.000000",
                        "chargeFrequency": "年",
                        "chargeModel": "固定",
                        "chargeName": "套餐",
                        "chargePrice": 2100,
                        "chargeQuantity": 1,
                        "chargeTerm": 1,
                        "cost": 0,
                        "createdBy": "Ella",
                        "createdOn": "2023-01-31 11:37:57",
                        "currency": {
                            "currencyCode": "CNY",
                            "currencyDecimal": 2,
                            "currencyLabel": "人民币",
                            "roundingModel": "halfUp"
                        },
                        "description": "",
                        "id": "1620265099095920642",
                        "lastUpdatedBy": "",
                        "lastUpdatedOn": null,
                        "mrr": 175,
                        "netChargeAmount": null,
                        "productChargeId": "1620265099095920643",
                        "tcv": 2100,
                        "unitCost": 0
                    }
                ],
                "createdBy": "Ella",
                "createdOn": "2023-01-31 11:37:57",
                "currency": {
                    "currencyCode": "CNY",
                    "currencyDecimal": 2,
                    "currencyLabel": "人民币",
                    "roundingModel": "halfUp"
                },
                "description": "这是一条示例数据",
                "edition": "",
                "id": "1620265098697461761",
                "lastUpdatedBy": "",
                "lastUpdatedOn": null,
                "mrr": 175,
                "planName": "5万条",
                "product": {
                    "arr": null,
                    "createdBy": "Ella",
                    "createdOn": "2023-01-31 11:37:57",
                    "currency": {
                        "currencyCode": "CNY",
                        "currencyDecimal": 2,
                        "currencyLabel": "人民币",
                        "roundingModel": "halfUp"
                    },
                    "description": "这是一个是示例产品",
                    "edition": "",
                    "id": "1620265098588409858",
                    "lastUpdatedBy": "",
                    "lastUpdatedOn": null,
                    "mrr": null,
                    "name": "短信包",
                    "productAttributes": "{\"1620265097455947777\":\"5万\"}"
                },
                "productAttributes": "{\"1620265097455947777\":\"5万\"}",
                "productChargePlanId": ""
            }
        ],
        "customerInformation": {
            "contacts": [],
            "crmId": "",
            "customerId": "1620265098475163649",
            "customerName": "璀璨未来科技有限公司",
            "keyContact": {
                "emailAddress": "269660922@qq.com",
                "name": "璀璨未来",
                "phoneNumber": "13522918130",
                "title": "PM"
            }
        },
        "yourInformation": {
            "contact": {
                "emailAddress": "269660922@qq.com",
                "name": "Ella",
                "phoneNumber": "13522918130",
                "title": ""
            },
            "tenantId": "1620265096533200898",
            "tenantName": "示例数据公司"
        }
    },
    "message": "请求成功",
    "success": true
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391

plaintext

GET 查询报价单跟进记录列表

接口地址 /bee/api/v1/quote-followup-records/quote/{quote-id}

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	schema
quote-id	quote-id	path	true	string

响应状态

状态码	说明	schema
200	OK	ResponseData
401	Unauthorized
403	Forbidden
404	Not Found

响应参数

参数名称	参数说明	类型	schema
code	响应状态码	integer(int32)	integer(int32)
data	通用返回数据	object
message	状态描述信息	string
success	是否成功	boolean

响应示例

{
    "code": 200,
    "data": [
        {
            "id": "1580118335684825090",
            "followupResult": "131",
            "followupResultAnalysis": "",
            "followupTime": null,
            "followupType": "线下",
            "remindContent": "1235",
            "remindTime": "2022-10-02 00:00:00"
        }
    ],
    "message": "请求成功",
    "success": true
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

json

POST 创建报价单跟进记录

接口地址 /bee/api/v1/quote-followup-records/quote/{quote-id}

请求方式 POST

consumes ["application/json"]

produces ["*/*"]

响应示例

{
  "remindTime": "2022-08-01 18:35:14",
  "remindContent": "周三与客户约谈报价",
  "followupTime": "2022-08-02 10:30:00",
  "followupType": "线上",
  "followupResult": null,
  "followupResultAnalysis": ""
}

1
2
3
4
5
6
7
8

json

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	schema
dto	dto	body	true	api报价单跟进记录创建model	api报价单跟进记录创建model
quote-id	quote-id	path	true	integer

schema属性说明

api报价单跟进记录创建model

参数名称	参数说明	请求类型	是否必须	数据类型
followupResult	跟进结果	body	false	string
followupResultAnalysis	跟进结果归因	body	false	string
followupTime	跟进时间	body	false	string(date-time)
followupType	跟进方式（线下/线上）	body	false	string
remindContent	下次提醒内容	body	false	string
remindTime	下次提醒时间	body	false	string(date-time)

响应状态

状态码	说明	schema
200	OK	ResponseData«QuoteFollowupRecordsResult»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数

参数名称	参数说明	类型	schema
code	响应状态码	integer(int32)	integer(int32)
data	通用返回数据	QuoteFollowupRecordsResult	QuoteFollowupRecordsResult
message	状态描述信息	string
success	是否成功	boolean

schema属性说明

QuoteFollowupRecordsResult

参数名称	参数说明	类型
createBy	创建人	string
createOn	创建时间	string(date-time)
followupResult	跟进结果	string
followupResultAnalysis	跟进结果归因	string
followupTime	跟进时间	string(date-time)
followupType	跟进方式（线上/线下）	string
id	主键id	string
lastUpdateBy	更新人	string
lastUpdateOn	更新时间	string(date-time)
remindContent	下次提醒内容	string
remindTime	下次提醒时间	string(date-time)

响应示例

{
  "code": 200,
  "data": [
    {
      "id": "3294373503048320500",
      "remindTime": "2022-08-01 18:35:14",
      "remindContent": "周三与客户约谈报价",
      "followupTime": "2022-08-02 10:30:00",
      "followupType": "线上",
      "followupResult": "客户需要同业务团队确认",
      "followupResultAnalysis": null,
      "createdBy": "Ella",
      "createdOn": "2022-08-01 18:43:25",
      "lastUpdatedBy": "Michael",
      "lastUpdatedOn": "2022-08-10 13:22:12"
    }
  ],
  "message": "请求成功",
  "success": true
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

json

GET 查询报价单跟进记录

接口地址 /bee/api/v1/quote-followup-records/{followup-id}

请求方式 GET

consumes ``

produces ["*/*"]

接口描述 ``

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	schema
followup-id	followup-id	path	true	integer

响应状态

状态码	说明	schema
200	OK	ResponseData«QuoteFollowupRecordsResult»
401	Unauthorized
403	Forbidden
404	Not Found

响应参数

参数名称	参数说明	类型	schema
code	响应状态码	integer(int32)	integer(int32)
data	通用返回数据	QuoteFollowupRecordsResult	QuoteFollowupRecordsResult
message	状态描述信息	string
success	是否成功	boolean

schema属性说明

QuoteFollowupRecordsResult

参数名称	参数说明	类型
createBy	创建人	string
createOn	创建时间	string(date-time)
followupResult	跟进结果	string
followupResultAnalysis	跟进结果归因	string
followupTime	跟进时间	string(date-time)
followupType	跟进方式（线上/线下）	string
id	主键id	string
lastUpdateBy	更新人	string
lastUpdateOn	更新时间	string(date-time)
remindContent	下次提醒内容	string
remindTime	下次提醒时间	string(date-time)

响应示例

{
  "code": 200,
  "data": [
    {
      "id": "3294373503048320500",
      "remindTime": "2022-08-01 18:35:14",
      "remindContent": "周三与客户约谈报价",
      "followupTime": "2022-08-02 10:30:00",
      "followupType": "线上",
      "followupResult": "客户需要同业务团队确认",
      "followupResultAnalysis": null,
      "createdBy": "Ella",
      "createdOn": "2022-08-01 18:43:25",
      "lastUpdatedBy": "Michael",
      "lastUpdatedOn": "2022-08-10 13:22:12"
    }
  ],
  "message": "请求成功",
  "success": true
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

json

PUT 更新报价单跟进记录

接口地址 /bee/api/v1/quote-followup-records/{followup-id}

请求方式 PUT

consumes ["application/json"]

produces ["*/*"]

请求示例


{
  "remindTime": "2022-08-01 18:35:14",
  "remindContent": "周三与客户约谈报价",
  "followupTime": "2022-08-02 10:30:00",
  "followupType": "线上",
  "followupResult": null,
  "followupResultAnalysis": ""
}

1
2
3
4
5
6
7
8
9

json

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	schema
dto	dto	body	true	api报价单跟进记录创建model	api报价单跟进记录创建model
followup-id	followup-id	path	true	integer

schema属性说明

api报价单跟进记录创建model

参数名称	参数说明	请求类型	是否必须	数据类型
followupResult	跟进结果	body	false	string
followupResultAnalysis	跟进结果归因	body	false	string
followupTime	跟进时间	body	false	string(date-time)
followupType	跟进方式（线下/线上）	body	false	string
remindContent	下次提醒内容	body	false	string
remindTime	下次提醒时间	body	false	string(date-time)

响应状态

状态码	说明	schema
200	OK	ResponseData«QuoteFollowupRecordsResult»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数

参数名称	参数说明	类型	schema
code	响应状态码	integer(int32)	integer(int32)
data	通用返回数据	QuoteFollowupRecordsResult	QuoteFollowupRecordsResult
message	状态描述信息	string
success	是否成功	boolean

schema属性说明

QuoteFollowupRecordsResult

参数名称	参数说明	类型
createBy	创建人	string
createOn	创建时间	string(date-time)
followupResult	跟进结果	string
followupResultAnalysis	跟进结果归因	string
followupTime	跟进时间	string(date-time)
followupType	跟进方式（线上/线下）	string
id	主键id	string
lastUpdateBy	更新人	string
lastUpdateOn	更新时间	string(date-time)
remindContent	下次提醒内容	string
remindTime	下次提醒时间	string(date-time)

响应示例

{
  "code": 200,
  "data": [
    {
      "id": "3294373503048320500",
      "remindTime": "2022-08-01 18:35:14",
      "remindContent": "周三与客户约谈报价",
      "followupTime": "2022-08-02 10:30:00",
      "followupType": "线上",
      "followupResult": "客户需要同业务团队确认",
      "followupResultAnalysis": null,
      "createdBy": "Ella",
      "createdOn": "2022-08-01 18:43:25",
      "lastUpdatedBy": "Michael",
      "lastUpdatedOn": "2022-08-10 13:22:12"
    }
  ],
  "message": "请求成功",
  "success": true
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

json

DELETE 删除报价单跟进记录

接口地址 /bee/api/v1/quote-followup-records/{followup-id}

请求方式 DELETE

consumes ``

produces ["*/*"]

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	schema
followup-id	followup-id	path	true	integer

响应状态

状态码	说明	schema
200	OK	ResponseData
204	No Content
401	Unauthorized
403	Forbidden

响应参数

参数名称	参数说明	类型	schema
code	响应状态码	integer(int32)	integer(int32)
data	通用返回数据	object
message	状态描述信息	string
success	是否成功	boolean

响应示例

{
	"code": 200
}

1
2
3

json

GET 查询报价单客户反馈

接口地址 /bee/api/v1/quote-customer-feedbacks/{quote-id}

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	schema
quote-id	quote-id	path	true	string

响应状态

状态码	说明	schema
200	OK	ResponseData
401	Unauthorized
403	Forbidden
404	Not Found

响应参数

参数名称	参数说明	类型	schema
code	响应状态码	integer(int32)	integer(int32)
data	通用返回数据	object
message	状态描述信息	string
success	是否成功	boolean

schema属性说明

QuoteCustomerFeedbacksResult

参数名称	参数说明	类型	schema
currency	币别	Currency	Currency
customerContact	客户联系人	string
customerFeedback	客户意见内容	string
id	主键	string
quoteAmount	报价金额	number
quoteCreateTime	报价创建时间	string(date-time)
quoteFeedback	报价意见同意 \| 拒绝	string
quoteRounds	报价轮次	integer(int32)

Currency

参数名称	参数说明	类型
currencyCode	代号(例:CNY）	string
currencyDecimal	精度	integer(int32)
currencyLabel	币别(例:人民币)	string
roundingModel	舍入模式(1down;2up;3half up)	string

响应示例

{
    "code": 200,
    "data": [
        {
            "id": "1580118709057572866",
            "currency": {
                "currencyCode": "CNY",
                "currencyDecimal": 2,
                "currencyLabel": "人民币",
                "roundingModel": "halfUp"
            },
            "customerContact": "Ella",
            "customerFeedback": "测试测试",
            "quoteAmount": 9000,
            "quoteCreateTime": "2022-10-12 16:50:32",
            "quoteFeedback": "需要再沟通",
            "quoteRounds": 1
        }
    ],
    "message": "请求成功",
    "success": true
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

json

GET 查询报价单发送记录

接口地址 /bee/api/v1/quote-send-records/quote/{quote-id}

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	schema
quote-id	quote-id	path	true	string

响应状态

状态码	说明	schema
200	OK	ResponseData
401	Unauthorized
403	Forbidden
404	Not Found

响应参数

参数名称	参数说明	类型	schema
code	响应状态码	integer(int32)	integer(int32)
data	通用返回数据	object
message	状态描述信息	string
success	是否成功	boolean

schema属性说明

QuoteSendRecordsResult

参数名称	参数说明	类型
id	主键	string
sentByChannel	发送方式 (邮件 \| 短信）	string
sentOn	发送时间	string(date-time)
sentToWhere	发送至哪邮箱：邮件地址短信：手机号码	string
sentToWho	发送至谁 (客户联系人姓名）	string

响应示例

{
    "code": 200,
    "data": [
        {
            "id": "1580118534490640385",
            "sentByChannel": "邮件",
            "sentOn": "2022-10-12 16:49:50",
            "sentToWhere": "269660922@qq.com",
            "sentToWho": "111"
        }
    ],
    "message": "请求成功",
    "success": true
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14

json

GET 查询报价单查看记录

接口地址 /bee/api/v1/quote-view-records/quote/{quote-id}

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	schema
quote-id	quote-id	path	true	string

响应状态

状态码	说明	schema
200	OK	ResponseData
401	Unauthorized
403	Forbidden
404	Not Found

响应参数

参数名称	参数说明	类型	schema
code	响应状态码	integer(int32)	integer(int32)
data	通用返回数据	object
message	状态描述信息	string
success	是否成功	boolean

schema属性说明

QuoteViewRecordsResult

参数名称	参数说明	类型
id	主键	string
quoteId	报价单 ID
viewedBy	查看人	string
viewedOn	查看时间	string(data-time)

响应示例

{
    "code": 200,
    "data": [
        {
            "id": "1580118665281622017",
            "quoteId": "1580118780654342146",
            "viewedBy": "TEST",
            "viewedOn": "2022-10-12 16:50:22"
        }
    ],
    "message": "请求成功",
    "success": true
}

1
2
3
4
5
6
7
8
9
10
11
12
13

json

GET 查询报价单审批评论

接口地址 /bee/api/v1/quote-approval-comments/{quote-id}

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	schema
quote-id	quote-id	path	true	string

响应状态

状态码	说明	schema
200	OK	ResponseData
401	Unauthorized
403	Forbidden
404	Not Found

响应参数

参数名称	参数说明	类型	schema
code	响应状态码	integer(int32)	integer(int32)
data	通用返回数据	object
message	状态描述信息	string
success	是否成功	boolean

schema属性说明

QuoteApprovalCommentsResult

参数名称	参数说明	类型	schema
approver	审批人	string
approverComments	审批意见内容	string
currency	币别	Currency	Currency
id	主键	string
quoteAmount	报价单金额	number
quoteCreateTime	报价创建时间	string(date-time)
quoteFeedback	审批意见 (通过 \| 驳回）	string
quoteRounds	轮次	integer(int32)

Currency

参数名称	参数说明	类型
currencyCode	代号(例:CNY）	string
currencyDecimal	精度	integer(int32)
currencyLabel	币别(例:人民币)	string
roundingModel	舍入模式(1down;2up;3half up)	string

响应示例

{
    "code": 200,
    "data": [
        {
            "approver": "Ella",
            "approverComments": "yes",
            "currency": {
                "currencyCode": "CNY",
                "currencyDecimal": 2,
                "currencyLabel": "人民币",
                "roundingModel": "halfUp"
            },
            "id": "401",
            "quoteAmount": 9000,
            "quoteCreateTime": "2022-10-12 16:51:46",
            "quoteFeedback": "审批通过",
            "quoteRounds": 2
        }
    ],
    "message": "请求成功",
    "success": true
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

json

GET 已反馈待跟进的报价客户

接口地址 /bee/api/v1/quote-customers/{quoter-phone-number}/feedback-received-wait-for-followup

请求方式 GET

接口描述 客户反馈了报价单，待销售人员跟进

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型
productName	产品名称	query	false	string
productCategory	产品分类	query	false	string
quoteName	报价单名称	query	false	string
quoter-phone-number	销售/报价人手机号	path	true	string

响应状态

状态码	说明	schema
200	OK	ResponseData«List«CustomerInformation»»
401	Unauthorized
403	Forbidden
404	Not Found

响应参数

参数名称	参数说明	类型	schema
code	响应状态码	integer(int32)	integer(int32)
data	通用返回数据	array	CustomerInformation
message	状态描述信息	string
success	是否成功	boolean

schema属性说明

CustomerInformation

参数名称	参数说明	类型	schema
contacts	联系人信息	array	Contacts
crmId	对外crmId	string
customerId	客户公司id	string
customerName	客户公司名称	string
keyContact	负责人信息	KeyContact	KeyContact

Contacts

参数名称	参数说明	类型
createdBy	创建人	string
createdOn	创建时间	string（data-time)
emailAddress	联系人邮箱	string
id	联系人id	string
lastUpdatedBy	最后更新人	string
lastUpdatedOn	最后更新时间	string（data-time)
name	联系人名字	string
phoneNumber	联系人手机号	string
title	联系人职位	string

KeyContact

参数名称	参数说明	类型
emailAddress	联系人邮箱	string
name	联系人名字	string
phoneNumber	联系人手机号	string
title	联系人职位	string

响应示例

{
	"code": 0,
	"data": [
		{
			"contacts": [
				{
					"createdBy": "",
					"createdOn": "",
					"emailAddress": "",
					"id": "",
					"lastUpdatedBy": "",
					"lastUpdatedOn": "",
					"name": "",
					"phoneNumber": "",
					"title": ""
				}
			],
			"crmId": "",
			"customerId": "",
			"customerName": "",
			"keyContact": {
				"emailAddress": "",
				"name": "",
				"phoneNumber": "",
				"title": ""
			}
		}
	],
	"message": "",
	"success": true
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

json

GET 已发送邮件待反馈的报价客户

接口地址 /bee/api/v1/quote-customers/{quoter-phone-number}/email-sent-wait-for-feedback

请求方式 GET

接口描述 已向客户发送邮件，待客户反馈

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型
productName	产品名称	query	false	string
productCategory	产品分类	query	false	string
quoteName	报价名称	query	false	string
quoter-phone-number	销售/报价人手机号	path	true	string

响应状态

状态码	说明	schema
200	OK	ResponseData«List«CustomerInformation»»
401	Unauthorized
403	Forbidden
404	Not Found

响应参数

参数名称	参数说明	类型	schema
code	响应状态码	integer(int32)	integer(int32)
data	通用返回数据	array	CustomerInformation
message	状态描述信息	string
success	是否成功	boolean

schema属性说明

CustomerInformation

参数名称	参数说明	类型	schema
contacts	联系人信息	array	Contacts
crmId	对外crmId	string
customerId	客户公司id	string
customerName	客户公司名称	string
keyContact	负责人信息	KeyContact	KeyContact

Contacts

参数名称	参数说明	类型
createdBy	创建人	string
createdOn	创建时间	string(data-time)
emailAddress	联系人邮箱	string
id	联系人id	string
lastUpdatedBy	最后更新人	string
lastUpdatedOn	最后更新时间	string(data-time)
name	联系人名字	string
phoneNumber	联系人手机号	string
title	联系人职位	string

KeyContact

参数名称	参数说明	类型
emailAddress	联系人邮箱	string
name	联系人名字	string
phoneNumber	联系人手机号	string
title	联系人职位	string

响应示例

{
	"code": 0,
	"data": [
		{
			"contacts": [
				{
					"createdBy": "",
					"createdOn": "",
					"emailAddress": "",
					"id": "",
					"lastUpdatedBy": "",
					"lastUpdatedOn": "",
					"name": "",
					"phoneNumber": "",
					"title": ""
				}
			],
			"crmId": "",
			"customerId": "",
			"customerName": "",
			"keyContact": {
				"emailAddress": "",
				"name": "",
				"phoneNumber": "",
				"title": ""
			}
		}
	],
	"message": "",
	"success": true
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

json

GET 所有的报价客户

接口地址 /bee/api/v1/quote-customers/{quoter-phone-number}

请求方式 GET

接口描述 所有状态的报价客户

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型
productName	产品名称	query	false	string
productCategory	产品分类	query	false	string
quoteName	报价名称	query	false	string
quoter-phone-number	销售/报价人手机号	path	true	string

响应状态

状态码	说明	schema
200	OK	ResponseData«List«CustomerInformation»»
401	Unauthorized
403	Forbidden
404	Not Found

响应参数

参数名称	参数说明	类型	schema
code	响应状态码	integer(int32)	integer(int32)
data	通用返回数据	array	CustomerInformation
message	状态描述信息	string
success	是否成功	boolean

schema属性说明

CustomerInformation

参数名称	参数说明	类型	schema
contacts	联系人信息	array	Contacts
crmId	对外crmId	string
customerId	客户公司id	string
customerName	客户公司名称	string
keyContact	负责人信息	KeyContact	KeyContact

Contacts

参数名称	参数说明	类型
createdBy	创建人	string
createdOn	创建时间	string(data-time)
emailAddress	联系人邮箱	string
id	联系人id	string
lastUpdatedBy	最后更新人	string
lastUpdatedOn	最后更新时间	string(data-time)
name	联系人名字	string
phoneNumber	联系人手机号	string
title	联系人职位	string

KeyContact

参数名称	参数说明	类型
emailAddress	联系人邮箱	string
name	联系人名字	string
phoneNumber	联系人手机号	string
title	联系人职位	string

响应示例

{
	"code": 0,
	"data": [
		{
			"contacts": [
				{
					"createdBy": "",
					"createdOn": "",
					"emailAddress": "",
					"id": "",
					"lastUpdatedBy": "",
					"lastUpdatedOn": "",
					"name": "",
					"phoneNumber": "",
					"title": ""
				}
			],
			"crmId": "",
			"customerId": "",
			"customerName": "",
			"keyContact": {
				"emailAddress": "",
				"name": "",
				"phoneNumber": "",
				"title": ""
			}
		}
	],
	"message": "",
	"success": true
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

json

组织架构 API

报价单模版 API

评价这篇文档

有帮助

没帮助

本篇目录

POST 创建报价单

GET 获取报价单列表信息

GET 获取报价单详情

GET 查询报价单跟进记录列表

POST 创建报价单跟进记录

GET 查询报价单跟进记录

PUT 更新报价单跟进记录

DELETE 删除报价单跟进记录

GET 查询报价单客户反馈

GET 查询报价单发送记录

GET 查询报价单查看记录

GET 查询报价单审批评论

GET 已反馈待跟进的报价客户

GET 已发送邮件待反馈的报价客户

GET 所有的报价客户