获取促销产品对象描述接口
POST
https://open.fxiaoke.com/cgi/crm/v2/object/describe
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.fxiaoke.com/cgi/crm/v2/object/describe' \
--header 'Content-Type: application/json' \
--data-raw '{
"corpAccessToken": "${corpAccessToken}",
"corpId": "${corpId}",
"currentOpenUserId": "${currentOpenUserId}",
"includeDetail": true,
"apiName": "PromotionProductObj"
}'响应示例响应示例
{
"traceId": "E-O.fktest188.1453-30adb393c2fd4e8d",
"data": {
"describe": {
"created_by": "-10000",
"api_name": "PromotionProductObj",
"display_name_r": "促销产品",
"fields": {
"lock_rule": {
"describe_api_name": "PromotionProductObj",
"is_index": false,
"is_active": true,
"create_time": 1529007975160,
"description": "锁定规则",
"is_unique": false,
"default_value": "default_lock_rule",
"rules": [],
"label": "锁定规则",
"type": "lock_rule",
"is_need_convert": false,
"is_required": false,
"api_name": "lock_rule",
"define_type": "package",
"is_index_field": false,
"is_single": false,
"index_name": "s_4"
},
"product_status": {
"describe_api_name": "PromotionProductObj",
"is_index": false,
"is_active": true,
"create_time": 1529007975136,
"quote_field_type": "select_one",
"is_unique": false,
"label": "状态",
"type": "quote",
"quote_field": "product_id__r.product_status",
"is_need_convert": false,
"is_required": false,
"api_name": "product_status",
"define_type": "package",
"is_extend": false,
"is_index_field": false,
"is_single": false,
"label_r": "状态",
"index_name": "s_7"
},
"promotion_id": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1529007975165,
"is_unique": false,
"label": "促销活动",
"target_api_name": "PromotionObj",
"type": "master_detail",
"target_related_list_name": "target_related_list_promotion_product_promotion",
"target_related_list_label": "促销产品",
"is_need_convert": false,
"is_required": true,
"api_name": "promotion_id",
"define_type": "package",
"is_create_when_master_create": true,
"is_extend": false,
"is_single": false,
"label_r": "促销活动",
"is_index_field": true,
"is_required_when_master_create": false,
"index_name": "s_8"
},
"derate_money": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1533827784815,
"length": 12,
"is_unique": false,
"label": "单价减免",
"type": "currency",
"currency_unit": "￥",
"decimal_places": 2,
"default_to_zero": true,
"is_need_convert": false,
"is_required": false,
"api_name": "derate_money",
"define_type": "package",
"is_extend": false,
"is_single": false,
"label_r": "单价减免",
"is_index_field": false,
"index_name": "d_3",
"round_mode": 4,
"max_length": 12
},
"lock_user": {
"describe_api_name": "PromotionProductObj",
"is_index": false,
"is_active": true,
"create_time": 1529007975160,
"description": "加锁人",
"is_unique": false,
"label": "加锁人",
"type": "employee",
"is_need_convert": false,
"is_required": false,
"api_name": "lock_user",
"define_type": "package",
"is_index_field": false,
"is_single": true,
"index_name": "a_1"
},
"purchase_num": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1563554087045,
"length": 12,
"is_unique": false,
"label": "购买数量满",
"type": "number",
"decimal_places": 0,
"default_to_zero": true,
"is_need_convert": false,
"is_required": false,
"api_name": "purchase_num",
"define_type": "package",
"is_extend": false,
"is_single": false,
"is_index_field": false,
"index_name": "d_11",
"config": {
"edit": 1,
"attrs": {
"is_required": 0,
"decimal_places": 1
}
},
"round_mode": 4,
"max_length": 14
},
"left_quota": {
"describe_api_name": "PromotionProductObj",
"is_unique": false,
"type": "number",
"decimal_places": 0,
"default_to_zero": true,
"is_required": false,
"define_type": "package",
"is_extend": false,
"is_single": false,
"label_r": "可用促销数量",
"index_name": "d_7",
"max_length": 14,
"is_index": true,
"is_active": true,
"create_time": 1530984004181,
"length": 12,
"default_value": "0",
"label": "可用促销数量",
"is_need_convert": false,
"api_name": "left_quota",
"is_index_field": false,
"config": {
"edit": 0,
"attrs": {
"is_readonly": 0,
"is_required": 0
}
},
"round_mode": 4
},
"gift_product_num": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1563554087052,
"length": 12,
"is_unique": false,
"label": "赠品数量",
"type": "number",
"decimal_places": 0,
"default_to_zero": true,
"is_need_convert": false,
"is_required": false,
"api_name": "gift_product_num",
"define_type": "package",
"is_extend": false,
"is_single": false,
"is_index_field": false,
"index_name": "d_5",
"config": {
"edit": 1,
"attrs": {
"is_required": 0,
"decimal_places": 1
}
},
"round_mode": 4,
"max_length": 14
},
"extend_obj_data_id": {
"describe_api_name": "PromotionProductObj",
"default_is_expression": false,
"is_index": true,
"is_active": true,
"create_time": 1529007975136,
"pattern": "",
"is_unique": false,
"label": "extend_obj_data_id",
"type": "text",
"default_to_zero": false,
"is_need_convert": false,
"is_required": false,
"api_name": "extend_obj_data_id",
"define_type": "package",
"is_extend": false,
"is_single": false,
"label_r": "extend_obj_data_id",
"is_index_field": false,
"index_name": "t_1",
"max_length": 256
},
"is_deleted": {
"describe_api_name": "PromotionProductObj",
"is_index": false,
"create_time": 1529007975238,
"is_unique": false,
"description": "is_deleted",
"default_value": false,
"label": "is_deleted",
"type": "true_or_false",
"is_need_convert": false,
"is_required": false,
"api_name": "is_deleted",
"define_type": "system",
"index_name": "is_del"
},
"gift_product_id": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1563554087052,
"is_unique": false,
"label": "赠品",
"target_api_name": "ProductObj",
"type": "object_reference",
"target_related_list_name": "target_related_list_promotion_product_gift_product",
"target_related_list_label": "赠品",
"action_on_target_delete": "set_null",
"is_need_convert": false,
"is_required": false,
"api_name": "gift_product_id",
"define_type": "package",
"is_extend": false,
"is_single": false,
"is_index_field": true,
"index_name": "s_1"
},
"combine_amount": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1533827784815,
"length": 12,
"is_unique": false,
"label": "组合数量",
"type": "number",
"decimal_places": 0,
"default_to_zero": true,
"is_need_convert": false,
"is_required": false,
"api_name": "combine_amount",
"define_type": "package",
"is_extend": false,
"is_single": false,
"label_r": "组合数量",
"is_index_field": false,
"index_name": "d_2",
"round_mode": 4,
"max_length": 12
},
"price": {
"describe_api_name": "PromotionProductObj",
"is_index": false,
"is_active": true,
"create_time": 1529007975136,
"quote_field_type": "currency",
"is_unique": false,
"label": "产品价格",
"type": "quote",
"quote_field": "product_id__r.price",
"is_need_convert": false,
"is_required": false,
"api_name": "price",
"define_type": "package",
"is_extend": false,
"is_index_field": false,
"is_single": false,
"label_r": "产品价格",
"index_name": "d_8"
},
"life_status_before_invalid": {
"describe_api_name": "PromotionProductObj",
"is_index": false,
"is_active": true,
"create_time": 1529007975160,
"pattern": "",
"description": "作废前生命状态",
"is_unique": false,
"label": "作废前生命状态",
"type": "text",
"is_need_convert": false,
"is_required": false,
"api_name": "life_status_before_invalid",
"define_type": "package",
"is_index_field": false,
"is_single": false,
"index_name": "t_2",
"max_length": 256
},
"product_id": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1529007975162,
"is_unique": false,
"label": "促销产品",
"target_api_name": "ProductObj",
"type": "object_reference",
"target_related_list_name": "target_related_list_promotion_product_product",
"target_related_list_label": "促销产品",
"action_on_target_delete": "set_null",
"is_need_convert": false,
"is_required": true,
"api_name": "product_id",
"define_type": "package",
"is_extend": false,
"is_single": false,
"label_r": "促销商品",
"is_index_field": true,
"index_name": "s_6"
},
"quota": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1529007975163,
"length": 12,
"is_unique": false,
"default_value": "0",
"label": "促销总量限额",
"type": "number",
"decimal_places": 0,
"default_to_zero": true,
"is_need_convert": false,
"is_required": false,
"api_name": "quota",
"define_type": "package",
"is_extend": false,
"is_single": false,
"label_r": "促销总量限额",
"is_index_field": false,
"index_name": "d_12",
"round_mode": 4,
"max_length": 14
},
"rule_description": {
"describe_api_name": "PromotionProductObj",
"default_is_expression": false,
"is_index": true,
"is_active": true,
"create_time": 1563554086224,
"pattern": "",
"is_unique": false,
"label": "规则描述",
"type": "text",
"default_to_zero": false,
"is_need_convert": false,
"is_required": false,
"api_name": "rule_description",
"define_type": "package",
"is_extend": false,
"is_single": false,
"is_index_field": false,
"index_name": "t_3",
"max_length": 500
},
"owner_department": {
"describe_api_name": "PromotionProductObj",
"default_is_expression": false,
"is_index": true,
"is_active": true,
"create_time": 1529007975136,
"pattern": "",
"is_unique": false,
"label": "负责人所在部门",
"type": "text",
"default_to_zero": false,
"is_need_convert": false,
"is_required": false,
"api_name": "owner_department",
"define_type": "package",
"is_extend": false,
"is_single": false,
"label_r": "负责人所在部门",
"is_index_field": false,
"index_name": "owner_dept",
"max_length": 256
},
"out_owner": {
"describe_api_name": "PromotionProductObj",
"is_index": false,
"is_active": true,
"create_time": 1529007975238,
"is_unique": false,
"label": "外部负责人",
"type": "employee",
"is_need_convert": false,
"is_required": false,
"api_name": "out_owner",
"define_type": "system",
"is_single": true,
"index_name": "o_owner",
"config": {
"display": 1
}
},
"owner": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1529007975161,
"is_unique": false,
"label": "负责人",
"type": "employee",
"is_need_convert": false,
"is_required": true,
"api_name": "owner",
"define_type": "package",
"is_extend": false,
"is_index_field": false,
"is_single": true,
"label_r": "负责人",
"index_name": "owner"
},
"price_discount": {
"describe_api_name": "PromotionProductObj",
"is_index": false,
"is_active": true,
"create_time": 1533827784755,
"is_unique": false,
"label": "价格折扣",
"type": "percentile",
"is_need_convert": false,
"is_required": false,
"api_name": "price_discount",
"define_type": "package",
"is_extend": false,
"is_index_field": false,
"is_single": false,
"label_r": "价格折扣",
"index_name": "d_9"
},
"lock_status": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1529007975160,
"description": "锁定状态",
"is_unique": false,
"default_value": "0",
"label": "锁定状态",
"type": "select_one",
"is_need_convert": false,
"is_required": false,
"api_name": "lock_status",
"options": [
{
"label": "未锁定",
"value": "0"
},
{
"label": "锁定",
"value": "1"
}
],
"define_type": "package",
"is_index_field": false,
"is_single": false,
"index_name": "s_5",
"config": {}
},
"last_modified_time": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"create_time": 1529007975238,
"is_unique": false,
"description": "last_modified_time",
"label": "最后修改时间",
"type": "date_time",
"time_zone": "",
"is_need_convert": false,
"is_required": false,
"api_name": "last_modified_time",
"define_type": "system",
"date_format": "yyyy-MM-dd HH:mm:ss",
"index_name": "md_time"
},
"create_time": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"create_time": 1529007975238,
"is_unique": false,
"description": "create_time",
"label": "创建时间",
"type": "date_time",
"time_zone": "",
"is_need_convert": false,
"is_required": false,
"api_name": "create_time",
"define_type": "system",
"date_format": "yyyy-MM-dd HH:mm:ss",
"index_name": "crt_time"
},
"left_amount_quota": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1555516020315,
"length": 12,
"is_unique": false,
"label": "可用促销金额",
"type": "currency",
"currency_unit": "￥",
"decimal_places": 2,
"default_to_zero": true,
"is_need_convert": false,
"is_required": false,
"api_name": "left_amount_quota",
"define_type": "package",
"is_extend": false,
"is_single": false,
"is_index_field": false,
"index_name": "d_6",
"round_mode": 4,
"max_length": 12
},
"life_status": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1529007975160,
"description": "生命状态",
"is_unique": false,
"default_value": "normal",
"label": "生命状态",
"type": "select_one",
"is_need_convert": false,
"is_required": true,
"api_name": "life_status",
"options": [
{
"label": "未生效",
"value": "ineffective"
},
{
"label": "审核中",
"value": "under_review"
},
{
"label": "正常",
"value": "normal"
},
{
"label": "变更中",
"value": "in_change"
},
{
"label": "作废",
"value": "invalid"
}
],
"define_type": "package",
"is_index_field": false,
"is_single": false,
"index_name": "s_3",
"config": {}
},
"specification": {
"describe_api_name": "PromotionProductObj",
"is_index": false,
"is_active": true,
"create_time": 1529007975136,
"quote_field_type": "text",
"is_unique": false,
"label": "规格",
"type": "quote",
"quote_field": "product_id__r.product_spec",
"is_need_convert": false,
"is_required": false,
"api_name": "specification",
"define_type": "package",
"is_extend": false,
"is_index_field": false,
"is_single": false,
"label_r": "规格",
"index_name": "t_4"
},
"fixed_price": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1533827784815,
"length": 12,
"is_unique": false,
"label": "一口价",
"type": "currency",
"currency_unit": "￥",
"decimal_places": 2,
"default_to_zero": true,
"is_need_convert": false,
"is_required": false,
"api_name": "fixed_price",
"define_type": "package",
"is_extend": false,
"is_single": false,
"label_r": "一口价",
"is_index_field": false,
"index_name": "d_4",
"round_mode": 4,
"max_length": 12
},
"gift_type": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1563554087052,
"is_unique": false,
"label": "赠品类型",
"type": "select_one",
"is_need_convert": false,
"is_required": false,
"api_name": "gift_type",
"options": [
{
"not_usable": false,
"label": "普通商品",
"value": "1"
},
{
"not_usable": false,
"label": "本品",
"value": "2"
}
],
"define_type": "package",
"is_extend": false,
"is_index_field": false,
"is_single": false,
"index_name": "s_2",
"config": {}
},
"last_modified_by": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1529007975238,
"is_unique": false,
"label": "最后修改人",
"type": "employee",
"is_need_convert": true,
"is_required": false,
"api_name": "last_modified_by",
"define_type": "system",
"is_single": true,
"index_name": "md_by"
},
"out_tenant_id": {
"describe_api_name": "PromotionProductObj",
"is_index": false,
"is_active": true,
"create_time": 1529007975238,
"pattern": "",
"is_unique": false,
"description": "out_tenant_id",
"label": "外部企业",
"type": "text",
"is_need_convert": false,
"is_required": false,
"api_name": "out_tenant_id",
"define_type": "system",
"index_name": "o_ei",
"config": {
"display": 0
},
"max_length": 200
},
"version": {
"describe_api_name": "PromotionProductObj",
"is_index": false,
"create_time": 1529007975238,
"length": 8,
"is_unique": false,
"description": "version",
"label": "version",
"type": "number",
"decimal_places": 0,
"is_need_convert": false,
"is_required": false,
"api_name": "version",
"define_type": "system",
"index_name": "version",
"round_mode": 4
},
"created_by": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1529007975238,
"is_unique": false,
"label": "创建人",
"type": "employee",
"is_need_convert": true,
"is_required": false,
"api_name": "created_by",
"define_type": "system",
"is_single": true,
"index_name": "crt_by"
},
"relevant_team": {
"describe_api_name": "PromotionProductObj",
"embedded_fields": {
"teamMemberEmployee": {
"is_index": true,
"is_need_convert": true,
"is_required": false,
"api_name": "teamMemberEmployee",
"is_unique": false,
"define_type": "package",
"description": "成员员工",
"label": "成员员工",
"type": "employee",
"is_single": true,
"help_text": "成员员工"
},
"teamMemberRole": {
"is_index": true,
"is_need_convert": false,
"is_required": false,
"api_name": "teamMemberRole",
"options": [
{
"label": "负责人",
"value": "1"
},
{
"label": "普通成员",
"value": "4"
}
],
"is_unique": false,
"define_type": "package",
"description": "成员角色",
"label": "成员角色",
"type": "select_one",
"help_text": "成员角色"
},
"teamMemberPermissionType": {
"is_index": true,
"is_need_convert": false,
"is_required": false,
"api_name": "teamMemberPermissionType",
"options": [
{
"label": "只读",
"value": "1"
},
{
"label": "读写",
"value": "2"
}
],
"is_unique": false,
"define_type": "package",
"description": "成员权限类型",
"label": "成员权限类型",
"type": "select_one",
"help_text": "成员权限类型"
}
},
"is_index": true,
"is_active": true,
"create_time": 1529007975166,
"is_unique": false,
"label": "相关团队",
"type": "embedded_object_list",
"is_need_convert": false,
"is_required": false,
"api_name": "relevant_team",
"define_type": "package",
"is_index_field": false,
"is_single": false,
"index_name": "a_team",
"help_text": "相关团队"
},
"record_type": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1529007975167,
"description": "record_type",
"is_unique": false,
"label": "业务类型",
"type": "record_type",
"is_need_convert": false,
"is_required": false,
"api_name": "record_type",
"options": [
{
"is_active": true,
"api_name": "default__c",
"description": "预设业务类型",
"label": "预设业务类型"
},
{
"is_active": true,
"api_name": "combine_promotion__c",
"label": "组合促销"
}
],
"define_type": "package",
"is_index_field": false,
"is_single": false,
"label_r": "业务类型",
"index_name": "r_type",
"config": {}
},
"unit": {
"describe_api_name": "PromotionProductObj",
"is_index": false,
"is_active": true,
"create_time": 1529007975136,
"quote_field_type": "select_one",
"is_unique": false,
"label": "单位",
"type": "quote",
"quote_field": "product_id__r.unit",
"is_need_convert": false,
"is_required": false,
"api_name": "unit",
"define_type": "package",
"is_extend": false,
"is_index_field": false,
"is_single": false,
"label_r": "单位",
"index_name": "s_10"
},
"data_own_department": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1529007975238,
"is_unique": false,
"label": "归属部门",
"type": "department",
"is_need_convert": false,
"is_required": false,
"api_name": "data_own_department",
"define_type": "package",
"is_single": true,
"index_name": "data_owner_dept_id"
},
"purchase_amount": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1563554087045,
"length": 12,
"is_unique": false,
"label": "购买金额满",
"type": "currency",
"currency_unit": "￥",
"decimal_places": 2,
"default_to_zero": true,
"is_need_convert": false,
"is_required": false,
"api_name": "purchase_amount",
"define_type": "package",
"is_extend": false,
"is_single": false,
"is_index_field": false,
"index_name": "d_10",
"round_mode": 4,
"max_length": 14
},
"name": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1529007975136,
"prefix": "PP{yyyy}-{mm}-{dd}_",
"is_unique": true,
"start_number": 0,
"serial_number": 1,
"label": "自增编号",
"type": "auto_number",
"is_need_convert": false,
"is_required": true,
"api_name": "name",
"define_type": "system",
"postfix": "",
"is_extend": false,
"is_single": false,
"label_r": "自增编号",
"is_index_field": false,
"index_name": "name"
},
"order_by": {
"describe_api_name": "PromotionProductObj",
"is_index": false,
"create_time": 1529007975238,
"length": 8,
"is_unique": false,
"description": "order_by",
"label": "order_by",
"type": "number",
"decimal_places": 0,
"is_need_convert": false,
"is_required": false,
"api_name": "order_by",
"define_type": "system",
"index_name": "l_by",
"round_mode": 4
},
"_id": {
"describe_api_name": "PromotionProductObj",
"is_index": false,
"is_active": true,
"create_time": 1529007975238,
"pattern": "",
"is_unique": false,
"description": "_id",
"label": "_id",
"type": "text",
"is_need_convert": false,
"is_required": false,
"api_name": "_id",
"define_type": "system",
"index_name": "_id",
"max_length": 200
},
"amount_quota": {
"describe_api_name": "PromotionProductObj",
"is_index": true,
"is_active": true,
"create_time": 1555516020315,
"length": 12,
"is_unique": false,
"label": "促销金额限额",
"type": "currency",
"currency_unit": "￥",
"decimal_places": 2,
"default_to_zero": true,
"is_need_convert": false,
"is_required": false,
"api_name": "amount_quota",
"define_type": "package",
"is_extend": false,
"is_single": false,
"is_index_field": false,
"index_name": "d_1",
"round_mode": 4,
"max_length": 12
}
}
},
"detailObjectDescribeList": []
},
"errorDescription": "success",
"errorMessage": "success",
"errorCode": 0
}请求参数
Body 参数application/json
返回响应
扫码加入交流群修改于 2022-03-01 06:53:39