API开放平台

TIP

# 销售报价单接口

# 新增销售报价单

接口说明：

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

{
  "customerCode": "CUS001", // 客户（必填） 或者 "customerId": 6928823652322085688
  "quotationName": "2025年度报价单", // 报价单名称
  "quotationDate": "2025-06-12", // 报价日期
  "salesOpportunityCode": "OPP001", // 商机 或者 "salesOpportunityId": 5420850610602186677
  "quotationDiscount": 0.95, // 整单折扣（可选，未填时按100%记录）
  // 报价单明细（必填）
  "detailList": [
    {
      "pdCode": "P001", // 商品（必填）若是bom详见说明 或者 "pdId": 5279580533528147536 或者 "pdSourceCode": "PS001"
      // "unitName": "包", // 单位 未开启多单位时只读，启用多单位时必填 或者 "unitId": 8605307914170421101
      "pdCount": 2, // 商品数量（必填）
      "actualPrice": 20, // 实际售价（必填）
      "extFields": {
        "custom_field_1": "报价行自定义值1"
      }
    }
  ],
  "extFields": {
    "custom_quotation_field_1": "报价单头自定义值1"
  }
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

字段 名称 类型 必填 说明
isTrigger 触发工作流 Boolean 否 是否触发工作流，默认 false
triggerEmployee 触发员工 Long 否 触发员工 ID。
当 isTrigger=true 时必填
checkRule 校验规则 Boolean 否 是否校验验证规则，默认 false
customerId 客户ID Long 是 客户 ID。
与 customerCode 至少传入一个，优先使用 customerId
customerCode 客户编号 String 是 客户编号。
与 customerId 至少传入一个
quotationName 报价单名称 String 否 报价单名称文本
quotationDate 报价日期 String 否 格式：yyyy-MM-dd，如 2025-06-12
salesOpportunityId 商机ID Long 否 商机 ID。
与 salesOpportunityCode 二选一，优先使用 salesOpportunityId
salesOpportunityCode 商机编号 String 否 商机编号
quotationDiscount 整单折扣 BigDecimal 否 百分比格式，如 0.95 表示 95%。
未填时按 100% 记录
currencyType 币种 String 否 不开启币种管理只读，币种代码，如 CNY。不传则使用本位币
extFields 自定义字段 Map 否 主对象自定义字段，格式：{"fieldKey": "fieldValue"}
extSlaveList 自定义从对象 Map 否 自定义从对象数据，格式：{"ObjectKey": [{"fieldKey": "fieldValue"}]}
quotation_amount 最终报价总额 BigDecimal 只读 系统自动计算：实际售价合计金额 × 整单折扣
actual_selling_total_amount 实际售价合计金额 BigDecimal 只读 系统自动统计：所有明细实际售价金额之和
suggested_selling_total_amount 建议售价合计金额 BigDecimal 只读 系统自动统计
pd_origin_total_amount 原价合计金额 BigDecimal 只读 系统自动统计
sys_discount 系统折扣 BigDecimal 只读 系统自动计算
additional_discount 额外折扣 BigDecimal 只读 系统自动计算
detailList 明细列表 List 是 报价单明细列表，至少包含一条明细
detailList.pdId 商品ID Long 是 商品 ID。
与 pdCode、pdSourceCode 至少传入一个，优先使用 pdId、pdCode
对接时，如果对应的商品组合是标准BOM，
按父商品信息和商品组合信息，自动补齐商品组合明细对应子商品对应的报价单明细行
如果对应的商品组合是配置BOM，则报错提示"不支持配置BOM的对接，请通过页面进行新建。"
detailList.pdCode 商品编码 String 是 商品编码。
与 pdId、pdSourceCode 至少传入一个，优先使用 pdId、pdCode
detailList.pdSourceCode 商品第三方编码 String 是 商品第三方编码。
与 pdId、pdCode 至少传入一个，优先使用 pdId、pdCode
detailList.unitId 单位ID Long 否 单位 ID，会关联商品过滤。未开启多单位时只读，系统赋值常用销售单位。
启用多单位时必填
与 unitName 二选一，优先使用 unitId
detailList.unitName 单位名称 String 否 单位名称，会关联商品过滤。优先使用 unitId
detailList.pdCount 数量 BigDecimal 是 商品数量，必须大于 0
detailList.actualPrice 实际售价 BigDecimal 是 实际售价，必须大于等于 0。
实际售价金额由系统自动计算：实际售价金额 = 实际售价 × 数量
detailList.pdPortfolioId 商品组合ID Long 否 商品组合 ID。
与 pdPortfolioCode 二选一，优先使用 pdPortfolioId。
启用 CPQ 且商品是组合父商品时必填。
仅支持标准 BOM，配置 BOM 会报错
detailList.pdPortfolioCode 商品组合编码 String 否 商品组合编码。
启用 CPQ 且商品是组合父商品时必填。
仅支持标准 BOM，配置 BOM 会报错
detailList.extFields 自定义字段 Map 否 明细自定义字段，格式：{"fieldKey": "fieldValue"}
detailList.actual_selling_amount 实际售价金额 BigDecimal 只读 自动计算：实际售价 × 数量
detailList.slave_pd_price 价目表 Long 只读 系统管理，openApi仅支持标准价目表
detailList.price_detail 价目表明细 Long 只读 根据价目表、商品、单位、数量自动匹配
detailList.pd_portfolio_detail 商品组合明细 Long 只读 系统自动处理
detailList.pd_origin_price 原价 BigDecimal 只读 从价目表获取
detailList.suggested_selling_price 建议售价 BigDecimal 只读 从价目表获取
detailList.pd_origin_amount 原价金额 BigDecimal 只读 自动计算
detailList.suggested_selling_amount 建议售价金额 BigDecimal 只读 自动计算
detailList.sys_discount 系统折扣 BigDecimal 只读 自动计算：实际售价 / 建议售价
detailList.additional_discount 额外折扣 BigDecimal 只读 自动计算：实际售价 / 原价
detailList.node_id BOM节点ID Long 只读 BOM 展开时自动生成
detailList.parent_node_id BOM父节点ID Long 只读 BOM 展开时自动生成
detailList.root_node_id BOM根节点ID Long 只读 BOM 展开时自动生成
detailList.tree_data BOM树数据 String 只读 BOM 展开时自动生成
detailList.portfolio_group 组合分组 String 只读 BOM 展开时自动生成

响应示例：

{
  "msg_id": "X000001",
  "return_code": 0,
  "return_msg": "",
  "response_data": "{\"id\":\"7123456789012345678\"}"
}

异常示例：

{
  "msg_id": "X000001",
  "return_code": 1,
  "return_msg": "数据不存在，dataName=CUS001！"
}

参数说明：

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

# 修改销售报价单

接口说明： 1、通过查询对象配置 (opens new window)接口，获得对象对应的fieldList --> 字段列表结构信息 2、详细字段入参规范说明参见 附录六：aPaaS字段类型样式说明 (opens new window) 3、报价单头修改只支持自定义字段和部分预置字段 4、报价单行针对已有的报价单行，可以修改自定义字段，暂不支持修改预置字段 5、报价单行支持新增报价单行，新增报价单行的逻辑同新增报价单

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

{
  "data_id": "6928823652322085688",
  "fields": {
    "id": "6928823652322085688",
    "quotation_date": "2025-06-15",
    "quotation_name": "修改后的报价单名称",
    "quotation_discount": "0.95",
    "fieldKey(自定义字段key)": "fieldValue(数据格式参见附录六)"
  },
  "slave_fields": {
    "ig_sales_quotation_detail": [
      {
        "id": "8672994005914241532",
        "fieldKey(自定义字段key)": "fieldValue(数据格式参见附录六)"
      }
    ],
    "objectKey(自定义从对象对象key)": [
      {
        "fieldKey(自定义字段key)": "fieldValue(数据格式参见附录六)"
      }
    ]
  },
  "is_trigger": false,
  "check_rule": false
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
data_id VARCHAR 是 数据id
fields VARCHAR 是 JSON格式字符串。格式：{字段key:value}，
(非特殊字段数据格式参见附录六)
slave_fields VARCHAR 是 JSON格式字符串。数据中传入id为编辑，无id为新增，
格式：{对象key:[{字段key:字段值}]}(非特殊字段数据格式参见附录六)
is_trigger boolean 否 是否触发工作流；true:触发，false:不触发
trigger_employee VARCHAR(32) 否 是否触发工作流为true的时候必填，员工id
check_rule boolean 否 是否校验验证规则和查重规则；true:校验，false:不校验

fields特殊参数说明： 其余预置字段都不支持修改

字段名称 字段key 字段类型 必填 特殊说明
客户名称 customer 关联关系 否 不可修改
报价日期 quotation_date 日期 否 支持修改
报价单名称 quotation_name 单行文本 否 支持修改
整单折扣 quotation_discount 百分比 否 支持修改。按传入值记录，未填时按100%记录（即1.0）
最终报价总额 quotation_amount 金额 否 不支持修改，系统自动计算。
计算规则：
- 如果实际售价合计金额≠0，则 最终报价总额 = SUM（明细行实际售价金额）× 整单折扣
- 如果实际售价合计金额=0，则 最终报价总额 = 0
实际售价合计金额 actual_selling_total_amount 统计字段 否 不支持修改，APaaS自动计算
建议售价合计金额 suggested_selling_total_amount 统计字段 否 不支持修改，APaaS自动计算
原价合计金额 pd_origin_total_amount 统计字段 否 不支持修改，APaaS自动计算

slave_fields.ig_sales_quotation_detail特殊参数说明： 针对新增的明细行（不传入id），逻辑同新增报价单行。 针对已存在的明细行（传入id），仅支持修改自定义字段。

字段名称 字段key 字段类型 必填 特殊说明
商品名称 pd_id 关联关系 是 新增明细行时必填
价目表 slave_pd_price 关联关系 否 不需要传入，系统自动按标准价目表处理
价目表明细编码 price_detail 关联关系 否 不需要传入
商品组合编号 pd_portfolio 关联关系 否 非必填字段
商品组合明细编号 pd_portfolio_detail 关联关系 否 不需要传入
原价 pd_origin_price 金额 否 不需要传入，APaaS自动计算
建议售价 suggested_selling_price 金额 否 不需要传入，APaaS自动从价目表获取并计算
实际售价 actual_price 金额 否 新增明细行时，实际售价和实际售价金额至少填写一个。
如果都填写，需校验：实际售价金额 = 实际售价 × 数量
系统折扣 sys_discount 百分比 否 不需要传入，APaaS自动计算
额外折扣 additional_discount 百分比 否 不需要传入，APaaS自动计算。
计算规则：
- 如果建议售价为0或为空，则额外折扣为空
- 否则，额外折扣 = 实际售价 / 建议售价
原价金额 pd_origin_amount 金额 否 不需要传入，APaaS自动计算
建议售价金额 suggested_selling_amount 金额 否 不需要传入，APaaS自动计算
实际售价金额 actual_selling_amount 金额 否 新增明细行时，实际售价和实际售价金额至少填写一个。
如果仅填写实际售价金额，则系统计算：实际售价 = 实际售价金额 / 数量
如果仅填写实际售价，则系统计算：实际售价金额 = 实际售价 × 数量
商品组合明细唯一标识 node_id 单行文本 否 不需要传入
商品组合明细父节点 parent_node_id 单行文本 否 不需要传入
根节点id root_node_id 单行文本 否 不需要传入
商品组合明细配置 tree_data 单行文本 否 不需要传入
商品组合明细分组 portfolio_group 单行文本 否 不需要传入

响应示例：

{
  "msg_id": "X000001",
  "return_code": 0,
  "return_msg": ""
}

异常示例：

{
  "msg_id": "X000001",
  "return_code": 1,
  "return_msg": "保存失败！"
}

参数说明：

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

# 查询销售报价单

接口说明 1、通过查询对象配置 (opens new window)接口，获得对象对应的fieldList --> 字段列表结构信息 2、请求入参操作符，详见附录操作符说明 (opens new window) 3、字段出参规范说明参见 附录六：aPaaS字段类型样式说明 (opens new window)

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

{
  "page": "1",
  "rows": "100",
  "sorts": [
    {
      "field_key": "create_time",
      "type": "desc"
    }
  ],
  "query_group": [
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "name",
          "operator": "ISN"
        }
      ]
    },
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "customer",
          "operator": "EQ",
          "field_values": [
            "6928823652322085688"
          ]
        }
      ]
    }
  ]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
