一、先完成API授权与权限确认
要通过Wish API获取订单数据，第一步不是直接调接口，而是确认商户账号具备API访问权限。登录Wish商户平台后，进入账户设置下的API管理页面，创建应用后会得到client_id和client_secret。这两个值相当于接口的身份标识，需妥善保存，尤其是client_secret不要在浏览器控制台或前端代码中暴露。
拿到密钥后，按照Wish的OAuth2授权流程获取access_token。调用订单接口时，请求头需要携带Authorization: Bearer加空格再加access_token。注意不同接口版本对权限要求不同，订单读取权限是基础，若还要获取物流、税务扩展信息，建议在创建应用时勾选相关权限。正式调用前可使用Wish提供的测试环境进行联调，确认返回结构无误后再切换到生产环境。
如果使用Windows服务器保存密钥文件，路径中的反斜杠必须原样处理，例如D:\wish_keys\client_secret.txt，不能写成D:/wish_keys/client_secret.txt，否则部分语言读取路径时会失败。
二、调用订单接口并定位报关字段
Wish订单API通常提供按订单号查询和按时间批量查询两种方式。按订单号查询适合处理少量异常订单，批量查询适合每天同步欧盟路向订单。接口地址可在Wish商户平台API文档中查看，常见的HTTP GET地址为https://merchant.wish.com/api/v3/orders和https://merchant.wish.com/api/v3/orders/订单ID。
批量请求时，建议携带以下参数：destination_country用于按目的国筛选，limit控制每页数量，since和until限定更新时间范围，states限定订单状态。比如只拉取已发货但尚未完成清关的订单，可以把states设置为SHIPPED。需要特别注意，欧盟路向不是单一国家筛选，而是要覆盖欧盟27个成员国，因此实际操作中可以把27国代码维护成一个列表，循环请求或拉取全量后在本地过滤。
- destination_country：目的国代码，如FR、DE、NL、ES等
- since/until：订单更新时间区间，避免每次全量拉取
- limit与offset：控制分页，防止单次返回数据过大导致超时
- states：订单状态筛选，减少无关数据
返回数据中，与欧盟海关报关相关的信息主要分布在订单顶层和订单明细节点。顶层通常包含订单号、目的国、币种、总金额、收件人姓名和地址；订单明细节点通常包含商品名称、SKU、数量、单价、重量、尺寸以及申报价值。原产国和HS编码是否直接返回，取决于商品创建时是否填写了海关信息。如果商品资料里缺少这些内容，API返回可能为空，需要先在Wish商户后台补充完善。
2.1 欧盟海关关键字段对应
下面把欧盟海关最常核查的项目与API返回字段做一个对应，方便对接报关单或电子清关系统。
| 欧盟海关核查项目 | API返回字段方向 | 处理要点 |
|---|---|---|
| 收件人姓名 | 订单顶层ship_to对象中的name | 必须与身份证件一致 |
| 收件人地址 | ship_to中的address、city、zipcode、country | 必须精确到街道和门牌号 |
| 商品申报品名 | 订单明细中的product_name | 建议用英文，避免模糊描述 |
| HS编码 | 订单明细或商品海关资料中的hs_code | 至少保证前6位准确 |
| 原产国 | 订单明细中的origin_country | 必须真实反映生产地 |
| 数量与单位 | 订单明细中的quantity | 与物流面单一致 |
| 申报价值 | 订单明细中的unit_price、total_price，币种为currency | 不得低报或高报 |
| 重量 | 订单明细中的weight | 区分毛重和净重 |
| IOSS编号 | 平台税务设置或订单扩展字段 | 货值不超过150欧元时使用 |
上表中的字段路径在不同API版本中可能略有差异，接入时应以Wish官方文档和实际返回为准。不要只依赖字段名称猜测，最好先拉取一单完整JSON并打印结构，确认每个字段所在层级。
三、欧盟海关最关心的申报要点
从欧盟境外发货进入欧盟，海关会重点核对三项：一是品名是否清晰具体，二是HS编码与品名是否匹配，三是申报价值是否合理。品名如果只写gift或accessories，极可能被要求补充申报，延误清关。HS编码如果错位，可能触发额外查验甚至罚款。因此API返回的product_name和hs_code不能直接照搬，需要和实物进行校验。
另外，IOSS规则的适用也直接影响申报方式。如果订单符合平台代征增值税条件，Wish会提供IOSS编号，报关时需要将该编号提交给物流商或海关系统。此时申报价值应填写销售给买家的实际成交价，而不是成本价。若订单不符合IOSS条件，则可能需要由收件人缴纳进口增值税和关税，卖家需在发货前清楚告知买家，避免拒收。
原产国和HS编码是脆弱的两个点，一旦不一致，欧盟海关可能认定申报不实。API拉到的数据如果来自商品资料，需确保商品资料中的原产国是按实际生产地维护，而不是默认填成中国或随便选一个。同一店铺不同SKU要分别维护，不能批量套用。
四、筛选欧盟路向订单并做批量处理
实际操作中，卖家通常不是逐单手工查，而是每天定时通过API把欧盟路向订单拉下来，导出成CSV或直接推送报关系统。建议在服务器上设置定时任务，例如每天上午和下午各同步一次，覆盖最近24小时的订单更新。Windows服务器导出的文件路径可以写成D:\wish_customs\eu_orders.csv，注意路径中的反斜杠要按原样书写，避免被转义。
筛选时先按destination_country排除非欧盟国家，再按订单状态排除已取消和已退款订单。欧盟27国代码包括AT、BE、BG、HR、CY、CZ、DK、EE、FI、FR、DE、GR、HU、IE、IT、LV、LT、LU、MT、NL、PL、PT、RO、SK、SI、ES、SE。可以把这些代码维护在配置文件中，每次拉取时循环调用接口，或者一次性拉取全量后在本地程序里过滤。
导出前建议做几项校验：收件人国家代码是否在欧盟清单内、订单币种是否统一、金额是否为正值、HS编码是否为空。发现空字段时先回商户后台补全商品资料，再重新拉取该订单。不要为了赶时效把空HS编码直接提交给物流商，否则清关时仍会被拦截。
五、常见问题与避坑建议
一是接口权限不足。部分店铺只开通了基础订单读取，但拿不到税务或物流扩展字段，会导致IOSS编号缺失。此时应检查应用权限，确认已勾选税务相关读取权限。二是字段为空的概率不低，尤其是HS编码和原产国。Wish的商品资料中如果有海关信息维护入口，要先维护好再调用API，否则接口返回中这些节点可能直接不存在。
三是频率限制和分页问题。接口通常有QPS或每日调用上限，连续暴力请求可能触发限流。建议加入指数退避重试，并用分页参数逐页拉取，不要一次设置超大limit。四是数据时差。订单状态更新可能存在几分钟到十几分钟延迟，如果API刚拉到订单还是未付款状态，先不要用于报关。五是IOSS编号必须与订单匹配，不能一个店铺所有订单共用一个编号且不判断货值，否则可能被海关视为无效申报。
最后提醒，API只是数据搬运工具，不能替代商品资料的合规维护。欧盟海关对申报信息的要求会随贸易政策调整，卖家应定期查看Wish商户平台公告和目的国海关要求。把API返回字段与正式报关单字段做好映射之后，自动化流程才能稳定运行。
Wish API订单查询欧盟海关报关信息跨境订单数据接口 修改时间：2026-10-06 04:17:20