mcpField
I
international-shipping

international-shipping

github.com/finsilabs其他60183 次安装6 天前更新
代码仓库

关于 international-shipping

面向拓展国际业务的电商运营者与开发者,梳理 Shopify、WooCommerce、BigCommerce 和自定义平台的国际运输配置。内容包括 HS 编码、关税税费、海关单据及目的地限制筛查。

主要功能

  1. 01为商品配置 HS 编码
  2. 02设置 DDP 或 DDU 税费
  3. 03生成国际运输海关单据
  4. 04筛查受限商品和目的地

适用场景

  1. 01为跨境订单估算落地成本
  2. 02减少因海关资料缺失造成的延误
  3. 03在结账时拦截受限商品订单

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/finsilabs/awesome-ecommerce-skills --skill international-shipping

安装后在 Claude Code 中输入/international-shipping确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

tile.json
evals/customs-declaration-form-generation/
criteria.json
task.md
evals/duties-estimation-and-de-minimis-thresho/
criteria.json
task.md
evals/product-schema-setup-and-restriction-scr/
criteria.json
task.md

详细介绍

国际运输

概述

国际运输不只是选择承运商那么简单——你还需要处理海关申报、关税和税费(在结账时向客户显示到岸成本,可以避免令人不快的意外)、为每件产品归类 HS 编码,并筛查在某些国家/地区禁止运输的物品。处理不当会导致包裹滞留海关、客户收到意外账单,以及品牌声誉受损。

本技能将介绍如何在各大平台上设置国际运输,包括选择合适的关税和税费工具,以及生成海关表单。

何时使用此技能

  • 从国内运输拓展到国际运输并需要处理海关申报时
  • 提供完税后交货(DDP),让客户在结账时看到完整到岸成本时
  • 构建需要 HS 编码以准确归类关税的产品目录时
  • 在处理国际运输订单前筛查受限物品时
  • 与报关行或承运商(EasyPost、Shippo、Easyship、Flexport)集成时

核心说明

步骤 1:确定平台并选择合适的国际运输工具
平台推荐工具原因
ShopifyShopify Markets + Zonos Duty & Tax 或 Global-eShopify Markets 可处理多币种和本地化结账;Zonos/Global-e 可提供准确的 DDP 到岸成本
WooCommerceWooCommerce Shipping + Easyship plugin 或 Zonos for WooCommerceEasyship 提供包括国际运输在内的多承运商费率;Zonos 负责处理关税和税费
BigCommerceBigCommerce Multi-Currency + Easyship 或 Avalara AvaTax Cross-Border内置多币种功能可处理定价;Easyship/Avalara 可提供关税估算
自定义 / 无头架构EasyPost 或 Shippo 生成运单 + Zonos 或 Avalara 估算关税使用承运商聚合平台生成运单;使用到岸成本 API 处理关税和税费
步骤 2:为所有产品分配 HS 编码

每件国际运输商品的海关申报都必须填写 HS(协调制度)编码。缺少编码会导致海关延误。

Shopify
  1. 前往 Products → [Product] → Shipping
  2. 在“Customs information”下,填写 HS tariff code(6–10 位)和 Country/Region of origin
  3. 对于大型目录:导出产品 CSV(Products → Export),批量填写 Variant HS Code 和 Variant Origin Country 列,然后重新导入

常见的电商 HS 编码:

  • 6109.10 — 棉质 T 恤
  • 6109.90 — 合成纤维 T 恤
  • 6404.11 — 运动鞋
  • 8471.30 — 笔记本电脑
  • 9503.00 — 玩具
  • 3304.99 — 化妆品

如需 HS 编码归类帮助,请使用:

  • Zonos Hello(zonos.com/hs-code 上的免费工具)——粘贴产品描述即可获取建议的 HS 编码
  • Avalara TariffFinder——免费的在线 HS 编码查询工具
  • Schedule B Search Engine(美国人口普查局)——美国出口的权威查询工具