page INT 是 页数，默认值为1
rows INT 是 条数，默认值为100
sorts List 是 排序，默认按创建时间倒序排序
sorts.field_key VARCHAR(30) 是 排序字段
sorts.type VARCHAR(4) 是 排序类型：asc 正序，desc 倒序
query_group List 是 查询条件列表
query_group.connector List 是 组内查询条件，条件AND或OR
query_group.filters VARCHAR(4) 是 组内查询条件
query_group.filters.field_key VARCHAR(32) 是 字段key
query_group.filters.operator VARCHAR(10) 是 操作符，详见附录操作符说明 (opens new window)
query_group.filters.field_values List 是 字段值集合

响应示例：

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

数据DATA示例:

[
  {
    "objectKey": "ig_sales_quotation",
    "owner": {
      "name": "hts",
      "id": "7007385368014262146",
      "status": "1"
    },
    "lock_status": {
      "code": "UNLOCK",
      "label": "未锁定"
    },
    "create_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-07-02 10:40:49"
    },
    "approval_status": {
      "code": "APPROVED",
      "label": "已通过"
    },
    "modify_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-07-02 10:40:51"
    },
    "source_type": {
      "code": "LROPFXCJ",
      "label": "自建"
    },
    "quotation_amount": "39.00",
    "quotation_date": {
      "format": "YYYY-MM-DD",
      "value": "2025-07-03"
    },
    "quotation_discount": "1.0",
    "business_type": {
      "code": "busitype_default__c",
      "id": "5680980238637871978",
      "label": "默认业务类型",
      "status": "1"
    },
    "modifyier_id": {
      "name": "hts",
      "id": "7007385368014262146",
      "status": "1"
    },
    "creator_id": {
      "name": "hts",
      "id": "7007385368014262146",
      "status": "1"
    },
    "quotation_name": "BGD2025070200156",
    "business_limit": {
      "code": "none_limit",
      "label": "不限制"
    },
    "id": "7467015467964275316",
    "department": {
      "name": "CPG",
      "id": "10",
      "status": "1"
    },
    "status": {
      "code": "1",
      "label": "正常"
    },
    "customer": {
      "objectKey": "bas_cm_customer",
      "name": "测试客户",
      "objectName": "客户",
      "id": "6928823652322085688",
      "status": "1"
    }
  }
]

