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

业务流程

一个流程 = 一件事,内部按顺序调哪几条接口都列在这里。AI 助手和 MCP 用的就是这份定义,所以它不会和代码对不上。

check_stock

一次问一批货还有没有:给一串 SKU(条码),逐个告诉你可用数量、你的结算价、缺货的预计到货日。问「这几个还有吗」用这个,别一个个查。

#这一步对应接口
1meGET /api/v1/me
2stock_listGET /api/v1/warehouses/{warehouse_code}/stock

需要权限:stock:read

find_products

按关键词找货:给款号或品名的一部分,返回匹配的款、你的结算价、能不能补货。想知道某一款有哪些颜色尺码、有没有货,再用 check_stock 或 product_get。

#这一步对应接口
1meGET /api/v1/me
2product_listGET /api/v1/products

需要权限:product:read

get_statement

对一段时间的账:一次给出账户余额、这段时间的流水合计和明细。问「这个月花了多少」「余额还剩多少」「对一下账」用这个。

#这一步对应接口
1balance_listGET /api/v1/balances
2transaction_listGET /api/v1/transactions

需要权限:finance:read

quote_order 写操作

批发下单前先看配货:建一张草稿单并跑配货预览,告诉你每一行能配多少、缺多少、几时到货、一共要付多少,不提交。看完要交就用 place_order,不交就用 cancel_order 撤掉(草稿留着会占配货)。

#这一步对应接口
1meGET /api/v1/me
2order_createPOST /api/v1/orders
3order_allocation_previewPOST /api/v1/orders/{order_id}/allocation-preview

需要权限:order:write

place_order 写操作

提交批发订单(提交后不能再改明细)。先用 quote_order 看过配货和金额再交。付款方式默认按发票付款。

#这一步对应接口
1order_submitPOST /api/v1/orders/{order_id}/submit

需要权限:order:write

cancel_order 写操作

作废一张批发订单,连同它占住的配货一起释放。看完配货决定不下了,用这个收尾。

#这一步对应接口
1order_cancelDELETE /api/v1/orders/{order_id}

需要权限:order:write

quote_dropship 写操作

代发下单前先预配:把这批代发明细建出来并跑预配,逐条告诉你能不能配齐、缺多少、要付多少,不提交。这是代发的标准做法——先看缺货再决定。要交用 place_dropship,不交用 release_dropship 释放。

#这一步对应接口
1meGET /api/v1/me
2dropship_order_createPOST /api/v1/dropship-orders
3dropship_order_allocation_previewPOST /api/v1/dropship-orders/allocation-preview

需要权限:df:write

place_dropship 写操作

提交代发(提交后不能改)。带上 quote_dropship 返回的 preview_key,就按那次预配的结果交。

#这一步对应接口
1meGET /api/v1/me
2dropship_order_submitPOST /api/v1/dropship-orders/submit

需要权限:df:write

release_dropship 写操作

释放代发预配占住的库存(预配完决定不交时用)。不释放的话这批货会一直被占着。

#这一步对应接口
1dropship_order_allocation_cancelDELETE /api/v1/dropship-orders/{dropship_order_id}/allocation

需要权限:df:write