“互聯網+第四方物(wù)流”供銷集配科技支撐體系數據對(duì)接标準


本規範确定了(le)“互聯網+第四方物(wù)流”供銷集配科技支撐體系數據對(duì)接标準,是供銷集配科技支撐體系信息化(huà)系統統一的(de)基礎、是各合作商對(duì)接供銷集配體系的(de)依據,是甯波百訊電子商務有限公司(以下(xià)簡稱電商公司)對(duì)社會統一開放共享的(de)前提。

本規範由甯波百訊電子商務有限公司技術部提出并歸口。

本規範由歸口部門負責解釋。

本規範起草(cǎo)單位:江西省電子商務有限公司


1、适用(yòng)範圍

适用(yòng)對(duì)象爲甯波百訊電子商務有限公司内部及合作方, 用(yòng)于在業務開展、招标選型、工程建設、運行維護、設備開發等方面提供技術參考依據

2、接口說明(míng)

本規範支持以下(xià)接口或協議(yì):http/https和(hé)數據庫接口,并可(kě)根據客戶、合作方的(de)具體需求提供相應的(de)對(duì)接方式。

3、數據接口

包含集配中心及集配中心設計到所有實體,例如車輛、司機、服務站、倉庫、客戶、供應商、産品等。以及集配中心開展業務經營情況信息,例如快(kuài)遞、快(kuài)消品、生鮮、等業務數據

正式請求地址:具體官網公布爲準

測試請求地址:具體官網公布爲準

官網地址:/

對(duì)接方式:http接口

3.1集配企業主體信息上報

接口描述

該接口用(yòng)于上報集配企業基礎信息

接口名稱:uploadCompanyInformation

請求方式:post

接口示例:參見附件一

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區(qū)id

code_id

int

360102

地區(qū)id标識的(de)是縣級運營中心所在的(de)地區(qū)(詳情請查看附件)

密鑰

key

string

Hdh#qqashdas

密鑰主要用(yòng)于上報數據接口驗證每個(gè)運營中心的(de)密鑰都是唯一的(de)

車輛數

car_num

int

20

車輛總數

倉庫面積

area_num

float

3525.3

倉庫面積

網點數

shop_num

int

222

網點數量

ip

ip

string

47.86.170.30

縣級運營中心上報數據的(de)ip地址

數據時(shí)間

create_time

date

2022-12-09

該字段是數據上報的(de)時(shí)間

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值爲1時(shí)代表成功,爲0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上報是否成功

返回信息

body

string

null

部分(fēn)接口會有返回信息

請求參數示例:

{

      "code_id": "360102",

      "key": "Hdh#qqashdas",

      "car_num": "20",

      "area_num": "3525.3",

      "shop_num": "222",

      "ip": "47.86.170.30",

      "create_time": "2022-12-09"

}

返回值示例:

{

      "code": "1",

      "msg": "正常",

      "body ": "null",

     }

3.2車輛信息上報

接口描述:該接口用(yòng)于上報集配中心車輛信息

接口名稱:uploadCarInformation

請求方式:post

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區(qū)id

code_id

int

360102

地區(qū)id标識的(de)是縣級運營中心所在的(de)地區(qū)(詳情請查看附件)

密鑰

key

string

Hdh#qqashdas

密鑰主要用(yòng)于上報數據接口驗證每個(gè)運營中心的(de)密鑰都是唯一的(de)

車牌号

car_name

int

20

車輛總數

車輛長(cháng)度(米)

car_long

float

12

倉庫面積

車載重量(噸)

shop_num

int

22

網點數量

購(gòu)買時(shí)間

buy_date

date

2022-12-09

數據時(shí)間

create_time

date

2022-12-09

該字段是數據上報的(de)時(shí)間

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值爲1時(shí)代表成功,爲0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上報是否成功

返回信息

body

string

null

部分(fēn)接口會有返回信息

請求參數示例:

{

      "code_id": "360102",

      "key": "Hdh#qqashdas",

      "car_num": "20",

      "car_long": "12",

      "shop_num": "20",

      "buy_date ": "2022-12-09",

      "create_time": "2022-12-09"

}

返回值示例:

{

      "code": "1",

      "msg": "正常",

      "body ": "null",

   }

3.3司機信息上報

接口描述:該接口用(yòng)于上報集配中心司機信息

接口名稱:uploadDriverInformation

請求方式:post

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區(qū)id

code_id

int

360102

地區(qū)id标識的(de)是縣級運營中心所在的(de)地區(qū)(詳情請查看附件)

密鑰

key

string

Hdh#qqashdas

密鑰主要用(yòng)于上報數據接口驗證每個(gè)運營中心的(de)密鑰都是唯一的(de)

司機名字

driver_name

int

王小明(míng)

司機名字

司機性别

driver_sex

float

1

1.男(nán)2女(nǚ)

從業證件

driver _certificate

int

222

上傳圖片

數據時(shí)間

create_time

date

2022-12-09

數據上報時(shí)間

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值爲1時(shí)代表成功,爲0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上報是否成功

返回信息

body

string

null

部分(fēn)接口會有返回信息

請求參數示例:

{

      "code_id": "360102",

      "key": "Hdh#qqashdas",

      "driver_name": "王小明(míng)",

      "driver_sex": "1",

      "driver _certificate ": "圖片",

      "create_time": "2022-12-09"

}

返回值示例:

{

      "code": "1",

      "msg": "正常",

      "body ": "null",

     }

3.4服務站點上報

接口描述:該接口用(yòng)于上報服務站點信息

接口名稱:uploadPartnerInformation

請求方式:post

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區(qū)id

code_id

int

360102

地區(qū)id标識的(de)是縣級運營中心所在的(de)地區(qū)(詳情請查看附件)

密鑰

key

string

Hdh#qqashdas

密鑰主要用(yòng)于上報數據接口驗證每個(gè)運營中心的(de)密鑰都是唯一的(de)

站點名稱

partner_name

int

XXX超市

提貨點、小賣鋪、服務站點、合夥人(rén)

聯系人(rén)名字

link_name

float

翟志剛

聯系人(rén)名字

聯系人(rén)電話(huà)

link_phone

int

18918882910

聯系人(rén)電話(huà)

經度

lot

float

28.32

經度

緯度

lat

float

112.23

緯度

ip

ip

string

47.86.170.30

縣級運營中心上報數據的(de)ip地址

數據時(shí)間

create_time

date

2022-12-09

該字段是數據上報的(de)時(shí)間

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值爲1時(shí)代表成功,爲0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上報是否成功

返回信息

body

string

null

部分(fēn)接口會有返回信息

請求參數示例:

{

      "code_id": "360102",

      "key": "Hdh#qqashdas",     

"partner_name": " XXX超市",

      "link_name": "翟志剛",

      "link_phone": "18918882910",

      "lot": "28.32",

"lat": "112.23",

      "ip": "47.86.170.30",

      "create_time": "2022-12-09"

}

返回值示例:

{

      "code": "1",

      "msg": "正常",

      "body ": "null",

     }

3.5素材上傳

接口描述:該接口用(yòng)于上傳素材信息、例如集配企業營業執照(zhào)、車輛行駛證、駕照(zhào)、重要文件、宣傳資料等信息

接口名稱:uploadFile

請求方式:post

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區(qū)id

code_id

int

360102

地區(qū)id标識的(de)是縣級運營中心所在的(de)地區(qū)(詳情請查看附件)

密鑰

key

string

Hdh#qqashdas

密鑰主要用(yòng)于上報數據接口驗證每個(gè)運營中心的(de)密鑰都是唯一的(de)

素材名稱

file_name

int

測試圖片

提貨點、小賣鋪、服務站點、合夥人(rén)

素材類型

file_type

int

1

1 圖片 2 視頻(pín) 3 文件

ip

ip

string

47.86.170.30

縣級運營中心上報數據的(de)ip地址

數據時(shí)間

create_time

date

2022-12-09

該字段是數據上報的(de)時(shí)間

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值爲1時(shí)代表成功,爲0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上報是否成功

返回信息

body

string

null

部分(fēn)接口會有返回信息

請求參數示例:

{

      "code_id": "360102",

      "key": "Hdh#qqashdas",

      "file_name": "測試圖片",

      "file_type": "1",

      "ip": "47.86.170.30",

      "create_time": "2022-12-09"

}