异常示例：

{
  "msg_id": "X000001",
  "return_code": 1,
  "return_msg": "查询失败！"
}

# 查询销售报价单明细

接口说明 1、通过查询对象配置 (opens new window)接口，获得对象对应的fieldList --> 字段列表结构信息 2、请求入参操作符，详见附录操作符说明 (opens new window) 3、字段出参规范说明参见 附录六：aPaaS字段类型样式说明 (opens new window)

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

{
  "page": "1",
  "rows": "100",
  "sorts": [
    {
      "field_key": "create_time",
      "type": "desc"
    }
  ],
  "query_group": [
    {
      "connector": "AND",
      "filters": [
        {
          "field_key": "quotation_id",
          "operator": "EQ",
          "field_values": [
            "7467015467964275316"
          ]
        }
      ]
    }
  ]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
page INT 是 页数，默认值为1
rows INT 是 条数，默认值为100
sorts List 是 排序，默认按创建时间倒序排序
sorts.field_key VARCHAR(30) 是 排序字段
sorts.type VARCHAR(4) 是 排序类型：asc 正序，desc 倒序
query_group List 是 查询条件列表
query_group.connector List 是 组内查询条件，条件AND或OR
query_group.filters VARCHAR(4) 是 组内查询条件
query_group.filters.field_key VARCHAR(32) 是 字段key
query_group.filters.operator VARCHAR(10) 是 操作符，详见附录操作符说明 (opens new window)
query_group.filters.field_values List 是 字段值集合

响应示例：

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

数据DATA示例:

[
  {
    "quotation_id": {
      "name": "BGD2025070200156",
      "id": "7467015467964275316"
    },
    "modify_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-07-02 10:40:51"
    },
    "additional_discount": "1.0000",
    "tree_data": "",
    "suggested_selling_price": "39.00",
    "pd_origin_price": "39.00",
    "price_detail": {
      "name": "JMMX2025050701684",
      "id": "6572587686455210763",
      "status": "1"
    },
    "pd_portfolio": {
      "name": "ZH20250425000253",
      "id": "6755162802890118829",
      "status": "1"
    },
    "slave_pd_price": {
      "name": "标准价目表",
      "id": "7086934903373518037",
      "status": "1"
    },
    "business_type": {
      "code": "busitype_default__c",
      "id": "7892298620467351415",
      "label": "默认业务类型",
      "status": "1"
    },
    "modifyier_id": {
      "name": "hts",
      "id": "7007385368014262146",
      "status": "1"
    },
    "id": "8672994005914241532",
    "department": {
      "name": "CPG",
      "id": "10",
      "status": "1"
    },
    "unit_id": {
      "name": "条",
      "id": "6237374727925106334",
      "status": "1"
    },
    "pd_id": {
      "name": "hts0408",
      "id": "6318874491881852762",
      "status": "1"
    },
    "owner": {
      "name": "hts",
      "id": "7007385368014262146",
      "status": "1"
    },
    "actual_selling_amount": "39.00",
    "sys_discount": "1.0000",
    "lock_status": {
      "code": "UNLOCK",
      "label": "未锁定"
    },
    "create_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-07-02 10:40:49"
    },
    "actual_price": "39.00",
    "approval_status": {
      "code": "APPROVED",
      "label": "已通过"
    },
    "source_type": {
      "code": "LROPFXCJ",
      "label": "自建"
    },
    "root_node_id": "6123531975969938990",
    "pd_count": "1.00",
    "creator_id": {
      "name": "hts",
      "id": "7007385368014262146",
      "status": "1"
    },
    "name": "BGDMX2025070200466",
    "status": {
      "code": "1",
      "label": "正常"
    },
    "node_id": "6123531975969938990"
  }
]

