帮助中心
所有文章
报价单 API
最后更新于 2023/09/22   阅读数 341

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

自定义产品

参数名称

参数说明

请求类型

是否必须

数据类型

schema

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

报价基本信息

参数名称

参数说明

请求类型

是否必须

数据类型

schema

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

折扣信息

参数名称

参数说明

请求类型

是否必须

数据类型

schema

amount

折扣金额

body

false

number

associatedId

关联销售折扣发放记录id

body

false

integer(int64)

description

描述

body

false

string

percentage

折扣百分比

body

false

number

valueType

值类型(“金额 | 百分比”)

body

false

string

ApiFeeVo

费用明细

参数名称

参数说明

请求类型

是否必须

数据类型

schema

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

产品明细项

参数名称

参数说明

请求类型

是否必须

数据类型

schema

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

参数名称

参数说明

类型

schema

currencyCode

币别代码

string

currencyDecimal

币别小数位(人民币:2)

integer(int32)

currencyLabel

币别名称

string

roundingModel

舍入模式(人民币:四舍五入)

string

QuotePDFURLVo

参数名称

参数说明

类型

schema

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&version=1",
      "externalUrl": "https://dev.dingyuefeng.com/quotePreview?quoteId=202207251142438730001&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

请求参数

参数名称

参数说明

请求类型

是否必须

数据类型

schema

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&tenantId=157e397307365822465",
                    "internalUrl": "https://www.dingyuefeng.com/quotePreview?quoteId=1572r54067767410689&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

参数名称

参数说明

类型

schema

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

联系人

参数名称

参数说明

类型

schema

createdBy

创建人

string

createdOn

创建时间

string

emailAddress

联系人邮箱

string

id

联系人id

string

lastUpdatedBy

最后更新人

string

lastUpdatedOn

最后更新时间

string(data-time)

name

联系人名字

string

phoneNumber

联系人手机号

string

title

联系人职位

string

KeyContact

参数名称

参数说明

类型

schema

emailAddress

联系人邮箱

string

name

联系人名字

string

phoneNumber

联系人手机号

string

title

联系人职位

string

YourInformation

公司信息

参数名称

参数说明

类型

schema

contact

公司联系人

Contact

Contact

tenantId

公司 ID

string

tenantName

公司名称

string

Contact

联系人

参数名称

参数说明

类型

schema

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

币别

参数名称

参数说明

类型

schema

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

参数名称

参数说明

请求类型

是否必须

数据类型

schema

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

参数名称

参数说明

类型

schema

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

参数名称

参数说明

类型

schema

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

参数名称

参数说明

请求类型

是否必须

数据类型

schema

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

参数名称

参数说明

类型

schema

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

参数名称

参数说明

类型

schema

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

参数名称

参数说明

类型

schema

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

参数名称

参数说明

类型

schema

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

参数名称

参数说明

类型

schema

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

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

请求参数

参数名称

参数说明

请求类型

是否必须

数据类型

schema

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

参数名称

参数说明

类型

schema

createdBy

创建人

string

createdOn

创建时间

string(data-time)

emailAddress

联系人邮箱

string

id

联系人id

string

lastUpdatedBy

最后更新人

string

lastUpdatedOn

最后更新时间

string(data-time)

name

联系人名字

string

phoneNumber

联系人手机号

string

title

联系人职位

string

KeyContact

参数名称

参数说明

类型

schema

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

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

请求参数

参数名称

参数说明

请求类型

是否必须

数据类型

schema

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

参数名称

参数说明

类型

schema

createdBy

创建人

string

createdOn

创建时间

string(data-time)

emailAddress

联系人邮箱

string

id

联系人id

string

lastUpdatedBy

最后更新人

string

lastUpdatedOn

最后更新时间

string(data-time)

name

联系人名字

string

phoneNumber

联系人手机号

string

title

联系人职位

string

KeyContact

参数名称

参数说明

类型

schema

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

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

请求参数

参数名称

参数说明

请求类型

是否必须

数据类型

schema

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

参数名称

参数说明

类型

schema

createdBy

创建人

string

createdOn

创建时间

string(data-time)

emailAddress

联系人邮箱

string

id

联系人id

string

lastUpdatedBy

最后更新人

string

lastUpdatedOn

最后更新时间

string(data-time)

name

联系人名字

string

phoneNumber

联系人手机号

string

title

联系人职位

string

KeyContact

参数名称

参数说明

类型

schema

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
本篇目录

POST 创建报价单

GET 获取报价单列表信息

GET 获取报价单详情

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

POST 创建报价单跟进记录

GET 查询报价单跟进记录

PUT 更新报价单跟进记录

DELETE 删除报价单跟进记录

GET 查询报价单客户反馈

GET 查询报价单发送记录

GET 查询报价单查看记录

GET 查询报价单审批评论

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

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

GET 所有的报价客户