商品资料

导入商品单位分组

在甩手掌柜平台上批量生成商品单位分组

接口名称

cmd = "ImportProdUnitGroup"

请求参数

参数名 类型 是否必须 示例值 描述
cmd string ImportProdUnitGroup 请求的命令,即接口名称
seq string eb46ce74-dffa-4108-87bc-4809144ca33c 序列号,采用全局唯一标识符,简称GUID
items json list   单位分组,见下表

上面表格中的字段items对应的值是个json数据,类型是列表,字段如下

参数名 类型 是否必须 示例值 描述
groupcode string 101 分组编码
groupname string 20个*50包*1件 分组名称,一般为包装规格
groupitems json list   单位换算列表,见下表

上面表格中的字段groupitems对应的值是个json数据,类型是列表,字段如下

参数名 类型 是否必须 示例值 描述
unitcode string 11 单位编码
extendunit string 单位名称
eunitquantity string 1 扩展单位数量
munitquantity string 20 主单位数量

注解

  • 单位分组用于商品的扩展单位上。即采购单位、配送单位、销售单位有所不同时,统一换算成库存单位(即商品资料中的主单位)。

请求示例

{
  "cmd": "ImportProdUnitGroup",
  "seq": "eb46ce74-dffa-4108-87bc-4809144ca33c",
  "items": [
    {
      "groupcode": "101",
      "groupname": "20个*50包*1件",
      "groupitems": [
        {
          "unitcode": "11",
          "extendunit": "包",
          "eunitquantity": "1",
          "munitquantity": "20"
        }
      ]
    }
  ]
}

返回参数

参数名 类型 是否必须 示例值 描述
code int 0 返回状态码,详见 业务错误码说明
seq string eb46ce74-dffa-4108-87bc-4809144ca33c 序列号,采用全局唯一标识符,简称GUID
msg string   返回状态解释,错误为错误提示信息

返回示例

{
  "code": 0,
  "msg": "",
  "seq": "eb46ce74-dffa-4108-87bc-4809144ca33c"
}

导入商品及分类

在甩手掌柜平台上批量生成商品及分类

_images/prodandclass.png

接口名称

cmd = "ImportProdAndClass"

请求参数

参数名 类型 是否必须 示例值 描述
cmd string ImportProdAndClass 请求的命令,即接口名称
seq string eb46ce74-dffa-4108-87bc-4809144ca33c 序列号,采用全局唯一标识符,简称GUID
items json list [{“classtype”:1,”fullclassname”:”肉类|猪肉”}]  

上面表格中的字段items对应的值是个json数据,类型是列表,字段如下

参数名 类型 是否必须 示例值 描述
classtype int 1 分类类型:1 表示商品,2 表示原料,3表示物料,4表示配料
fullclassname string 肉类|猪肉 分类全名,格式:零食类|饼干类|曲奇饼干类
extproduid string 124 商品id(第三方)
prodcode string 001 商品编码
random string 6926459720013 商品条码
prodname string 商品名称
unit string 单位
standard string 16K 规格
state int 0 状态:-1删除,0启用,1停售(不允许销售),2停购(不允许采购),3下架(默认为启用状态)
price BigDecimal 12.4 零售价
standardsalepri BigDecimal 11.00 批发价
guidepri BigDecimal 12.4 基准价
guidepurchpri BigDecimal 8.5 基准进价
mempri BigDecimal 9.9 会员价
transfer_price BigDecimal 9.9 配送价
additional_unit string   辅单位
addiunitratio BigDecimal   辅单位与主单位换算比例,有辅单位时必填,1辅单位 = 辅单位与主单位换算比例 * 主单位
addistandard string   辅单位规格
calunit string   核算单位
unit_to_calunit BigDecimal   核算单位与主单位换算比例,有核算单位时必填,1主单位 = 核算单位与主单位换算比例 * 核算单位
marttime string 2016-10-10 上市日期(yyyy-mm-dd),填写了上市日期,则过季日期必须填写
expirationdate string 2026-10-10 过季日期(yyyy-mm-dd),填写了上市日期,则过季日期必须填写
isweight BigDecimal 0 是否为称重商品(0非称重商品,1称重商品),默认为 0
isstock BigDecimal 0 是否为计库存商品(0计库存,1不计库存),默认为 0
isdiscount int 0 是否为允许折扣商品(0不允许折扣,1允许折扣),默认为 1
brand_name string 书屋 品牌
remark string   备注
unitgroupcode string 12 商品单位分组编码

