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


本規範确定了(le)“互聯網+第四方物流”供銷集配科技支撐體(tǐ)系數據對接标準,是供銷集配科技支撐體(tǐ)系信息化(huà)系統統一(yī)的基礎、是各合作(zuò)商(shāng)對接供銷集配體(tǐ)系的依據,是江西(xī)省供銷電子(zǐ)商(shāng)務(wù)有限公司(以下(xià)簡稱電商(shāng)公司)對社會統一(yī)開放(fàng)共享的前提。

本規範由江西(xī)省供銷電子(zǐ)商(shāng)務(wù)有限公司技術部提出并歸口。

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

本規範起草單位:江西(xī)省電子(zǐ)商(shāng)務(wù)有限公司


1、适用範圍

适用對象為(wèi)江西(xī)省供銷電子(zǐ)商(shāng)務(wù)有限公司内部及合作(zuò)方, 用于在業務(wù)開展、招标選型、工程建設、運行維護、設備開發等方面提供技術參考依據

2、接口說(shuō)明

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

3、數據接口

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

正式請求地址:具體(tǐ)官網公布為(wèi)準

測試請求地址:具體(tǐ)官網公布為(wèi)準

官網地址:/

對接方式:http接口

3.1集配企業主體(tǐ)信息上(shàng)報(bào)

接口描述

該接口用于上(shàng)報(bào)集配企業基礎信息

接口名稱:uploadCompanyInformation

請求方式:post

接口示例:參見附件一(yī)

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區id

code_id

int

360102

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

密鑰

key

string

Hdh#qqashdas

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

車輛數

car_num

int

20

車輛總數

倉庫面積

area_num

float

3525.3

倉庫面積

網點數

shop_num

int

222

網點數量

ip

ip

string

47.86.170.30

縣級運營中心上(shàng)報(bào)數據的ip地址

數據時(shí)間(jiān)

create_time

date

2022-12-09

該字段是數據上(shàng)報(bào)的時(shí)間(jiān)

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值為(wèi)1時(shí)代表成功,為(wèi)0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上(shàng)報(bào)是否成功

返回信息

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車輛信息上(shàng)報(bào)

接口描述:該接口用于上(shàng)報(bào)集配中心車輛信息

接口名稱:uploadCarInformation

請求方式:post

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區id

code_id

int

360102

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

密鑰

key

string

Hdh#qqashdas

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

車牌号

car_name

int

20

車輛總數

車輛長度(米)

car_long

float

12

倉庫面積

車載重量(噸)

shop_num

int

22

網點數量

購(gòu)買時(shí)間(jiān)

buy_date

date

2022-12-09

數據時(shí)間(jiān)

create_time

date

2022-12-09

該字段是數據上(shàng)報(bào)的時(shí)間(jiān)

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值為(wèi)1時(shí)代表成功,為(wèi)0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上(shàng)報(bào)是否成功

返回信息

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司機信息上(shàng)報(bào)

接口描述:該接口用于上(shàng)報(bào)集配中心司機信息

接口名稱:uploadDriverInformation

請求方式:post

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區id

code_id

int

360102

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

密鑰

key

string

Hdh#qqashdas

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

司機名字

driver_name

int

王小明

司機名字

司機性别

driver_sex

float

1

1.2女(nǚ)

從業證件

driver _certificate

int

222

上(shàng)傳圖片

數據時(shí)間(jiān)

create_time

date

2022-12-09

數據上(shàng)報(bào)時(shí)間(jiān)

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值為(wèi)1時(shí)代表成功,為(wèi)0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上(shàng)報(bào)是否成功

返回信息

body

string

null

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

請求參數示例:

{

      "code_id": "360102",

      "key": "Hdh#qqashdas",

      "driver_name": "王小明",

      "driver_sex": "1",

      "driver _certificate ": "圖片",

      "create_time": "2022-12-09"

}

返回值示例:

{

      "code": "1",

      "msg": "正常",

      "body ": "null",

     }

3.4服務(wù)站(zhàn)點上(shàng)報(bào)

接口描述:該接口用于上(shàng)報(bào)服務(wù)站(zhàn)點信息

接口名稱:uploadPartnerInformation

請求方式:post

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區id

code_id

int

360102

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

密鑰

key

string

Hdh#qqashdas

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

站(zhàn)點名稱

partner_name

int

XXX超市(shì)

