供应链数据

接口说明

二维火提供商户供应链数据接口,第三方系统可通过此接口获取商户供应链数据

二维火商户和第三方系统商户进行id匹配;

接口定义

请求URL:

http://{servename}/router(二维火提供查询)

1、查询供应商列表

method="dfire.shop.supplier.list"

传递参数为:

字段说明 字段名 类型 可空(Y/N) 举例
门店id entityId String N 所属总部Id
供应商编码 supplierCode String Y 1001

传递form表单参数实例:

appKey:cdc08577b61942442aa89390dacb25ad
timestamp:1476255107097
sign:DF0719FCD2B0CE188307595BB39F5DE9488DD57E
v:1.0
method:dfire.shop.supplier.list
entityId:NRZB
supplierCode:

返回参数为:

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
总部名称 entityName String N  
所属供应商Id supplierId String N  
供应商名称 name String N  
供应商编码 code String N  
类别ID typeId String N  
类别 type String N  
联系人 relation String Y  
联系电话 phone String Y  
手机号码 mobile String Y  
微信 weChat String Y  
邮箱 email String Y  
传真号码 fax String Y  
联系地址 address String Y  
开户行 bankName String Y  
银行帐户 bankCardNo String Y  
户名 bankAccountName String Y  
税率 taxRate BigDecimal Y 0
付款条件 termOfPayment String Y  

返回参数 实例:

{
        "success": true,

        "model": [
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "supplierId": "9992891057dc47600157dc5090da0004",

                        "name": "阿俊农家菜",

                        "code": "0001",

                        "typeId": "9992891057dc47600157dc4d17930002",

                        "type": "杭州供应商",

                        "relation": "张俊",

                        "phone": "0751-5236587",

                        "mobile": "13589650000",

                        "weChat": "junjun",

                        "email": "emall@qq.com",

                        "fax": "0571-2580000",

                        "address": "杭州市西湖区浙大紫金港",

                        "bankName": "交通银行",

                        "bankCardNo": "580896523366980",

                        "bankAccountName": "张俊",

                        "taxRate": 0
                },
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "supplierId": "9992891057dc47600157dc53ebe1000f",

                        "name": "三哥海产店",

                        "code": "0002",

                        "typeId": "9992891057dc47600157dc4d17930002",

                        "type": "杭州供应商",

                        "relation": "三三",

                        "phone": "0571-5258000",

                        "mobile": "13587402000",

                        "weChat": "sansanweixin",

                        "email": "sansan@qq.com",

                        "fax": "0571-5252470",

                        "address": "杭州市西湖区教工路552号。",

                        "taxRate": 0
                }
        ],
        "totalRecord": 0
}

2、查询原料信息列表

method="dfire.shop.goods.list"

传递参数为:

字段说明 字段名 类型 可空(Y/N) 举例
门店id entityId String N 所属总部Id
原料Id goodsId String Y 1001

传递form表单参数实例:

appKey:cdc08577b61942442aa89390dacb25ad
timestamp:1476255107097
sign:DF0719FCD2B0CE188307595BB39F5DE9488DD57E
v:1.0
method:dfire.shop.goods.list
entityId:NRZB
goodsId:

返回参数为:

字段说明 字段名 类型 可空(Y/N) 默认值
总部ID entityId String N  
总部名称 entityName String N  
原料Id goodsId String N  
原料名称 name String N  
原料分类编码 typeCode String N  
原料分类名称 typeName String N  
原料编码 barCode String N  
单位类型 unitType Integer N

1:双单位

2:主副单位

原料分类 type Integer N

1.普通商品

2.拆分商品

3.组装商品

4.称重商品

5.原料商品

6.加工商品

条形码 standardBarCode String N  
多单位列表 goodsUnitVoList List<GoodsUnitVo> N  
规格 specification String N  
保质期 period String N  

GoodsUnitVo

字段说明 字段名 类型 可空(Y/N) 默认值
所属实体 entityId String N  
所属商品 goodsName String N  
所属单位 unitName String N  
单位类型 type Integer N

1.数量单位

2.重量单位

3.多单位主单位

4.多单位副单位

主单位换算值 unitConversion BigDecimal N 0.00
是否计价单位 isValuationUnit String N  
是否库存单位 isInventoryUnit String N  

返回参数 实例:

{
        "success": true,

        "model": [
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "goodsId": "9992891057fa68d70157fabffcee01b1",

                        "name": "鱿鱼",

                        "typeName": "冰鲜鱼",

                        "barCode": "00001",

                        "unitType": 2,

                        "type": 5,

                        "goodsUnitVoList": [
                                {
                                        "entityId": "NRZB",

                                        "goodsName": "鱿鱼",

                                        "unitName": "斤",

                                        "type": 3,

                                        "unitConversion": 1,

                                        "isValuationUnit": "1",

                                        "isInventoryUnit": "0"
                                },
                                {
                                        "entityId": "NRZB",

                                        "goodsName": "鱿鱼",

                                        "unitName": "箱",

                                        "type": 4,

                                        "unitConversion": 50,

                                        "isValuationUnit": "0",

                                        "isInventoryUnit": "1"
                                }
                        ],
                        "specification": "0.5*0.5",

                        "period": "7"
                },
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "goodsId": "9992891057fa68d70157fac233cb01c1",

                        "name": "香菜",

                        "typeName": "果实类",

                        "barCode": "00002",

                        "unitType": 2,

                        "type": 5,

                        "goodsUnitVoList": [
                                {
                                        "entityId": "NRZB",

                                        "goodsName": "香菜",

                                        "unitName": "斤",

                                        "type": 3,

                                        "unitConversion": 1,

                                        "isValuationUnit": "0",

                                        "isInventoryUnit": "1"
                                },
                                {
                                        "entityId": "NRZB",

                                        "goodsName": "香菜",

                                        "unitName": "把",

                                        "type": 4,

                                        "unitConversion": 1,

                                        "isValuationUnit": "1",

                                        "isInventoryUnit": "0"
                                }
                        ],

                        "period": "5"
                }
        ],
        "totalRecord": 0
}