注解

  • 系统默认有6个缺省分类,“商品”、“原料”、“物料”、“配料”和 “待分配商品”,默认类别不能修改和删除
  • 其中 “待分配商品” 下不能建类别;其它分类最多只能建3级,类别的层级中间用 | 隔开
  • 只能在叶子节点增加商品、原料、物料和配料信息
  • fullareaname = 一级分类 + | + 二级分类 + | + 三级分类
  • 同一级别下的区域名称不能重复
  • 商品编码为关键字,当出现编码重复时,后面的记录将覆盖前面的信息,不会提示失败
  • 必填字段必须填写正确,否则同步失败
  • 填写了上市日期,则过季日期必须填写,否则同步失败
  • 商品资料再次同步时,如果修改了主单位,而该商品已经产生过营业数据,则提示不能修改,同步失败
  • 有辅单位必须填辅单位与主单位换算比例
    1辅单位 = 辅单位与主单位换算比例 * 主单位
  • 有核算单位,必须有核算单位与主单位换算比例
    1主单位 = 核算单位与主单位换算比例 * 核算单位
  • 主单位、辅单位、核算单位必须不一致。
  • 商品单位分组不为空时,extunit(json list)与前面导入的商品单位分组校验,必须相同。在此补充扩展单位的单价。
  • 分类及商品可多次导入,每次导入后,分类重新建立。对已存在的商品,再次导入时,首先将其设置成删除状态,并将其分配到“待分配商品”下,然后将本次导入的商品更新或插入到新分类下。
  • 商品分类如果被销售模板引用,模板中分类按商品重新建立。删除的商品如果引用在销售模板中,则该商品从销售模板删除。

请求示例

{
  "cmd": "ImportProdAndClass",
  "seq": "eb46ce74-dffa-4108-87bc-4809144ca33c",
  "items": [
    {
      "classtype": 1,
      "fullclassname": "书|儿童文学",
      "prodcode": "001",
      "random": "6926459720013",
      "prodname": "书",
      "unit": "本",
      "standart": "16K",
      "state": 0,
      "price": 12.4,
      "standardsalepri": 11.00,
      "guidepri": 12.4,
      "guidepurchpri": 8.5,
      "mempri": 9.9,
      "transfer_price": 9.9,
      "additional_unit": "包",
      "addiunitratio": 1,
      "addistandard": "12*1",
      "calunit": "克",
      "unit_to_calunit": 500,
      "marttime": "2016-10-10",
      "expirationdate": "2026-10-10",
      "isweight": 0,
      "isstock": 0,
      "isdiscount": 0,
      "brand_name": "书屋",
      "remark": "新品",
      "unitgroupcode": "12",
      "extunit": [
        {
          "extunit": "001",
          "extquantity": 2,
          "quantity": 1,
          "price": 18.00,
          "standardsalepri": 11.00,
          "guidepri": 12.4,
          "guidepurchpri": 8.5,
          "mempri": 9.9,
          "transfer_price": 9.9
        }
      ]
    }
  ]
}

返回参数

参数名 类型 是否必须 示例值 描述
code int 0 返回状态码,详见 业务错误码说明
seq string eb46ce74-dffa-4108-87bc-4809144ca33c 序列号,采用全局唯一标识符,简称GUID
msg string   返回状态解释,错误为错误提示信息

返回示例

{
  "code": 0,
  "msg": "",
  "seq": "eb46ce74-dffa-4108-87bc-4809144ca33c"
}

查询商品单位分组

接口名称

cmd = "QueryProdUnitGroup"

请求参数

参数名 类型 是否必须 示例值 描述
cmd string QueryProdUnitGroup 请求的命令,即接口名称
seq string eb46ce74-dffa-4108-87bc-4809144ca33c 序列号,采用全局唯一标识符,简称GUID

请求示例

{
  "cmd": "QueryProdUnitGroup",
  "seq": "eb46ce74-dffa-4108-87bc-4809144ca33c"
}

返回参数

