API开放平台

TIP

# 商机查询

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/salesOpportunities/v1/querySalesOpportunitiesInfo/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
	"create_time_start":"2024-04-01",
	"create_time_end":"2024-04-30",
	"modify_time_start":"2024-04-01",
	"modify_time_end":"2024-04-30",
	"page":"1",
	"page_size":"1000"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
create_time_start VARCHAR(32) 否 创建时间起始。格式：yyyy-MM-dd
create_time_end VARCHAR(32) 否 创建时间结束。格式：yyyy-MM-dd
modify_time_start VARCHAR(32) 否 修改时间起始。格式：yyyy-MM-dd
modify_time_end VARCHAR(32) 否 修改时间结束。格式：yyyy-MM-dd
page INT 否 页码，默认1
page_size INT 否 分页大小，默认1000

响应示例：

{
    "return_code": "0", 
    "return_msg": null,
    "msg_id": null,
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
     {
		  "id": "6789690485561771524",  
		  "creator_id": "4894496930669766018",  
		  "create_time": "2023-04-01 12:10:10",  
		  "modifyier_id": "4894496930669766018",  
		  "modify_time": "2023-04-01 12:10:10",  
		  "status": "1",  
		  "add_approval_status": "1",  
		  "approval_type": "addApproval",  
		  "market_id": "8130823261636150507",  
		  "approval_status": "1",  
		  "sales_oppo_code": "O2023070700000001",  
		  "saleslead_name": "张三的线索",  
		  "saleslead_id": "7626593043392023977",  
		  "stage_change_time": "2023-04-01 12:10:10",  
		  "stage_change_person_id": "8609187093134263268",  
		  "delete_reason": null,  
		  "follow_up_time": "2023-04-01 12:10:10",  
		  "follow_up_person_id": "8823777742865429558",  
		  "follow_up_person_name": "李四",  
		  "sales_oppo_remark": "备注",  
		  "sales_oppo_person_dept_id": "7171248398104726945",  
		  "sales_oppo_person_id": "9160716171813861618",  
		  "input_describe": "输单",  
          "input_reason_id":"7760023060297659528",
		  "input_reason_name":"输单原因1",
		  "input_stage_id": "7593846080108355879",  
		  "input_stage_name": "阶段1",  
		  "projected_amount": "10000.00",  
		  "sales_oppo_status_id": "8999546638097576083",  
		  "sales_oppo_status_name": "商机状态1",  
		  "sales_oppo_source_id": "5680133696404052338",  
		  "sales_oppo_source_name": "来源1",  
		  "sales_business_type_id": "8235725273858875067",  
		  "sales_business_type_name": "业务类型1",  
		  "oppo_type_id": "8769528160027926302",  
		  "oppo_type_name": "机会来源1",  
		  "esti_trans_date": "2024-06-30",  
		  "sales_oppo_price": "20000.00",  
		  "process_stage_id": "7811777636260296442",  
		  "process_stage_name": "阶段1",  
		  "sales_process_id": "5523540769500983960",  
		  "sales_process_name": "商机流程1",  
		  "cus_id": "5983322659186788925",  
		  "sales_oppo_name": "商机名称",  
		  "follow_up_content": "跟进了",  
		  "winning_rate": "75%" 
     }
]

参数说明：

