达人店后台接口-代发管理

1,代发商品获取

request

method: GET  
url: /shop/v1/supplier/product/search?keyword=test&page=1&pageSize=10  
&supplierId=12&supplierName=test

参数说明

参数名 类型 必填 描述

keyword

string

搜索关键字

supplierId

string

供应商id

supplierName

string

供应商名

page

string

页数

pageSize

string

每页的数量

response

body:{  
  'code': 1,
  'message': 'success',
  'pageCount': 1,
  'pageCurrent': 1,
  'data': [{
      "skuId": 55673,
      "spuId": 66287,
      "name": "雅诗兰黛 净莹柔肤洁面乳(2支装) 60ml",
      "brandName": "雅诗兰黛",
      "supplierId": 1,
      "inventory": 35,
      "supplierName": "农夫山泉",
      "status": true
  },...],
  'isRedirect': 0,
  'redirect': 'url',
  'login': 0
}

可能出现的状态码及描述

code message

1

success

1000

系统内部错误

1100

请求参数确实或格式不正确

2,添加供货商

request

method: POST  
url: /shop/v1/supplier/add

body = {  
    name: 'test',
    supplyPlace: 'test',
    chargePerson: 'test',
    remark: 'test',
        isNeedIdCard: 0
}

参数说明

参数名 类型 必填 描述

name

string

发货商名

supplyPlace

string

发货地

chargePerson

string

负责人

remark

string

备注

isNeedIdCard

int

是否需要身份验证

response

body:{  
  'code': 1,
  'message': 'success',
  'pageCount': 1,
  'pageCurrent': 1,
  'data': null,
  'isRedirect': 0,
  'redirect': 'url',
  'login': 0
}

可能出现的状态码及描述

code message

1

success

1000

系统内部错误

1100

请求参数确实或格式不正确

3,修改供货商

request

method: POST  
url: /shop/v1/supplier/modify

body = {  
    supplierId: 8,
    name: 'test',
    supplyPlace: 'test',
    chargePerson: 'test',
    remark: 'test',
        isNeedIdCard: 0
}

参数说明

参数名 类型 必填 描述

supplierId

number

供货商ID

name

string

发货商名

supplyPlace

string

发货地

chargePerson

string

负责人

remark

string

备注

isNeedIdCard

int

是否需要身份验证

response

body:{  
  'code': 1,
  'message': 'success',
  'pageCount': 1,
  'pageCurrent': 1,
  'data': null,
  'isRedirect': 0,
  'redirect': 'url',
  'login': 0
}

可能出现的状态码及描述

code message

1

success

1000

系统内部错误

1100

请求参数确实或格式不正确

8000

供货商不存在

4,获取供货商

request

method: GET  
url: /shop/v1/supplier/get?name=test&supplierId=123&page=1&pageSize=10  

参数说明

参数名 类型 必填 描述

name

string

发货商名

supplierId

string

发货商ID

page

string

页数

pageSize

string

每页的数量

response

body:{  
  'code': 1,
  'message': 'success',
  'pageCount': 1,
  'pageCurrent': 1,
  'data': [
    {
      "id": 1,
      "name": "农夫山泉",
      "supplyPlace": "杭州千岛湖",
      "chargePerson": "米奇",
      "remark": "nice",
      "isNeedIdCard": 0,
      "skuNum": 4
    },...
  ],
  'isRedirect': 0,
  'redirect': 'url',
  'login': 0
}

可能出现的状态码及描述

code message

1

success

1000

系统内部错误

1100

请求参数确实或格式不正确

5,代发订单信息获取

request

method: GET  
url: /shop/v1/branch-order/search?skuId=123&itemName=name&orderNumber=123&expressId=123&supplierId=123&status=22&gmtStartTime=time&gmtEndTime=time&buyerId=123&page=1&pageSize=10&outTradeNo=123

参数说明

参数名 类型 必填 描述

skuId

string

商品skuId

itemName

string

商品名

orderNumber

string

订单ID

expressId

string

物流单号

supplierId

string

供应商ID

status

string

状态0-全部,20,交易成功,21-待支付,22-待发货,23-已发货, -2-交易关闭

gmtStartTime

string

开始时间

gmtEndTime

string

结束时间

buyerId

string

买家ID

page

string

页数

pageSize

string

每页的数据量

outTradeNo

string

支付交易号

response

body = {  
  "code": 1,
  "message": "success",
  "data": [
    {
      "orderNumber": "9147861500120876",
      "status": 22,
      "actualPrice": 171,
      "postFee": 0,
      "buyerId": 714076,
      "buyerName": "aaa",
      "payOrderId": "1532375",
      "outTradeNo": "",
      "addressDetail": "北京东城区无视测试",
      "buyerRemark": "",
      "paidTime": "2016-11-08 11:02:41",
      "createOrderTime": "2016-11-08 10:23:21",
      "preferentialInfo": "",
      "payTypeZh": "wap微信支付",
      "branchItems": [
        {
          "branchOrderNumber": "9147861500120876000",
          "itemShopRelations": [
            {
              "itemName": "安娜苏紫境魔钥女士淡香水30ml",
              "price": 1,
              "quantity": 1,
              "skuId": 8329,
              "selledShopId": 4880,
              "selledShop": "A"
            }
          ],
          "statusCode": 22,
          "supplierId": 0,
          "chargeMan": "尚妆自营"
        },
        {
          "branchOrderNumber": "9147861500120876001",
          "itemShopRelations": [
            {
              "itemName": "九朵云气垫BB霜15g",
              "price": 170,
              "quantity": 1,
              "skuId": 112772,
              "selledShopId": 4880,
              "selledShop": "A"
            }
          ],
          "expressCompany": "韵达",
          "expressNumber": "11111111111",
          "shippingTime": "2016-11-08 11:06:15",
          "statusCode": 23,
          "supplierId": 1,
          "chargeMan": "米奇"
        }
      ]
    }
  ],
  "pageCount": 451,
  "pageCurrent": "1",
  "isRedirect": 0,
  "redirect": "",
  "login": 0
}

可能出现的状态码及描述

code message

1

success

1000

系统内部错误

1100

请求参数确实或格式不正确

6000

订单不存在

6,批量关闭代发订单

request

method: POST  
url: /shop/v1/branch-order/close

{
orderNumberArr: ['123', '456']  
}

response

body = {  
  "code": 1,
  "message": "success",
  "data": null,
  "pageCount": 451,
  "pageCurrent": "1",
  "isRedirect": 0,
  "redirect": "",
  "login": 0
}

可能出现的状态码及描述

code message

1

success

1000

系统内部错误

7,获取订单物流状态

request

method: GET  
url: /shop/v1/trade/tracking-info?orderNumber=1234  

参数说明

参数名 类型 必填 描述

orderNumber

string

订单号

response

body:{  
  'code': 1,
  'message': 'success',
  'pageCount': 1,
  'pageCurrent': 1,
  'data': [
    {
    },...
  ],
  'isRedirect': 0,
  'redirect': 'url',
  'login': 0
}

可能出现的状态码及描述

code message

1

success

1000

系统内部错误

1100

请求参数确实或格式不正确

沐风

继续阅读此作者的更多文章