提貨點、小賣鋪、服務(wù)站(zhàn)點、合夥人(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

縣級運營中心上(shàng)報(bào)數據的ip地址

數據時(shí)間(jiān)

create_time

date

2022-12-09

該字段是數據上(shàng)報(bào)的時(shí)間(jiān)

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值為(wèi)1時(shí)代表成功,為(wèi)0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上(shàng)報(bào)是否成功

返回信息

body

string

null

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

請求參數示例:

{

      "code_id": "360102",

      "key": "Hdh#qqashdas",     

"partner_name": " XXX超市(shì)",

      "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素材上(shàng)傳

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

接口名稱:uploadFile

請求方式:post

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區id

code_id

int

360102

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

密鑰

key

string

Hdh#qqashdas

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

素材名稱

file_name

int

測試圖片

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

素材類型

file_type

int

1

1 圖片 2 視(shì)頻 3 文件

ip

ip

string

47.86.170.30

縣級運營中心上(shàng)報(bào)數據的ip地址

數據時(shí)間(jiān)

create_time

date

2022-12-09

該字段是數據上(shàng)報(bào)的時(shí)間(jiān)

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值為(wèi)1時(shí)代表成功,為(wèi)0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上(shàng)報(bào)是否成功

返回信息

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í)坐标

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

接口名稱:uploadCarPosition

請求方式:post

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區id

code_id

int

360102

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

密鑰

key

string

Hdh#qqashdas

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

車輛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

縣級運營中心上(shàng)報(bào)數據的ip地址

數據時(shí)間(jiān)

create_time

date

2022-12-09

該字段是數據上(shàng)報(bào)的時(shí)間(jiān)

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值為(wèi)1時(shí)代表成功,為(wèi)0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上(shàng)報(bào)是否成功

返回信息

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)遞數據上(shàng)報(bào)接口(每日上(shàng)報(bào)一(yī)次快(kuài)遞數據)

地址:uploadLogistics

請求方式:post

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區id

code_id

int

360102

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

密鑰

key

string

hdhashdas

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

快(kuài)遞上(shàng)行件

up_num

int

1344

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

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

down_num

int

222

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

日期

data_time

date

2022-12-09

快(kuài)遞數據日期一(yī)般為(wèi)當天的日期

ip

ip

string

47.86.170.30

縣級運營中心上(shàng)報(bào)數據的ip地址

數據時(shí)間(jiān)

create_time

date

2022-12-09

該字段是數據上(shàng)報(bào)的時(shí)間(jiān)

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值為(wèi)1時(shí)代表成功,為(wèi)0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上(shàng)報(bào)是否成功

返回信息

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訂單數據上(shàng)報(bào)接口

集配中心訂單數據上(shàng)報(bào)接口(每個(gè)成功的訂單上(shàng)報(bào)一(yī)次數據)

地址:uploadOrder

請求方式:post

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區id

code_id

int

360102

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

密鑰

key

string

hdhashdas

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

訂單類型

type

int

1

标識訂單類型(1、新(xīn)零售2、生(shēng)鮮3、農(nóng)資)

訂單總價

price

decimal

222.11

訂單總金(jīn)額

日期

data_time

string

202006100909

下(xià)單日期

ip

ip

string

47.86.170.30

縣級運營中心上(shàng)報(bào)數據的ip地址

數據時(shí)間(jiān)

create_time

date

2022-12-09

該字段是數據上(shàng)報(bào)的時(shí)間(jiān)

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值為(wèi)1時(shí)代表成功,為(wèi)0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上(shàng)報(bào)是否成功

返回信息

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訂單商(shāng)品數據上(shàng)報(bào)接口

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

地址:uploadOrderDetial

請求方式:post

請求參數:

字段名

變量名

必填

類型

示例值

描述

地區id

code_id

int

360102

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

密鑰

key

string

hdhashdas

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

訂單類型

type

int

1

标識訂單類型(1、新(xīn)零售2、生(shēng)鮮3、農(nóng)資)

訂單金(jīn)額

price

decimal

222.11

訂單總金(jīn)額

單品名稱

sku_name

string

橘子(zǐ)

商(shāng)品名稱

單品id

sku_id

int

00001

商(shāng)品規格id

日期

data_time

date

202006100909

下(xià)單日期

ip

ip

string

47.86.170.30

縣級運營中心上(shàng)報(bào)數據的ip地址

數據時(shí)間(jiān)

create_time

date

2022-12-09

該字段是數據上(shàng)報(bào)的時(shí)間(jiān)

返回參數:

字段名

變量名

必填

類型

示例值

描述

返回狀态碼

code

int

1

返回值為(wèi)1時(shí)代表成功,為(wèi)0時(shí)代表失敗

msg

msg

string

成功

主要表述數據上(shàng)報(bào)是否成功

返回信息

body

string

null

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

請求參數示例:

{

      "code_id": "360102",

      "key": "Hdh#qqashdas",

      "type ": "1",

      "price": "222.11",

      "sku_name ": "橘子(zǐ)",

      "sku_id ": "00001",

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

      "ip": "47.86.170.30",

      "create_time": "2022-12-09"

}

返回值示例:

{

      "code": "1",

      "msg": "正常",

      "body ": "null",

     }

4、數據庫對接

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

4.1.數據庫對接方式

數據庫方式通信所對應的數據庫組網方式有以下(xià)兩種:

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

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

4.2數據庫表結構定義

集配企業

字段名

變量名

必填

類型

示例值

描述

地區id

code_id

int

360102

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

公司名稱

name

string

XX公司

公司名稱

訂單類型

type

int

1

标識訂單類型(1、新(xīn)零售2、生(shēng)鮮3、農(nóng)資)

注冊資金(jīn)

registered_capital

decimal

222

公司注冊資金(jīn)

股權占比

equity_ratio

float

36.3%

股權占比

經營類型

business_type