异常示例：

{
  "msg_id": "X000001",
  "return_code": 1,
  "return_msg": "查询失败！"
}

# 删除销售报价单

接口说明： 1、删除指定ID的销售报价单数据 2、删除操作将触发系统的删除校验规则

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

{
  "data_id": "7467015467964275316"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
data_id VARCHAR 是 要删除的数据ID

响应示例：

{
  "msg_id": "X000001",
  "return_code": 0,
  "return_msg": ""
}

异常示例：

{
  "msg_id": "X000001",
  "return_code": 1,
  "return_msg": "删除失败！"
}

参数说明：

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

# 推送销售报价单

推送说明：参见 推送aPaaS对象数据变更 (opens new window)

请求示例：

{
  "appId": 200004,
  "data": {
    "objectKey": "ig_sales_quotation",
    "owner": {
      "name": "hts",
      "id": "7007385368014262146",
      "status": "1"
    },
    "slaveObjectMap": {
      "ig_sales_quotation_detail": [
        {
          "quotation_id": {
            "name": "BGD2025070200156",
            "id": "7467015467964275316"
          },
          "modify_time": {
            "format": "YYYY-MM-DD HH:mm:ss",
            "value": "2025-07-02 10:40:51"
          },
          "additional_discount": "1.0000",
          "tree_data": "",
          "suggested_selling_price": "39.00",
          "pd_origin_price": "39.00",
          "price_detail": {
            "name": "JMMX2025050701684",
            "id": "6572587686455210763",
            "status": "1"
          },
          "pd_portfolio": {
            "name": "ZH20250425000253",
            "id": "6755162802890118829",
            "status": "1"
          },
          "slave_pd_price": {
            "name": "标准价目表",
            "id": "7086934903373518037",
            "status": "1"
          },
          "business_type": {
            "code": "busitype_default__c",
            "id": "7892298620467351415",
            "label": "默认业务类型",
            "status": "1"
          },
          "modifyier_id": {
            "name": "hts",
            "id": "7007385368014262146",
            "status": "1"
          },
          "id": "8672994005914241532",
          "department": {
            "name": "CPG",
            "id": "10",
            "status": "1"
          },
          "unit_id": {
            "name": "条",
            "id": "6237374727925106334",
            "status": "1"
          },
          "pd_id": {
            "name": "hts0408",
            "id": "6318874491881852762",
            "status": "1"
          },
          "owner": {
            "name": "hts",
            "id": "7007385368014262146",
            "status": "1"
          },
          "actual_selling_amount": "39.00",
          "sys_discount": "1.0000",
          "lock_status": {
            "code": "UNLOCK",
            "label": "未锁定"
          },
          "create_time": {
            "format": "YYYY-MM-DD HH:mm:ss",
            "value": "2025-07-02 10:40:49"
          },
          "actual_price": "39.00",
          "approval_status": {
            "code": "APPROVED",
            "label": "已通过"
          },
          "source_type": {
            "code": "LROPFXCJ",
            "label": "自建"
          },
          "root_node_id": "6123531975969938990",
          "pd_count": "1.00",
          "creator_id": {
            "name": "hts",
            "id": "7007385368014262146",
            "status": "1"
          },
          "name": "BGDMX2025070200466",
          "status": {
            "code": "1",
            "label": "正常"
          },
          "node_id": "6123531975969938990"
        }
      ]
    },
    "lock_status": {
      "code": "UNLOCK",
      "label": "未锁定"
    },
    "create_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-07-02 10:40:49"
    },
    "approval_status": {
      "code": "APPROVED",
      "label": "已通过"
    },
    "modify_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-07-02 10:40:51"
    },
    "source_type": {
      "code": "LROPFXCJ",
      "label": "自建"
    },
    "quotation_amount": "39.00",
    "quotation_date": {
      "format": "YYYY-MM-DD",
      "value": "2025-07-03"
    },
    "quotation_discount": "1.0",
    "business_type": {
      "code": "busitype_default__c",
      "id": "5680980238637871978",
      "label": "默认业务类型",
      "status": "1"
    },
    "modifyier_id": {
      "name": "hts",
      "id": "7007385368014262146",
      "status": "1"
    },
    "creator_id": {
      "name": "hts",
      "id": "7007385368014262146",
      "status": "1"
    },
    "quotation_name": "BGD2025070200156",
    "business_limit": {
      "code": "none_limit",
      "label": "不限制"
    },
    "id": "7467015467964275316",
    "department": {
      "name": "CPG",
      "id": "10",
      "status": "1"
    },
    "status": {
      "code": "1",
      "label": "正常"
    },
    "customer": {
      "objectKey": "bas_cm_customer",
      "name": "测试客户",
      "objectName": "客户",
      "id": "6928823652322085688",
      "status": "1"
    }
  },
  "dataFormat": "json",
  "dataId": "7467015467964275316",
  "dataSource": "biz",
  "dataType": "apaas_data_change_event",
  "tenantId": 7867203268463838962,
  "version": "v1"
}

