Ever Connect
v1.4.0中文·EN·한국어登录申请接入
参考资料

数据模型

这门生意的领域模型:实体、字段、关系。只列对外可见的字段。机器读的 JSON-LD 在 /ontology

关系

ProducthasManySku一款含多个色码 / 尺码变体
SkuhasStockInWarehouseSKU 在各仓有库存(Stock)
StockrefersToSku库存记录对应一个 SKU
StockbelongsToWarehouse库存行自带 warehouse_code
ChannelhasAccessToWarehouse渠道可访问的仓(仓白名单)
ChannelhasPriceForProduct渠道对款的专属价(Price)
OrderbelongsToChannel订单归属渠道(归属校验)
DropshipOrderbelongsToChannel代发单归属渠道
ShipmentbelongsToChannel发货单归属渠道
ShipmentbelongsToOrder发货单来自批发订单(order_id)
StockReservationbelongsToOrder锁单来自批发订单(order_id);订单审核后生成锁单,发货后生成发货单
StockReservationbelongsToChannel锁单归属渠道
CartbelongsToChannel购物车(经 account)归属渠道
TransactionbelongsToChannel一笔流水记在某个渠道的账上
TransactionrefersToOrder流水多半挂着一张订货单(order_id)与一张配单(reservation_id)

Product 产品(款)

一个款号,含多个色码 / 尺码变体(SKU)。

字段类型说明
product_codestring款号
product_namestring英文品名
product_name_zhstring中文品名(有值才出;目前上游未接)
brandstring品牌
price_wholesalenumber批发价
price_retailnumber零售价
currencystring币种(AUD / CNY)
weight_gramsinteger克重(有值才出;目前上游未接)
image_urlsarray产品图片 URL 列表
descriptionstring规格描述
skusarray这一款的全部变体(Sku)

Sku SKU(条码 / 变体)

一个具体条码 = 款 × 颜色 × 尺码。

字段类型说明
skustringSKU / 条码
product_codestring所属款号
color_codestring色码
color_namestring颜色名
color_name_zhstring颜色中文名(有值才出;目前上游未接)
sizestring尺码

Warehouse 仓库

库存所在的仓。warehouse_code 是唯一标识,路径、参数、响应里都叫它:AU = 澳洲(全部仓合计)(合计视图);AUSYD2 = 悉尼主仓(Rosehill);AUSYD1 = 悉尼配件仓;CN = 中国(全部仓合计)(合计视图);CHNZJ1 = 中国镇江仓

字段类型说明
warehouse_codestring仓库编码:AU / AUSYD2 / AUSYD1 / CN / CHNZJ1
namestring仓库名(英文)
name_zhstring仓库名(中文)
countrystring国家(AU / CN)
company_codestring所属公司编码(100003 澳洲 / 500001 中国)
typestringgroup = 公司级合计视图;physical = 真实仓
can_shipboolean能否从该仓直接发货
currencystring币种

Stock 库存

某 SKU 在某仓的实时库存(含价格快照)。整仓、按款、按 SKU、增量口返回的都是它。

字段类型说明
warehouse_codestring所在仓(每行自带)
skustringSKU
product_codestring款号
product_namestring品名
color_codestring色码
color_namestring颜色
sizestring尺码
brandstring品牌
quantity_on_handinteger在库数量
quantity_availableinteger可用数量(在库 − 已锁)
price_wholesalenumber批发价
price_retailnumber零售价
currencystring币种
expected_arrival_datestring预计到货日(有在途才出)
quantity_incominginteger在途数量(有在途才出)

Channel 渠道(客户)

批发客户。token 里带渠道号;能调什么由角色和仓白名单决定。

字段类型说明
channel_codestring渠道号(客户身份)
regionstring默认区域 au / cn
rolesarray角色(reader / trader / full)

Price 渠道价

某渠道对某款的价格(按渠道算,不是库存里那个统一价)。

字段类型说明
warehouse_codestring
channel_codestring渠道
product_codestring款号
price_wholesalenumber本渠道批发价
price_retailnumber零售价
price_settlementnumber结算价

Order 批发订单

批发下单 / 查单,归属某渠道。下单发什么、查单拿回什么,同一个形状。

字段类型说明
order_idstring订单号
warehouse_codestring
linesarray明细 [{sku, quantity}]
statusstring状态:draft 未审核 / confirmed 已审核 / cancelled 作废
status_rawinteger状态原值
created_datestring单据日期
notestring备注
channel_codestring归属渠道(归属校验用:只能看到自己的)

DropshipOrder 代发订单

代发下单 / 查单,归属某渠道,带收件人。一张代发单只有一个 SKU。

字段类型说明
dropship_order_idstring代发订单号
serial_numberstring流水号
client_order_numberstring客户自己的单号
warehouse_codestring
skustringSKU
quantityinteger件数
quantity_allocatedinteger已配货
quantity_shippedinteger已发货
recipientobject收件人 {name, phone, address, country_code, state, city, postal_code}
senderobject发件人 {name, phone}
shipping_methodstring运输方式 normal / express
carrierstring承运商
tracking_numberstring运单号
shippedboolean是否已发货
shipped_datestring发货日期
statusstring状态:pending 新建未配货 / shipped 已发货 / intercepted 已拦截 / cancelled 已取消
status_rawinteger状态原值
paidboolean是否已付款
price_settlementnumber结算价
amount_shippingnumber运费
channel_codestring归属渠道(归属校验用:只能看到自己的)

Shipment 发货单

发货单,归属某渠道;物流轨迹挂在它下面。

字段类型说明
shipment_idstring发货单号
order_idstring来源批发订单号
reservation_idstring来源锁单号
warehouse_codestring
statusstring状态:shipped 已发货
tracking_numberstring运单号
linesarray明细
channel_codestring归属渠道(归属校验用:只能看到自己的)

StockReservation 锁单 / 预留库存

渠道锁定的库存,归属某渠道。

字段类型说明
reservation_idstring锁单号
order_idstring来源批发订单号
warehouse_codestring
statusstring状态:reserved 锁定中 / cancelled 已作废 / confirmed 已审核
shippedboolean是否已发货
linesarray明细 [{sku, quantity}]
channel_codestring归属渠道(归属校验用:只能看到自己的)

Cart 购物车

按 OMS 账号的购物车(账号归属某渠道)。

字段类型说明
accountstringOMS 账号
linesarray明细 [{sku, quantity}]
channel_codestring归属渠道(归属校验用:只能看到自己的)

Transaction 账户流水

渠道账户的一笔资金变动:充值 / 扣款 / 退款。余额是它们的累计结果。

字段类型说明
transaction_idstring流水号(14 位纯数字,与代发流水号同形——认号要给候选)
transaction_typestring类型:recharge 充值 / payment 支付 / refund 退款
amountnumber金额(正负号按类型)
currencystring币种
balance_afternumber这一笔之后的余额——余额链首尾可验算
order_idstring关联的订货单号(有才出)
reservation_idstring关联的配单号(有才出)
created_atstring上游处理时间(不是业务发生时间:补录会落在补录那天)
channel_codestring归属渠道(归属校验用:只能看到自己的)