3、查询店铺采购单信息列表

method="dfire.shop.purchase.list"

传递参数为:

字段说明 字段名 类型 可空(Y/N) 举例
店铺Id entityId String N  
单号 no String Y  
状态 status Integer Y  
要求到货日 date String Y  
开始时间 startTime Long N  
结束时间 endTime Long N  

传递form表单参数实例:

appKey:cdc08577b61942442aa89390dacb25ad
timestamp:1476255107097
sign:DF0719FCD2B0CE188307595BB39F5DE9488DD57E
v:1.0
method:dfire.shop.purchase.list
entityId:NRZB
no:
status:
date:
startTime:1477324800
endTime:1477452242

返回参数为:

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
门店名称 entityName String N  
供应商名称 supplierName String N  
供应商编号 supplierCode String N  
采购单号 purchaseNo String N  
要求到货日 predictDate String N  
状态 status Integer N

1:未提交

2:待审核

3:已审核

4:已拒绝

5:采购完成

备注 memo String Y  
提交人Id createUserId String N  
提交人 createUser String N  
提交时间 createTime String N  
审核人Id auditUserId String N  
审核人 auditUser String N  
审核时间 auditTime String N  
采购原料 purchaseDetailVoList List<PurchaseDetailVo> N  
单据金额 totalAmount BigDecimal N 0.00

PurchaseDetailVo

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
采购单号 purchaseNo String N  
原料Id goodsId String N  
原料名称 goodsName String N  
条形码 standardBarCode String N  
数量单位ID numUnitId String N  
数量单位名称 numUnitName String N  
计价单位ID priceUnitId String N  
计价单位名称 priceUnitName String N  
单价 goodsPrice BigDecimal N 0.00
数量 goodsNum BigDecimal N 0.00
金额 totalAmount BigDecimal N 0.00

返回参数 实例:

{
        "success": true,

        "model": [
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "purchaseNo": "CG20161025000006",

                        "createUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "createUser": "超级管理员",

                        "createTime": "1477393942",

                        "auditUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "auditUser": "超级管理员",

                        "auditTime": "1477393962",

                        "purchaseDetailVoList": [
                                {
                                        "entityId": "NRZB",

                                        "purchaseNo": "CG20161025000006",

                                        "goodsId": "9992891057fa68d70157fabffcee01b1",

                                        "goodsName": "鱿鱼",

                                        "standardBarCode": "00001",

                                        "numUnitId": "unitbase000000000000000000000007",

                                        "numUnitName": "斤",

                                        "priceUnitId": "unitbase000000000000000000000007",

                                        "priceUnitName": "斤",

                                        "goodsPrice": 2000,

                                        "goodsNum": 100,

                                        "totalAmount": 200000
                                }
                        ],

                        "totalAmount": 200000

                },
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "purchaseNo": "CG20161026000001",

                        "memo": "新鲜",

                        "createUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "createUser": "超级管理员",

                        "createTime": "1477450417",

                        "auditUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "auditUser": "超级管理员",

                        "auditTime": "1477450430",

                        "purchaseDetailVoList": [
                                {
                                        "entityId": "NRZB",

                                        "purchaseNo": "CG20161026000001",

                                        "goodsId": "9992891057fa68d70157fac233cb01c1",

                                        "goodsName": "香菜",

                                        "standardBarCode": "00002",

                                        "numUnitId": "unitbase000000000000000000000019",

                                        "numUnitName": "把",

                                        "priceUnitId": "unitbase000000000000000000000019",

                                        "priceUnitName": "把",

                                        "goodsPrice": 1000,

                                        "goodsNum": 50,

                                        "totalAmount": 50000

                                }
                        ],

                        "totalAmount": 50000

                }
        ],
        "totalRecord": 0
}

4、查询店铺配送单信息列表

查询距离当前时间3个月内的店铺配送单信息。

method="dfire.shop.transfer.list"

传递参数为:

字段说明 字段名 类型 可空(Y/N) 举例
店铺Id entityId String N  
单号 no String Y  
仓库Id warehouseId String Y  
状态 status Integer Y  
要求到货日 date String Y  
开始时间 startTime Long N  
结束时间 endTime Long N  

传递form表单参数实例:

appKey:cdc08577b61942442aa89390dacb25ad
timestamp:1476255107097
sign:DF0719FCD2B0CE188307595BB39F5DE9488DD57E
v:1.0
method:dfire.shop.transfer.list
entityId:NR1
no:
warehouseId:
status:
date:
startTime:1477324800
endTime:1477463943

返回参数为:

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
门店名称 entityName String N  
状态 status String N

1:待发货

2:配送中

3:已收货

4:拒绝发货

5:拒绝收货

配送单号 transferNo String N  
发货仓库Id warehouseId String N  
发货仓库 warehouseName String N  
要求到货日 predictDate String N  
配送费 transferFee String N  
备注 memo String Y  
提交人Id createUserId String N  
提交人 createUser String N  
提交时间 createTime String N  
审核人Id auditUserId String N  
审核人 auditUser String N  
审核时间 auditTime String N  
配送原料 transferDetailVoList List<TransferDetailVo> N  
单据金额 totalAmount BigDecimal N 0.00

TransferDetailVo

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
采购单号 transferNo String N  
原料Id goodsId String N  
原料名称 goodsName String N  
条形码 standardBarCode String N  
数量单位ID numUnitId String N  
数量单位名称 numUnitName String N  
计价单位ID priceUnitId String N  
计价单位名称 priceUnitName String N  
单价 goodsPrice BigDecimal N 0.00
数量 goodsNum BigDecimal N 0.00
金额 totalAmount BigDecimal N 0.00