参数 类型 说明
id INT8 主键
creator_id INT8 创建人
create_time TIMESTAMP(6) 创建时间
modifyier_id INT8 修改人
modify_time TIMESTAMP(6) 修改时间
status CHAR(1) 商机状态；0作废 1正常
add_approval_status VARCHAR(32) 新增审批状态，0：已通过 1：待审批 2：已打回
approval_type VARCHAR(32) 当前审批类型， addApproval：新增商机审批 editApproval：编辑商机审批 stageApproval：商机变更阶段审批
market_id INT8 市场活动id
approval_status VARCHAR(32) 商机审批状态，0：已通过 1：待审批 2：已打回
sales_oppo_code VARCHAR(32) 商机编码
saleslead_name VARCHAR(100) 线索名
saleslead_id INT8 线索id
stage_change_time TIMESTAMP(6) 阶段变更时间
stage_change_person_id INT8 阶段变更人
delete_reason VARCHAR(100) 作废原因
follow_up_time TIMESTAMP(6) 最后跟进时间
follow_up_person_id INT8 最后跟进人ID
follow_up_person_name VARCHAR(100) 最后跟进人姓名
sales_oppo_remark VARCHAR(4000) 备注
sales_oppo_person_dept_id INT8 负责人部门ID
sales_oppo_person_id INT8 负责人ID
input_describe VARCHAR(4000) 输单描述
input_reason_id INT8 输单原因ID
input_reason_name VARCHAR(4000) 输单原因
input_stage_id INT8 输单阶段ID
input_stage_name VARCHAR(100) 输单阶段名称
projected_amount NUMERIC(18,2) 预测金额
sales_oppo_status_id INT8 商机状态ID
sales_oppo_status_name VARCHAR(100) 商机状态
sales_oppo_source_id INT8 机会来源ID
sales_oppo_source_name VARCHAR(100) 机会来源
sales_business_type_id INT8 业务类型ID
sales_business_type_name VARCHAR(100) 业务类型
oppo_type_id INT8 机会类型ID
oppo_type_name VARCHAR(100) 机会类型
esti_trans_date TIMESTAMP(6) 预计成交日期
sales_oppo_price NUMERIC(18,2) 商机金额（元）
process_stage_id INT8 流程阶段ID
process_stage_name VARCHAR(100) 流程阶段名称
sales_process_id INT8 流程ID
sales_process_name VARCHAR(100) 流程名称
cus_id INT8 客户ID
sales_oppo_name VARCHAR(100) 商机名称
follow_up_content VARCHAR(4000) 最后跟进内容
winning_rate VARCHAR(100) 赢率%

# 商机查询 V2.0

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/salesOpportunities/v2/querySalesOpportunitiesInfo/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "operate_time_start" : "2023-04-15",
  "operate_time_end" : "2025-04-15",
  "page" : 1,
  "rows" : 100,
  "sorts" : [
    {
      "field_key" : "create_time",
      "type" : "desc"
    }
  ],
  "query_group" : [
    {
      "connector" : "and",
      "filters" : [{
        "field_key" : "status",
        "operator" : "EQ",
        "field_values" : ["0"]
      }
      ]
    },
    {
      "connector" : "or",
      "filters" : [{
        "field_key" : "id",
        "operator" : "IN",
        "field_values" : ["5540163727699599492","7130241847520595243"]
      }
      ]
    }
  ]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
operate_time_start VARCHAR(32) 否 操作时间起始。格式：yyyy-MM-dd
operate_time_end VARCHAR(32) 否 操作时间结束。格式：yyyy-MM-dd
sorts List 否 排序
page VARCHAR(32) 否 页数，默认值为1
rows VARCHAR(32) 否 条数，默认值为100
query_group List 否 查询条件列表
query_group.connector VARCHAR(32) 否 组内查询条件，条件AND或OR
query_group.filters List 否 组内查询条件
query_group.filters.field_key VARCHAR(32) 否 字段key
query_group.filters.operator VARCHAR(32) 否 操作符，详见附录操作符说明(opens new window)
query_group.filters.field_values VARCHAR(4000) 否 字段值集合

响应示例：