# 查询报价单（老版）

接口说明 1、通过查询对象配置 (opens new window)接口，获得对象对应的fieldList --> 字段列表结构信息 2、请求入参操作符，详见附录操作符说明 (opens new window) 3、字段出参规范说明参见 附录六：aPaaS字段类型样式说明 (opens new window)

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

{
  "page": "1",
  "rows": "100",
  "sorts": [
    {
      "field_key": "create_time",
      "type": "desc"
    }
  ],
  "query_group": [
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "name",
          "operator": "ISN"
        }
      ]
    },
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "customer",
          "operator": "EQ",
          "field_values": [
            "6928823652322085688"
          ]
        }
      ]
    }
  ]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
page INT 是 页数，默认值为1
rows INT 是 条数，默认值为100
sorts List 是 排序，默认按创建时间倒序排序
sorts.field_key VARCHAR(30) 是 排序字段
sorts.type VARCHAR(4) 是 排序类型：asc 正序，desc 倒序
query_group List 是 查询条件列表
query_group.connector List 是 组内查询条件，条件AND或OR
query_group.filters VARCHAR(4) 是 组内查询条件
query_group.filters.field_key VARCHAR(32) 是 字段key
query_group.filters.operator VARCHAR(10) 是 操作符，详见附录操作符说明 (opens new window)
query_group.filters.field_values List 是 字段值集合

