当前位置: API文档
suites_push.php(创建组合装)
1.1 接口描述:创建/更新组合装信息 |
1.2 适用版本:客户端 V2.4.0.5及以上版本 |
1.3 注意事项: 如果suite_info中的is_default_ratio=1,即默认按照零售价分摊金额占比,那么suite_detail中的ratio字段不传值,传值也视为无效。如参数suite_info中的is_default_ratio=0,那么ratio必须传值,且总和为1,否则会提示错误。 如果suite_detail中的is_fixed_price=1,则相应的ratio需传0(接口默认处理成0),其他is_fixed_price=0时根据suite_info、is_default_ratio值,进行默认分摊金额占比或者按照指定金额占比处理(如果是指定金额占比,会检验剩下非固定价格行的金额占比之和是否为1)如所有行都选择固定价格,那么最后一行ratio=1,其他行均为0。 组合装更新的时候,需要保证suite_no、spec_no不变,明细行全量更新。并非只传更新的货品信息。(如原来明细是三个货品,更新时也需要完整传输三个货品的信息,如果只传两个货品,第三个货品会被删除) 其他检验逻辑和客户端逻辑保持一致。 |
2.1 举例说明:满足外部系统——>OMS创建组合装的场景 |
环境 | HTTP地址 |
---|---|
测试环境 | http://sandbox.wangdian.cn/openapi2/suites_push.php |
正式环境 | http://api.wangdian.cn/openapi2/suites_push.php |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
卖家账号 | sid | String | 是 | 购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。 | |
接口账号 | appkey | String | 是 | 本开放平台“自助对接”功能模块内自助申请,获取方式点击这里 | |
时间戳 | timestamp | int | 是 | 北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。 | |
签名 | sign | String | 是 | API输入参数签名结果,签名算法介绍单击这里 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
组合装列表节点 | suite_info | data[] | 是 | 请求参数的1级数据节点,包含组合装所有属性信息的数据节点,节点下数据字段详见下述“suite_info” |
suite_info
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
组合装名称 | suite_name | varchar(255) | 是 | 组合装名称 | |
组合装编码 | suite_no | varchar(40) | 是 | 组合装编码 | |
是否默认金额占比 | is_default_ratio | tinyint(4) | 否 | 是否默认金额占比分摊1.默认0不默认(默认为1) | |
组合装简称 | short_name | varchar(255) | 否 | 组合装简称(默认空) | |
条码 | barcode | varchar(40) | 否 | 条码(默认空) | |
品牌编码 | brand_no | varchar(40) | 否 | 品牌编码(默认无) | |
分类名称 | class_name | varchar(40) | 否 | 分类名称(默认无) | |
单位名称 | unit_name | varchar(40) | 否 | 单位名称(默认无) | |
辅助单位名称 | aux_unit_name | varchar(40) | 否 | 辅助单位名称(默认无) | |
零售价 | retail_price | decimal(19,4) | 否 | 零售价(默认0) | |
批发价 | wholesale_price | decimal(19,4) | 否 | 批发价(默认0) | |
会员价 | member_price | decimal(19,4) | 否 | 会员价(默认0) | |
市场价 | market_price | decimal(19,4) | 否 | 市场价(默认0) | |
备注 | remark | varchar(64) | 否 | 备注 | |
组合装打印内容 | is_print_suite | tinyint(4) | 否 | 组合装打印内容(0:组合装明细/1:组合装以及明细/2:组合装)默认0 | |
组合装搭建大件属性 | large_split | tinyint(4) | 否 | 组合装搭建大件属性(0:非大件/1:普通大件/2:独立大件)默认0 | |
自定义属性1 | prop1 | varchar(40) | 否 | 自定义属性1 | |
自定义属性2 | prop2 | varchar(40) | 否 | 自定义属性2 | |
自定义属性3 | prop3 | varchar(40) | 否 | 自定义属性3 | |
自定义属性4 | prop4 | varchar(40) | 否 | 自定义属性4 | |
组合装组合单品 | suite_details | data[] | 是 | 装组合单品 |
suite_details
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
单品商家编码 | spec_no | varchar | 是 | 单品商家编码 | |
单品数量 | num | decimal(19,4) | 是 | 单品数量 | |
金额占比 | ratio | decimal(5,4) | 否 | 金额占比(非默认占比的时候必填) | |
是否使用固定价格 | is_fixed_price | tinyint(1) | 否 | 是否使用固定价格(1固定 0不固定)默认0 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
错误码 | code | int | 11 | 是 | 状态码:0表示成功,其他表示失败 |
新增数量 | new_count | int | 11 | 是 | 新增数量 |
更新数量 | chg_count | int | 11 | 是 | 更新数量 |
出错数量 | error_count | int | 11 | 是 | 出错数量 |
出错信息 | error_message | varchar(255) | 是 | 出错信息 |
6.响应示例
6.1 正常响应示例
JSON | { "code": 0, "new_count":1 , "chg_count":1 , "error_count":0, "error_message":"OK" } |
6.2 异常响应示例
JSON | { "code": 0, "new_count":1 , "chg_count":1 , "error_count":0, "error_message":"OK" } |