[
  {
    "oppo_type_name": "",
    "saleslead_id": {
      "name": "dfgsdfg",
      "id": "6143031763020839301",
      "status": "1"
    },
    "modify_time": "2024-08-15 13:53:52",
    "sales_process": "",
    "sales_oppo_code": "O2024081500000001",
    "sales_oppo_price": "111.00",
    "sales_oppo_remark": "",
    "cus_id": {
      "objectKey": "bas_cm_store",
      "name": "POS00006394",
      "objectName": "终端",
      "id": "8463310165659454575",
      "status": "1"
    },
    "delete_reason": "",
    "sales_business_type": "",
    "sales_oppo_person_dept": {
      "name": "产品部",
      "id": "6351818345948560160",
      "status": "1"
    },
    "modifyier_id": {
      "name": "孙君君",
      "id": "5052943648704112943",
      "status": "1"
    },
    "id": "5657490351205378904",
    "department": "",
    "stage_change_person_id": {
      "name": "孙君君",
      "id": "5052943648704112943",
      "status": "1"
    },
    "exts": [],
    "input_reason": "SDYY0001",
    "projected_amount": "11.10",
    "process_stage_id": "",
    "sales_process_name": "",
    "sales_oppo_name": "",
    "lock_status": "",
    "create_time": "2024-08-15 13:53:52",
    "follow_up_person": {
      "name": "ccdev",
      "id": "6303768659958313364",
      "status": "1"
    },
    "approval_status": "APPROVED",
    "process_stage_name": "",
    "market_id": "",
    "source_type": "",
    "input_reason_name": "价格不合适",
    "sales_oppo_source": "",
    "sales_business_type_name": "",
    "sales_oppo_source_name": "",
    "esti_trans_date": "2024-08-15",
    "saleslead_name": "dfgsdfg",
    "sales_oppo_status": "1",
    "sales_oppo_status_name" : "",
    "creator_id": {
      "name": "孙君君",
      "id": "5052943648704112943",
      "status": "1"
    },
    "follow_up_time": "2025-02-18 16:04",
    "follow_up_person_name": "6303768659958313364",
    "follow_up_content": "22222",
    "stage_change_time": "2024-12-02 14:41",
    "winning_rate": "",
    "oppo_type": "",
    "sales_oppo_person": "",
    "status": "NORMAL",
    "input_describe": ""
  }
]

参数说明：

参数 类型 说明
id String 主键
creator_id Map 创建人
create_time String 创建时间
modifyier_id Map 修改人
modify_time String 修改时间
status String 状态
market_id Map 市场活动id
approval_status String 新增审批状态
sales_oppo_code String 商机编码
saleslead_name String 线索名
saleslead_id Map 线索id
stage_change_time String 阶段变更时间
stage_change_person_id Map 阶段变更人
delete_reason String 作废原因
follow_up_time String 最后跟进时间
follow_up_person Map 最后根据人
follow_up_person_name String 最后根据人姓名
sales_oppo_remark String 备注
sales_oppo_person_dept Map 负责人部门
sales_oppo_person Map 负责人
input_describe String 输单描述
input_reason String 输单原因
input_reason_name String 具体输单原因
projected_amount String 预测金额
sales_oppo_status String 商机状态
sales_oppo_status_name String 商机状态名称
sales_oppo_source String 机会来源
sales_oppo_source_name String 具体机会来源
sales_business_type String 业务类型
sales_business_type_name String 具体业务类型
oppo_type String 机会类型
oppo_type_name String 具体机会类型
esti_trans_date String 预计成交日期
sales_oppo_price String 商机金额
process_stage_id Map 阶段流程id
process_stage_name String 阶段流程名称
sales_process Map 流程id
sales_process_name String 流程名称
cus_id Map 客户id
sales_oppo_name String 商机名
follow_up_content String 最后跟进内容
winning_rate String 赢率%
department String 数据所属部门
source_type Map 数据来源
lock_status Map 锁定状态
exts List 商机自定义字段列表
exts.key String 自定义字段key
exts.value String 自定义字段value

参数说明：

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
response_data String 响应数据

