匡佳华 / API-Interfaces · Files

Go to a project
外采单或者调拨单相关app接口.md 8.15 KB

此文档封装了北京的接口 具体字段含义参考 http://git.yoho.cn/YOHOERP/erp-shop/wikis/%E5%A4%96%E9%87%87%E5%8D%95

1、外采单列表

外采单列表（method=app.purchase.list)

请求参数

参数名称 参数类型 可否为空 示例 备注
proRequisitionFormId int 可 1212 外采单id
productSkn int 可 1212 productSkn
sknFactoryCode string 可 1212 商家商品编号
skuFactoryCode String 可 1212 条码
startTime int 可 开始时间(页面上选择日期当日的0点)
endTime int 可 结束时间(页面上选择日期当日的24点)
shopId int 否 411 店铺ID
pageSize int 否 10 每页显示数量
pageNo int 否 1 页数
statusList List 否 [1] 状态列表(1：未处理 2：已处理 3：已入库)
isOvertime String 可 N 是否超时(Y：超时 N：否)

请求示例 http://127.0.0.1:8081/gateway?method=app.purchase.list

请求样例数据

{
    "shopId": 952,
    "pageNo": 1,
    "pageSize": 100,
    "offset": 0,
    "statusList" : [1]
}


正常返回：
{
    "alg": "SALT_MD5",
    "code": 200,
    "data": {
        "offset": 0,
        "records": [
            {
                 "productSkc": 236723, //SKC
                "brandName": "COMBACK",//品牌名
                "isOvertime": "N",//是否超时 N 未超时 Y 已超时
                "lackNum": 0, //缺货数量
                "salesPrice": 179.00, //销售价
                "purchasePrice": 175.4200, //进货价
                "skuFactoryCode": "C0274", //条码
                "proRequisitionFormId": 195518, //单号
                "productName": "combackC0274", //产品名称
                "buyingNums": 6, //外采数量
                "shipmentsNums": 0, //发货数量
                "inStoreNum": 0, //入库数量
                "productSku": 772115, //SKU
                "sizeName": "F", //尺码名
                "createTime": 1493350862, //创建时间
                "predictArrivalTime": 1493610038, //预计到货时间
                "purchaseDiscount": 0.9800, //进货折扣
                "sknFactoryCode": "", //厂家编号
                "id": 3500983,
                "productSkn": 51116043, 
                "retailPrice": 360.00, //吊牌价
                "shipmentTime": 0, //发货时间
                "factoryGoodsName":"白色", //厂家颜色
                "originalPurchasePrice": 0.0000,
                "status": 1 //状态 1 未处理 2 已处理 3 已完成 4 已取消
            },
            {
                "productSkc": 305239,
                "brandName": "Into The Rainbow",
                "isOvertime": "N",
                "lackNum": 0,
                "salesPrice": 162.00,
                "purchasePrice": 158.7600,
                "skuFactoryCode": "ITRGA601OJ-21YEX",
                "proRequisitionFormId": 195518,
                "productName": "Into The Rainbow 冲锋衣 ITRGA601OJ-21",
                "buyingNums": 70,
                "shipmentsNums": 0,
                "inStoreNum": 0,
                "productSku": 962611,
                "sizeName": "M",
                "createTime": 1493350862,
                "predictArrivalTime": 1493610038,
                "purchaseDiscount": 0.9800,
                "sknFactoryCode": "",
                "id": 3501000,
                "productSkn": 51173778,
                "retailPrice": 539.00,
                "shipmentTime": 0,
"factoryGoodsName":"白色",
                "originalPurchasePrice": 0.0000,
                "status": 1
            }
                ],
        "pageNo": 1,
        "totalPage": 18,
        "pageSize": 100,
        "totalCount": 1711
    },
    "md5": "9dbd26575de72afc29b89b82e86e329c",
    "message": "SUCCESS"
}

2、外采单发货接口

外采单发货接口（method=app.purchase.delivery)

请求参数

参数名称 参数类型 可否为空 示例 备注
expressId int 否 2 物流公司id
expressNumber String 否 2212112222 物流单号
shopId int 否 2 店铺ID
expressGoodsMap map 否 key为外采单号, value为外采单发货商品明细list