参数名 类型 是否必须 示例值 描述
code int 0 返回状态码,详见 [业务错误码说明](errorcode.html#api-error-code)
seq string eb46ce74-dffa-4108-87bc-4809144ca33c 序列号,采用全局唯一标识符,简称GUID
msg string   返回状态解释,错误为错误提示信息
items json list   商品单位分组list,见下表

上面表格中的字段items对应的值是个json数据,类型是列表,字段如下

参数名 类型 是否必须 示例值 描述
groupcode string 101 分组编码
groupname string 20个*50包*1件 分组名称,一般为包装规格
groupitems json list   单位换算列表,见下表

上面表格中的字段groupitems对应的值是个json数据,类型是列表,字段如下

参数名 类型 是否必须 示例值 描述
unitcode string 11 单位编码
extendunit string 单位名称
eunitquantity BigDecimal 1 扩展单位数量
munitquantity BigDecimal 20 主单位数量

返回示例

{
  "code": 0,
  "msg": "",
  "seq": "eb46ce74-dffa-4108-87bc-4809144ca33c",
  "items": [
    {
      "groupcode": "101",
      "groupname": "20个*50包*1件",
      "groupitems": [
        {
          "unitcode": "11",
          "extendunit": "包",
          "eunitquantity": 1,
          "munitquantity": 20
        }
      ]
    }
  ]
}

查询商品及分类

接口名称

cmd = "QueryProdAndClass"

请求参数

参数名 类型 是否必须 示例值 描述
cmd string QueryProdAndClass 请求的命令,即接口名称
seq string eb46ce74-dffa-4108-87bc-4809144ca33c 序列号,采用全局唯一标识符,简称GUID
datatype int 1 数据分类(0-全部、1-商品、2-原料、3-物料、4-配料、5-费用),当datatype为null 则表示下载所有商品类别信息。

请求示例

{
  "cmd": "QueryProdAndClass",
  "seq": "eb46ce74-dffa-4108-87bc-4809144ca33c",
  "datatype": 1
}

返回参数

参数名 类型 是否必须 示例值 描述
code int 0 返回状态码,详见 [业务错误码说明](errorcode.html#api-error-code)
seq string eb46ce74-dffa-4108-87bc-4809144ca33c 序列号,采用全局唯一标识符,简称GUID
msg string   返回状态解释,错误为错误提示信息
items json list   返回的商品类别基本信息

上面表格中的字段items对应的值是个json数据,类型是列表,字段如下

参数名 类型 是否必须 示例值 描述
classtype int 1 分类类型:1 表示商品,2 表示原料,3表示物料,4表示配料
fullclassname string 肉类|猪肉 分类全名,格式:零食类|饼干类|曲奇饼干类
extproduid string 124 商品id(第三方)
prodcode string 001 商品编码
random string 6926459720013 商品条码
prodname string 商品名称
unit string 单位
standard string 16K 规格
state int 0 状态:-1删除,0启用,1停售(不允许销售),2停购(不允许采购),3下架(默认为启用状态)
price BigDecimal 12.4 零售价
standardsalepri BigDecimal 11.00 批发价
guidepri BigDecimal 12.4 基准价
guidepurchpri BigDecimal 8.5 基准进价
mempri BigDecimal 9.9 会员价
transfer_price BigDecimal 9.9 配送价
additional_unit string   辅单位
addiunitratio BigDecimal   辅单位与主单位换算比例,有辅单位时必填,1辅单位 = 辅单位与主单位换算比例 * 主单位
addistandard string   辅单位规格
calunit string   核算单位
unit_to_calunit BigDecimal   核算单位与主单位换算比例,有核算单位时必填,1主单位 = 核算单位与主单位换算比例 * 核算单位
marttime string 2016-10-10 上市日期(yyyy-mm-dd),填写了上市日期,则过季日期必须填写
expirationdate string 2026-10-10 过季日期(yyyy-mm-dd),填写了上市日期,则过季日期必须填写
isweight BigDecimal 0 是否为称重商品(0非称重商品,1称重商品),默认为 0
isstock BigDecimal 0 是否为计库存商品(0计库存,1不计库存),默认为 0
isdiscount int 0 是否为允许折扣商品(0不允许折扣,1允许折扣),默认为 1
brand_name string 书屋 品牌
remark string   备注
unitgroupcode string 12 商品单位分组编码
extunititems json list   扩展单位列表,详见下表

上面表格中的字段 extunit 对应的值是个json 数据,类型是列表,字段如下

参数名 类型 是否必须 示例值 描述
prodcode_ext string 001 编码
extunit string 扩展单位
extquantity BigDecimal 2 扩展单位数量
quantity BigDecimal 1 标准单位数量
price_ext BigDecimal 18.00 扩展单位商品零售价,不填默认根据比例换算
standardsalepri_ext BigDecimal 11.00 批发价
guidepri_ext BigDecimal 12.4 基准价
guidepurchpri_ext BigDecimal 8.5 基准进价
mempri_ext BigDecimal 9.9 会员价
transfer_price_ext BigDecimal 9.9 配送价

返回示例

{
  "code": 0,
  "msg": "",
  "seq": "eb46ce74-dffa-4108-87bc-4809144ca33c",
  "items": [
    {
      "classtype": 1,
      "fullclassname": "书|儿童文学",
      "prodcode": "001",
      "random": "6926459720013",
      "prodname": "书",
      "unit": "本",
      "standart": "16K",
      "state": 0,
      "price": 12.4,
      "standardsalepri": 11.00,
      "guidepri": 12.4,
      "guidepurchpri": 8.5,
      "mempri": 9.9,
      "transfer_price": 9.9,
      "additional_unit": "包",
      "addiunitratio": 1,
      "addistandard": "12*1",
      "calunit": "克",
      "unit_to_calunit": 500,
      "marttime": "2016-10-10",
      "expirationdate": "2026-10-10",
      "isweight": 0,
      "isstock": 0,
      "isdiscount": 0,
      "brand_name": "书屋",
      "remark": "新品",
      "unitgroupcode": "12",
      "extunititems": [
        {
          "prodcode_ext": "2030002|100EA/个",
          "extunit": "个",
          "extquantity": 2,
          "quantity": 1,
          "price_ext": 18.00,
          "standardsalepri_ext": 11.00,
          "guidepri_ext": 12.4,
          "guidepurchpri_ext": 8.5,
          "mempri_ext": 9.9,
          "transfer_price_ext": 9.9
        },
        {
          "prodcode_ext": "2030002|2000EA/件",
          "extunit": "件",
          "extquantity": 1,
          "quantity": 2000,
          "price_ext": 18.00,
          "standardsalepri_ext": 0,
          "guidepri_ext": 12.4,
          "guidepurchpri_ext": 8.5,
          "mempri_ext": 9.9,
          "transfer_price_ext": 9.9
        },
        {
          "prodcode_ext": "2030002|100EA/条",
          "extunit": "条",
          "extquantity": 1,
          "quantity": 100,
          "price_ext": 18.00,
          "standardsalepri_ext": 0,
          "guidepri_ext": 12.4,
          "guidepurchpri_ext": 8.5,
          "mempri_ext": 9.9,
          "transfer_price_ext": 9.9
        }
      ]
    }
  ]
}

查询商品类别

接口名称

cmd = "QueryProductsClassInfo"

请求参数

参数名 类型 是否必须 示例值 描述
cmd string QueryProductsClassInfo 请求的命令,即接口名称
seq string eb46ce74-dffa-4108-87bc-4809144ca33c 序列号,采用全局唯一标识符,简称GUID
datatype int 1 数据分类(0-全部、1-商品、2-原料、3-物料、4-配料、5-费用),当datatype为null 则表示下载所有商品类别信息。

请求示例

{
  "cmd": "QueryProductsClassInfo",
  "seq": "eb46ce74-dffa-4108-87bc-4809144ca33c",
  "datatype": 1
}

返回参数

参数名 类型 是否必须 示例值 描述
code int 0 返回状态码,详见 [业务错误码说明](errorcode.html#api-error-code)
seq string eb46ce74-dffa-4108-87bc-4809144ca33c 序列号,采用全局唯一标识符,简称GUID
msg string   返回状态解释,错误为错误提示信息
items json list   返回的商品类别基本信息

上面表格中的字段productsitems对应的值是个json数据,类型是列表,字段如下

参数名 类型 是否必须 示例值 描述
prodclassuid integer 201 分类id
datatype int 1 数据分类(0-全部、1-商品、2-原料、3-物料、4-配料、5-费用)
classcode string 001 分类编码
classname string 1 分类名称
parentuid int 0 父类别id
state int 0 状态(-1删除,0正常)
prodtype int 0 分类类型(0、表示正常分类,1、标示未分类商品分类)

返回示例

{
  "code": 0,
  "msg": "",
  "seq": "123123-abc12",
  "items": [
    {
      "prodclassuid": 201,
      "datatype": 1,
      "classcode": "001",
      "classname": "盒装类",
      "parentuid": 0,
      "state": 0,
      "prodtype": 0
    },
    {
      "prodclassuid": 523,
      "datatype": 1,
      "classcode": "001",
      "classname": "麻辣系列",
      "parentuid": 0,
      "state": 0,
      "prodtype": 0
    }
  ]
}

查询门店商品

接口名称

cmd = "QueryProductsInfo"

请求参数

参数名 类型 是否必须 示例值 描述
cmd string QueryProductsInfo 请求的命令,即接口名称
seq string eb46ce74-dffa-4108-87bc-4809144ca33c 序列号,采用全局唯一标识符,简称GUID
datatype int 1 数据分类(0-全部、1-商品、2-原料、3-物料、4-配料、5-费用)
modle int 1 模板类型 (1-报货、2-销售),modle为null非指定模板中商品信息,modle不为null则为对应门店模板中的商品信息。
storesuid integer   门店ID,storeitems为null则为标准商品信息,不为null则为指定门店的商品价格信息。

注解

  • modle与storeitems必须同时作为请求参数

请求示例

{
  "cmd": "QueryProductsInfo",
  "seq": "eb46ce74-dffa-4108-87bc-4809144ca33c",
  "datatype": 1,
  "modle": 1,
  "storeuid": 100
}

返回参数

参数名 类型 是否必须 示例值 描述
code int 0 返回状态码,详见 [业务错误码说明](errorcode.html#api-error-code)
seq string eb46ce74-dffa-4108-87bc-4809144ca33c 序列号,采用全局唯一标识符,简称GUID
msg string   返回状态解释,错误为错误提示信息
productsclassitems json list   返回的商品类别信息

上面表格中的字段productsclassitems对应的值是个json数据,类型是列表,字段如下

参数名 类型 是否必须 示例值 描述
prodclassuid integer 201 商品类别ID
productsitems json list   返回的商品类别基本信息

上面表格中的字段productsitems对应的值是个json数据,类型是列表,字段如下

参数名 类型 是否必须 示例值 描述
extproduid string 124 商品id(第三方)
produid integer 201 商品id
prodcode string 001 商品编码
prodname string 小黄鸭 商品名称
random string 001 条码
unit string 单位
standard string 1000*10 规格
price BigDecimal 20.00 销售价
mempri BigDecimal 17.00 会员价
standardsalepri BigDecimal 15.00 批发价
transfer_price BigDecimal 13.00 调拨价
newpurchasingpri BigDecimal 8.88 最新进价
additional_unit string 辅单位
unit_to_calunit int 10 辅单位换算比例
calunit string 核算单位
unit_to_labelunit int 10 核算单位与主单位换算关系

注解

  • 有辅单位必须填辅单位与主单位换算比例
  • 1辅单位 = 辅单位与主单位换算比例 * 主单位

返回示例

{
  "code": 0,
  "msg": "",
  "seq": "123123-abc12",
  "datatype": 1,
  "modle": 1,
  "storeuid": 421,
  "items": [
    {
      "prodclassuid": 3,
      "items": [
        {
          "produid": 201,
          "prodcode": "001",
          "prodname": "小黄鸭",
          "random": "001",
          "unit": "盒",
          "standard": 0.00,
          "price": 0.00,
          "mempri": 0.00,
          "standardsalepri": 0.00,
          "transfer_price": 0.00,
          "newpurchasingpri": 0.00,
          "additional_unit": "包",
          "unit_to_calunit": 10,
          "calunit": "克",
          "unit_to_labelunit": 10
        },
        {
          "produid": "201",
          "prodcode": "001",
          "pordname": "小黄鸭",
          "random": "001",
          "unit": "盒",
          "standard": 0.00,
          "price": 0.00,
          "mempri": 0.00,
          "standardsalepri": 0.00,
          "transfer_price": 0.00,
          "newpurchasingpri": 0.00,
          "additional_unit": "包",
          "unit_to_calunit": 10,
          "calunit": "克",
          "unit_to_labelunit": 10
        }
      ]
    },
    {
      "prodclassuid": 4,
      "items": [
        {
          "produid": 201,
          "prodcode": "001",
          "pordname": "小黄鸭",
          "random": "001",
          "unit": "盒",
          "standard": 0.00,
          "price": 0.00,
          "mempri": 0.00,
          "standardsalepri": 0.00,
          "transfer_price": 0.00,
          "newpurchasingpri": 0.00,
          "additional_unit": "包",
          "unit_to_calunit": 10,
          "calunit": "克",
          "unit_to_labelunit": 10
        },
        {
          "produid": "201",
          "prodcode": "001",
          "pordname": "小黄鸭",
          "random": "001",
          "unit": "盒",
          "standard": 0.00,
          "price": 0.00,
          "mempri": 0.00,
          "standardsalepri": 0.00,
          "transfer_price": 0.00,
          "newpurchasingpri": 0.00,
          "additional_unit": "包",
          "unit_to_calunit": 10,
          "calunit": "克",
          "unit_to_labelunit": 10
        }
      ]
    }
  ]
}