返回参数 实例:

{
        "success": true,

        "model": [
                {
                        "entityId": "NR1",

                        "entityName": "牛肉连锁直营门店",

                        "warehouseId": "9992891057d0c4340157d0c434ab0000",

                        "transferNo": "PS20161026000002",

                        "transferFee": "5000",

                        "predictDate": "20161026",

                        "status": "3",

                        "createUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "createUser": "超级管理员",

                        "createTime": "1477461371",

                        "auditUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "auditUser": "超级管理员",

                        "auditTime": "1477461447",

                        "totalAmount": 43000,

                        "transferDetailVoList": [
                                {
                                        "entityId": "NR1",

                                        "transferNo": "PS20161026000002",

                                        "goodsId": "9992891057fa68d70157fac233cb01c1",

                                        "goodsName": "香菜",

                                        "numUnitId": "unitbase000000000000000000000019",

                                        "numUnitName": "把",

                                        "priceUnitId": "unitbase000000000000000000000019",

                                        "priceUnitName": "把",

                                        "goodsPrice": 1500,

                                        "goodsNum": 10,

                                        "totalAmount": 15000

                                },
                                {
                                        "entityId": "NR1",

                                        "transferNo": "PS20161026000002",

                                        "goodsId": "9992891057fa68d70157fabffcee01b1",

                                        "goodsName": "鱿鱼",

                                        "numUnitId": "unitbase000000000000000000000007",

                                        "numUnitName": "斤",

                                        "priceUnitId": "unitbase000000000000000000000007",

                                        "priceUnitName": "斤",

                                        "goodsPrice": 2800,

                                        "goodsNum": 10,

                                        "totalAmount": 28000
                                }
                        ]
                }
        ],
        "totalRecord": 0
}

5、查询店铺入库单信息列表

method="dfire.shop.storage.list"

传递参数为:

字段说明 字段名 类型 可空(Y/N) 举例
店铺Id entityId String N  
单号 no String Y  
仓库Id warehouseId String Y  
状态 status Integer Y  
入库日期 date String Y  
开始时间 startTime Long N  
结束时间 endTime Long N  

传递form表单参数实例:

appKey:cdc08577b61942442aa89390dacb25ad
timestamp:1476255107097
sign:DF0719FCD2B0CE188307595BB39F5DE9488DD57E
v:1.0
method:dfire.shop.transfer.list
entityId:NRZB
no:
warehouseId:
status:
date:
startTime:1477324800
endTime:1477463943

返回参数为:

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
门店名称 entityName String N  
入库单号 storageNo String N  
供应商名称 supplierName String N  
供应商编号 supplierCode String N  
入库仓库Id warehouseId String N  
入库仓库 warehouseName String N  
入库日期 storageDate String N  
备注 memo String Y  
提交人Id createUserId String N  
提交人 createUser String N  
提交时间 createTime String N  
审核人Id auditUserId String N  
审核人 auditUser String N  
审核时间 auditTime String N  
入库原料 storageDetailVoList List<StorageDetailVo> N  
单据金额 totalAmount BigDecimal N 0.00

StorageDetailVo

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
入库单号 storageNo String N  
原料Id goodsId String N  
原料名称 goodsName String N  
条形码 standardBarCode String N  
主入货仓库Id warehouseId String N  
主入货仓库 warehouseName String N  
生产日期 productionDate String N  
数量单位ID numUnitId String N  
数量单位名称 numUnitName String N  
计价单位ID priceUnitId String N  
计价单位名称 priceUnitName String N  
单价 goodsPrice BigDecimal N 0.00
数量 goodsNum BigDecimal N 0.00
金额 totalAmount BigDecimal N 0.00

返回参数 实例:

{
        "success": true,

        "model": [
                {

                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "warehouseName": "总部第一收货库",

                        "warehouseId": "9992891057d0c4340157d0c46d6e0001",

                        "supplierName": "三哥海产店",

                        "supplierCode": "9992891057dc47600157dc53ebe1000f",

                        "storageNo": "RK20161025000006",

                        "storageDate": "20161025",

                        "status": "3",

                        "createUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "createUser": "超级管理员",

                        "createTime": "1477393962",

                        "auditUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "auditUser": "超级管理员",

                        "auditTime": "1477394020",

                        "totalAmount": 200000,

                        "storageDetailVoList": [
                                {
                                        "entityId": "NRZB",

                                        "storageNo": "RK20161025000006",

                                        "warehouseId": "9992891057d0c4340157d0c46d6e0001",

                                        "productionDate": "0",

                                        "goodsId": "9992891057fa68d70157fabffcee01b1",

                                        "goodsName": "鱿鱼",

                                        "standardBarCode": "00001",

                                        "numUnitId": "unitbase000000000000000000000007",

                                        "numUnitName": "斤",

                                        "priceUnitId": "unitbase000000000000000000000007",

                                        "priceUnitName": "斤",

                                        "goodsPrice": 2000,

                                        "goodsNum": 100,

                                        "totalAmount": 200000
                                }
                        ]
                },
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "warehouseName": "总部第一收货库",

                        "warehouseId": "9992891057d0c4340157d0c46d6e0001",

                        "supplierName": "阿俊农家菜",

                        "supplierCode": "9992891057dc47600157dc5090da0004",

                        "storageNo": "RK20161026000001",

                        "storageDate": "20161025",

                        "status": "3",

                        "createUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "createUser": "超级管理员",

                        "createTime": "1477450430",

                        "auditUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "auditUser": "超级管理员",

                        "auditTime": "1477450487",

                        "totalAmount": 50000,

                        "storageDetailVoList": [
                                {
                                        "entityId": "NRZB",

                                        "storageNo": "RK20161026000001",

                                        "warehouseId": "9992891057d0c4340157d0c46d6e0001",

                                        "productionDate": "0",

                                        "goodsId": "9992891057fa68d70157fac233cb01c1",

                                        "goodsName": "香菜",

                                        "standardBarCode": "00002",

                                        "numUnitId": "unitbase000000000000000000000019",

                                        "numUnitName": "把",

                                        "priceUnitId": "unitbase000000000000000000000019",

                                        "priceUnitName": "把",

                                        "goodsPrice": 1000,

                                        "goodsNum": 50,

                                        "totalAmount": 50000
                                }
                        ]
                }
        ],
        "totalRecord": 0
}

