飞书多维表格对接全流程

Tariffin 暴露一个 webhook(https://tariffin.com/api/lark/classify), 它接受商品名 + 目的国,返回 HS 编码、关税率、落地成本。飞书多维表格的「自动化流程」可以监听某一列变化, 调用 webhook,把返回值写到指定列。整个过程是这样:

按下表新增 8 个字段。前 4 个是「你填的」,后 4 个会被自动填(暂时留空)。 字段名可以改,但要和后面自动化里映射的一致。

在多维表格右上角点 ⚙️ 自动化 → 「新建流程」→ 选「从空白开始」。然后按下面 3 步配置。

{
  "product_name": "{{商品名}}",
  "destination": "{{目的国}}",
  "declared_value_usd": {{申报货值(USD)}},
  "origin": "{{原产国}}"
}

POST https://tariffin.com/api/lark/classify

请求头

Authorization: Bearer tfk_xxxxxxxxxxxxxxxxxxxxxxxx
content-type: application/json

请求体字段

完整请求示例

curl -X POST https://tariffin.com/api/lark/classify \
  -H "Authorization: Bearer tfk_xxxxxxxxxxxxxxxxxxxx" \
  -H "content-type: application/json" \
  -d '{
    "product_name": "便携蓝牙音箱,塑料外壳,USB-C,5W",
    "destination": "US",
    "declared_value_usd": 1000,
    "origin": "CN"
  }'

字段定义

完整响应示例

{
  "hs_code": "851829",
  "description_en": "Other loudspeakers, single",
  "description_zh": "其他扬声器,单声道",
  "confidence": 0.92,
  "reasoning": "便携蓝牙音箱,塑料外壳,USB-C 充电,5W 输出 → 归入 HS 8518.29(其他扬声器,单只)。",
  "mfn_rate": 0.024,
  "full_code": "8518.29.80",
  "source": "USITC HTS",
  "source_url": "https://hts.usitc.gov/?query=8518.29",
  "landed_cost_usd": 1117.6,
  "landed_cost_local": 1117.6,
  "currency": "USD",
  "effective_rate_percent": 2.4,
  "detected_language": "zh",
  "provider": "deepseek",
  "latency_ms": 1843
}

8.1 多目的国对比

想一次比对同一商品在 13 国的关税?在飞书里建一个「目的国」单选填多个值的写法不太可行 —— 推荐的做法是:多维表格用「关联表」,主表填商品,从表为该商品 × 13 个国家 13 条记录, 每条记录的「目的国」不同,自动化逐条触发。这样每次只调 1 个国家,响应快、容易排错。

8.2 批量回填存量数据

如果你已经有一张 1000 行的旧表想批量归类:打开自动化的「修改触发条件」, 临时改成「定时触发,每天 8 点扫描所有空 HS 字段并补充」,跑完后再切回「按需触发」。 注意 60 次/分钟限制,1000 行预计需要 ~17 分钟。

8.3 多个团队成员共用

推荐每个团队成员或每个使用场景签发独立的 API 密钥(在 Dashboard 里给密钥起不同名称, 如「张三-生产」「李四-测试」)。这样:

• 密钥使用量、最近调用时间分别统计
• 某人离职 → 撤销他的密钥,不影响其他人
• 限流按密钥分桶,互不抢配额

8.4 在脚本里使用同一 webhook

这个 webhook 本质就是 REST API,不局限于飞书。任何能发 HTTP 请求的工具都可以调: Python requests、n8n、Zapier、Bash 脚本,只要带上 Bearer 密钥就行。

8.5 在线测试

配置自动化之前,先在 Dashboard → 飞书集成 → Webhook 测试 输入一个商品名一键调用,确认你账号的密钥能正常工作。