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_numberorder_id 二选一传入即可。

认证

请求头中需要携带 skill-access-token

Header
skill-access-token {your-skill-access-token} (请替换为你自己的 token)

请求参数

参数 类型 必填 说明
order_number String 二选一 订单编号,从 Fecify-待处理订单-列表Fecify-未完成订单-列表 获取
order_id Number 二选一 订单 ID,来源同上

请求示例

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'

返回结果

code200 表示成功;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_statuspayment_statusfulfillment_statuspost_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 历史订单总金额(基础货币)

注意事项

  1. order_numberorder_id 二选一传入即可查询,两者均可从 Fecify-待处理订单-列表Fecify-未完成订单-列表 获取。
  2. items[].image 可能是相对路径或完整 URL。相对路径时需拼接基础 URL(通过 店铺-存储基础URL 获取)。
  3. recall_status 在顶层和 order_info 中的含义不同:顶层用于列表状态判断,order_info 层用于详情展示。
  4. second_order_itemsorder_is_show_second 仅开启斗篷功能时有效。
  5. paypal_transaction_info 仅 PayPal 支付时返回。
  6. can_* 系列字段表示当前订单可执行的操作,前端可根据这些值控制按钮显隐。
  7. client_detailorder_info.clientDetails 数据一致,但 updated_at 字段格式可能不同。
  8. billingAddress 在未单独设置账单地址时为 null
  9. tags 为数组类型,有标签时如 ["432423", "321312321"],无标签时为 null

results matching ""

    No results matching ""