ERP 与订单系统
让税率查询进入订单流程
按订单目的地查询税率，将州、县、市和特别税区的税率明细带入你的业务系统。
Byte Orca / API地址税率查询示例
POST
/external/v2/tax-rate/queryBellevue, WA
98005 · King County州6.5%县2.4%市0%特别税区1.4%
综合税率10.3%
示例订单税额$11.33
演示数据。订单税额用返回税率乘以 $110 示例应税金额得出。
HTTPSX-API-KeyJSON多语言接入示例
为你的业务场景而设计
你的产品体验，接上税率能力。
电商工具与平台
按收货地址查询结算税率
按收货地址查询适用税率，将结果用于购物车和结算流程。
开发团队与 SaaS
用熟悉的 HTTPS 与 JSON 接入
通过 API Key 认证，使用现有技术栈发起请求。开发文档包含多种语言示例及参数说明。
从第一条请求开始
一次请求，返回税率明细
提交州和查询项目。一个请求可查询一条地址，也可批量查询同一州内的多个地址。
一个 ZIP 对应多个税区时
在 items[].address 传入门牌号和街道，并尽量补充城市、县和 ZIP+4。逐项检查 status 和 matchedLevel，ADDRESS 才表示命中地址级。
遇到 NO_MATCH，或只匹配到 ZIP 等较粗层级且业务要求地址级结果时，先核对和补全地址再重试。仍无法确认时，可转人工核对。
cURL 请求示例
curl 'https://{your_api_domain}/external/v2/tax-rate/query' \
-H 'X-API-Key: <your_api_key>' \
-H 'Content-Type: application/json' \
--data '{
"state": "WA",
"items": [{
"itemId": "order-001",
"address": "123 Main St",
"city": "Bellevue",
"county": "King",
"zipCode": "98005"
}]
}'将占位符替换为开通时确认的 API 域名和密钥。请在服务端安全保存密钥。
JSON 响应节选
1{2 "code": 200,3 "msg": "OK",4 "data": {5 "state": "WA",6 "totalCount": 1,7 "successCount": 1,8 "noMatchCount": 0,9 "invalidCount": 0,10 "failedCount": 0,11 "items": [{12 "itemId": "order-001",13 "status": "SUCCESS",14 "matchedLevel": "ADDRESS",15 "mainItem": {16 "taxRate": "10.3",17 "stateTaxRate": "6.5",18 "countyTaxRate": "2.4",19 "cityTaxRate": "0",20 "specialDistrictTaxRate": "1.4"21 }22 }]23 }24}示例仅展示关键字段。税率以百分数的字符串返回，"10.3" 表示 10.3%。
API 定价
按查询量选择 API 套餐
套餐额度按每月成功查询次数计算，价格以美元计。
| 套餐 | 每月成功查询 | 月费 |
|---|---|---|
| 开发测试 | 100 | 免费 |
| Starter | 1,500 | $29 |
| Growth | 5,000 | $59 |
| Scale | 10,000 | $89 |
| Scale Plus | 25,000 | $129 |
| Enterprise | 100,000 | $300 |
| Enterprise Custom | 超过 100,000 | 定制报价 |
额度与计费规则
- 每个返回有效主税率结果的查询项目计 1 次。重复成功查询分别计次，批量查询按成功项目数计次。未返回有效主税率的项目免计。
- 额度按月重置，未用额度当月到期。开发测试额度仅用于接入验证，用完后暂停或升级。
- 预计超额时，请提前联系团队确认升级方案。套餐支持月付或按年预付，年付仍按月分配额度，价格以报价为准。
FAQ
接入前，你可能想了解。
查询税率，需要传订单金额吗？
不需要。提供地点信息即可查询税率。可在你的系统中用返回的税率和应税金额计算税额。
支持街道地址级查询吗？
API 支持提交含门牌号和街道的地址，并返回实际匹配层级。匹配精度取决于当地数据，也可能命中 ZIP 等较粗层级。试用时建议用你的实际业务地址检查覆盖和匹配层级。
API 会返回哪些信息？
API 返回每项查询的状态、实际匹配层级和适用税率，包括可用的州、县、市及特别税区明细。
试用是否自动开通？
提交申请后由团队跟进，确认访问方式与试用条件。提交表单不会自动开通 API，也不会产生扣费。
调用 API 就包含申报服务吗？
这项服务提供税率查询。Nexus 判断、注册及申报可按业务需要另行咨询。