6、查询店铺退货单信息列表

method="dfire.shop.refund.list"

传递参数为:

字段说明 字段名 类型 可空(Y/N) 举例
店铺Id entityId String N  
单号 no String Y  
仓库Id warehouseId String Y  
状态 status Integer Y  
退货日期 date String Y  
开始时间 startTime Long N  
结束时间 endTime Long N  

传递form表单参数实例:

appKey:cdc08577b61942442aa89390dacb25ad
timestamp:1476255107097
sign:DF0719FCD2B0CE188307595BB39F5DE9488DD57E
v:1.0
method:dfire.shop.refund.list
entityId:NR1
no:
warehouseId:
status:
date:
startTime:1477324800
endTime:1477464577

返回参数为:

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
门店名称 entityName String N  
退货单号 refundNo String N  
状态 status String N  
供应商名称 supplierName String N  
供应商编号 supplierCode String N  
退货仓库Id fromWarehouseId String N  
退货仓库 fromWarehouseName String N  
退货日期 refundDate String N  
退货接收仓库Id toWarehouseId String N  
退货接收仓库 toWarehouseName String N  
备注 memo String Y  
提交人Id createUserId String N  
提交人 createUser String N  
提交时间 createTime String N  
审核人Id auditUserId String N  
审核人 auditUser String N  
审核时间 auditTime String N  
退货原料 refundDetailVoList List<RefundDetailVo> N  
单据金额 totalAmount BigDecimal N 0.00

RefundDetailVo

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
退货单号 refundNo String N  
原料Id goodsId String N  
原料名称 goodsName String N  
条形码 standardBarCode String N  
主退货接收仓库Id warehouseId String N  
主退货接收仓库 warehouseName String N  
退货原因 refundReason String N  
数量单位ID numUnitId String N  
数量单位名称 numUnitName String N  
计价单位ID priceUnitId String N  
计价单位名称 priceUnitName String N  
单价 goodsPrice BigDecimal N 0.00
数量 goodsNum BigDecimal N 0.00
金额 totalAmount BigDecimal N 0.00

返回参数 实例:

{
        "success": true,

        "model": [
                {
                        "entityId": "NR1",

                        "entityName": "牛肉连锁直营门店",

                        "fromWarehouseName": "一门店仓库",

                        "fromWarehouseId": "9992891157d0c4340157d14898d623fa",

                        "toWarehouseId": "9992891057d0c4340157d0c46d6e0001",

                        "toWarehouseName": "总部第一收货库",

                        "supplierCode": "0",

                        "refundNo": "TH20161026000003",

                        "refundDate": "20161026",

                        "status": "5",

                        "memo": "部分不新鲜。",

                        "createUserId": "999289115742265501575f5f927b0003",

                        "createUser": "超级管理员",

                        "createTime": "1477464474",

                        "auditUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "auditUser": "超级管理员",

                        "auditTime": "1477464589",

                        "refundDetailVoList": [
                                {

                                        "entityId": "NR1",

                                        "refundNo": "TH20161026000003",

                                        "warehouseName": "总部第一收货库",

                                        "warehouseId": "9992891057d0c4340157d0c46d6e0001",

                                        "goodsId": "9992891057fa68d70157fac233cb01c1",

                                        "goodsName": "香菜",

                                        "standardBarCode": "00002",

                                        "numUnitId": "unitbase000000000000000000000019",

                                        "numUnitName": "把",

                                        "priceUnitId": "unitbase000000000000000000000019",

                                        "priceUnitName": "把",

                                        "goodsPrice": 1500,

                                        "goodsNum": 5,

                                        "totalAmount": 7500
                                },
                                {
                                        "entityId": "NR1",

                                        "refundNo": "TH20161026000003",

                                        "warehouseName": "总部第一收货库",

                                        "warehouseId": "9992891057d0c4340157d0c46d6e0001",

                                        "goodsId": "9992891057fa68d70157fabffcee01b1",

                                        "goodsName": "鱿鱼",

                                        "standardBarCode": "00001",

                                        "numUnitId": "unitbase000000000000000000000007",

                                        "numUnitName": "斤",

                                        "priceUnitId": "unitbase000000000000000000000007",

                                        "priceUnitName": "斤",

                                        "goodsPrice": 2800,

                                        "goodsNum": 5,

                                        "totalAmount": 14000
                                }
                        ],
                        "totalAmount": 21500
                }
        ],
        "totalRecord": 0
}

7、查询店铺仓库间调拨单列表

method="dfire.shop.warehouse.allocation.list"

传递参数为:

字段说明 字段名 类型 可空(Y/N) 举例
店铺Id entityId String N  
单号 no String Y  
调出仓库Id fromWarehouseId String Y  
调出仓库Id toWarehouseId String Y  
状态 status Integer Y  
调拨日期 date String Y  
开始时间 startTime Long N  
结束时间 endTime Long N  

传递form表单参数实例:

appKey:cdc08577b61942442aa89390dacb25ad
timestamp:1476255107097
sign:DF0719FCD2B0CE188307595BB39F5DE9488DD57E
v:1.0
method:dfire.shop.warehouse.allocation.list
entityId:NRZB
no:
fromWarehouseId:
 