# 商机商品查询

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/salesOpportunities/v1/querySalesOpportunitiesGoods/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
	"create_time_start":"2024-04-01",
	"create_time_end":"2024-04-30",
	"modify_time_start":"2024-04-01",
	"modify_time_end":"2024-04-30",
	"sales_oppo_code":"O2023070700000001",
	"sales_id":"6789690485561771524",
	"page":"1",
	"page_size":"1000"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
create_time_start VARCHAR(100) 否 创建时间起始。格式：yyyy-MM-dd
create_time_end VARCHAR(100) 否 创建时间结束。格式：yyyy-MM-dd
modify_time_start VARCHAR(100) 否 修改时间起始。格式：yyyy-MM-dd
modify_time_end VARCHAR(100) 否 修改时间结束。格式：yyyy-MM-dd
sales_oppo_code VARCHAR(100) 否 商机编码
sales_id VARCHAR(100) 否 商机id
page INT 否 页码，默认1
page_size INT 否 分页大小，默认1000

响应示例：

{
    "return_code": "0", 
    "return_msg": null,
    "msg_id": null,
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
     {
		"sales_id": "8504558858541727243",
		"sales_oppo_code": "O2023070700000001",
		"status": "1",    
        "discount": "0.9",    
        "price": "100.00",    
        "unit": "个",    
        "linkgoods_id": "5068610107298583626",    
        "linkgoods_name": "商品名称",    
        "expected_unit_price": "110.00",    
        "amount": "5",    
        "total_price": "500.00",    
        "expected_total_price": "550.00",    
        "discount_subtotal": "50.00"  
     }
]

参数说明：

参数 类型 说明
sales_id INT8 商机id
sales_oppo_code VARCHAR(32) 商机编码
status CHAR(1) 商机商品状态；0作废 1正常
discount VARCHAR(32) 折扣
price NUMERIC(18,2) 单价
unit VARCHAR(32) 单位
linkgoods_id INT8 商品id
linkgoods_name VARCHAR(200) 商品名称
expected_unit_price VARCHAR(32) 预期单价
amount VARCHAR(32) 数量
total_price VARCHAR(32) 总价
expected_total_price VARCHAR(32) 预期总价
discount_subtotal VARCHAR(32) 折扣小计

# 商机商品查询 V2.0

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/salesOpportunities/v2/querySalesOpportunitiesGoods/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "operate_time_start" : "2023-04-15",
  "operate_time_end" : "2025-04-15",
  "sales_oppo_id": "5469378655955959284",
  "sales_oppo_code" : "O2024121600000004",
  "page" : 1,
  "rows" : 100,
  "sorts" : [
    {
      "field_key" : "create_time",
      "type" : "desc"
    }
  ],
  "query_group" : [
    {
      "connector" : "and",
      "filters" : [{
        "field_key" : "status",
        "operator" : "EQ",
        "field_values" : ["0"]
      }
      ]
    },
    {
      "connector" : "or",
      "filters" : [{
        "field_key" : "id",
        "operator" : "IN",
        "field_values" : ["5540163727699599492","7130241847520595243"]
      }
      ]
    }
  ]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
operate_time_start VARCHAR(32) 否 操作时间起始。格式：yyyy-MM-dd
operate_time_end VARCHAR(32) 否 操作时间结束。格式：yyyy-MM-dd
sales_oppo_id VARCHAR(32) 否 商机编码
sales_oppo_code VARCHAR(32) 否 商机id
sorts List 否 排序
page VARCHAR(32) 否 页数，默认值为1
rows VARCHAR(32) 否 条数，默认值为100
query_group List 否 查询条件列表
query_group.connector VARCHAR(32) 否 组内查询条件，条件AND或OR
query_group.filters List 否 组内查询条件
query_group.filters.field_key VARCHAR(32) 否 字段key
query_group.filters.operator VARCHAR(32) 否 操作符，详见附录操作符说明(opens new window)
query_group.filters.field_values VARCHAR(4000) 否 字段值集合

响应示例：