响应示例：

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

数据DATA示例:

[
  {
    "objectKey": "sales_quotation_info",
    "owner": {
      "name": "hts",
      "id": "7007385368014262146",
      "status": "1"
    },
    "lock_status": {
      "code": "UNLOCK",
      "label": "未锁定"
    },
    "create_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-07-02 10:40:49"
    },
    "approval_status": {
      "code": "APPROVED",
      "label": "已通过"
    },
    "modify_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-07-02 10:40:51"
    },
    "source_type": {
      "code": "LROPFXCJ",
      "label": "自建"
    },
    "sales_quote_price": "39.00",
    "sales_quote_name": "报价单名称",
    "quotation_date": {
      "format": "YYYY-MM-DD",
      "value": "2025-07-03"
    },
    "discount": "1.0",
    "business_type": {
      "code": "busitype_default__c",
      "id": "5680980238637871978",
      "label": "默认业务类型",
      "status": "1"
    },
    "modifyier_id": {
      "name": "hts",
      "id": "7007385368014262146",
      "status": "1"
    },
    "creator_id": {
      "name": "hts",
      "id": "7007385368014262146",
      "status": "1"
    },
    "name": "BGD2025070200156",
    "business_limit": {
      "code": "none_limit",
      "label": "不限制"
    },
    "id": "7467015467964275316",
    "department": {
      "name": "CPG",
      "id": "10",
      "status": "1"
    },
    "status": {
      "code": "1",
      "label": "正常"
    },
    "cm_id": {
      "objectKey": "bas_cm_customer",
      "name": "测试客户",
      "objectName": "客户",
      "id": "6928823652322085688",
      "status": "1"
    }
  }
]