WooCommerce
  1. 前往 Products → [Product] → Shipping tab
  2. 大多数运输插件(ShipStation、Easyship)会在此处添加自定义 HS 编码和原产国字段
  3. 如果插件没有添加这些字段,请安装 WooCommerce Extra Product Options,或使用 Custom Fields 元框为每件产品存储 _hs_code 和 _country_of_origin
BigCommerce
  1. 前往 Products → [Product] → Shipping
  2. 在“Harmonized System Code”字段中填写 HS 编码(所有套餐均可见)
  3. 在“Country of Manufacture”字段中填写原产国
步骤 3:配置关税和税费(DDP 与 DDU)

DDP(完税后交货): 客户在结账时支付关税——最有利于转化率,也不会产生意外费用。 DDU(未完税交货): 客户在送达时支付关税——会增加购买阻力和退货率。

在主要国际市场始终应优先采用 DDP。

Shopify

使用 Shopify Markets(DDP):

  1. 前往 Settings → Markets → International markets
  2. 启用你要发货到的每个国家/地区,并设置货币
  3. 对于关税:从 App Store 安装 Zonos Duty & Tax 或 Global-e
  4. Zonos 可与 Shopify Markets 结账流程集成,并将准确的关税金额显示为单独的项目
  5. 在 Zonos 设置中,配置哪些市场显示 DDP(在结账时收取关税),哪些显示 DDU

注意: Shopify 内置的国际配送功能不会自动计算关税——你需要使用 Zonos 或 Global-e 才能实现此功能。

WooCommerce
  1. 从 WordPress.org 或 easyship.com 安装 Easyship plugin
  2. 在 Easyship 设置中,启用“Show duties and taxes at checkout”
  3. Easyship 会根据目的地国家/地区和你的 HS 编码计算关税
  4. 客户会在结账时看到关税预估金额,作为单独的项目显示

面向较大规模业务的替代方案: 使用 Zonos Checkout for WooCommerce plugin,确保到岸成本准确无误。

BigCommerce
  1. 从 BigCommerce App Marketplace 安装 Avalara AvaTax Cross-Border
  2. 使用你的发货地地址配置 Avalara,并启用跨境税费计算
  3. Avalara 会在结账时显示关税预估金额;升级到其 DDP 产品即可确保到岸成本准确无误
第 4 步:设置国际标签创建及海关表单

承运商要求每个国际包裹都附上海关申报单(价值低于 $400 的物品使用 CN22;更高价值的物品使用 CN23/商业发票)。

Shopify
  • 为国际订单购买标签时,Shopify Shipping 会自动生成海关表单
  • 前往 Orders → [Order] → Fulfill items,Shopify 会显示根据产品 HS 编码预填的海关信息表单
  • 如有需要,请检查并调整申报价值(使用售价,不要降低申报价值——为规避关税而申报较低价值属于违法行为)
  • 对于订单量大的业务:ShipStation(Shopify App Store)或 Easyship 可批量生成海关表单,并与所有主要承运商(DHL、FedEx、UPS、USPS)集成
WooCommerce
  • WooCommerce Shipping(由 WooCommerce Shipping & Tax plugin 提供支持)可为 USPS 和 DHL Express 标签生成海关表单
  • 前往 WooCommerce → Shipments → Create Label,选择一个订单——海关字段会根据产品数据自动填充
  • 如需覆盖所有承运商:使用 ShipStation 或 Easyship plugins,它们可处理所有承运商的海关表单
BigCommerce
  • ShipStation(BigCommerce App Marketplace)可处理所有承运商的海关表单,并内置 BigCommerce 订单同步功能
  • Easyship(BigCommerce App Marketplace)也支持多承运商国际标签,并能自动生成海关表单
第 5 步:拦截受限和违禁商品

某些产品无法运送到特定国家/地区(枪械零件、酒类、某些电子产品)。

