当前位置: API文档

suites_push.php(创建组合装)

¥标准

1.接口说明

1.1 接口描述创建/更新组合装信息
1.2 适用版本:网页版

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.调用场景

2.1 举例说明:自研商城、SCMSRM、财务系统、SAP等系统的对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境https://openapitest.huice.com/openapi/suites_push.php
正式环境https://openapi.huice.com/openapi/suites_push.php

   3.2 公共请求参数

名称字段类型长度必须描述
卖家账号sidString
购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。
接口账号appkeyString

时间戳timestampint
北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。
签名signString
API输入参数签名结果,签名算法介绍单击这里

   3.3 业务请求参数

名称字段类型长度必须描述
组合装列表节点suite_infodata[]
请求参数的1级数据节点,包含组合装所有属性信息的数据节点,节点下数据字段详见下述“suite_info”

suite_info


名称字段类型长度必须描述
组合装名称suite_namevarchar(255)
组合装名称
组合装编码suite_novarchar(40)
组合装编码
是否默认金额占比is_default_ratiotinyint(4)
是否默认金额占比分摊1.默认0不默认(默认为1)
组合装简称short_namevarchar(255)
组合装简称(默认空)
条码barcodevarchar(40)
条码(默认空)
品牌编码brand_novarchar(40)
品牌编码(默认无)
分类名称class_namevarchar(40)
分类名称(默认无)
单位名称unit_namevarchar(40)
单位名称(默认无)
辅助单位名称aux_unit_namevarchar(40)
辅助单位名称(默认无)
零售价retail_pricedecimal(19,4)
零售价(默认0)
批发价wholesale_pricedecimal(19,4)
批发价(默认0)
会员价member_pricedecimal(19,4)
会员价(默认0)
市场价market_pricedecimal(19,4)
市场价(默认0)
备注remarkvarchar(64)
备注
组合装组合单品suite_detailsdata[]
装组合单品

suite_details

名称字段类型长度必须描述
单品商家编码spec_novarchar
单品商家编码
单品数量numdecimal(19,4)
单品数量
金额占比ratiodecimal(5,4)
金额占比(非默认占比的时候必填)
是否使用固定价格is_fixed_pricetinyint(1)
是否使用固定价格(1固定 0不固定)默认0

4.响应参数

名称字段类型长度必须描述
错误码codeint11状态码:0表示成功,其他表示失败
新增数量new_countint11新增数量
更新数量chg_countint11更新数量
出错数量error_countint11出错数量
出错信息error_messagevarchar(255)
出错信息
处理失败的错误列表errorsdatadata[]处理失败的错误列表,当code为0且有错误信息时才非空.只列出同一批内有错误的记录.如果code=0,errors为空说明全部成功

errors

名称字段类型长度必须描述
错误的组合装编码suite_novarchar(40)                    40组合装编码
错误信息的描述errorvarchar255错误信息的描述



常用工具