返回值示例:

{

      "code": "1",

      "msg": "正常",

      "body ": "null",

     }

3.6車輛實時(shí)坐(zuò)标

接口描述:該接口用(yòng)于實時(shí)上報車輛位置,設備開啓後間隔30s傳輸一次。

接口名稱:uploadCarPosition

請求方式:post

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區(qū)id

code_id

int

360102

地區(qū)id标識的(de)是縣級運營中心所在的(de)地區(qū)(詳情請查看附件)

密鑰

key

string

Hdh#qqashdas

密鑰主要用(yòng)于上報數據接口驗證每個(gè)運營中心的(de)密鑰都是唯一的(de)

車輛id

car_id

int

20

車輛id

車牌号

car_name

string

A23131

車牌号

經度

lot

float

28.31

經度

緯度

lat

float

116.23

緯度

ip

ip

string

47.86.170.30

縣級運營中心上報數據的(de)ip地址

數據時(shí)間

create_time

date

2022-12-09

該字段是數據上報的(de)時(shí)間

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值爲1時(shí)代表成功,爲0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上報是否成功

返回信息

body

string

null

部分(fēn)接口會有返回信息

請求參數示例:

{

      "code_id": "360102",

      "key": "Hdh#qqashdas",

      "car_id": "20",

      "car_name": "A23131",

      "lot": "28.31",   

"lat": "116.23",

      "ip": "47.86.170.30",

      "create_time": "2022-12-09"

}

返回值示例:

{

      "code": "1",

      "msg": "正常",

      "body ": "null",

     }

3.7快(kuài)遞數據接口

集配中心每日快(kuài)遞數據上報接口(每日上報一次快(kuài)遞數據)

地址:uploadLogistics

請求方式:post

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區(qū)id

code_id

int

360102

地區(qū)id标識的(de)是縣級運營中心所在的(de)地區(qū)(詳情請查看附件)

密鑰

key

string

hdhashdas

密鑰主要用(yòng)于上報數據接口驗證每個(gè)運營中心的(de)密鑰都是唯一的(de)

快(kuài)遞上行件

up_num

int

1344

快(kuài)遞上行件的(de)數量

快(kuài)遞下(xià)行件

down_num

int

222

快(kuài)遞下(xià)行件的(de)數量

日期

data_time

date

2022-12-09

快(kuài)遞數據日期一般爲當天的(de)日期

ip

ip

string

47.86.170.30

縣級運營中心上報數據的(de)ip地址

數據時(shí)間

create_time

date

2022-12-09

該字段是數據上報的(de)時(shí)間

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值爲1時(shí)代表成功,爲0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上報是否成功

返回信息

body

string

null

部分(fēn)接口會有返回信息

請求參數示例:

{

      "code_id": "360102",

      "key": "Hdh#qqashdas",

      "up_num ": "2021",

      "down_num ": "3525",

"date_time": "2022-12-09",

      "ip": "47.86.170.30",

      "create_time": "2022-12-09"

}

返回值示例:

{

      "code": "1",

      "msg": "正常",

      "body ": "null",

     }

3.8訂單數據上報接口

集配中心訂單數據上報接口(每個(gè)成功的(de)訂單上報一次數據)

地址:uploadOrder

請求方式:post

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區(qū)id

code_id

int

360102

地區(qū)id标識的(de)是縣級運營中心所在的(de)地區(qū)(詳情請查看附件)

密鑰

key

string

hdhashdas

密鑰主要用(yòng)于上報數據接口驗證每個(gè)運營中心的(de)密鑰都是唯一的(de)

訂單類型

type

int

1

标識訂單類型(1、新零售2、生鮮3、農資)

訂單總價

price

decimal

222.11

訂單總金額

日期

data_time

string

202006100909

下(xià)單日期

ip

ip

string

47.86.170.30

縣級運營中心上報數據的(de)ip地址

數據時(shí)間

create_time

date

2022-12-09

該字段是數據上報的(de)時(shí)間

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值爲1時(shí)代表成功,爲0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上報是否成功

返回信息

body

string

null

部分(fēn)接口會有返回信息