外采单发货商品明细

参数名称 参数类型 可否为空 示例 备注
productSku int 否 22222 sku
num int 否 2 发货数量

注意，通用的头部没有列出。

请求示例 http://127.0.0.1:8081/gateway?method=app.purchase.delivery

请求样例数据

{
    "expressId": 23,
    "expressNumber":"ceshi-second-send",
    "shopId": 11,
    "expressGoodsMap": {
        "88254":[
            {
                "sku":934409,
                "num":13,
                "factoryCode":""
            },
            {
                "sku":934408,
                "num":13,
                "factoryCode":""
            }
        ]
    }
}


正常返回：
{
    "alg": "SALT_MD5",
    "code": 200,
    "data": [],
    "md5": "6d729d4b35f10fc73531210bd7ecff91",
    "message": "success"
}

异常返回：

{
    "alg": "SALT_MD5",
    "code": 201,
    "data": [],
    "md5": "6d729d4b35f10fc73531210bd7ecff91",
    "message": "proReqFormGoods is null, proReqFormId: null, sku: null"
}

3、物流公司列表接口

物流公司列表接口（method=app.express.getExpressList)

请求参数

无

注意，通用的头部没有列出。

请求示例 http://127.0.0.1:8081/gateway?method=app.express.getExpressList

请求样例数据


正常返回：
{
    "alg": "SALT_MD5",
    "code": 200,
    "data": [
        {
            "companyName": "EMS",
            "id": 2,
            "isDoorService": "N",
            "utl": "EMS"
        },
        {
            "companyName": "宅急送",
            "id": 5,
            "isDoorService": "N",
            "utl": "ZJS"
        }
    ],
    "md5": "eb1d1dcf8f37ca57c319930c61c251a0",
    "message": "SUCCESS"
}

4、外采单发货获取仓库信息接口

外采单发货获取仓库信息接口（method=app.purchase.queryBySupplierId)

请求参数

参数名称 参数类型 可否为空 示例 备注
supplierId int 否 2 供应商ID

注意，通用的头部没有列出。

请求示例 http://127.0.0.1:8081/gateway?method=app.purchase.queryBySupplierId

请求样例数据

{
    "supplierId":1702
}


正常返回：
{
    "alg": "SALT_MD5",
    "code": 200,
    "data": {
        "adminName": "许凯",
        "address": "南京市玄武区1号",
        "phone": "13901065166",
        "storehouseName": "南京1号仓库",
        "id": 3,
        "status": 1
    },
    "md5": "94e46f6032aba2fc6c3d81cea2cf0110",
    "message": "SUCCESS"
}

5、外采单发货-上传缺货接口接口

外采单发货-上传缺货接口接口（method=app.purchase.stockOut)

请求参数

参数名称 参数类型 可否为空 示例 备注
proReqFormId int 否 2222 请购单ID
productSku int 否 2323 SKU
num int 否 2 缺货数量

注意，通用的头部没有列出。

请求示例 http://127.0.0.1:8081/gateway?method=app.purchase.stockOut

请求样例数据

{
    "proReqFormId":123,
    "productSku":12332123,
    "num":1
}


正常返回：
{
  "alg": "SALT_MD5",
  "code": 200,
  "data": -1,
  "md5": "61eff333bcef4882a81184dafa3e027d",
  "message": "操作成功"
}

6、查询当前店铺经营模式接口

查询当前店铺经营模式接口（method=app.sellerShop.sellType)

请求参数

参数名称 参数类型 可否为空 示例 备注
shopId int 否 2222 店铺ID

注意，通用的头部没有列出。

请求示例 http://eshop.yoho.cn/?debug=XYZ&method=app.sellerShop.sellType&shopId=952

请求样例数据



正常返回：
{
    "code": 200,
    "data": [
        {
            "id": 2,
            "text": "代销"
        },
        {
            "id": 3,                // 如果有此项，则代表要出现外采单按钮
            "text": "JIT"         
        }
    ],
    "md5": "6ac76e5ec1d5318fdcd117312cf24f1c",
    "message": "查询成功."
}