int

1

公司經營類型1快(kuài)遞,2新(xīn)零售,3生(shēng)鮮,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.中通2圓通等等

配送單價

express_price

decimal

1.2

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

配送線路(lù)

route_num

int

2

配送線路(lù)

企業負責人(rén)

real_name

string

王小明

企業負責人(rén)

聯系方式

phone

string

13154218546

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

province

string

江西(xī)

市(shì)

city

string

南(nán)昌

市(shì)

area

string

西(xī)湖區

/

gps x坐标

gps_x

float

28.33

百度地圖坐标

gps y坐标

gps_y

float

115.212

百度地圖坐标

注冊時(shí)間(jiān)

create_time

datetime

2020-02-03

注冊時(shí)間(jiān)

服務(wù)站(zhàn)點表

字段名

變量名

必填

類型

示例值

描述

公司id

company_id

int

12

公司id

企業名稱

company_name

string

XX公司

所屬公司名稱

服務(wù)站(zhàn)點名稱

name

string

XXX超市(shì)

服務(wù)站(zhàn)點名稱

聯系人(rén)

link_man

string

1

聯系人(rén)

聯系電話(huà)

link_phone

string

13154218546

聯系電話(huà)

經度

longitude

float

28.23

訂單總金(jīn)額

緯度

latitude

float

116.3

商(shāng)品名稱

創建時(shí)間(jiān)

create_time

datetime

2020-03-03

商(shāng)品規格id

快(kuài)遞操作(zuò)記錄

字段名

變量名

必填

類型

示例值

描述

公司id

key_id

int

12

公司id

公司名稱

add_name

string

XX公司

所屬公司名稱

快(kuài)遞單号

sn

string

XXX超市(shì)

快(kuài)遞單号

快(kuài)遞品牌

logis_name

string

圓通

快(kuài)遞品牌

操作(zuò)人(rén)

user_name

string

小明

操作(zuò)人(rén)

數據時(shí)間(jiān)

data_time

date

2020-03-03

數據時(shí)間(jiān)

地址

address

string

民(mín)安路(lù)99

地址

手機号

phone

string

13154218546

手機号

數據傳輸時(shí)間(jiān)

create_time

datetime

2020-03-03

數據傳輸時(shí)間(jiān)

生(shēng)鮮數據

字段名

變量名

必填

類型

示例值

描述

地區id

code_id

int

12

地區id

公司id

company_id

string

06

訂單所屬公司id

商(shāng)品名

goods_name

string

小白菜

商(shāng)品名

商(shāng)品數量

goods_num

Int

111

商(shāng)品數量

訂單數量

order_num

Int

111

訂單數量

訂單總價

totle_price

decimal

124214.2

訂單總價

數據時(shí)間(jiān)

data_time

date

2020-03-03

數據時(shí)間(jiān)

數據傳輸時(shí)間(jiān)

create_time

datetime

2020-03-03

數據傳輸時(shí)間(jiān)

快(kuài)遞數據

字段名

變量名

必填

類型

示例值

描述

地區id

code_id

int

12

地區id

公司id

company_id

int

06

訂單所屬公司id

快(kuài)遞名稱

express_name

string

圓通快(kuài)遞

快(kuài)遞名稱

快(kuài)遞上(shàng)行數量

up_num

int

6465

快(kuài)遞上(shàng)行數量

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

down_num

int

3122

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

數據時(shí)間(jiān)

data_time

date

2020-03-03

數據時(shí)間(jiān)

數據傳輸時(shí)間(jiān)

create_time

datetime

2020-03-03

數據傳輸時(shí)間(jiān)

新(xīn)零售數據表

字段名

變量名

必填

類型

示例值

描述

地區id

code_id

int

12

地區id

公司id

company_id

string

06

訂單所屬公司id

商(shāng)品名

goods_name

string

王老吉

商(shāng)品名

商(shāng)品數量

goods_num

int

111

商(shāng)品數量

訂單數量

order_num

int

111

訂單數量

訂單總價

totle_price

decimal

124214.2

訂單總價

數據時(shí)間(jiān)

data_time

date

2020-03-03

數據時(shí)間(jiān)

數據傳輸時(shí)間(jiān)

create_time

datetime

2020-03-03

數據傳輸時(shí)間(jiān)

農(nóng)資農(nóng)具數據表

字段名

變量名

必填

類型

示例值

描述

地區id

code_id

int

12

地區id

公司id

company_id

string

06

訂單所屬公司id

商(shāng)品名

goods_name

string

化(huà)肥

商(shāng)品名

商(shāng)品數量

goods_num

int

111

商(shāng)品數量

訂單數量

order_num

int

111

訂單數量

訂單總價

totle_price

decimal

124214.2

訂單總價

數據時(shí)間(jiān)

data_time

date

2020-03-03

數據時(shí)間(jiān)

數據傳輸時(shí)間(jiān)

create_time

datetime

2020-03-03

數據傳輸時(shí)間(jiān)


2023年04月(yuè)(yuè)26日 09:11:22
江西(xī)供銷電子(zǐ)商(shāng)務(wù)有限公司 備案序号