近7天订单数据
全部
-
状态
物流单号 / 订单编号
运输商
最新动态
最近查询
加载中...
1 / 1
单号导入查询
批量查询
Excel 导入
已输入 0 条单号
支持 .xlsx / .xls / .csv 文件，自动读取第一列或名为「运单号/tracking_number」的列
通过 API 导入单号
调用接口批量上传单号，每次最多建议 1000 条。支持纯文本字符串，或带订单编号、备注的对象数组。
POST http://YOUR_HOST/api/user/import
Content-Type: application/json
请求参数：
{
"text": "U1234567890,GFUS1234567890,9400111899223456789012", // 方式一：逗号/换行/空格分隔的字符串
// 或方式二：对象数组
"numbers": [
{ "number": "U1234567890", "order_no": "SO20260001", "remark": "客户 A" },
{ "number": "GFUS1234567890", "order_no": "SO20260002" }
]
}
响应示例：
{ "ok": true, "added": 3, "total": 3 }
Content-Type: application/json
请求参数：
{
"text": "U1234567890,GFUS1234567890,9400111899223456789012", // 方式一：逗号/换行/空格分隔的字符串
// 或方式二：对象数组
"numbers": [
{ "number": "U1234567890", "order_no": "SO20260001", "remark": "客户 A" },
{ "number": "GFUS1234567890", "order_no": "SO20260002" }
]
}
响应示例：
{ "ok": true, "added": 3, "total": 3 }
cURL 示例
curl -X POST http://YOUR_HOST/api/user/import \\\n -H "Content-Type: application/json" \\\n -b session=YOUR_COOKIE \\\n -d '{"text":"U1234567890,GFUS1234567890"}'
curl -X POST http://YOUR_HOST/api/user/import \\\n -H "Content-Type: application/json" \\\n -b session=YOUR_COOKIE \\\n -d '{"text":"U1234567890,GFUS1234567890"}'
Python 示例
import requests
url = "http://YOUR_HOST/api/user/import"
payload = {
"numbers": [
{"number": "U1234567890", "order_no": "SO20260001", "remark": "客户 A"},
{"number": "GFUS1234567890"}
]
}
resp = requests.post(url, json=payload, cookies={"session": "YOUR_COOKIE"})
print(resp.json())
import requests
url = "http://YOUR_HOST/api/user/import"
payload = {
"numbers": [
{"number": "U1234567890", "order_no": "SO20260001", "remark": "客户 A"},
{"number": "GFUS1234567890"}
]
}
resp = requests.post(url, json=payload, cookies={"session": "YOUR_COOKIE"})
print(resp.json())
JavaScript 示例
const resp = await fetch('/api/user/import', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ text: 'U1234567890,GFUS1234567890' })
});
const data = await resp.json();
console.log(data);
const resp = await fetch('/api/user/import', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ text: 'U1234567890,GFUS1234567890' })
});
const data = await resp.json();
console.log(data);
-
今日概况
今日消耗
0
可能异常
0
投递失败
0
今日导入
0
可用额度
0/ 0
每次 API 查询消耗 1 点额度
购买额度
加载中…
选择额度档位后扫码支付，提交「我已付款」等待后台审核开通。
近7天导入订单走势
运单导入（API）
通过接口批量导入单号（导入不消耗额度）。支持纯文本字符串或带订单编号、备注的对象数组，单次建议不超过 1000 条。
POSThttp://YOUR_HOST/api/user/import
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| text | string | 否 | 逗号 / 换行 / 空格分隔的单号字符串（与 numbers 二选一） |
| numbers | array | 否 | 对象数组，元素含 number / order_no / remark |
| source | string | 否 | 来源标记，如 api / excel / manual |
cURL 示例
curl -X POST http://YOUR_HOST/api/user/import \
-H "Content-Type: application/json" \
-b session=YOUR_COOKIE \
-d '{"text":"U1234567890,GFUS1234567890"}'
-H "Content-Type: application/json" \
-b session=YOUR_COOKIE \
-d '{"text":"U1234567890,GFUS1234567890"}'
Python 示例
import requests
url = "http://YOUR_HOST/api/user/import"
payload = {"numbers":[{"number":"U1234567890","order_no":"SO20260001","remark":"客户A"},{"number":"GFUS1234567890"}]}
resp = requests.post(url, json=payload, cookies={"session":"YOUR_COOKIE"})
print(resp.json())
url = "http://YOUR_HOST/api/user/import"
payload = {"numbers":[{"number":"U1234567890","order_no":"SO20260001","remark":"客户A"},{"number":"GFUS1234567890"}]}
resp = requests.post(url, json=payload, cookies={"session":"YOUR_COOKIE"})
print(resp.json())
JavaScript 示例
const resp = await fetch('/api/user/import', {
method:'POST', headers:{'Content-Type':'application/json'},
body: JSON.stringify({ text:'U1234567890,GFUS1234567890' })
});
const data = await resp.json();
console.log(data);
method:'POST', headers:{'Content-Type':'application/json'},
body: JSON.stringify({ text:'U1234567890,GFUS1234567890' })
});
const data = await resp.json();
console.log(data);
响应示例
{ "ok": true, "added": 2, "total": 2, "skipped": [] }
动态查询接口
使用 API Key 查询已导入单号的最新物流信息，每次调用消耗 1 点额度。
GEThttp://YOUR_HOST/api/v1/track/{tracking_number}?api_key=YOUR_API_KEY
请求参数
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
| tracking_number | path | 是 | 运单号 |
| api_key | query | 是 | 你的 API Key（可在「运单导入」页或账户中心获取） |
cURL 示例
curl "http://YOUR_HOST/api/v1/track/U1234567890?api_key=YOUR_API_KEY"
Python 示例
import requests
url = "http://YOUR_HOST/api/v1/track/U1234567890"
resp = requests.get(url, params={"api_key":"YOUR_API_KEY"})
print(resp.json())
url = "http://YOUR_HOST/api/v1/track/U1234567890"
resp = requests.get(url, params={"api_key":"YOUR_API_KEY"})
print(resp.json())
JavaScript 示例
const resp = await fetch('/api/v1/track/U1234567890?api_key=YOUR_API_KEY');
const data = await resp.json();
console.log(data);
const data = await resp.json();
console.log(data);
响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
| ok | bool | 请求是否成功 |
| trackingNumber | string | 运单号 |
| carrier | string | 承运商，如 USPS / GOFO / UniUni |
| status | string | 中文状态（见「跟踪推送」状态取值） |
| statusRaw | string | 原始英文状态 |
| statusSummary | string | 最新物流摘要 |
| isTerminal | bool | 是否终态（已签收 / 失败） |
| latestLocation | string | 最新地点 |
| latestEventTime | string | 最新事件时间 |
| lastCheckedAt | int | 最近查询时间戳（毫秒） |
跟踪推送（Webhook）
当单号状态更新时，我们会向你配置的 URL 发送 POST 请求（JSON）。你可在服务端校验签名，确保数据来自本平台。
POSThttps://your-domain.com/webhook
请求头
| Header | 说明 |
|---|---|
| Content-Type | application/json |
| X-Webhook-Signature | sha256=HMAC-SHA256(payload, secret)，secret 为你配置的推送 Secret（未配置则为空） |
回调参数
| 字段 | 类型 | 说明 |
|---|---|---|
| trackingNumber | string | 运单号 |
| carrier | string | 承运商 |
| status | string | 中文状态（取值见下表） |
| statusRaw | string | 原始英文状态 |
| statusSummary | string | 最新物流摘要 |
| latestLocation | string | 最新地点 |
| latestEventTime | string | 最新事件时间 |
| timestamp | int | 推送时间戳（毫秒） |
状态取值（status 字段）
| 状态 | 英文触发 | 说明 |
|---|---|---|
| 查询不到 | Unknown / Not Found | 无有效轨迹信息 |
| 待揽收 | Pre Transit / Label Created / Accepted | 已生成面单、待揽收 |
| 运输途中 | In Transit / Arrived / Departed | 在途运输 |
| 到达待取 | Available for Pickup | 已到达待取点 |
| 派送途中 | Out for Delivery | 派送中 |
| 投递失败 | Delivery Attempted / Returned / Refused | 投递失败或退回 |
| 成功签收 | Delivered | 已签收（终态） |
| 可能异常 | Alert / Exception | 异常件 |
| 运输过久 | — | 超过 30 天无更新 |
推送时机：单号状态发生变化（状态、摘要或地点更新）时触发一次 POST 回调。若配置了 secret，请用 X-Webhook-Signature 校验：
sha256 = HMAC-SHA256(raw_body, secret)。配置推送地址
我的发货地址
发货地址添加后需经管理端审核，审核通过后才可用于在线下单。状态：待审核 / 已通过 / 已拒绝。
加载中...
添加发货地址
在线下单
没有地址？请先去「发货管理 > 发货地址」添加。
收件人信息
订单信息
批量上传订单
1
选择发货地址
2
开始上传
请下载模板并按字段填写后上传。支持 .xlsx / .xls / .csv，列名兼容 muban.xlsx 模板。
解析预览（前 5 条）
下单列表
状态
订单号
发货地址
收件人信息
下单时间
加载中...
物流轨迹
加载中...
购买额度 · 扫码支付
充值金额
¥0.00