订单-详细

得到订单的详细信息

接口信息

  • 接口地址: {your-site-url}/api/skill/order/get-order-info
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
  • 请求方式: GET
  • 说明: 此接口用于获取指定订单的详细信息，包含订单基本数据、商品明细、收货/账单地址、支付交易、快递物流、客户信息、操作权限等完整字段。

认证

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

Header 值
skill-access-token {your-skill-access-token} （请替换为你自己的 token）

请求参数 (Query String)

字段 类型 必填 说明
order_number string 否 订单编号（order_number 和 order_id 至少有一个有值）
order_id int 否 订单 ID（order_number 和 order_id 至少有一个有值）

查询优先级：如果 order_number 有值，则优先通过 order_number 查询；如果 order_number 为空，则通过 order_id 查询。两者至少有一个必须有值。

请求示例

按订单编号查询

curl --location --request GET '{your-site-url}/api/skill/order/get-order-info?order_number=E528504573115869' \
--header 'skill-access-token: {your-skill-access-token}'

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": {
        "order_info": {
            "id": 6409,
            "shop_id": 15,
            "order_number": "E528504573115869",
            "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": "EUR",
            "order_to_base_rate": "1.00",
            "curr_subtotal": "315.00",
            "base_subtotal": "315.00",
            "base_tips": "94.50",
            "curr_tips": "94.50",
            "base_insurance": "0.00",
            "curr_insurance": "0.00",
            "base_tax": "0.00",
            "curr_tax": "0.00",
            "curr_shipping_total": "9.00",
            "base_shipping_total": "9.00",
            "curr_subtotal_with_discount": "0.00",
            "base_subtotal_with_discount": "0.00",
            "curr_grand_total": "418.50",
            "base_grand_total": "418.50",
            "customer_type": 1,
            "customer_id": 539,
            "customer_email": "1186735711@qq.com",
            "customer_phone": "13133333333",
            "coupon_code": "",
            "discount_set": {
                "coupon": {
                    "coupon_code": "",
                    "curr_discount_amount": 0,
                    "base_discount_amount": 0
                }
            },
            "payment_method": "Payzl",
            "payment_name": "Payzl Inside",
            "payment_position_type": 1,
            "payment_fee": "0.00",
            "shipping_method_id": 49,
            "shipping_method_name": "价格运费",
            "note": "",
            "cancelled_at": 0,
            "cancel_reason": 0,
            "payed_at": "2026-05-28 14:41:40",
            "created_at": "2026-05-28 14:40:57",
            "updated_at": "2026-05-28 14:41:26",
            "billing_is_use_shipping_address": 1,
            "step": 6,
            "recall_status": 3,
            "recalled_at": "2026-05-28 14:41:40",
            "recall_send_email_count": 0,
            "recall_send_email_time": 0,
            "fulfilled_at": 0,
            "post_saled_at": 0,
            "post_sale_status": 1,
            "tags": null,
            "over_sold_count": 0,
            "is_stock_deducted": 1,
            "fist_loading_url": "https://diydomain.fecmall.cn/",
            "affiliate_tracking_id": "affffffff",
            "remark": "",
            "is_rebate": 2,
            "shippingAddress": {
                "id": 4300,
                "shop_id": 15,
                "order_id": 6409,
                "first_name": "张",
                "last_name": "三",
                "phone": "13133333333",
                "company": "",
                "address_1": "辽源路街道",
                "address_2": "4-4-403",
                "city": "青岛",
                "country_code": "AX",
                "province_code": "",
                "zip": "266300",
                "created_at": 1779950457,
                "updated_at": 1779950486
            },
            "billingAddress": null,
            "clientDetails": {
                "id": 5596,
                "order_id": 6409,
                "shop_id": 15,
                "country_code": "",
                "region_code": "",
                "region_name": "",
                "city": "",
                "timezone": "",
                "longitude": "",
                "latitude": "",
                "client_type": 1,
                "browser_ip": "112.226.41.191",
                "browser_lang": "en-US",
                "browser_height": "1168",
                "browser_width": "1710",
                "user_agent": "Chrome",
                "referring_site": "https://diydomain.fecmall.cn/search",
                "fist_loading_url": "https://diydomain.fecmall.cn/",
                "created_at": 1779950457,
                "updated_at": 1779950457
            },
            "txnid": {
                "order_id": 6409,
                "txn_id": "N202605281441407207042",
                "payment_method": "payzl"
            },
            "items": [
                {
                    "id": 7795,
                    "shop_id": 15,
                    "order_id": 6409,
                    "product_id": 7036,
                    "variant_id": 48940,
                    "spu": "",
                    "sku": "crossbody-bag-black-backpack-0",
                    "variant_title": "",
                    "product_title": "Crossbody bag black backpack",
                    "image": "/product/15/image/2026/05/23/42fb5fc3d3f7af099f78ae558ab36347.jpg",
                    "gram": "0.00",
                    "base_price": "315.00",
                    "curr_price": "315.00",
                    "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": "315.00",
                    "row_gram": "0.00",
                    "base_row_price": "315.00",
                    "is_reviewed": 2,
                    "over_sold_count": 0,
                    "created_at": 1779950457,
                    "updated_at": 1779950486,
                    "product_source_id": "",
                    "variant_source_id": "",
                    "source_type": 0
                }
            ],
            "payafteruse": false
        },
        "second_order_items": [],
        "order_is_show_second": true,
        "paypal_transaction_info": "",
        "post_sale_curr_refunded_amount": "0.00",
        "final_curr_grand_total": "418.50",
        "status": {
            "order_status": 2,
            "payment_status": 3,
            "fulfillment_status": 1,
            "post_sale_status": 1
        },
        "pay_txn_id": "N202605281441407207042",
        "customer_info": {
            "first_name": "张",
            "last_name": "三",
            "email": "1186735711@qq.com",
            "phone": "+1 13144444444",
            "first_order_date": "2025-11-06 11:25:52",
            "history_order_count": 92,
            "history_order_product_count": 105,
            "history_order_base_amount": "13214.09"
        },
        "client_detail": {
            "id": 5596,
            "order_id": 6409,
            "shop_id": 15,
            "country_code": "",
            "region_code": "",
            "region_name": "",
            "city": "",
            "timezone": "",
            "longitude": "",
            "latitude": "",
            "client_type": 1,
            "browser_ip": "112.226.41.191",
            "browser_lang": "en-US",
            "browser_height": "1168",
            "browser_width": "1710",
            "user_agent": "Chrome",
            "referring_site": "https://diydomain.fecmall.cn/search",
            "fist_loading_url": "https://diydomain.fecmall.cn/",
            "created_at": "2026-05-28 14:40:57",
            "updated_at": "2026-05-28 14:40:57",
            "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 bool 是否展示二库订单商品数据。true = 展示，false = 不展示
paypal_transaction_info string PayPal 交易信息（仅 PayPal 支付时有数据）
post_sale_curr_refunded_amount string 订单退款金额（当前货币）
final_curr_grand_total string 订单最终支付金额（当前货币）= 订单金额 - 退款金额
status Object 订单各状态汇总
pay_txn_id string 订单支付交易号
customer_info Object 订单顾客信息
client_detail Object 客户端详细信息
fulfillments Array 快递物流信息
post_sale_status int 订单售后状态
can_cancel bool 是否可以进行订单取消操作
can_archived bool 是否可以进行订单归档操作
can_cancel_archived bool 是否可以进行取消归档操作
can_change_address bool 是否可以修改收货地址
can_change_discount bool 是否可以更改优惠
can_remove_discount bool 是否可以删除优惠
is_customer_complete_order bool 顾客是否已完成订单（订单是否已召回）
recall_status int 召回状态。待处理订单返回 0；未完成订单：1 = 找回中，2 = 未召回，3 = 召回失败
can_fulfill bool 是否可以进行订单发货操作
can_receive bool 是否可以进行订单收货操作
order_post_sale_id int 订单售后 ID。0 表示无售后
post_sale_can_refund bool 是否可以进行售后-仅退款操作
post_sale_can_return bool 是否可以进行售后-仅退货操作
post_sale_can_refund_and_return bool 是否可以进行售后-退货并退款操作

order_info - 订单基本信息

字段 类型 说明
order_info.id int 订单 ID
order_info.shop_id int 店铺 ID
order_info.order_number string 订单编号
order_info.client_type int 客户端类型。1 = PC，2 = 平板，3 = 手机，4 = 后台创建，5 = 外部导入
order_info.order_status int 订单状态。1 = 结账初始，2 = 已创建/进入订单流程，3 = 归档，4 = 已取消
order_info.payment_status int 支付状态。1 = 初始，2 = 待支付，21 = 等待支付审核，3 = 已支付，4 = 部分退款，5 = 已全部退款
order_info.fulfillment_status int 发货/履行状态。1 = 初始，2 = 未发货，3 = 挂起，4 = 部分发货，5 = 已全部发货，6 = 部分收货，7 = 全部收货，8 = 已全部退货
order_info.checkout_type int 结账类型。1 = 购物车结账，2 = 立即购买，3 = 后台创建
order_info.cart_id int 购物车 ID
order_info.lang_code string 用户访问网站的语言
order_info.items_count int 订单商品总件数
order_info.gram string 订单总重量（克）
order_info.currency_code string 下单当前货币
order_info.base_currency_code string 店铺基础货币
order_info.order_to_base_rate string 当前货币与基础货币的汇率
order_info.curr_subtotal string 订单商品总额（当前货币）
order_info.base_subtotal string 订单商品总额（基础货币）
order_info.base_tips string 订单小费（基础货币）
order_info.curr_tips string 订单小费（当前货币）
order_info.base_insurance string 保险费用（基础货币）
order_info.curr_insurance string 保险费用（当前货币）
order_info.base_tax string 税费（基础货币）
order_info.curr_tax string 税费（当前货币）
order_info.curr_shipping_total string 订单运费（当前货币）
order_info.base_shipping_total string 订单运费（基础货币）
order_info.curr_subtotal_with_discount string 订单折扣（当前货币）
order_info.base_subtotal_with_discount string 订单折扣（基础货币）
order_info.curr_grand_total string 订单总额（当前货币）
order_info.base_grand_total string 订单总额（基础货币）
order_info.customer_type int 客户类型。1 = 游客，2 = 注册用户
order_info.customer_id int 下单用户 ID
order_info.customer_email string 下单用户邮箱
order_info.customer_phone string 用户手机号
order_info.coupon_code string 优惠券码
order_info.discount_set Object 折扣信息（JSON 格式，含优惠券满减折等）
order_info.payment_method string 支付方式标识
order_info.payment_name string 支付方式名称
order_info.payment_position_type int 支付发起位置。1 = 标准结账，2 = 购物车直接发起，3 = 产品页发起，4 = 结账页顶部发起
order_info.payment_fee string 支付服务费
order_info.shipping_method_id int 货运方式 ID
order_info.shipping_method_name string 货运方式名称
order_info.note string 订单备注
order_info.cancelled_at string/int 取消时间。0 表示未取消
order_info.cancel_reason int 取消原因。1 = 用户取消，2 = 后台取消
order_info.payed_at string/int 支付时间。0 表示未支付
order_info.created_at string 创建时间
order_info.updated_at string 最后更新时间
order_info.billing_is_use_shipping_address int 账单地址是否使用收货地址。1 = 是，2 = 否
order_info.step int 结账步骤。1 = 已创建，2 = 已填写收货地址，3 = 已填写货运方式，4 = 已填写支付方式，5 = 已发起支付，6 = 支付完成
order_info.recall_status int 召回状态。1 = 不可召回，2 = 可召回，3 = 已召回
order_info.recalled_at string/int 召回成功时间
order_info.recall_send_email_count int 召回邮件发送次数
order_info.recall_send_email_time int 召回邮件最后一次发送时间
order_info.fulfilled_at int 发货时间（多个包裹时为最后一个包裹的发货时间）
order_info.post_saled_at int 进入售后处理的时间
order_info.post_sale_status int 售后状态。1 = 初始，2 = 售后处理中，3 = 售后已完成，4 = 售后已存档
order_info.tags string/null 标签，多个以 `\ \ \ ` 分隔
order_info.over_sold_count int 超卖个数
order_info.is_stock_deducted int 是否已扣除库存。1 = 是，2 = 否
order_info.fist_loading_url string 用户首次访问的页面 URL
order_info.affiliate_tracking_id string 网盟商唯一编码
order_info.remark string 顾客提交的备注信息
order_info.is_rebate int 是否满减活动订单。1 = 是，2 = 否
order_info.payafteruse bool 是否先用后付订单

order_info.items - 订单商品明细

字段 类型 说明
order_info.items[].id int 订单商品记录 ID
order_info.items[].order_id int 所属订单 ID
order_info.items[].product_id int 商品 ID
order_info.items[].variant_id int 规格变体 ID
order_info.items[].spu string 商品 SPU
order_info.items[].sku string 规格 SKU
order_info.items[].variant_title string 规格变体名称
order_info.items[].product_title string 商品标题
order_info.items[].image string 商品图片。可能是相对路径或完整 URL。相对路径需拼接 attachment_url
order_info.items[].gram string 单品重量（克）
order_info.items[].base_price string 单品单价（基础货币）
order_info.items[].curr_price string 单品单价（当前货币）
order_info.items[].qty int 购买数量
order_info.items[].curr_row_price string 行总金额 = 单价 × 数量（当前货币）
order_info.items[].row_gram string 行总重量（克）
order_info.items[].base_row_price string 行总金额（基础货币）
order_info.items[].base_row_tax string 行税费（基础货币）
order_info.items[].curr_row_tax string 行税费（当前货币）
order_info.items[].is_reviewed int 是否已评价。1 = 已评价，2 = 未评价
order_info.items[].over_sold_count int 超卖个数
order_info.items[].source_type int 商品来源类型。0 = 自建，1 = 1688
order_info.items[].product_source_id string 商品来源 ID
order_info.items[].variant_source_id string 规格来源 ID

order_info.shippingAddress - 收货地址

字段 类型 说明
order_info.shippingAddress.id int 地址记录 ID
order_info.shippingAddress.order_id int 所属订单 ID
order_info.shippingAddress.first_name string 收货人名字
order_info.shippingAddress.last_name string 收货人姓氏
order_info.shippingAddress.phone string 收货人电话
order_info.shippingAddress.company string 公司名称
order_info.shippingAddress.address_1 string 地址行 1
order_info.shippingAddress.address_2 string 地址行 2
order_info.shippingAddress.city string 城市
order_info.shippingAddress.country_code string 国家简码
order_info.shippingAddress.province_code string 省/州简码
order_info.shippingAddress.province_name string 省/州名称
order_info.shippingAddress.zip string 邮政编码

order_info.txnid - 支付交易

字段 类型 说明
order_info.txnid Object/null 支付交易信息。未支付时为 null
order_info.txnid.order_id int 所属订单 ID
order_info.txnid.txn_id string 支付交易号
order_info.txnid.payment_method string 支付方式标识

order_info.clientDetails / client_detail - 客户端详情

字段 类型 说明
~.id int 记录 ID
~.order_id int 所属订单 ID
~.country_code string 国家代码
~.region_code string 地区代码
~.region_name string 地区名称
~.city string 城市
~.timezone string 时区
~.browser_ip string 浏览器 IP
~.browser_lang string 浏览器语言
~.browser_height string 浏览器高度
~.browser_width string 浏览器宽度
~.user_agent string 用户代理
~.referring_site string 来源站点
~.fist_loading_url string 首次加载 URL

customer_info - 顾客信息

字段 类型 说明
customer_info.first_name string 顾客名字
customer_info.last_name string 顾客姓氏
customer_info.email string 顾客邮箱
customer_info.phone string 顾客电话
customer_info.first_order_date string 首单日期
customer_info.history_order_count int 历史订单数
customer_info.history_order_product_count int 历史购买商品数
customer_info.history_order_base_amount string 历史订单总金额（基础货币）

注意事项

  1. order_number 和 order_id 二选一传入即可查询
  2. items[].image 为相对路径时，完整图片 URL = attachment_url + image
  3. recall_status 在 data 顶层和 order_info 中的含义不同：
    • data.recall_status：待处理订单返回 0；未完成订单返回 1/2/3
    • order_info.recall_status：1 = 不可召回，2 = 可召回，3 = 已召回
  4. second_order_items 和 order_is_show_second 仅开启斗篷功能时有效
  5. paypal_transaction_info 仅 PayPal 支付时返回
  6. can_* 系列字段表示当前订单可执行的操作，前端可根据这些值控制按钮显隐
Copyright © fecify.com 2025 all right reserved，powered by Gitbook该文件修订时间： 2026-06-01 23:21:24

results matching ""

    No results matching ""