Shopify
  1. 使用 Shopify Markets 按产品设置国家/地区的销售范围:
    • 前往 Products → [Product] → Sales channels
    • 为受限产品禁用特定市场
  2. 如需全面的限制清单:安装 Fraud Filter,或使用 Shopify Flow(Plus)标记将受限产品运往受限国家/地区的订单
  3. Geoipfy 等应用可针对受限国家/地区与产品的组合重定向或拦截结账
WooCommerce
  1. 使用 WooCommerce Shipping Restrictions plugin,阻止将特定产品运送到特定国家/地区
  2. 前往 Products → [Product] → Shipping tab,按国家/地区设置“Shipping restrictions”
  3. 如需按订单拦截:在 WooCommerce → Settings → General → Selling location(s) 中使用 WooCommerce 内置的“Restrict to countries”
BigCommerce
  1. 前往 Products → [Product] → Shipping
  2. 将“Free Shipping”设为禁用,并使用自定义配送规则拦截特定目的地
  3. 如需全面拦截:使用 ShipperHQ 应用,它支持基于区域的配送限制
自定义 / 无头
// Screen cart for restricted items before allowing checkout to proceed
async function screenForRestrictions(params: {
  orderLines: { productId: string; hsCode?: string }[];
  destinationCountry: string;
}): Promise<{ allowed: boolean; blockedItems: string[] }> {
  const blockedItems: string[] = [];

  // Common restrictions — seed these from a country-restrictions database
  const RESTRICTIONS: Record<string, string[]> = {
    AU: ['9305'],    // Firearm parts
    IN: ['2207'],    // Alcohol (requires import licence)
    CN: ['8517'],    // Consumer electronics require CCC certification
  };

  const countryRestrictions = RESTRICTIONS[params.destinationCountry] ?? [];

  for (const line of params.orderLines) {
    if (!line.hsCode) continue;
    const hsPrefixBlocked = countryRestrictions.some(prefix => line.hsCode!.startsWith(prefix));
    if (hsPrefixBlocked) {
      blockedItems.push(line.productId);
    }
  }

  return { allowed: blockedItems.length === 0, blockedItems };
}

最佳实践

  • 启用国际配送前,为每件商品分配 HS 编码 — 缺少 HS 编码是导致海关延误最常见的原因;可使用 Zonos 或 Avalara 分类工具进行批量分配
  • 收件地址中务必填写电话号码 — 大多数国际承运商都要求提供收件人电话号码;应将其设为所有非国内配送地址的必填项
  • 为最重要的 5 个国际市场提供 DDP — 结账时能看到完整到岸成本的客户,转化率显著高于收货时才收到关税账单的客户
  • 遵守最低免税额度 — 低于最低免税额度的订单(美国:$800;英国:£135;欧盟:€150;澳大利亚:AUD $1,000)通常免征关税;大多数 DDP 应用会自动处理
  • 海关申报品名应通用但准确 — “棉质 T 恤”比品牌名称更有利于快速通关;避免使用可能需要特殊许可证的描述
  • 扩大业务前,先用真实国际订单进行测试 — 向每个新国家寄送测试订单,并在当地开展营销活动前跟踪其通关情况

常见问题

问题解决方案
未为国际订单生成海关表格确保配送应用中的所有商品记录都包含 HS 编码和原产国;缺少这些字段是最常见的原因
结账时估算的关税与实际征收的关税不同使用 DDP 服务提供商(Zonos、Global-e)确保准确性;使用 DDU 时,将估算金额标注为“估算值”
包裹创建面单并在运输途中后,才发现禁运商品在结账时而非履约时筛查限制;对于受限的国家 / 商品组合,应阻止结账
包裹因“需要提供海关信息”而被退回所有国际货件都需要海关表格,即使是低价值货件也不例外;配置配送应用,确保向非国内目的地发货时始终附上海关数据

相关技能

  • @order-fulfillment-workflow
  • @shipment-tracking
  • @shipping-rate-calculator
  • @same-day-delivery
  • @order-management-system

评论

支持 Markdown