轻易云
注册体验

领星ERP查询订单管理订单列表接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
多平台 · POST · 请求参数 15 个(必填 2) · 响应参数 155 个 · 限流令牌桶容量 10
更新日期
2026-11-21

查询订单管理订单列表

POST/pb/mp/order/v2/list
加工厂
{
  "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": []
        }
      ]
    }
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1offset分页偏移量integer—必填分页偏移量
2length分页长度integer—必填分页长度,上限500
3date_type时间类型string—可选时间类型: 更新时间 update_time 订购时间 global_purchase_time 发货时间 global_delivery_time 付款时间 global_payment_time 平台发货时间 delivery_time(附加说明.4) 当且仅当传入平台单号或平台单名称查询时可不必传
4start_time开始时间integer—可选开始时间,时间戳格式【单位:秒】,双开区间 当且仅当传入平台单号或平台单名称查询时可不必传,查询时间跨度不能超过31天
5end_time结束时间integer—可选结束时间,时间戳格式【单位:秒】,双开区间 当且仅当传入平台单号或平台单名称查询时可不必传,查询时间跨度不能超过31天
6store_id店铺idarray<any>—可选店铺id,取值等同于查询多平台店铺信息返回结果的store_id
7platform_code平台codearray<any>—可选平台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>—可选平台单号列表 ,元素不超过200个 以下平台不可用,需要用platform_order_names查询: 10003-ebay 10014-newegg 10020-coupang 10002-shopify 10012-美客多 10016-shopline
9platform_order_names特定平台单号列表array<any>—可选特定平台单号列表 ,元素不超过200个 10003-ebay 10014-newegg 10020-coupang 10002-shopify 10012-美客多 10016-shopline,使用该字段查询
10tracking_nos跟踪号列表array<any>—可选跟踪号列表,元素不超过200个
11global_order_nos系统单号array<any>—可选系统单号
12order_status订单状态integer—可选订单状态: 1 同步中 2 已同步 3 待付款 4 待审核 5 待发货 6 已发货 7 已取消/不发货 8 不显示 9 平台发货
13platform_shipping_status平台单发货状态array<any>—可选平台单发货状态 Shopify状态枚举值: fulfilled:已发货,并且全部发货 null:未发货 partial:部分发货 restocked:已退货
14platform_payment_status平台单支付状态array<any>—可选平台单支付状态 Shopify状态枚举值: pending:待支付 authorized:买家信用卡支付,并且已经确认授权,但是卖家并未收款 partially_paid:已完成部分款项支付 paid:已全部支付完成 partially_refunded:已部分退款 refunded:已全部退款 voided:支付被取消,或支付无效,或支付被撤销,通常出现在订单取消之后
15include_delete是否包含已删除订单boolean—可选是否包含已删除订单 true 包含 false 不包含

接口响应参数

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

领星ERP的接口:查询订单管理订单列表(/pb/mp/order/v2/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。