toWarehouseId:
status:
date:
startTime:1477324800
endTime:1477464944

返回参数为:

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
门店名称 entityName String N  
调拨单号 warehouseAllocationNo String N  
状态 status String N

1:未提交

2:调拨中

3:已完成

4:已拒绝

调出仓库Id fromWarehouseId String N  
调出仓库 fromWarehouseName String N  
调入仓库Id toWarehouseId String N  
调入仓库 toWarehouseName String N  
调拨日期 allocationDate String N  
调拨时间 allocationTime String N  
提交人Id createUserId String N  
提交人 createUser String N  
提交时间 createTime String N  
审核人Id auditUserId String N  
审核人 auditUser String N  
审核时间 auditTime String N  
备注 memo String Y  
调拨原料 warehouseAllocationDetailVoList List<WarehouseAllocationDetailVo> N  
单据金额 totalAmount BigDecimal N  

WarehouseAllocationDetailVo

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
调拨单号 warehouseAllocationNo String N  
原料Id goodsId String N  
原料名称 goodsName String N  
条形码 standardBarCode String N  
数量单位ID numUnitId String N  
数量单位名称 numUnitName String N  
计价单位ID priceUnitId String N  
计价单位名称 priceUnitName String N  
单价 goodsPrice BigDecimal N 0.00
数量 goodsNum BigDecimal N 0.00
单据金额 totalAmount BigDecimal N 0.00

返回参数 实例:

{
        "success": true,

        "model": [
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "fromWarehouseName": "总部第一收货库",

                        "fromWarehouseId": "9992891057d0c4340157d0c46d6e0001",

                        "toWarehouseId": "9992891057d0c4340157d0c434ab0000",

                        "toWarehouseName": "总部第一发货库",

                        "warehouseAllocationNo": "CK20161026000004",

                        "allocationDate": "20161026",

                        "status": "3",

                        "createUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "createUser": "超级管理员",

                        "createTime": "1477464870",

                        "auditUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "auditUser": "超级管理员",

                        "auditTime": "1477464914",

                        "totalAmount": 45000,

                        "warehouseAllocationDetailVoList": [
                                {
                                        "entityId": "NRZB",

                                        "warehouseAllocationNo": "CK20161026000004",

                                        "goodsId": "9992891057fa68d70157fac233cb01c1",

                                        "goodsName": "香菜",

                                        "standardBarCode": "00002",

                                        "numUnitId": "unitbase000000000000000000000019",

                                        "numUnitName": "把",

                                        "priceUnitId": "unitbase000000000000000000000019",

                                        "priceUnitName": "把",

                                        "goodsPrice": 1000,

                                        "goodsNum": 5,

                                        "totalAmount": 5000
                                },
                                {
                                        "entityId": "NRZB",

                                        "warehouseAllocationNo": "CK20161026000004",

                                        "goodsId": "9992891057fa68d70157fabffcee01b1",

                                        "goodsName": "鱿鱼",

                                        "standardBarCode": "00001",

                                        "numUnitId": "unitbase000000000000000000000007",

                                        "numUnitName": "斤",

                                        "priceUnitId": "unitbase000000000000000000000007",

                                        "priceUnitName": "斤",

                                        "goodsPrice": 2000,

                                        "goodsNum": 20,

                                        "totalAmount": 40000
                                }
                        ]
                }
        ],
        "totalRecord": 0
}

8、查询店铺库存调整单列表

method="dfire.shop.stock.adjust.list"

传递参数为:

字段说明 字段名 类型 可空(Y/N) 举例
店铺Id entityId String N  
单号 no String Y  
仓库Id warehouseId String Y  
状态 status Integer Y  
调整日期 date String Y  
开始时间 startTime Long N  
结束时间 endTime Long N  

传递form表单参数实例:

appKey:cdc08577b61942442aa89390dacb25ad
timestamp:1476255107097
sign:DF0719FCD2B0CE188307595BB39F5DE9488DD57E
v:1.0
method:dfire.shop.stock.adjust.list
entityId:NRZB
no:
warehouseId:
status:
date:
startTime:1477324800
endTime:1477465204

返回参数为:

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
门店名称 entityName String N  
调整单号 stockAdjustNo String N  
状态 status String N

1: 未提交;

2: 已调整

调整仓库Id warehouseId String N  
调整仓库 warehouseName String N  
调整日期 stockAdjustDate String N  
调整时间 stockAdjustTime String N  
备注 memo String Y  
提交人Id createUserId String N  
提交人 createUser String N  
提交时间 createTime String N  
审核人Id auditUserId String N  
审核人 auditUser String N  
审核时间 auditTime String N  
调整原料 stockAdjustDetailVoList List<StockAdjustDetailVo> N  
单据金额 totalAmount BigDecimal N 0.00

StockAdjustDetailVo

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
调整单号 stockAdjustNo String N  
原料Id goodsId String N  
原料名称 goodsName String N  
条形码 standardBarCode String N  
数量单位ID numUnitId String N  
数量单位名称 numUnitName String N  
计价单位ID priceUnitId String N  
计价单位名称 priceUnitName String N  
单价 goodsPrice BigDecimal N 0.00
帐面数量 oldStockNum BigDecimal N 0.00
调整数量 adjustNum BigDecimal N 0.00
调整后数量 goodsNum BigDecimal N 0.00
调整原因 reason String N  
金额 totalAmount BigDecimal N 0.00

返回参数 实例:

{
        "success": true,

        "model": [
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "warehouseName": "总部第一收货库",

                        "warehouseId": "9992891057d0c4340157d0c46d6e0001",

                        "stockAdjustDate": "20161026",

                        "stockAdjustNo": "TZ20161026000005",

                        "status": "2",

                        "createUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "createUser": "超级管理员",

                        "createTime": "1477465298",

                        "auditUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "auditUser": "超级管理员",

                        "auditTime": "1477465370",

                        "totalAmount": -110000,

                        "stockAdjustDetailVoList": [
                                {
                                        "entityId": "NRZB",

                                        "stockAdjustNo": "TZ20161026000005",

                                        "goodsId": "9992891057fa68d70157fabffcee01b1",

                                        "goodsName": "鱿鱼",

                                        "standardBarCode": "00001",

                                        "numUnitId": "unitbase000000000000000000000009",

                                        "numUnitName": "箱",

                                        "priceUnitId": "unitbase000000000000000000000007",

                                        "priceUnitName": "斤",

                                        "goodsPrice": 2000,

                                        "oldStockNum": 1.7,

                                        "adjustNum": -1,

                                        "goodsNum": 0.7,

                                        "reason": "过期",

                                        "totalAmount": -100000
                                },
                                {
                                        "entityId": "NRZB",

                                        "stockAdjustNo": "TZ20161026000005",

                                        "goodsId": "9992891057fa68d70157fac233cb01c1",

                                        "goodsName": "香菜",

                                        "standardBarCode": "00002",

                                        "numUnitId": "unitbase000000000000000000000007",

                                        "numUnitName": "斤",

                                        "priceUnitId": "unitbase000000000000000000000019",

                                        "priceUnitName": "把",

                                        "goodsPrice": 1000,

                                        "oldStockNum": 50,

                                        "adjustNum": -10,

                                        "goodsNum": 40,

                                        "reason": "过期",

                                        "totalAmount": -10000
                                }
                        ]
                }
        ],
        "totalRecord": 0
}

9、查询店铺仓库盘存单列表

method="dfire.shop.stock.check.list"

传递参数为:

字段说明 字段名 类型 可空(Y/N) 举例
店铺Id entityId String N  
单号 no String Y  
仓库Id warehouseId String Y  
状态 status Integer Y  
调整日期 date String Y  
开始时间 startTime Long N  
结束时间 endTime Long N  

传递form表单参数实例:

appKey:cdc08577b61942442aa89390dacb25ad
timestamp:1476255107097
sign:DF0719FCD2B0CE188307595BB39F5DE9488DD57E
v:1.0
method:dfire.shop.stock.check.list
entityId:NRZB
no:
warehouseId:
status:
date:
startTime:1477324800
endTime:1477465204

返回参数为:

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
门店名称 entityName String N  
盘点单号 stockCheckNo String N  
状态 status String N

1:盘存中;

2:已盘存

盘存仓库Id warehouseId String N  
盘存仓库 warehouseName String N  
盘点日期 checkDate String N  
盘点时间 checkTime String N  
备注 memo String N  
提交人Id createUserId String N  
提交人 createUser String N  
提交时间 createTime String N  
审核人Id auditUserId String N  
审核人 auditUser String N  
审核时间 auditTime String N  
盘点原料 stockAdjustDetailVoList List<StockAdjustDetailVo> N  
单据金额 totalAmount BigDecimal N 0.00

StockAdjustDetailVo

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
盘点单号 stockCheckNo String N  
原料Id goodsId String N  
原料名称 goodsName String N  
条形码 standardBarCode String N  
数量单位ID numUnitId String N  
数量单位名称 numUnitName String N  
计价单位ID priceUnitId String N  
计价单位名称 priceUnitName String N  
单价 goodsPrice BigDecimal N 0.00
帐面数量 oldStockNum BigDecimal N 0.00
实际数量 realStockNum BigDecimal N 0.00
差异数量 diffStockNum BigDecimal N 0.00
差异金额 diffAmount BigDecimal N 0.00
金额 totalAmount BigDecimal N 0.00

返回参数 实例:

{
        "success": true,

        "model": [
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "stockCheckNo": "PD20161026000006",

                        "status": "2",

                        "warehouseId": "9992891057d0c4340157d0c46d6e0001",

                        "warehouseName": "总部第一收货库",

                        "checkDate": "20161026",

                        "createUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "createUser": "超级管理员",

                        "createTime": "1477465790",

                        "auditUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "auditUser": "超级管理员",

                        "auditTime": "1477465843",

                        "totalAmount": 110000,

                        "stockCheckDetailVoList": [
                                {
                                        "entityId": "NRZB",

                                        "stockCheckNo": "PD20161026000006",

                                        "goodsId": "9992891057fa68d70157fabffcee01b1",

                                        "goodsName": "鱿鱼",

                                        "standardBarCode": "00001",

                                        "numUnitId": "unitbase000000000000000000000009",

                                        "numUnitName": "箱",

                                        "priceUnitId": "unitbase000000000000000000000007",

                                        "priceUnitName": "斤",

                                        "goodsPrice": 2000,

                                        "oldStockNum": 0.7,

                                        "realStockNum": 0.7,

                                        "diffStockNum": 0,

                                        "diffAmount": 0,

                                        "totalAmount": 70000
                                },
                                {
                                        "entityId": "NRZB",

                                        "stockCheckNo": "PD20161026000006",

                                        "goodsId": "9992891057fa68d70157fac233cb01c1",

                                        "goodsName": "香菜",

                                        "standardBarCode": "00002",

                                        "numUnitId": "unitbase000000000000000000000007",

                                        "numUnitName": "斤",

                                        "priceUnitId": "unitbase000000000000000000000019",

                                        "priceUnitName": "把",

                                        "goodsPrice": 1000,

                                        "oldStockNum": 40,

                                        "realStockNum": 40,

                                        "diffStockNum": 0,

                                        "diffAmount": 0,

                                        "totalAmount": 40000
                                }
                        ]
                }
        ],
        "totalRecord": 0
}

10、查询店铺加工单列表

method="dfire.shop.process.list"

传递参数为:

字段说明 字段名 类型 可空(Y/N) 举例
店铺Id entityId String N  
单号 no String Y  
状态 status Integer Y  
加工日期 date String Y  
开始时间 startTime Long N  
结束时间 endTime Long N  

传递form表单参数实例:

appKey:cdc08577b61942442aa89390dacb25ad
timestamp:1476255107097
sign:DF0719FCD2B0CE188307595BB39F5DE9488DD57E
v:1.0
method:dfire.shop.process.list
entityId:NRZB
no:
status:
date:
startTime:1477324800
endTime:1477466606

返回参数为:

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
门店名称 entityName String N  
加工单号 processNo String N  
状态 status String N

1:未提交;

2:加工中;

3:加工完成

原料出库仓库Id fromWarehouseId String N  
原料出库仓库 fromWarehouseName String N  
半成品入库仓库Id toWarehouseId String N  
半成品入库仓库 toWarehouseName String N  
盘点日期 processDate String N  
备注 memo String Y  
加工原料 processDetailVoList List<ProcessDetailVo> N  
扩展字段 extendFields String N  
金额 totalAmount BigDecimal N  
提交人Id createUserId String N  
提交人 createUser String N  
提交时间 createTime String N  
审核人Id auditUserId String N  
审核人 auditUser String N  
审核时间 auditTime String N  

ProcessDetailVo

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
加工单号 processNo String N  
原料Id goodsId String N  
原料名称 goodsName String N  
条形码 standardBarCode String N  
数量单位ID numUnitId String N  
数量单位名称 numUnitName String N  
计价单位ID priceUnitId String N  
计价单位名称 priceUnitName String N  
单价 goodsPrice BigDecimal N 0.00
数量 goodsNum BigDecimal N 0.00
计价单位换算值 priceConversion BigDecimal N 0.00
选择单位换算值 unitConversion BigDecimal N 0.00
扩展字段 extendFields String N  
操作人Id opUserId String N  
操作人 opUser String N  
操作时间 opTime String N  
金额 totalAmount BigDecimal N 0.00

返回参数 实例:

{
        "success": true,

        "model": [
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "processNo": "JG20161026000001",

                        "status": "3",

                        "processDate": "20161026",

                        "opTime": "1477466572",

                        "fromWarehouseId": "9992891057d0c4340157d0c46d6e0001",

                        "fromWarehouseName": "总部第一收货库",

                        "toWarehouseId": "9992891057d0c4340157d0c434ab0000",

                        "toWarehouseName": "总部第一发货库",

                        "createUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "createUser": "超级管理员",

                        "createTime": "1477466089",

                        "auditUserId": "e84e686ee3004056a02f12a8753ddcfc",

                        "auditUser": "超级管理员",

                        "auditTime": "1477466572",

                        "processDetailVoList": [
                                {
                                        "entityId": "NRZB",

                                        "processNo": "JG20161026000001",

                                        "goodsId": "9992891057fa68d70157fabffcee01b1",

                                        "goodsName": "鱿鱼",

                                        "standardBarCode": "00001",

                                        "numUnitId": "unitbase000000000000000000000007",

                                        "numUnitName": "斤",

                                        "priceUnitId": "unitbase000000000000000000000007",

                                        "priceUnitName": "斤",

                                        "goodsPrice": 2000,

                                        "goodsNum": 1,

                                        "unitConversion": 1,

                                        "totalAmount": 2000

                                },
                                {
                                        "entityId": "NRZB",

                                        "processNo": "JG20161026000001",

                                        "goodsId": "9992891057fa68d70157fac233cb01c1",

                                        "goodsName": "香菜",

                                        "standardBarCode": "00002",

                                        "numUnitId": "unitbase000000000000000000000007",

                                        "numUnitName": "斤",

                                        "priceUnitId": "unitbase000000000000000000000019",

                                        "priceUnitName": "把",

                                        "goodsPrice": 1000,

                                        "goodsNum": 0.1,

                                        "unitConversion": 1,

                                        "totalAmount": 100
                                },
                                {
                                        "entityId": "NRZB",

                                        "processNo": "JG20161026000001",

                                        "goodsId": "9992891057ffb5ce0157ffdd027600e7",

                                        "goodsName": "腌制香菜鱿鱼",

                                        "standardBarCode": "2000000000015",

                                        "numUnitId": "unitbase000000000000000000000007",

                                        "numUnitName": "斤",

                                        "priceUnitId": "unitbase000000000000000000000007",

                                        "priceUnitName": "斤",

                                        "goodsPrice": 0,

                                        "goodsNum": 1.1,

                                        "unitConversion": 1,

                                        "totalAmount": 0
                                }
                        ],
                        "totalAmount": 2100
                }
        ],
        "totalRecord": 0
}

11、查询店铺库存列表

method="dfire.shop.stock.list"

传递参数为:

字段说明 字段名 类型 可空(Y/N) 举例
店铺Id entityId String N  
原料Id goodsId String Y  
仓库Id warehouseId String Y  

传递form表单参数实例:

appKey:cdc08577b61942442aa89390dacb25ad
timestamp:1476255107097
sign:DF0719FCD2B0CE188307595BB39F5DE9488DD57E
v:1.0
method:dfire.shop.stock.list
entityId:NRZB
warehouseId:
goodsId:

返回参数为:

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
门店名称 entityName String N  
仓库Id warehouseId String N  
仓库名称 warehouseName String N  
查询时间 opTime String N  
原料Id goodsId String N  
原料名称 goodsName String N  
库存数量 stockNum String N  

返回参数 实例:

