SPOTTER API
  1. 订单
SPOTTER API
  • 文档说明
    • 简介
    • 版本日志
    • 开发指南
    • API认证
    • 业务说明
      • 运输商编码列表
  • 开放能力
    • 商品
      • 查询报价协议
      • 查询产品信息
    • 订单
      • 可售库存
        • 查询可售库存
        • 编辑渠道库存
      • 查询订单
        POST
      • 创建多渠道订单
        POST
      • 取消发货
        POST
    • 物流
      • 查询VC物流
      • 查询承运商
    • 报告
      • 查询VC库存报告
      • 查询VC销售诊断
      • 查询VC销售预测
      • 查询VC实时销量
    • 仓储
      • 仓库配置
        • 查询仓库列表
      • 入库
        • 查询入库单列表
        • 查询入库箱唛列表
        • 创建入库单
        • 创建待发货入库单
        • 分页查询入库单
      • 库存
        • 查询库存
        • 分页查询库龄汇总
        • 分页查询库龄明细
      • 出库
        • 查询出库通知单列表
    • 广告
      • 查询SP推广商品
      • 查询SD推广商品
      • 查询SB广告
    • 促销
      • 查询促销活动-COUPON
  1. 订单

查询订单

POST
https://openapi.spotterio.com/api/v1/page_vc_order

请求参数

Header 参数
X-Site-Tenant
string 
必需
渠道租户(多渠道场景将AMZ替换为SPT,如US_SPT):
US_AMZ:美国亚马逊,时区:America/Los_Angeles
CA_AMZ:加拿大亚马逊,时区:America/Vancouver
DE_AMZ:德国亚马逊,时区:Europe/Berlin
GB_AMZ:英国亚马逊,时区:Europe/London
FR_AMZ:法国亚马逊,时区:Europe/Paris
IT_AMZ: 意大利亚马逊,时区:Europe/Rome
ES_AMZ:西班牙亚马逊,时区:Europe/Madrid
示例值:
US_AMZ
Body 参数application/json
current_page
integer 
当前页数
必需
>= 1
page_size
integer 
展示条数
必需
<= 100
type
string 
可选
订单类型(必须与type_list二选一,否则会报系统错误):
PO:PO订单
DI:DI订单
DF:DF订单
MO:多渠道一件代发订单
FBA:多渠道FBA订单
type_list
array[string]
可选
订单类型列表(必须与type二选一,否则会报系统错误)
status_list
array[string]
可选
订单状态列表:
New(待确认):未确认的新订单
Pending(待提交):已接单或下单时间+20小时内未进行接单,且暂未提交至三方平台,支持调整接单信息的订单
Unshipped(待创建出库单):已将接单结果提交到三方平台,待创建出库单
Picked(待取件):已创建出库单,待承运商取件,该状态下订单可以通过fo_no关联VC物流查询发货信息
Shipped(在途中):仓库已发货,未到货的订单产品状态
Delivered(已到货):追踪物流轨迹,已到货订单产品状态
Cancelled(已取消):已提交且接单数量为0的订单产品状态
plt_order_name_list
array[string]
可选
销售单号列表(仅支持多渠道以及AMZ-DF场景)
fo_no_list
array[string]
可选
履约单号列表,订单状态为Picked、Shipped、Delivered才会有该单号
spt_no_list
array[string]
可选
Spotter订单号列表
ssku_list
array[string]
可选
Spotter Sku列表
plt_sku_list
array[string]
可选
平台Sku列表:
Asin:亚马逊标准识别号(Amazon Standard Identification Number)
ordered_on_ms_start
integer 
可选
下单时间戳起始(ms)
ordered_on_ms_end
integer 
可选
下单时间戳结束(ms)
created_at_start
integer 
可选
订单在spotter创建时间戳起始(ms)
created_at_end
integer 
可选
订单在spotter创建时间戳结束(ms)
updated_at_start
integer 
可选
订单更新时间戳起始(ms)
updated_at_end
integer 
可选
订单更新时间戳结束(ms)
order_source
string 
可选
渠道订单来源:
Amz_Auto:亚马逊自动订单
Amz_Manual:亚马逊手动订单
Amz_Batch:亚马逊批量订单
示例
{
    "current_page": 1,
    "page_size": 20
}

返回响应

🟢200成功
application/json
Body
code
integer 
响应码
必需
msg
string 
异常信息
可选
resp_data
object 
响应数据
可选
current_page
integer 
当前页数
必需
page_size
integer 
展示条数
必需
total_num
integer 
总条数
必需
total_page
integer 
总页数
必需
data
array [object {30}] 
必需
trace_id
string 
必需
示例
{
    "code": 0,
    "msg": "string",
    "resp_data": {
        "current_page": 0,
        "page_size": 0,
        "total_num": 0,
        "total_page": 0,
        "data": [
            {
                "id": "string",
                "order_type": "string",
                "order_source": "string",
                "fo_no": "string",
                "spt_no": "string",
                "plt_no": "string",
                "plt_order_name": "string",
                "status": "string",
                "ordered_quantity": 0,
                "confirmed_quantity": 0,
                "ssku": "string",
                "plt_sku": "string",
                "msku": "string",
                "brand_name": "string",
                "product_name": "string",
                "ordered_on_ms": 0,
                "storage_code": "string",
                "storage_name": "string",
                "for_ready_day_ms": 0,
                "expected_delivered_day_ms": 0,
                "actual_shipping_ms": 0,
                "actual_delivered_ms": 0,
                "window_start_ms": 0,
                "window_end_ms": 0,
                "po_ship_info": {
                    "ship_to": "string",
                    "ship_type": "string",
                    "window_start_ms": 0,
                    "window_end_ms": 0
                },
                "ship_to_address": {
                    "country_code": "string"
                },
                "logistics_info_list": [
                    {
                        "carrier": "string",
                        "tracking_num": "string"
                    }
                ],
                "spt_cost_price": {
                    "cent": 0,
                    "currency_code": "string"
                },
                "created_at": 0,
                "updated_at": 0
            }
        ]
    },
    "trace_id": "string"
}
修改于 2025-06-05 15:45:22
上一页
编辑渠道库存
下一页
创建多渠道订单
Built with