請求參數示例:

{

      "code_id": "360102",

      "key": "Hdh#qqashdas",

      "type ": "2",

      "price ": "3525.3",

      "data_time ": "2022-12-09",

      "ip": "47.86.170.30",

      "create_time": "2022-12-09"

}

返回值示例:

{

      "code": "1",

      "msg": "正常",

      "body ": "null",

     }

3.9訂單商品數據上報接口

縣級運營中心訂單數據上報接口,該接口主要根據訂單單品來(lái)上報,用(yòng)于統計每個(gè)單品的(de)銷售情況

地址:uploadOrderDetial

請求方式:post

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區(qū)id

code_id

int

360102

地區(qū)id标識的(de)是縣級運營中心所在的(de)地區(qū)(詳情請查看附件)

密鑰

key

string

hdhashdas

密鑰主要用(yòng)于上報數據接口驗證每個(gè)運營中心的(de)密鑰都是唯一的(de)

訂單類型

type

int

1

标識訂單類型(1、新零售2、生鮮3、農資)

訂單金額

price

decimal

222.11

訂單總金額

單品名稱

sku_name

string

橘子

商品名稱

單品id

sku_id

int

00001

商品規格id

日期

data_time

date

202006100909

下(xià)單日期

ip

ip

string

47.86.170.30

縣級運營中心上報數據的(de)ip地址

數據時(shí)間

create_time

date

2022-12-09

該字段是數據上報的(de)時(shí)間

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值爲1時(shí)代表成功,爲0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上報是否成功

返回信息

body

string

null

部分(fēn)接口會有返回信息

請求參數示例:

{

      "code_id": "360102",

      "key": "Hdh#qqashdas",

      "type ": "1",

      "price": "222.11",

      "sku_name ": "橘子",

      "sku_id ": "00001",

      "data_time ": "2022-12-09",

      "ip": "47.86.170.30",

      "create_time": "2022-12-09"

}

返回值示例:

{

      "code": "1",

      "msg": "正常",

      "body ": "null",

     }

4、數據庫對(duì)接

通(tōng)過http接口對(duì)接的(de)數據會經過篩選和(hé)處理(lǐ),容易導緻數據失真,不利于後續數據的(de)分(fēn)析和(hé)利用(yòng)。可(kě)以采取開放數據庫權限,直接對(duì)接數據庫的(de)方式獲取原始數據。

4.1.數據庫對(duì)接方式

數據庫方式通(tōng)信所對(duì)應的(de)數據庫組網方式有以下(xià)兩種:

一、由合作夥伴提供一個(gè)交互用(yòng)的(de)數據庫服務器,要求數據庫的(de)結構滿足本規範中定義要求。

二、電商公司提供一個(gè)符合規範定義的(de)結構要求的(de)标準數據庫,供合作方數據交互。

4.2數據庫表結構定義

集配企業

字段名

變量名

必填

類型

示例值

描述

地區(qū)id

code_id

int

360102

地區(qū)id标識的(de)是縣級運營中心所在的(de)地區(qū)(詳情請查看附件)

公司名稱

name

string

XX公司

公司名稱

訂單類型

type

int

1

标識訂單類型(1、新零售2、生鮮3、農資)

注冊資金

registered_capital

decimal

222

公司注冊資金

股權占比

equity_ratio

float

36.3%

股權占比

經營類型

business_type

int

1

公司經營類型1快(kuài)遞,2新零售,3生鮮,4

員(yuán)工數量

staff_num

int

20

員(yuán)工數量

店(diàn)鋪數量

shop_num

int

47

公司名下(xià)店(diàn)鋪數量

總場(chǎng)地面積

totle_area

float

10000

總場(chǎng)地面積

快(kuài)遞品牌

express_brand

int

1

快(kuài)遞品牌1.中通(tōng)2圓通(tōng)等等

配送單價

express_price

decimal

1.2

配送快(kuài)遞的(de)價格

配送線路

route_num

int

2

配送線路

企業負責人(rén)

real_name

string

王小明(míng)

企業負責人(rén)

聯系方式

phone

string

13154218546

企業負責人(rén)聯系方式

province

string

江西

city

string

