Fecify-订单-详细
接口信息
- 接口地址:
{your-site-url}/api/skill/order/get-order-info
- 基础 URL:
{your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/admin
- 请求方式:
GET
- Content-Type:
application/json
- 说明: 获取订单完整详情,包括订单基本信息、商品明细、收货地址、支付交易、客户端信息、顾客信息及可执行操作标识等。
order_number 和 order_id 二选一传入即可。
认证
请求头中需要携带 skill-access-token:
| Header |
值 |
skill-access-token |
{your-skill-access-token} (请替换为你自己的 token) |
请求参数
请求示例
cURL
curl --location --request GET '{your-site-url}/api/skill/order/get-order-info?order_number=FECE726305304927083' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'
返回结果
code 为 200 表示成功;code 不为 200 表示失败。
成功响应
{
"code": 200,
"data": {
"order_info": {
"id": 6555,
"shop_id": 15,
"order_number": "FECE726305304927083",
"client_type": 1,
"order_status": 2,
"payment_status": 3,
"fulfillment_status": 1,
"checkout_type": 2,
"cart_id": 0,
"lang_code": "en",
"items_count": 1,
"gram": "0.00",
"currency_code": "USD",
"base_currency_code": "USD",
"order_to_base_rate": "1.00",
"curr_subtotal": "1.68",
"base_subtotal": "1.68",
"base_tips": "0.50",
"curr_tips": "0.50",
"base_insurance": "0.00",
"curr_insurance": "0.00",
"base_tax": "0.00",
"curr_tax": "0.00",
"curr_shipping_total": "43.00",
"base_shipping_total": "43.00",
"curr_subtotal_with_discount": "0.00",
"base_subtotal_with_discount": "0.00",
"curr_grand_total": "45.18",
"base_grand_total": "45.18",
"customer_type": 1,
"customer_id": 558,
"customer_email": "fecify@126.com",
"customer_phone": "8632132",
"coupon_code": "",
"discount_set": {
"coupon": {
"coupon_code": "",
"curr_discount_amount": 0,
"base_discount_amount": 0
}
},
"payment_method": "Stripe",
"payment_name": "Stripe Credit Card",
"payment_position_type": 1,
"payment_fee": "0.00",
"shipping_method_id": 51,
"shipping_method_name": "strandard Shipping",
"note": "订单备注信息",
"cancelled_at": 0,
"cancel_reason": 0,
"payed_at": "2026-07-26 09:50:37",
"created_at": "2026-07-26 09:48:50",
"updated_at": "2026-07-26 09:58:13",
"billing_is_use_shipping_address": 2,
"step": 6,
"recall_status": 3,
"recalled_at": "2026-07-26 09:50:37",
"recall_send_email_count": 0,
"recall_send_email_time": 0,
"fulfilled_at": 0,
"post_saled_at": 0,
"post_sale_status": 1,
"tags": ["432423", "321312321", "4343"],
"over_sold_count": 0,
"is_stock_deducted": 1,
"fist_loading_url": "https://diydomain.fecmall.cn/products/cyberpunk-led-party-glasses...",
"affiliate_tracking_id": "2222",
"remark": "",
"is_rebate": 2,
"payafteruse": false,
"items": [
{
"id": 7955,
"shop_id": 15,
"order_id": 6555,
"product_id": 7137,
"variant_id": 50285,
"spu": "ylbb1601784498226",
"sku": "191288010210192001",
"variant_title": "Black / 6.29*6*1.77inches(15.98*15.24*4.50cm)",
"product_title": "Cyberpunk LED Party Glasses | Glowing Luminous Sunglasses for Rave Nightclub | Futuristic Neon Headwear for Halloween Costume 家电",
"image": "https://sc04.alicdn.com/kf/Hda98e1989d4243bc8c3e410211cf3bd6f.jpg",
"gram": "0.00",
"base_price": "1.68",
"curr_price": "1.68",
"base_row_tax": "0.00",
"curr_row_tax": "0.00",
"addition_attr_base_price": "0.00",
"addition_attr_curr_price": "0.00",
"addition_attr": "",
"glasses_custom_base_price": "0.00",
"glasses_custom_curr_price": "0.00",
"glasses_customized": null,
"qty": 1,
"curr_row_price": "1.68",
"row_gram": "0.00",
"base_row_price": "1.68",
"is_reviewed": 2,
"over_sold_count": 0,
"created_at": 1785030530,
"updated_at": 1785030613,
"product_source_id": "",
"variant_source_id": "",
"source_type": 0
}
],
"shippingAddress": {
"id": 4429,
"shop_id": 15,
"order_id": 6555,
"first_name": "Terry",
"last_name": "zhao",
"phone": "8632132",
"company": "fecify",
"address_1": "chong qing zhong lu 227",
"address_2": "432432",
"city": "qingdao",
"country_code": "CN",
"province_code": "JS",
"zip": "323232",
"created_at": 1785030600,
"updated_at": 1785030613,
"province_name": "Jiangsu"
},
"billingAddress": {
"id": 392,
"shop_id": 15,
"order_id": 6555,
"first_name": "Terry zhao",
"last_name": "zhao",
"address_1": "chong qing zhong lu 22712",
"address_2": "34343",
"city": "qingdao",
"country_code": "CN",
"province_code": "AH",
"zip": "323232",
"created_at": 1785030619,
"updated_at": 1785030625,
"province_name": "AnHui"
},
"clientDetails": {
"id": 5740,
"order_id": 6555,
"shop_id": 15,
"country_code": "",
"region_code": "",
"region_name": "",
"city": "",
"timezone": "",
"longitude": "",
"latitude": "",
"client_type": 1,
"browser_ip": "119.166.179.91",
"browser_lang": "en-US",
"browser_height": "945",
"browser_width": "1920",
"user_agent": "Chrome",
"referring_site": "https://diydomain.fecmall.cn/apimanager666/...",
"fist_loading_url": "https://diydomain.fecmall.cn/products/...",
"created_at": 1785030530,
"updated_at": 1785030530
},
"txnid": {
"order_id": 6555,
"txn_id": "pi_3TxHCZIyi1yvgHm21rjRSCbp",
"payment_method": "stripe"
}
},
"second_order_items": [],
"order_is_show_second": false,
"paypal_transaction_info": "",
"post_sale_curr_refunded_amount": "0.00",
"final_curr_grand_total": "45.18",
"status": {
"order_status": 2,
"payment_status": 3,
"fulfillment_status": 1,
"post_sale_status": 1
},
"pay_txn_id": "pi_3TxHCZIyi1yvgHm21rjRSCbp",
"customer_info": {
"first_name": "terry",
"last_name": "water",
"email": "fecify@126.com",
"phone": "8632132",
"first_order_date": "2025-11-14 15:00:45",
"history_order_count": 83,
"history_order_product_count": 132,
"history_order_base_amount": "41712.21"
},
"client_detail": {
"id": 5740,
"order_id": 6555,
"shop_id": 15,
"country_code": "",
"region_code": "",
"region_name": "",
"city": "",
"timezone": "",
"longitude": "",
"latitude": "",
"client_type": 1,
"browser_ip": "119.166.179.91",
"browser_lang": "en-US",
"browser_height": "945",
"browser_width": "1920",
"user_agent": "Chrome",
"referring_site": "https://diydomain.fecmall.cn/apimanager666/...",
"fist_loading_url": "https://diydomain.fecmall.cn/products/...",
"created_at": "2026-07-26 09:48:50",
"updated_at": "2026-07-26 09:48:50",
"country_name": {
"name": "",
"cn_name": ""
}
},
"fulfillments": [],
"post_sale_status": 0,
"can_cancel": true,
"can_archived": false,
"can_cancel_archived": false,
"can_change_address": true,
"can_change_discount": false,
"can_remove_discount": false,
"is_customer_complete_order": true,
"recall_status": 0,
"can_fulfill": true,
"can_receive": true,
"order_post_sale_id": 0,
"post_sale_can_refund": false,
"post_sale_can_return": false,
"post_sale_can_refund_and_return": false
},
"message": "success"
}
返回字段说明
顶层 data 字段
| 字段 |
类型 |
说明 |
order_info |
Object |
订单详细信息 |
second_order_items |
Array |
二库订单商品数据(仅开启斗篷功能时有数据) |
order_is_show_second |
Boolean |
是否展示二库订单商品:true = 展示,false = 不展示 |
paypal_transaction_info |
String |
PayPal 交易信息(仅 PayPal 支付时有数据) |
post_sale_curr_refunded_amount |
String |
订单退款金额(当前货币) |
final_curr_grand_total |
String |
订单最终支付金额(当前货币)= 订单总额 - 退款额 |
status |
Object |
订单各状态汇总,包含 order_status、payment_status、fulfillment_status、post_sale_status |
pay_txn_id |
String |
订单支付交易号 |
customer_info |
Object |
订单顾客信息 |
client_detail |
Object |
客户端详细信息(与 order_info.clientDetails 数据一致) |
fulfillments |
Array |
快递物流信息 |
post_sale_status |
Number |
订单售后状态(顶层),0 = 无售后 |
can_cancel |
Boolean |
是否可以取消订单 |
can_archived |
Boolean |
是否可以归档订单 |
can_cancel_archived |
Boolean |
是否可以取消归档 |
can_change_address |
Boolean |
是否可以修改收货地址 |
can_change_discount |
Boolean |
是否可以更改优惠 |
can_remove_discount |
Boolean |
是否可以删除优惠 |
is_customer_complete_order |
Boolean |
顾客是否已完成订单(是否已召回) |
recall_status |
Number |
召回状态(顶层):待处理订单返回 0;未完成订单:1 = 找回中,2 = 未召回,3 = 召回失败 |
can_fulfill |
Boolean |
是否可以发货 |
can_receive |
Boolean |
是否可以收货 |
order_post_sale_id |
Number |
订单售后 ID,0 = 无售后 |
post_sale_can_refund |
Boolean |
是否可以售后-仅退款 |
post_sale_can_return |
Boolean |
是否可以售后-仅退货 |
post_sale_can_refund_and_return |
Boolean |
是否可以售后-退货并退款 |
order_info — 订单基本信息
| 字段 |
类型 |
说明 |
id |
Number |
订单 ID |
shop_id |
Number |
店铺 ID |
order_number |
String |
订单编号 |
client_type |
Number |
客户端类型:1 = PC,2 = 平板,3 = 手机,4 = 后台创建,5 = 外部导入 |
order_status |
Number |
订单状态:1 = 结账初始,2 = 已创建/进入流程,3 = 归档,4 = 已取消 |
payment_status |
Number |
支付状态:1 = 初始,2 = 待支付,21 = 待审核,3 = 已支付,4 = 部分退款,5 = 全部退款 |
fulfillment_status |
Number |
发货状态:1 = 初始,2 = 未发货,3 = 挂起,4 = 部分发货,5 = 全部发货,6 = 部分收货,7 = 全部收货,8 = 全部退货 |
checkout_type |
Number |
结账类型:1 = 购物车结账,2 = 立即购买,3 = 后台创建 |
cart_id |
Number |
购物车 ID |
lang_code |
String |
用户访问网站的语言 |
items_count |
Number |
订单商品总件数 |
gram |
String |
订单总重量(克) |
currency_code |
String |
下单当前货币 |
base_currency_code |
String |
店铺基础货币 |
order_to_base_rate |
String |
当前货币与基础货币的汇率 |
curr_subtotal |
String |
订单商品总额(当前货币) |
base_subtotal |
String |
订单商品总额(基础货币) |
base_tips |
String |
订单小费(基础货币) |
curr_tips |
String |
订单小费(当前货币) |
base_insurance |
String |
保险费用(基础货币) |
curr_insurance |
String |
保险费用(当前货币) |
base_tax |
String |
税费(基础货币) |
curr_tax |
String |
税费(当前货币) |
curr_shipping_total |
String |
订单运费(当前货币) |
base_shipping_total |
String |
订单运费(基础货币) |
curr_subtotal_with_discount |
String |
订单折扣(当前货币) |
base_subtotal_with_discount |
String |
订单折扣(基础货币) |
curr_grand_total |
String |
订单总额(当前货币) |
base_grand_total |
String |
订单总额(基础货币) |
customer_type |
Number |
客户类型:1 = 游客,2 = 注册用户 |
customer_id |
Number |
下单用户 ID |
customer_email |
String |
下单用户邮箱 |
customer_phone |
String |
用户手机号 |
coupon_code |
String |
优惠券码 |
discount_set |
Object |
折扣信息。coupon 子字段:coupon_code 优惠券码、curr_discount_amount 当前货币折扣金额、base_discount_amount 基础货币折扣金额 |
payment_method |
String |
支付方式标识 |
payment_name |
String |
支付方式名称 |
payment_position_type |
Number |
支付发起位置:1 = 标准结账,2 = 购物车直接发起,3 = 产品页发起,4 = 结账页顶部发起 |
payment_fee |
String |
支付服务费 |
shipping_method_id |
Number |
货运方式 ID |
shipping_method_name |
String |
货运方式名称 |
note |
String |
订单备注 |
cancelled_at |
Number |
取消时间(Unix 时间戳),0 = 未取消 |
cancel_reason |
Number |
取消原因:1 = 用户取消,2 = 后台取消 |
payed_at |
Number / String |
支付时间,0 表示未支付;已支付时为时间字符串 YYYY-MM-DD HH:mm:ss |
created_at |
String |
创建时间,格式 YYYY-MM-DD HH:mm:ss |
updated_at |
String |
最后更新时间,格式 YYYY-MM-DD HH:mm:ss |
billing_is_use_shipping_address |
Number |
账单地址是否使用收货地址:1 = 是,2 = 否 |
step |
Number |
结账步骤:1 = 已创建,2 = 已填地址,3 = 已选货运,4 = 已选支付,5 = 已发起支付,6 = 支付完成 |
recall_status |
Number |
召回状态(order_info 层级):1 = 不可召回,2 = 可召回,3 = 已召回 |
recalled_at |
String / Number |
召回成功时间,时间字符串或 0 |
recall_send_email_count |
Number |
召回邮件发送次数 |
recall_send_email_time |
Number |
召回邮件最后发送时间戳 |
fulfilled_at |
Number |
发货时间(多包裹时取最后一个包裹的发货时间) |
post_saled_at |
Number |
进入售后处理的时间 |
post_sale_status |
Number |
售后状态(order_info 层级):1 = 初始,2 = 售后处理中,3 = 售后已完成,4 = 售后已存档 |
tags |
Array |
标签数组,如 ["432423", "321312321"],无标签时为 null |
over_sold_count |
Number |
超卖个数 |
is_stock_deducted |
Number |
是否已扣除库存:1 = 是,2 = 否 |
fist_loading_url |
String |
用户首次访问的页面 URL |
affiliate_tracking_id |
String |
网盟商唯一编码 |
remark |
String |
顾客提交的备注信息 |
is_rebate |
Number |
是否满减活动订单:1 = 是,2 = 否 |
payafteruse |
Boolean |
是否先用后付订单 |
items |
Array |
订单商品明细 |
shippingAddress |
Object |
收货地址 |
billingAddress |
Object / Null |
账单地址,未单独设置时为 null |
clientDetails |
Object |
客户端详情 |
txnid |
Object / Null |
支付交易详情,未支付时为 null |
order_info.items — 商品明细
| 字段 |
类型 |
说明 |
id |
Number |
订单商品记录 ID |
order_id |
Number |
所属订单 ID |
shop_id |
Number |
所属店铺 ID |
product_id |
Number |
商品 ID |
variant_id |
Number |
规格变体 ID |
spu |
String |
商品 SPU |
sku |
String |
规格 SKU |
variant_title |
String |
规格名称 |
product_title |
String |
商品标题 |
image |
String |
商品图片路径。可能是相对路径(需拼接基础 URL)或完整 URL |
gram |
String |
单品重量(克) |
base_price |
String |
单品单价(基础货币) |
curr_price |
String |
单品单价(当前货币) |
base_row_tax |
String |
行税费(基础货币) |
curr_row_tax |
String |
行税费(当前货币) |
addition_attr_base_price |
String |
附加属性价格(基础货币) |
addition_attr_curr_price |
String |
附加属性价格(当前货币) |
addition_attr |
String |
附加属性信息 |
glasses_custom_base_price |
String |
眼镜定制价格(基础货币) |
glasses_custom_curr_price |
String |
眼镜定制价格(当前货币) |
glasses_customized |
Object / Null |
眼镜定制信息 |
qty |
Number |
购买数量 |
curr_row_price |
String |
行总金额(当前货币) |
row_gram |
String |
行总重量(克) |
base_row_price |
String |
行总金额(基础货币) |
is_reviewed |
Number |
是否已评价:1 = 已评价,2 = 未评价 |
over_sold_count |
Number |
超卖个数 |
created_at |
Number / String |
创建时间 |
updated_at |
Number / String |
更新时间 |
product_source_id |
String |
商品来源 ID |
variant_source_id |
String |
规格来源 ID |
source_type |
Number |
商品来源:0 = 自建,1 = 1688 |
order_info.shippingAddress — 收货地址
| 字段 |
类型 |
说明 |
id |
Number |
地址记录 ID |
order_id |
Number |
所属订单 ID |
shop_id |
Number |
所属店铺 ID |
first_name |
String |
收货人名字 |
last_name |
String |
收货人姓氏 |
phone |
String |
收货人电话 |
company |
String |
公司名称 |
address_1 |
String |
地址行 1 |
address_2 |
String |
地址行 2 |
city |
String |
城市 |
country_code |
String |
国家简码 |
province_code |
String |
省/州简码 |
province_name |
String |
省/州名称 |
zip |
String |
邮政编码 |
created_at |
Number / String |
创建时间 |
updated_at |
Number / String |
更新时间 |
order_info.billingAddress — 账单地址
| 字段 |
类型 |
说明 |
id |
Number |
地址记录 ID |
shop_id |
Number |
所属店铺 ID |
order_id |
Number |
所属订单 ID |
first_name |
String |
账单联系人名字 |
last_name |
String |
账单联系人姓氏 |
address_1 |
String |
地址行 1 |
address_2 |
String |
地址行 2 |
city |
String |
城市 |
country_code |
String |
国家简码 |
province_code |
String |
省/州简码 |
province_name |
String |
省/州名称 |
zip |
String |
邮政编码 |
created_at |
Number / String |
创建时间 |
updated_at |
Number / String |
更新时间 |
order_info.txnid — 支付交易
| 字段 |
类型 |
说明 |
order_id |
Number |
所属订单 ID |
txn_id |
String |
支付交易号 |
payment_method |
String |
支付方式标识 |
order_info.clientDetails / client_detail — 客户端详情
| 字段 |
类型 |
说明 |
id |
Number |
记录 ID |
order_id |
Number |
所属订单 ID |
shop_id |
Number |
所属店铺 ID |
country_code |
String |
国家代码 |
region_code |
String |
地区代码 |
region_name |
String |
地区名称 |
city |
String |
城市 |
timezone |
String |
时区 |
longitude |
String |
经度坐标 |
latitude |
String |
纬度坐标 |
client_type |
Number |
客户端类型 |
browser_ip |
String |
浏览器 IP |
browser_lang |
String |
浏览器语言 |
browser_height |
String |
浏览器高度 |
browser_width |
String |
浏览器宽度 |
user_agent |
String |
用户代理 |
referring_site |
String |
来源站点 |
fist_loading_url |
String |
首次加载 URL |
created_at |
String |
创建时间 |
updated_at |
String |
更新时间 |
country_name |
Object |
国家名称多语言信息,如 {"name":"","cn_name":""} |
customer_info — 顾客信息
| 字段 |
类型 |
说明 |
first_name |
String |
顾客名字 |
last_name |
String |
顾客姓氏 |
email |
String |
顾客邮箱 |
phone |
String |
顾客电话 |
first_order_date |
String |
首单日期,格式 YYYY-MM-DD HH:mm:ss |
history_order_count |
Number |
历史订单数 |
history_order_product_count |
Number |
历史购买商品数 |
history_order_base_amount |
String |
历史订单总金额(基础货币) |
注意事项
order_number 和 order_id 二选一传入即可查询,两者均可从 Fecify-待处理订单-列表 或 Fecify-未完成订单-列表 获取。
items[].image 可能是相对路径或完整 URL。相对路径时需拼接基础 URL(通过 店铺-存储基础URL 获取)。
recall_status 在顶层和 order_info 中的含义不同:顶层用于列表状态判断,order_info 层用于详情展示。
second_order_items 和 order_is_show_second 仅开启斗篷功能时有效。
paypal_transaction_info 仅 PayPal 支付时返回。
can_* 系列字段表示当前订单可执行的操作,前端可根据这些值控制按钮显隐。
client_detail 与 order_info.clientDetails 数据一致,但 updated_at 字段格式可能不同。
billingAddress 在未单独设置账单地址时为 null。
tags 为数组类型,有标签时如 ["432423", "321312321"],无标签时为 null。