API开放平台

TIP

# 价目表接口

# 修改价目表

接口说明： 1、通过查询对象配置 (opens new window)接口，获得对象对应的fieldList --> 字段列表结构信息 2、详细字段入参规范说明参见 附录六：aPaaS字段类型样式说明 (opens new window) 3、价目表主对象只支持修改自定义字段 4、价目表明细针对已有的明细行，仅支持修改自定义字段 5、价目表明细支持新增明细行，新增明细行需要校验商品和单位是否匹配 6、标准价目表不允许修改

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

{
  "data_id": "8513927843273923185",
  "fields": {
    "id": "8513927843273923185",
    "fieldKey(自定义字段key)": "fieldValue(数据格式参见附录六)"
  },
  "slave_fields": {
    "bas_pd_price_detail": [
      {
        "id": "6525956386285711919",
        "fieldKey(自定义字段key)": "fieldValue(数据格式参见附录六)"
      },
      {
        "pd_id": "6318874491881852762",
        "pd_unit_id": "6958918108784261474",
        "pricing_mode": "unit_price",
        "price": "100.00",
        "sales": "100.00",
        "discount": "1.0000",
        "fieldKey(自定义字段key)": "fieldValue(数据格式参见附录六)"
      }
    ]
  },
  "is_trigger": false,
  "check_rule": false
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
data_id VARCHAR 是 数据id，注意：标准价目表（id=7086934903373518037）不允许修改
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 字段类型 必填 特殊说明
价目表名称 name 单行文本 否 不可修改
负责人 owner 员工 否 不可修改
启用状态 enable 单选 否 不可修改
是否标准价目表 standard_bool 是否 否 不可修改
适用客户 cm_range 业务固化字段 否 不可修改
适用组织 org_range 业务固化字段 否 不可修改

slave_fields.bas_pd_price_detail特殊参数说明：

针对已存在的明细行（传入id），仅支持修改自定义字段。 针对新增的明细行（不传入id），需要传入商品和单位，系统会校验商品和单位是否匹配。

字段名称 字段key 字段类型 必填 特殊说明
商品 pd_id 关联关系 是（新增时） 新增明细行时必填，编辑时不可修改
单位 pd_unit_id 关联关系 是（新增时） 新增明细行时必填，系统会校验该单位是否属于对应的商品，编辑时不可修改
定价模式 pricing_mode 单选 否 新增时可填，编辑时不可修改
价目表原价 price 金额 否 新增时可填，编辑时不可修改
价目表售价 sales 金额 否 新增时可填，编辑时不可修改
价目表折扣 discount 百分比 否 新增时可填，编辑时不可修改
价目表减价额 reduced_price 金额 否 新增时可填，编辑时不可修改
浮动上限价格 float_upper_price 金额 否 新增时可填，编辑时不可修改
浮动下限价格 float_lower_price 金额 否 新增时可填，编辑时不可修改
标准价 standard_price 金额 否 新增时可填，编辑时不可修改
起始数量 start_num 数值 否 新增时可填，编辑时不可修改
截止数量 end_num 数值 否 新增时可填，编辑时不可修改
有效开始时间 expire_start_time 日期时间 否 新增时可填，编辑时不可修改
有效结束时间 expire_end_time 日期时间 否 新增时可填，编辑时不可修改

响应示例：

{
  "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)

主对象特殊字段说明：

字段名称 字段key 字段类型 必填 特殊说明
适用客户 cm_range 业务固化字段（VARCHAR） 否 客户范围策略id，使用方式参见客户范围选择控件 (opens new window)
适用组织 org_range 业务固化字段（VARCHAR） 否 字段示例：
[
{
"sourceCode": "cpg_111",
"rangeType": "department",
"rangeValueName": "CPG部门",
"rangeValue": "10"
},
{
"sourceCode": "acs_111",
"rangeType": "employee",
"rangeValueName": "acs员工",
"rangeValue": "6956755871716854396"
}
]
-- org_range.rangeType -- -- 范围类型 employee-员工，department-部门
-- org_range.sourceCode -- -- 第三方编码
-- org_range.rangeValue -- -- 数据id
-- org_range.rangeValueName -- -- 数据名称

请求示例：

{
  "appId": 200004,
  "data": {
    "objectKey": "bas_pd_price",
    "owner": {
      "name": "hts",
      "id": "7007385368014262146",
      "status": "1"
    },
    "slaveObjectMap": {
      "bas_pd_price_detail": [
        {
          "pd_price_id": {
            "name": "sssx",
            "id": "8513927843273923185"
          },
          "float_lower_price": "3.00",
          "modify_time": {
            "format": "YYYY-MM-DD HH:mm:ss",
            "value": "2025-07-02 11:06:03"
          },
          "discount": "1.0000",
          "expire_start_time": {
            "format": "YYYY-MM-DD HH:mm",
            "value": "2025-07-02 10:44"
          },
          "sales": "111.00",
          "price": "111.00",
          "expire_end_time": {
            "format": "YYYY-MM-DD HH:mm",
            "value": "2025-07-13 10:49"
          },
          "business_type": {
            "code": "busitype_default__c",
            "id": "4736524444055805742",
            "label": "默认业务类型",
            "status": "1"
          },
          "modifyier_id": {
            "name": "hts",
            "id": "7007385368014262146",
            "status": "1"
          },
          "pd_class": {
            "name": "未分类1",
            "id": "1",
            "status": "1"
          },
          "end_num": "10.00",
          "id": "6525956386285711919",
          "pricing_mode": {
            "code": "unit_price",
            "label": "单价"
          },
          "department": {
            "name": "CPG",
            "id": "10",
            "status": "1"
          },
          "pd_id": {
            "name": "hts0408",
            "id": "6318874491881852762",
            "status": "1"
          },
          "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:44:45"
          },
          "float_upper_price": "3.00",
          "is_combo_rule_main_pd": {
            "code": "1",
            "label": "是"
          },
          "source_type": {
            "code": "LROPFXCJ",
            "label": "自建"
          },
          "basic_unit_price": "1.00",
          "start_num": "1.00",
          "basic_unit": "条",
          "creator_id": {
            "name": "hts",
            "id": "7007385368014262146",
            "status": "1"
          },
          "name": "JMMX2025070201717",
          "status": {
            "code": "1",
            "label": "正常"
          }
        }
      ]
    },
    "lock_status": {
      "code": "UNLOCK",
      "label": "未锁定"
    },
    "cm_range": "7422704289226405552",
    "create_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-07-02 10:44:45"
    },
    "org_range": "[{\"dataId\":\"8513927843273923185\",\"rangeType\":\"department\",\"rangeValueName\":\"CPG\",\"rangeValue\":\"10\"},{\"dataId\":\"8513927843273923185\",\"rangeType\":\"employee\",\"rangeValueName\":\"戈业龙\",\"rangeValue\":\"7659690811795479889\"},{\"dataId\":\"8513927843273923185\",\"rangeType\":\"employee\",\"rangeValueName\":\"黄成举\",\"rangeValue\":\"5271751989663129657\"},{\"dataId\":\"8513927843273923185\",\"rangeType\":\"employee\",\"rangeValueName\":\"桑绍亮\",\"rangeValue\":\"9194751330563632911\"}]",
    "approval_status": {
      "code": "APPROVED",
      "label": "已通过"
    },
    "modify_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-07-02 11:06:03"
    },
    "source_type": {
      "code": "LROPFXCJ",
      "label": "自建"
    },
    "priority_level": "122",
    "expire_end_date": {
      "format": "YYYY-MM-DD"
    },
    "enable": {
      "code": "1",
      "label": "启用"
    },
    "expire_start_date": {
      "format": "YYYY-MM-DD",
      "value": "2025-07-02"
    },
    "business_type": {
      "code": "busitype_default__c",
      "id": "4641970814238095767",
      "label": "默认业务类型",
      "status": "1"
    },
    "modifyier_id": {
      "name": "hts",
      "id": "7007385368014262146",
      "status": "1"
    },
    "name": "sssx",
    "creator_id": {
      "name": "hts",
      "id": "7007385368014262146",
      "status": "1"
    },
    "id": "8513927843273923185",
    "department": {
      "name": "CPG",
      "id": "10",
      "status": "1"
    },
    "standard_bool": {
      "code": "false",
      "label": "否"
    },
    "status": {
      "code": "1",
      "label": "正常"
    }
  },
  "dataFormat": "json",
  "dataId": "8513927843273923185",
  "dataSource": "biz",
  "dataType": "apaas_data_change_event",
  "tenantId": 7867203268463838962,
  "version": "v1"
}

← 报价单 →