[
  {
    "amount": "100",
    "lock_status": {
      "code": "UNLOCK",
      "label": "未锁定"
    },
    "create_time": "2024-12-13 10:26:26",
    "total_price": "100.00",
    "approval_status": "APPROVED",
    "modify_time": "2024-12-13 10:26:25",
    "sales_oppo_code": "O2024121300000002",
    "discount": "1.0000",
    "source_type": {
      "code": "LROPFXCJ",
      "label": "自建"
    },
    "discount_subtotal": "0.00",
    "linkgoods_id": {
      "name": "1000ml水晶剑商品酒",
      "id": "9008747133041623853",
      "status": "1"
    },
    "expected_total_price": "100.00",
    "unit": "瓶",
    "price": "1.00",
    "modifyier_id": {
      "name": "sun",
      "id": "6090674608962079732",
      "status": "1"
    },
    "creator_id": {
      "name": "sun",
      "id": "6090674608962079732",
      "status": "1"
    },
    "id": "6546276230378929531",
    "department": {
      "name": "sun",
      "id": "10",
      "status": "1"
    },
    "sales_id": "5469378655955959284",
    "unit_id": "9090198980752914974",
    "expected_unit_price": "1.00",
    "exts": [],
    "linkgoods_name": "1000ml水晶剑商品酒",
    "status": "NORMAL"
  }
]

参数说明：

参数 类型 说明
id String id
status String 状态
creator_id Map 创建人
create_time String 创建时间
modifyier_id Map 修改人
modify_time String 修改时间
sales_id Map 商机id
sales_oppo_code String 商机编码
discount String 折扣
price String 单价
unit String 单位名称
unit_id String 单位id
linkgoods_id Map 商品id
linkgoods_code String 商品编码
linkgoods_name String 商品名称
expected_unit_price String 预期单价
amount String 数量
total_price String 总价
expected_total_price String 预期总价
discount_subtotal String 折扣小计
department Map 数据所属部门
source_type Map 数据来源
lock_status Map 锁定状态
approval_status String 新增审批状态
exts List 商机商品自定义字段列表
exts.key String 自定义字段key
exts.value String 自定义字段value

参数说明：

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
response_data String 响应数据

# 商机跟进查询

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/salesOpportunities/v1/querySalesOpportunitiesRecord/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
	"create_time_start":"2024-04-01",
	"create_time_end":"2024-04-30",
	"page":"1",
	"page_size":"1000"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
create_time_start VARCHAR(100) 否 创建时间起始。格式：yyyy-MM-dd
create_time_end VARCHAR(100) 否 创建时间结束。格式：yyyy-MM-dd
page INT 否 页码，默认1
page_size INT 否 分页大小，默认1000

响应示例：

{
    "return_code": "0", 
    "return_msg": null,
    "msg_id": null,
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
     {  
        "id": "5632276084273286301",
        "creator_id": "8851971499072799260",
        "create_time": "2023-04-01 12:00:00",
        "status": "1",
        "stage_id": "987654321098765432",
        "stage_name": "阶段1",
        "flow_id": "987654321098765433",
        "flow_name": "流程1",
        "sale_follow_adress": "江苏省南京市建邺区嘉陵江东街18号5栋1层北侧",
        "visit_implement_id": "987654321098765434",
        "biz_flow_path": "https://image-test.waiqin365.com/7619626022706826512/salesoppo/202302/202302161317956_d989ff2bb314469f90a8f36260c47a10.xlsx&fileName=20230214202415135537.xlsx",
        "result": "销售阶段：赢单 → 商务谈判",
        "sales_id": "7583819814123807104"
    }  
]

参数说明：