{
        "success": true,

        "model": [
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "selfEntityId": "NRZB",

                        "shopName": "牛肉连锁总部",

                        "warehouseId": "9992891057d0c4340157d0c434ab0000",

                        "warehouseName": "总部第一发货库",

                        "opTime": "1477464914",

                        "goodsId": "9992891057fa68d70157fabffcee01b1",

                        "goodsName": "鱿鱼",

                        "stockNum": "10.000000"
                },
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "selfEntityId": "NRZB",

                        "shopName": "牛肉连锁总部",

                        "warehouseId": "9992891057d0c4340157d0c434ab0000",

                        "warehouseName": "总部第一发货库",

                        "opTime": "1477464914",

                        "goodsId": "9992891057fa68d70157fac233cb01c1",

                        "goodsName": "香菜",

                        "stockNum": "-5.000000"
                },
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "selfEntityId": "NRZB",

                        "shopName": "牛肉连锁总部",

                        "warehouseId": "9992891057d0c4340157d0c46d6e0001",

                        "warehouseName": "总部第一收货库",

                        "opTime": "1477466539",

                        "goodsId": "9992891057fa68d70157fac233cb01c1",

                        "goodsName": "香菜",

                        "stockNum": "39.900000"
                },
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "selfEntityId": "NRZB",

                        "shopName": "牛肉连锁总部",

                        "warehouseId": "9992891057d0c4340157d0c46d6e0001",

                        "warehouseName": "总部第一收货库",

                        "opTime": "1477466539",

                        "goodsId": "9992891057fa68d70157fabffcee01b1",

                        "goodsName": "鱿鱼",

                        "stockNum": "34.000000"
                },
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "selfEntityId": "NRZB",

                        "shopName": "牛肉连锁总部",

                        "warehouseId": "9992891057d0c4340157d0c434ab0000",

                        "warehouseName": "总部第一发货库",

                        "opTime": "1477466572",

                        "goodsId": "9992891057ffb5ce0157ffdd027600e7",

                        "goodsName": "腌制香菜鱿鱼",

                        "stockNum": "1.100000"
                }
        ],
        "totalRecord": 0
}

12、查询店铺仓库列表

method="dfire.shop.warehouse.list"

传递参数为:

字段说明 字段名 类型 可空(Y/N) 举例
店铺Id entityId String N  
仓库Id warehouseId String Y  

传递form表单参数实例:

appKey:cdc08577b61942442aa89390dacb25ad
timestamp:1476255107097
sign:DF0719FCD2B0CE188307595BB39F5DE9488DD57E
v:1.0
method:dfire.shop.warehouse.list
entityId:NRZB
warehouseId:

返回参数为:

字段说明 字段名 类型 可空(Y/N) 默认值
所属门店 entityId String N  
门店名称 entityName String N  
仓库Id warehouseId String N  
仓库名称 warehouseName String N  
是否有效 isValid Integer N

0:无效;

1:有效

返回参数 实例:

{
        "success": true,

        "model": [
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "warehouseId": "9992891057d0c4340157d0c434ab0000",

                        "warehouseName": "总部第一发货库",

                        "isOutput": 1,

                        "isInput": 0
                },
                {
                        "entityId": "NRZB",

                        "entityName": "牛肉连锁总部",

                        "warehouseId": "9992891057d0c4340157d0c46d6e0001",

                        "warehouseName": "总部第一收货库",

                        "isOutput": 0,

                        "isInput": 1
                }
        ],
        "totalRecord": 0
}

13、POS销售订单提交

method="dfire.pos.sale.order.submit"

传递参数为:

字段说明 字段名 类型 可空(Y/N) 举例
POS销售订单对象 posSaleOrderBo PosSaleOrderBo Y  
[PosSaleOrderBo]POS销售订单结构

传递参数:

字段说明 字段名 类型 可空(Y/N) 举例
设备ID,SN号 snNo String Y  
设备出厂公司 deviceCompanyName String Y 比如:商米;新大陆;荣焱;
设备型号 deviceVersion String Y  
设备类型 deviceType byte Y 1-手持, 2-标准, 3-高端, 4-旗舰
设备对应的软件方公司名称 deviceSoftwareName String Y 二维火
设备激活时间 gmtActivate long Y  
设备出厂时间 gmtProduction long Y  
设备解绑时间 gmtUnbundling long N  
设备MAC地址 deviceMac String Y  
设备IP值 deviceIp String Y  
最后登录时间 gmtLogin long Y  
最后发送信息时间 gmtSend long Y  
最后更新时间 gmtUpdate long Y  
设备运行的操作系统版本 deviceOsVersion String Y  
设备安装的应用数 deviceAppCnt int Y  
设备安装的应用列表 deviceAppList List<String> Y  
设备总使用流量 deviceFlow int Y  
设备安装的应用列表对应的流量 deviceAppFlow int Y  
设备状态值 deviceStatus int Y 1-已出厂,2-已入仓,3-已出售,4-已报单,5-已发货,6-已收货,7-已激活、8-已绑定、9-运行中、10-设备失联、11-已解绑
二维火的店铺id entityId String Y  

传递form表单参数实例:

appKey:cdc08577b61942442aa89390dacb25ad
timestamp:1476255107097
sign:DF0719FCD2B0CE188307595BB39F5DE9488DD57E
v:1.0
method:dfire.pos.sale.order.submit
posSaleOrderBo:{"deviceAppCnt":3,"deviceAppFlow":100,"deviceAppList":["掌柜","收银"],"deviceCompanyName":"荣焱","deviceFlow":1000,"deviceIp":"10.1.125.10","deviceMac":"2001:0:dacd:399a:141c:1930:f5fe:a85f","deviceOsVersion":"1.0","deviceSoftwareName":"二维火","deviceStatus":7,"deviceType":1,"deviceVersion":"荣焱P10S","entityId":"99927909","gmtActivate":1524109126085,"gmtLogin":1524109126085,"gmtProduction":1524109126085,"gmtSend":1524109126085,"gmtUnbundling":1524109126085,"gmtUpdate":1524109126085,"snNo":"10000001"}

返回参数 实例:

{
        "success": true,
        "model": [],
        "totalRecord": 0
}