异常示例：

{
  "msg_id": "X000001",
  "return_code": 1,
  "return_msg": "查询失败！"
}

# 查询报价单商品明细（老版）

接口说明 1、通过查询对象配置 (opens new window)接口，获得对象对应的fieldList --> 字段列表结构信息 2、请求入参操作符，详见附录操作符说明 (opens new window) 3、字段出参规范说明参见 附录六：aPaaS字段类型样式说明 (opens new window)

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

{
  "page": "1",
  "rows": "100",
  "sorts": [
    {
      "field_key": "create_time",
      "type": "desc"
    }
  ],
  "query_group": [
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "name",
          "operator": "ISN"
        }
      ]
    },
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "customer",
          "operator": "EQ",
          "field_values": [
            "6928823652322085688"
          ]
        }
      ]
    }
  ]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
page INT 是 页数，默认值为1
rows INT 是 条数，默认值为100
sorts List 是 排序，默认按创建时间倒序排序
sorts.field_key VARCHAR(30) 是 排序字段
sorts.type VARCHAR(4) 是 排序类型：asc 正序，desc 倒序
query_group List 是 查询条件列表
query_group.connector List 是 组内查询条件，条件AND或OR
query_group.filters VARCHAR(4) 是 组内查询条件
query_group.filters.field_key VARCHAR(32) 是 字段key
query_group.filters.operator VARCHAR(10) 是 操作符，详见附录操作符说明 (opens new window)
query_group.filters.field_values List 是 字段值集合

响应示例：

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

数据DATA示例:

[
  {
    "quote_product_price": "23.00",
    "modify_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-07-19 10:42:49"
    },
    "quote_product_original_price": "230.00",
    "modifyier_id": {
      "name": "老板",
      "id": "6044797260167447230",
      "status": "1"
    },
    "quote_product_brand": {
      "code": "7872470323618986156",
      "label": "默认品牌"
    },
    "quote_product_total": "200.00",
    "id": "8500919100269338837",
    "department": {
      "name": "zhaoyuyuan",
      "id": "10",
      "status": "1"
    },
    "owner": {
      "name": "老板",
      "id": "6044797260167447230",
      "status": "1"
    },
    "sales_quote_id": {
      "name": "Q2025030700000251",
      "id": "6749372688584259149"
    },
    "lock_status": {
      "code": "UNLOCK",
      "label": "未锁定"
    },
    "quote_product_code": "ksf_zhishinaicha_001",
    "create_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-03-07 14:26:07"
    },
    "approval_status": {
      "code": "APPROVED",
      "label": "已通过"
    },
    "quote_product_quote": "20.00",
    "quote_product_discount": "0.8696",
    "source_type": {
      "code": "LROPFXCJ",
      "label": "自建"
    },
    "quote_product_amount": "10",
    "quote_product_name": {
      "name": "康师傅_PET350芝士奶茶12*2入纸箱",
      "id": "5519658560117818524",
      "status": "1"
    },
    "name": "QP2025030700000366",
    "creator_id": {
      "name": "老板",
      "id": "6044797260167447230",
      "status": "1"
    },
    "quote_product_unit": "瓶",
    "status": {
      "code": "NORMAL",
      "label": "正常"
    }
  }
]

异常示例：

{
  "msg_id": "X000001",
  "return_code": 1,
  "return_msg": "查询失败！"
}

← 合同 →