Qeasy Cloud
Get Started

领星ERP 查询订单管理订单列表 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
多平台 · POST · 请求参数 15 个(必填 2) · 响应参数 155 个 · 限流令牌桶容量 10
Updated At
2026-11-21

查询订单管理订单列表

POST/pb/mp/order/v2/list
Factory
{
  "operation": {
    "method": "POST",
    "path": "/pb/mp/order/v2/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 10,
    "text": ""
  },
  "requestExample": {
    "start_time": 1710925191,
    "end_time": 1713430791,
    "date_type": "update_time",
    "offset": 0,
    "length": 20,
    "order_status": 3,
    "store_id": [
      "110418202566107648"
    ],
    "platform_code": [
      10001,
      10002
    ],
    "platform_order_nos": [
      "119834203044003",
      "120073601764065"
    ]
  },
  "responseExample": {
    "code": 0,
    "message": "操作成功",
    "response_time": "2023-09-18 10:37:12",
    "request_id": "532e9175-a6d5-42ab-8744-b5d0d8eaea04.1695004631603",
    "data": {
      "total": "1",
      "list": [
        {
          "global_order_no": "103351413752115712",
          "store_id": "110268822038528000",
          "order_from_name": "线上订单",
          "delivery_type": 2,
          "split_type": "1",
          "status": 4,
          "global_purchase_time": 1693467680,
          "global_payment_time": 1693467680,
          "global_review_time": null,
          "global_distribution_time": null,
          "global_print_time": null,
          "global_delivery_time": 0,
          "amount_currency": "USD",
          "remark": "",
          "global_latest_ship_time": "1693497600",
          "global_cancel_time": 0,
          "update_time": "1693496773",
          "order_tag": [
            {
              "tag_type": "系统处理类型",
              "tag_no": "3-8",
              "tag_name": "商品未配对"
            }
          ],
          "wid": "0",
          "item_info": [
            {
              "id": "8745387",
              "platform_order_no": "CS483128864",
              "order_item_no": "NBRC003BLKOS-MVQ",
              "item_from_name": "线上",
              "msku": "NBRC003BLKOS-MVQ",
              "local_sku": "",
              "product_no": "",
              "local_product_name": "",
              "variant_attr": "",
              "unit_price_amount": "60.00",
              "item_price_amount": "120.00",
              "quantity": 2,
              "remark": "",
              "platform_status": "",
              "type": "产品",
              "stockCost": null,
              "wms_outbound_cost_amount": "0.00",
              "stock_cost_amount": "0.00",
              "cg_price_amount": "0.00",
              "shipping_amount": "0.00",
              "wms_shipping_price_amount": "0.00",
              "customer_shipping_amount": "0.00",
              "discount_amount": "0.00",
              "customer_tip_amount": "0.00",
              "tax_amount": "0.00",
              "sales_revenue_amount": "24.58",
              "transaction_fee_amount": "0.49",
              "other_amount": "0.00",
              "customized_url": null,
              "cod_amount": "0.00",
              "gift_wrap_amount": "0.00",
              "platform_tax_amount": "0.00",
              "points_granted_amount": "0.00",
              "other_fee": "0.00",
              "platform_subsidy_amount": ""
            }
          ],
          "platform_info": [
            {
              "order_from": "线上订单",
              "platform_order_no": "5501270851822",
              "platform_order_name": "#1064",
              "platform_code": "10002",
              "store_Country_code": "US",
              "status": "closed",
              "payment_status": "paid",
              "shipping_status": "fulfilled",
              "purchase_time": 1696929350,
              "payment_time": 1696929349,
              "latest_ship_time": 0,
              "cancel_time": 0,
              "delivery_time": 0
            }
          ],
          "logistics_info": {
            "status": 0,
            "logistics_type_id": "0",
            "logistics_type_name": null,
            "logistics_provider_id": "0",
            "logistics_provider_name": null,
            "actual_carrier": "",
            "waybill_no": "",
            "pre_weight": 0,
            "pre_fee_weight": 0,
            "pre_fee_weight_unit": "g",
            "pre_pkg_length": 0,
            "pre_pkg_height": 0,
            "pre_pkg_width": 0,
            "weight": 0,
            "pkg_fee_weight": 0,
            "pkg_fee_weight_unit": "",
            "pkg_length": 0,
            "pkg_width": 0,
            "pkg_height": 0,
            "weight_unit": "",
            "pkg_size_unit": "",
            "cost_currency_code": "",
            "pre_cost_amount": "-¥0.00",
            "cost_amount": "0",
            "logistics_time": null,
            "tracking_no": "",
            "mark_no": ""
          },
          "transaction_info": [
            {
              "order_item_amount": "¥49.16",
              "customer_tax_amount_show": "¥0.00",
              "discount_amount": "¥0.00",
              "customer_shipping_amount": "¥0.00",
              "customer_tip_amount": "¥0.00",
              "order_total_amount": "¥49.16",
              "cg_price_amount": "¥0.00",
              "stock_cost_amount": "¥0.00",
              "outbound_cost_amount": "¥0.00",
              "wms_outbound_cost_amount": "¥0.00",
              "pre_cost_amount": "-¥0.00",
              "wms_shipping_price_amount": "¥0.00",
              "transaction_fee_amount": "¥-0.98",
              "profit_amount": "¥48.18",
              "other_amount": "¥0.00",
              "cod_amount": "¥0.00",
              "gift_wrap_amount": "¥0.00",
              "platform_tax_amount": "¥0.00",
              "points_granted_amount": "¥0.00",
              "other_fee": "¥0.00",
              "platform_subsidy_amount": ""
            }
          ],
          "original_global_order_no": null,
          "customer_shipping_list": null,
          "exception_order_tag": [],
          "pending_order_tag_order_tag": []
        }
      ]
    }
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1offset分页偏移量integer—Required分页偏移量
2length分页长度integer—Required分页长度,上限500
3date_type时间类型string—Optional时间类型: 更新时间 update_time 订购时间 global_purchase_time 发货时间 global_delivery_time 付款时间 global_payment_time 平台发货时间 delivery_time(附加说明.4) 当且仅当传入平台单号或平台单名称查询时可不必传
4start_time开始时间integer—Optional开始时间,时间戳格式【单位:秒】,双开区间 当且仅当传入平台单号或平台单名称查询时可不必传,查询时间跨度不能超过31天
5end_time结束时间integer—Optional结束时间,时间戳格式【单位:秒】,双开区间 当且仅当传入平台单号或平台单名称查询时可不必传,查询时间跨度不能超过31天
6store_id店铺idarray<any>—Optional店铺id,取值等同于查询多平台店铺信息返回结果的store_id
7platform_code平台codearray<any>—Optional平台code: 10001 AMAZON 10002 Shopify 10003 eBay 10004 Wish 10005 AliExpress 10006 Shopee 10007 Lazada 10008 Walmart 10009 自定义平台 10010 Wayfair 10011 TikTok 10012 MERCADO 10013 CDISCOUNT 10014 NEWEGG 10015 RAKUTEN 10016 SHOPLINE 10017 TEAPPLIX 10018 SHOPLAZZA 10019 UEESHOP 10020 COUPANG 10021 SHEIN 10022 temu全托管 10024 temu半托管 10025 OTTO 10026 OZON 10027 SHEIN全托管 10028 SHEIN半托管 10029 AliExpress半托管 10030 AliExpress全托管 10031 AliExpress海外托管 10033 Qoo10 10034 Mirakl 10025 OTTO 10026 OZON 10027 SHEIN全托管 10028 SHEIN半托管 10029 AliExpress半托管 10030 AliExpress全托管 10033 Qoo10 10034 Mirakl 10035 AMAZON VC 10036 Kaufland 10037 Allegro 10038 Line Shopping 10039 SPS Commerce
8platform_order_nos平台单号列表array<any>—Optional平台单号列表 ,元素不超过200个 以下平台不可用,需要用platform_order_names查询: 10003-ebay 10014-newegg 10020-coupang 10002-shopify 10012-美客多 10016-shopline
9platform_order_names特定平台单号列表array<any>—Optional特定平台单号列表 ,元素不超过200个 10003-ebay 10014-newegg 10020-coupang 10002-shopify 10012-美客多 10016-shopline,使用该字段查询
10tracking_nos跟踪号列表array<any>—Optional跟踪号列表,元素不超过200个
11global_order_nos系统单号array<any>—Optional系统单号
12order_status订单状态integer—Optional订单状态: 1 同步中 2 已同步 3 待付款 4 待审核 5 待发货 6 已发货 7 已取消/不发货 8 不显示 9 平台发货
13platform_shipping_status平台单发货状态array<any>—Optional平台单发货状态 Shopify状态枚举值: fulfilled:已发货,并且全部发货 null:未发货 partial:部分发货 restocked:已退货
14platform_payment_status平台单支付状态array<any>—Optional平台单支付状态 Shopify状态枚举值: pending:待支付 authorized:买家信用卡支付,并且已经确认授权,但是卖家并未收款 partially_paid:已完成部分款项支付 paid:已全部支付完成 partially_refunded:已部分退款 refunded:已全部退款 voided:支付被取消,或支付无效,或支付被撤销,通常出现在订单取消之后
15include_delete是否包含已删除订单boolean—Optional是否包含已删除订单 true 包含 false 不包含

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码int0Required状态码,0 成功
2message提示信息string操作成功Required提示信息
3request_id请求链路idstringad9c1a8625c74f3ea0525e216374e31a1676514819613Required请求链路id
4response_time响应时间string2023-02-16 10:33:40Required响应时间
5data响应数据object—Required响应数据
5.1total总数int1Required总数
5.2list详细列表array—Required详细列表
5.2.1store_id店铺idstring—Required店铺id
5.2.2site_code站点string10001-UKOptional站点
5.2.3wid仓库idstring1Required仓库id
5.2.4reference_no平台参考号string1Required平台参考号
5.2.5global_order_no系统单号string—Required系统单号 系统本地唯一订单号
5.2.6original_global_order_no补发订单原系统单号string—Required补发订单原系统单号
5.2.7customer_shipping_list客选物流列表array[""]Optional客选物流列表
5.2.8amount_currency币种string—Required币种
5.2.9remark客服备注string—Required客服备注
5.2.10order_from_name订单来源string—Required订单来源
5.2.11status系统订单状态int—Required系统订单状态: 1 同步中 2 已同步 3 未付款 4 待审核 5 待发货 6 已发货 7 已取消/不发货 8 不显示 9 平台发货
5.2.12flow_node系统流转节点(仅用于细粒度状态判断)int—Required系统流转节点(仅用于细粒度状态判断) 平台发货订单(且已发货):status=9 && flow_node=11
5.2.13status_sub二级状态(仅用于细粒度状态判断)int—Required二级状态(仅用于细粒度状态判断) 冻结订单:status=4 && status_sub=5
5.2.14split_type拆分单类型string—Required拆分单类型: 1 原始单 2 合并单 3 拆分单
5.2.15delivery_type发货方式int2Required发货方式: 1 混合方式【中转值,最终会转为2或3】 2 自发货 3 平台发货【指由平台仓库自动完成履约的订单,如Walmart的WFS订单】
5.2.16supplier_idWayfair平台对订单指定的发货仓库 IDstring—RequiredWayfair平台对订单指定的发货仓库 ID,店铺后台称为 Supplier ID
5.2.17vc_warehouse_codeAmazon VC 仓库代码stringGYTNOptionalAmazon VC 仓库代码
5.2.18vc_ship_methodAmazon VC 运输方式stringUPS_GR_RESOptionalAmazon VC 运输方式
5.2.19update_time订单更新时间string—Required订单更新时间
5.2.20global_purchase_time订购时间int—Required订购时间
5.2.21global_review_time审核时间int—Required审核时间
5.2.22global_cancel_time取消时间int—Required取消时间
5.2.23global_delivery_time发货时间int—Required发货时间
5.2.24global_distribution_time配货时间int—Required配货时间
5.2.25global_latest_ship_time发货时限string—Required发货时限
5.2.26global_payment_time付款时间int—Required付款时间
5.2.27global_print_time打单时间int—Required打单时间
5.2.28global_mark_time标发时间int—Required标发时间
5.2.29order_custom_fields订单自定义字段object—Optional订单自定义字段
5.2.30item_info商品信息array—Required商品信息
5.2.30.1id系统商品唯一idstring—Required系统商品唯一id
5.2.30.2global_item_no商品行系统唯一键string—Required商品行系统唯一键
5.2.30.3item_from_name商品来源string—Required商品来源 1 线上 2 本地 3 本地(自定义平台导入带MSKU商品,可换货)
5.2.30.4customer_shipping_amount客付运费string—Required客付运费,币种取amount_currency
5.2.30.5customer_tip_amountShopify小费string—RequiredShopify小费,币种取amount_currency
5.2.30.6discount_amount折扣string—Required折扣,币种取amount_currency
5.2.30.7item_price_amount商品金额string—Required商品金额,币种取amount_currency
5.2.30.8local_skulocal_skustring—RequiredSKU
5.2.30.9mskumskustring—RequiredMSKU
5.2.30.10local_product_name品名string—Required品名
5.2.30.11product_no亚马逊返回asinstring—Required亚马逊返回asin,多平台返回平台商品id
5.2.30.12order_item_no订单明细单号string—Required订单明细单号
5.2.30.13platform_order_no平台单号string—Required平台单号
5.2.30.14platform_status平台订单商品状态string—Required平台订单商品状态
5.2.30.15quantity数量int—Required数量
5.2.30.16remark商品备注string—Required商品备注
5.2.30.17customized_url亚马逊定制商品文件下载链接string—Required亚马逊定制商品文件下载链接
5.2.30.18sales_revenue_amount销售收益string—Required销售收益
5.2.30.19stockCost商品出库成本string—Required商品出库成本
5.2.30.20tax_amount商品税费string—Required商品税费,币种取amount_currency
5.2.30.21transaction_fee_amount商品交易费string—Required商品交易费,币种取amount_currency
5.2.30.22type商品类型string—Optional商品类型
5.2.30.23unit_price_amount单价string—Required单价,币种取amount_currency
5.2.30.24variant_attr变体属性string—Required变体属性
5.2.30.25wms_outbound_cost_amount实际出库成本string67.56Required实际出库成本,币种CNY,取自销售出库单出库成本
5.2.30.26stock_cost_amount库存明细成本string67.56Required库存明细成本,币种CNY,取自订单创建时库存明细计算成本
5.2.30.27cg_price_amount采购成本string65.00Required采购成本,币种CNY,取自产品管理固定值
5.2.30.28shipping_amount预估运费string2984.42Required预估运费,币种CNY
5.2.30.29wms_shipping_price_amount实际运费string¥9.17Required实际运费,取自销售出库单运费,币种取自data>>list>>logistics_info>>cost_currency_code
5.2.30.30is_bundled是否为捆绑产品int0Required是否为捆绑产品: 1 是 0 否
5.2.30.31sub_products子产品object—Required子产品
5.2.30.31.1sku子产品SKUString—Required子产品SKU
5.2.30.31.2qty子产品发货数量int—Required子产品发货数量
5.2.30.32title商品标题string—Required商品标题
5.2.30.33other_amount平台其他费用string0.00Required平台其他费用,币种取amount_currency
5.2.30.34cod_amountCOD费用string14.00RequiredCOD费用,币种取amount_currency
5.2.30.35gift_wrap_amount礼品包装费string300.00Required礼品包装费,币种取amount_currency
5.2.30.36platform_tax_amount销售税string0.00Required销售税,币种取amount_currency
5.2.30.37points_granted_amount积分成本string0.00Required积分成本,币种取amount_currency
5.2.30.38other_fee其他费用string4.00Required其他费用,用户手动按系统订单导入,有正有负
5.2.30.39delivery_time平台发货时间string—Optional平台发货时间,当前仅支持Shopify平台,查询条件满足"platform_code":["10002"] && "date_type":"delivery_time"才返回此字段
5.2.30.40platform_subsidy_amountplatform_subsidy_amountstring—Optional平台补贴(目前仅TikTok、Shopee支持返回))
5.2.30.41location_idShopify发货仓库IDstring—OptionalShopify发货仓库ID
5.2.30.42source_nameShopify销售渠道string—OptionalShopify销售渠道
5.2.30.43data_json扩展字段(json)string—Optional扩展字段(json)
5.2.30.44stock_deduct_id备货店铺IDstring—Optional备货店铺ID
5.2.30.45stock_deduct_name备货店铺名称string—Optional备货店铺名称
5.2.30.46item_custom_fields订单产品自定义字段object—Optional订单产品自定义字段
5.2.31logistics_info物流信息object—Required物流信息
5.2.31.1actual_carrier实际承运人string—Required实际承运人
5.2.31.2cost_amount物流实际运费string—Required物流实际运费
5.2.31.3cost_currency_code物流实际运费币种codestring—Required物流实际运费币种code
5.2.31.4logistics_provider_id物流商idint—Required物流商id
5.2.31.5logistics_provider_name物流商名称string—Required物流商名称
5.2.31.6logistics_time物流下单成功时间int—Required物流下单成功时间
5.2.31.7logistics_type_id物流方式idstring—Required物流方式id
5.2.31.8logistics_type_name物流方式名称string—Required物流方式名称
5.2.31.9pkg_fee_weight实际计费重量number—Required实际计费重量
5.2.31.10pkg_fee_weight_unit实际计费重单位string—Required实际计费重单位
5.2.31.11pkg_height实际包裹高number—Required实际包裹高
5.2.31.12pkg_length实际包裹长number—Required实际包裹长
5.2.31.13pkg_size_unit包裹尺寸单位string—Required包裹尺寸单位
5.2.31.14pkg_width实际包裹宽number—Required实际包裹宽
5.2.31.15pre_cost_amount预估运费 负string—Required预估运费 负
5.2.31.16pre_fee_weight预估计费重量number—Required预估计费重量
5.2.31.17pre_fee_weight_unit预估计费重单位string—Required预估计费重单位
5.2.31.18pre_pkg_height预估包裹高(cm)number—Required预估包裹高(cm)
5.2.31.19pre_pkg_length预估包裹长(cm)number—Required预估包裹长(cm)
5.2.31.20pre_pkg_width预估包裹宽(cm)number—Required预估包裹宽(cm)
5.2.31.21pre_weight预估重量(g)number—Required预估重量(g)
5.2.31.22status状态int—Required状态: 0 待物流下单 1 物流下单中 2 成功 3 失败 4 已取消
5.2.31.23tracking_no跟踪号string—Required跟踪号
5.2.31.24waybill_no物流商返回的物流单号string—Required物流商返回的物流单号
5.2.31.25owms_waybill_no仓配分离场景下的海外仓运单号string—Required仓配分离场景下的海外仓运单号
5.2.31.26weight实际重量(g)number—Required实际重量(g)
5.2.31.27weight_unit包裹实际重量单位string—Required包裹实际重量单位
5.2.32order_tag标签+处理类型array—Required标签+处理类型
5.2.32.1tag_name标签名称string—Required标签名称
5.2.32.2tag_no标签编号string—Required标签编号
5.2.32.3tag_type标签类型string—Required标签类型: 1 自定义处理类型 2 自定义订单标签 3 系统处理类型 4 系统订单标签
5.2.33exception_order_tag异常类型标签array—Required异常类型标签
5.2.34pending_order_tag待办类型标签array—Required待办类型标签
5.2.35platform_info平台单信息array—Required平台单信息
5.2.35.1cancel_time取消单时间int—Required取消单时间
5.2.35.2delivery_time平台发货时间int—Required平台发货时间
5.2.35.3latest_ship_time最后发货时间int—Required最后发货时间
5.2.35.4order_from订单来源string—Required订单来源
5.2.35.5payment_status平台单支付状态string—Required平台单支付状态
5.2.35.6payment_time支付时间int—Required支付时间
5.2.35.7platform_code平台CODEint—Required平台CODE
5.2.35.8platform_order_name平台订单编号string—Required平台订单编号 【具体见附加说明】
5.2.35.9platform_order_no平台订单号string—Required平台订单号
5.2.35.10purchase_time订购时间int—Required订购时间
5.2.35.11shipping_status状态string—Required状态
5.2.35.12status平台单状态string—Required平台单状态
5.2.35.13store_Country_code订单国家(二位iso_3166_1)string—Required订单国家(二位iso_3166_1)
5.2.36transaction_info交易信息array—Required交易信息
5.2.36.1customer_shipping_amount客付运费string—Required客付运费,币种取amount_currency
5.2.36.2customer_tax_amount_show客付税费string—Required客付税费,币种取amount_currency
5.2.36.3customer_tip_amount小费string—Required小费,币种取amount_currency
5.2.36.4discount_amount折扣string—Required折扣,币种取amount_currency
5.2.36.5order_item_amount商品金额string—Required商品金额,币种取amount_currency
5.2.36.6order_total_amount订单总额string—Required订单总额,币种取amount_currency
5.2.36.7outbound_cost_amount预估出库成本string—Required预估出库成本 币种默认CNY
5.2.36.8pre_cost_amount预估运费string—Required预估运费 币种默认CNY
5.2.36.9transaction_fee_amount交易费string—Required交易费,币种取amount_currency
5.2.36.10profit_amount预估毛利润string—Required预估毛利润,币种取amount_currency
5.2.36.11other_amount平台其他费string¥0.00Required平台其他费
5.2.36.12cg_price_amount采购成本string-¥77.00Required采购成本,币种CNY,取自产品管理固定值
5.2.36.13stock_cost_amount库存明细成本string-¥80.07Required库存明细成本,币种CNY,取自订单创建时库存明细计算成本
5.2.36.14wms_outbound_cost_amount实际出库成本string-¥80.07Required实际出库成本,币种CNY,取自销售出库单出库成本
5.2.36.15wms_shipping_price_amount实际运费string-¥11.00Required实际运费,币种CNY,取自销售出库单出库运费
5.2.36.16cod_amountCOD费用stringJP¥14.00RequiredCOD费用,币种取amount_currency
5.2.36.17gift_wrap_amount礼品包装费stringJP¥601.00Required礼品包装费,币种取amount_currency
5.2.36.18platform_tax_amount销售税stringJP¥0.00Required销售税,币种取amount_currency
5.2.36.19points_granted_amount积分成本string-JP¥31.00Required积分成本,币种取amount_currency
5.2.36.20other_fee其他费用 用户手动按系统订单导入stringJP¥10.00Required其他费用 用户手动按系统订单导入,有正有负
5.2.36.21platform_subsidy_amountplatform_subsidy_amountstring—Optional平台补贴(目前仅TikTok、Shopee支持返回))

The 查询订单管理订单列表 API (/pb/mp/order/v2/list) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.