本地生活商品模版
本地生活商品产品类型介绍
\1. 团购套餐
\2. 代金券
关键属性介绍
请通过本地商品模板查询接口 alipay.open.app.localitem.template.query（获取本地商品模板信息）查询以下属性是否是必填项，当 is_required=true 时表示必填。
| 属性名 | 属性key | 示例值 | 说明 |
|---|---|---|---|
| 库存 | limit_stock_rule | { "limit": "1", "num": "10", "unit": "份"} | limit、num、unit 使用字符串格式。limit="1" 时限制库存，需要填写 num 限制数量；limit="0" 时不限制库存，不要填写 num 限制数量。 |
| 商品详情图 | description_image | { "url_list":[ "url1", "url2" ]} | 商品详情图的文件 id 列表。图片支持 jpg、jpeg、png 格式，宽度及宽高比为 1:1 ，750px*750px。文件 id 通过 alipay.open.file.upload（支付宝文件上传接口）上传资源获取。 |
| 原价设置方式 | original_price_source | "0"/"1" | 该字段与 commodity 搭配使用，控制 commodity.price 字段是否需要指定："1"：默认值，需设置单品原价，commodity.price 必须指定值。商品创建和修改时系统根据 commodity.price 自动计算替换 sku.original_price 商品原价字段。"0"：无需设置单品原价，commodity.price 为空。商品创建和修改时，必须设置 sku.original_price 商品原价字段。 |
| 套餐搭配 | commodity | [ { "group_name": "商品组名", "total_count": 5, "option_count": 3, "item_list": [ { "name": "单品名称", "count": 1, "count_unit":"份", "price": 10050, "unit": "元" } ] }] | commodity 列表中每一个结构都代表一个商品组。每个商品组中都包含 group_name 商品组名、total_count 总数、option_count 选几以及 item_ist 可选单品列表。item_list 中每一个结构都代表一个可选单品。每个 item_list 可选单品列表中都包含 name 单品名称、count 份数、count_unit 份数单位、price 价格以及 unit 价格单位。price 价格以分为单位，并且具体数值大小由 unit 指定，如 price=10050 且 unit ="元"时，最终价格为 100.5 元。price 是否填写与 original_price_source关联。 |
| 使用说明 | notification | "请输入使用规则，注意该信息需与商品信息、售卖/使用信息保持前后一致，避免顾客理解错误而引起不必要的纠纷。" | 请使用字符串格式 |
| 可使用门店 | use_shop | [ { "shop_id":"shop1" }, { "shop_id":"shop2" }] | shop_id 可使用门店id请使用字符串格式，shop_id 获取参见 门店管理介绍。 |
| 可使用日期 | use_date | { "use_date_type":"1", "day_duration":"XX", "use_start_date":"yyyy-MM-dd", "use_end_date":"yyyy-MM-dd"} | use_date_type、day_duration、use_start_date、use_end_date 请使用字符串格式。use_date_type"1" 代表指定日期，"2" 代表指定天数use_start_date 与 use_end_date 的粒度为天，如“2023-05-01”。use_date_type 为"1"时，需指定日期时需指定开始日期 use_start_date 和结束日期 use_end_date。use_date_type 为"2"时，需指定有效天数 day_duration，如"90"。可使用日期的开始时间不能早于售卖开始时间（sold_time）。 |
| 时间限制 | use_limit | { "use_time_type":"1", "use_date_list":[ { "days_of_week":[ "1", "7", ], "start_time":"HH:mm:ss", "end_time":"HH:mm:ss", "end_time_type":"SAME_DAY" } ], "can_no_use_date_list":[ { "holidays":[ { "start_time":"HH:mm:ss", "end_time":"HH:mm:ss", "end_time_type":"SAME_DAY" } ], "date_list":[ { "start_date":"yyyy-MM-dd", "end_date":"yyyy-MM-dd", "start_time":"HH:mm:ss", "end_time":"HH:mm:ss", "end_time_type":"SAME_DAY" } ] } ]} | use_time_type 请使用字符串格式，"1"代表任意时间可用， "2"代表指定时间可用。use_date_list 代表可用日期范围，周一~周日对应字符串"1"-"7"，end_time_type 指定截止类型为当日或次日，语义示例：周一和周日的 07:00-18:00 (当日)可用。截止时间类型 end_time_type 中"SAME_DAY"代表开始时间与结束时间在同一天内，"NEXT_DAY" 代表结束时间在开始时间的第二天。can_no_use_date_list 指定不可用日期范围。holidays：指定法定节假日不可用时段，如法定节假日10:00-16:00不可用。date_list：指定日期时间段不可用，如 2023-05-01 12:00 到 2023-05-01 18:00 不可用。当指定可使用日期(use_date)类型为“1”时，需保证 can_no_use_date_list 不可用日期范围在可使用日期范围内。 |
| 每人限购 | limit_buy_rule | { "limit":"1", "num":"10"} | limit 和 num 请使用字符串格式。limit="1" 代表设置每人限购，limit="0" 代表不设置每人限购。limit 指定为"0"不限制时，num 不允许指定。 |
| 退款规则 | refund_rule | {"refund_policy": ["1", "2"] } | refund_policy 请使用字符串列表格式。退款规则 renfund_policy 中"1"代表随时可退，"2"代表过期未核销自动退。字符串列表必须同时支持"1"和"2"。 |
| 由商家确认退款 | merchant_refund_confirm | "1" | 请使用字符串格式。"1"代表退款需商家确认，"2"代表退款无需商家确认。 |
| 使用方式 | usage_type | { "usage_list":[ { "use_type":"1" }, { "use_type":"2", "use_path":"alipays url1" } ]} | use_type 请使用字符串格式。使用方式 use_type 中"1"代表到店亮码，"2"代表小程序内使用。use_path：以alipays 开头，use_type=2 时，需要附带使用链接。 |
| 核销方式 | verify_type | ["1","2"] | 请使用字符串列表格式。"1"代表商家用支付宝 POS 小程序验证核销，"2"代表商家用自有方式核销。 |
| 券码生成方式 | code_source_type | "2" | 请使用字符串格式。"1"代表三方码核销（商家码核销）, "2"代表一方码核销（支付宝码核销）。券码生成方式 code_source_type 默认为"2"。 |
| 收款方式 | settle_type | { "settle_type":"1", "settle_pid_info":"xxxxx"} | settle_type 请使用字符串格式。收款方式 settle_type 中"1"代表统一收款类型，"2"代表分店收款类型。若商户在商家平台/服务商平台入驻环节已设置统一收款账户，且指定统一收款方式（settle_type="1"）时，统一收款账号 settle_pid_info 可不传。否则均需传入 settle_pid_info，且该账号做为统一收款账号。 |
| 预约规则 | preorder_rule | { "need_appointment": true, "appointment_instruction": "预约说明：请至少提前一天预约。" } | need_appointment 请使用 boolean 格式。 //true-需预约，false-无需预约。仅当 need_appointment 为 true 时需要填写 appointment_instruction 预约说明。 |
| 顾客信息设置 | contact_info_type | "1" | 请使用字符串格式。 "1"代表需要顾客手机号，"2"代表不需要顾客手机号。 |
| 结算规则 | order_settle_rule | {"order_settle_rule": "1"} | order_settle_rule 值请使用字符串格式。默认"1"，表示需凭证核销后结算。 |
| 详细描述富文本 | detail_rich_desc | {"type":"1","content":" 夏日阳光早餐 | type="1" 表示富文本格式，content 支持富文本格式，当前 content 字段整体长度限制为 3000 字符。当该字段与商品详情图（description_image）同时存在时，默认忽略详情图保留富文本。 |
商品模板
| 英文名称 | 中文名称 | 美食本地商品×团购券 | 美食本地商品×代金券 | 酒店本地商品×团购券 | 酒店本地商品×代金券 |
|---|---|---|---|---|---|
| limit_stock_rule | 库存 | ✓ | ✓ | ✓ | ✓ |
| description_image | 商品详情图 | ✓ | - | ✓ | - |
| commodity | 套餐搭配 | ✓ | - | - | - |
| notification | 使用说明 | ✓ | ✓ | ✓ | ✓ |
| use_shop | 可使用门店 | ✓ | ✓ | ✓ | ✓ |
| use_date | 可使用日期 | ✓ | ✓ | ✓ | ✓ |
| use_limit | 时间限制 | ✓ | ✓ | ✓ | ✓ |
| limit_buy_rule | 每人限购 | ✓ | ✓ | ✓ | ✓ |
| refund_rule | 退款规则 | ✓ | ✓ | ✓ | ✓ |
| merchant_refund_confirm | 由商家确认退款 | ✓ | ✓ | ✓ | ✓ |
| usage_type | 顾客使用方式 | ✓ | ✓ | ✓ | ✓ |
| verify_type | 商家核销方式 | ✓ | ✓ | ✓ | ✓ |
| code_source_type | 一方码：POS核销/接口三方码：接口 | ✓ | ✓ | ✓ | ✓ |
| settle_type | 收款方式 | ✓ | ✓ | ✓ | ✓ |
| preorder_rule | 预约规则 | ✓ | ✓ | ✓ | ✓ |
| contact_info_type | 顾客信息设置 | ✓ | ✓ | ✓ | ✓ |
本地生活商品创建代码示例
{
"biz_content":{
"category_id":"C0000", // 修改为类目获取接口的叶子类目节点
"item_type":"1",
"title":"测试商品001",
"out_item_id":"test_item_001",
"head_img":"A*Z-V2To1nD9wAAAAAAAAAAAAAAVR1AQ",
"item_details_page_model":"1",
"sold_time":{
"start_time":"2023-05-25 18:00:00",
"end_time":"2023-06-29 18:00:00"
},
"merchant_name":"测试商家",
"customer_service_mobile":{
"phone_type":1,
"phone_number":"18888888888"
},
"image_list":[
"A*6XqwQKpS1t0AAAAAAAAAAAAADi92AA"
],
"skus":[
{
"sale_price":100,
"original_price":300,
"price_unit":"元",
"sale_status":"AVAILABLE",
"stock_num":600
}
],
"attrs":[
{
"attr_key":"limit_stock_rule",
"attr_value":"{\"limit\":\"1\",\"num\":\"600\"}"
},
{
"attr_key":"description_image",
"attr_value":"{\"url_list\":[\"A*Z-V2To1nD9wAAAAAAAAAAAAAAVR1AQ\",\"A*6XqwQKpS1t0AAAAAAAAAAAAADi92AA\"]}"
},
{
"attr_key":"commodity",
"attr_value":"[{\"group_name\":\"商品组1\",\"total_count\":2,\"option_count\":1,\"item_list\":[{\"name\":\"单品1.1\",\"count\":1,\"price\":5155,\"unit\":\"元\"},{\"name\":\"单品1.2\",\"count\":1,\"price\":30000,\"unit\":\"元\"}]},{\"group_name\":\"商品组2\",\"total_count\":1,\"option_count\":1,\"item_list\":[{\"name\":\"单品2.1\",\"count\":1,\"price\":12050,\"unit\":\"元\"}]}]"
},
{
"attr_key":"notification",
"attr_value":"请输入使用规则，注意该信息需与商品信息、售卖/使用信息保持前后一致，避免顾客理解错误而引起不必要的纠纷。"
},
{
"attr_key":"use_shop", // 修改为门店接口获取的门店ID数据
"attr_value":"[{\"shop_id\":\"******\"},{\"shop_id\":\"******\"}]"
},
{
"attr_key":"use_date",
"attr_value":"{\"use_date_type\":\"1\",\"use_start_date\":\"2023-06-05 23:00:00\",\"use_end_date\":\"2023-07-06 23:00:00\"}"
},
{
"attr_key":"use_limit",
"attr_value":"{\"use_time_type\":\"2\",\"use_date_list\":[{\"days_of_week\":[\"1\",\"2\"],\"start_time\":\"09:00:00\",\"end_time\":\"20:30:00\",\"end_time_type\":\"SAME_DAY\"}],\"can_no_use_date_list\":[{\"holidays\":[{\"start_time\":\"09:00:00\",\"end_time\":\"21:30:00\",\"end_time_type\":\"SAME_DAY\"}],\"date_list\":[{\"start_date\":\"2023-06-22\",\"end_date\":\"2023-06-25\",\"start_time\":\"09:00:00\",\"end_time\":\"23:00:00\",\"end_time_type\":\"SAME_DAY\"}]}]}"
},
{
"attr_key":"limit_buy_rule",
"attr_value":"{\"limit\":\"1\",\"num\":\"200\",\"unit\":\"件\"}"
},
{
"attr_key":"refund_rule",
"attr_value":"{\"refund_policy\": [\"1\", \"2\"]}"
},
{
"attr_key":"merchant_refund_confirm",
"attr_value":"1"
},
{
"attr_key":"usage_type",
"attr_value":"{\"usage_list\":[{\"use_type\":\"1\"}]}"
},
{
"attr_key":"verify_type",
"attr_value":"[\"1\",\"2\"]"
},
{
"attr_key":"code_source_type",
"attr_value":"2"
},
{
"attr_key":"settle_type", // 修改为收款账号信息
"attr_value":"{\"settle_type\":\"1\",\"settle_pid_info\":\"******\"}"
},
{
"attr_key":"preorder_rule",
"attr_value":"{\"need_appointment\":true,\"appointment_instruction\":\"预约说明：请至少提前一天预约。\"}"
},
{
"attr_key":"contact_info_type",
"attr_value":"1"
}
]
}
}
免审更新代码示例
免审更新时平台侧的 item_id 或者商家侧 out_item_id 不能同时为空，特殊可选，仅支持更新以下三个属性：
- 售卖时间（sold_time）
- 售价（sale_price）
- 库存信息（stockNum），当库存为不限库存时，无需指定 stockNum 值。若商品已参加招商活动等公域场，则库存不能减少。
其他属性不支持修改。入参中的原价（original_price）需要与当前查询原价值保持一致。
{
"biz_content":{
"out_item_id":"zs20230626005",
"sold_time":{
"start_time":"2023-06-25 18:00:00",
"end_time":"2023-06-29 18:00:00"
},
"skus":[
{
"sale_price":1000,
"original_price":4227,
"sale_status":"AVAILABLE",
"stock_num":"1001"
}
]
}
}
修改于 2023-11-22 02:16:33