南(nán)昌

area

string

西湖區(qū)

/區(qū)

gps x坐(zuò)标

gps_x

float

28.33

百度地圖坐(zuò)标

gps y坐(zuò)标

gps_y

float

115.212

百度地圖坐(zuò)标

注冊時(shí)間

create_time

datetime

2020-02-03

注冊時(shí)間

服務站點表

字段名

變量名

必填

類型

示例值

描述

公司id

company_id

int

12

公司id

企業名稱

company_name

string

XX公司

所屬公司名稱

服務站點名稱

name

string

XXX超市

服務站點名稱

聯系人(rén)

link_man

string

1

聯系人(rén)

聯系電話(huà)

link_phone

string

13154218546

聯系電話(huà)

經度

longitude

float

28.23

訂單總金額

緯度

latitude

float

116.3

商品名稱

創建時(shí)間

create_time

datetime

2020-03-03

商品規格id

快(kuài)遞操作記錄

字段名

變量名

必填

類型

示例值

描述

公司id

key_id

int

12

公司id

公司名稱

add_name

string

XX公司

所屬公司名稱

快(kuài)遞單号

sn

string

XXX超市

快(kuài)遞單号

快(kuài)遞品牌

logis_name

string

圓通(tōng)

快(kuài)遞品牌

操作人(rén)

user_name

string

小明(míng)

操作人(rén)

數據時(shí)間

data_time

date

2020-03-03

數據時(shí)間

地址

address

string

民安路99

地址

手機号

phone

string

13154218546

手機号

數據傳輸時(shí)間

create_time

datetime

2020-03-03

數據傳輸時(shí)間

生鮮數據

字段名

變量名

必填

類型

示例值

描述

地區(qū)id

code_id

int

12

地區(qū)id

公司id

company_id

string

06

訂單所屬公司id

商品名

goods_name

string

小白菜

商品名

商品數量

goods_num

Int

111

商品數量

訂單數量

order_num

Int

111

訂單數量

訂單總價

totle_price

decimal

124214.2

訂單總價

數據時(shí)間

data_time

date

2020-03-03

數據時(shí)間

數據傳輸時(shí)間

create_time

datetime

2020-03-03

數據傳輸時(shí)間

快(kuài)遞數據

字段名

變量名

必填

類型

示例值

描述

地區(qū)id

code_id

int

12

地區(qū)id

公司id

company_id

int

06

訂單所屬公司id

快(kuài)遞名稱

express_name

string

圓通(tōng)快(kuài)遞

快(kuài)遞名稱

快(kuài)遞上行數量

up_num

int

6465

快(kuài)遞上行數量

快(kuài)遞下(xià)行數量

down_num

int

3122

快(kuài)遞下(xià)行數量

數據時(shí)間

data_time

date

2020-03-03

數據時(shí)間

數據傳輸時(shí)間

create_time

datetime

2020-03-03

數據傳輸時(shí)間

新零售數據表

字段名

變量名

必填

類型

示例值

描述

地區(qū)id

code_id

int

12

地區(qū)id

公司id

company_id

string

06

訂單所屬公司id

商品名

goods_name

string

王老吉

商品名

商品數量

goods_num

int

111

商品數量

訂單數量

order_num

int

111

訂單數量

訂單總價

totle_price

decimal

124214.2

訂單總價

數據時(shí)間

data_time

date

2020-03-03

數據時(shí)間

數據傳輸時(shí)間

create_time

datetime

2020-03-03

數據傳輸時(shí)間

農資農具數據表

字段名

變量名

必填

類型

示例值

描述

地區(qū)id

code_id

int

12

地區(qū)id

公司id

company_id

string

06

訂單所屬公司id

商品名

goods_name

string

化(huà)肥

商品名

商品數量

goods_num

int

111

商品數量

訂單數量

order_num

int

111

訂單數量

訂單總價

totle_price

decimal

124214.2

訂單總價

數據時(shí)間

data_time

date

2020-03-03

數據時(shí)間

數據傳輸時(shí)間

create_time

datetime

2020-03-03

數據傳輸時(shí)間


2023年04月(yuè)26日 09:11:22
江西供銷電子商務有限公司 備案序号