参数 类型 说明
id INT8 主键
creator_id INT8 创建人
create_time TIMESTAMP(6) 创建时间
status CHAR(1) 商机跟进记录状态；0作废 1正常
stage_id INT8 流程阶段id
stage_name VARCHAR(100) 流程阶段名称
flow_id INT8 流程执行id
flow_name VARCHAR(100) 流程执行名称
sale_follow_adress VARCHAR(100) 跟进地址
visit_implement_id INT8 拜访id
biz_flow_path VARCHAR(4000) 商机跟进图片
result VARCHAR(4000) 跟进内容
sales_id INT8 商机id

# 商机跟进查询 V2.0

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/salesOpportunities/v2/querySalesOpportunitiesFollow/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "create_time_start" : "2023-08-02",
  "create_time_end" : "2023-08-03",
  "modify_time_start" : "2023-08-02",
  "modify_time_end" : "2023-08-03",
  "page" : 1,
  "rows" : 100
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
create_time_start VARCHAR(32) 否 创建时间起始。格式：yyyy-MM-dd
create_time_end VARCHAR(32) 否 创建时间结束。格式：yyyy-MM-dd
modify_time_start VARCHAR(32) 否 修改时间起始。格式：yyyy-MM-dd
modify_time_end VARCHAR(32) 否 修改时间结束。格式：yyyy-MM-dd
page VARCHAR(32) 否 页数，默认值为1
rows VARCHAR(32) 否 条数，默认值为100

响应示例：

[
  {
    "field_F2EMN__c": {
      "code": "JFMYIRTL",
      "label": "提前1小时"
    },
    "modify_time": "",
    "field_O6Qmt__c": {
      "code": "JBHQQJHY",
      "label": "电话"
    },
    "sale_follow_adr": "江苏省南京市建邺区沙洲街道白龙江东街南京国际广告大厦附近",
    "field_ywH6R__c": "2023-08-04 15:26",
    "modifyier_id": "",
    "field_tZVDs__c": "123",
    "sales_oppo_id": {
      "objectKey": "salesopportunities_info",
      "id": "4625504003457147794"
    },
    "id": "4661073391905974878",
    "department": {
      "name": "测试二组",
      "id": "7054648746542779496",
      "status": "1"
    },
    "exts": [],
    "lock_status": {
      "code": "UNLOCK",
      "label": "未锁定"
    },
    "create_time": "2023-08-02 15:27:32",
    "approval_status": "APPROVED",
    "source_type": {
      "code": "LROPFXCJ",
      "label": "自建"
    },
    "field_b5YnR__c": "",
    "field_9ATft__c": [
      {
        "path": "object_acqmw__cpuzwji/202308/202308021526211_f682c4eab55c4b01a9da1aa00e235220.jpg",
        "name": "test3.jpg",
        "url": "http://image-test.waiqin365.com/6927614752729538773/object_acqmw__cpuzwji/202308/202308021526211_f682c4eab55c4b01a9da1aa00e235220.jpg"
      }
    ],
    "visit_implement_id": "5312869106888799131",
    "creator_id": {
      "name": "szy",
      "id": "8431289533107457440",
      "status": "1"
    },
    "name": "20230802000048",
    "status": "NORMAL"
  }
]

参数说明：

参数 类型 说明
id String id
status String 状态
creator_id Map 创建人
create_time String 创建时间
modifyier_id Map 修改人
modify_time String 修改时间
department Map 数据所属部门
source_type Map 数据来源
lock_status Map 锁定状态
approval_status String 新增审批状态
name String 跟进记录编号
sale_follow_adr String 跟进地址
visit_implement_id Map 拜访id
field_9ATft__c Map 商机跟进图片
field_tZVDs__c String 跟进内容
sales_oppo_id Map 商机id
field_ywH6R__c String 下次跟进时间
field_F2EMN__c String 提醒
field_b5YnR__c String 提醒时间
field_O6Qmt__c Map 跟进方式
exts List 商机跟进自定义字段列表
exts.key String 自定义字段key
exts.value String 自定义字段value

参数说明：

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
response_data String 响应数据

← 商品品牌接口 →