¶ Nimbus 清关申报、轨迹与税金查询操作指引
本指引适用于员工端使用 Nimbus 提交小包及空运主提单清关资料，并查询小包轨迹、税金和取消申报。请按“配置接口 → 补齐资料 → 封包 → 创建航班 → 查询结果”的顺序操作。
Nimbus 在“转单 API”中维护配置，但此处用于清关申报，不是替代原有的承运商取号打单。封包成功不等于海关放行；税金查询在主单提示成功，也不等于每票子单已经入账。
¶ 按你的工作找步骤
- 接口管理员：先完成第二节的三组接口配置，再按第三节核对资料。
- 操作同事：接口已配置好时，从第三节开始；第四至八节分别介绍小包申报、主单申报、轨迹、税金和取消。
- 财务同事：重点看第七节，税金入账要到每票子单检查。
本文截图取自旧版员工端。先读步骤，再按红色箭头点击；编号仅表示本张图的位置。 深色区域是已遮挡的账号、单号和业务资料。配置图使用空白表单演示，结果图仅说明查看位置，不代表已申报成功或已查到税金。图片可点击放大。
¶ 操作顺序
首次使用：配置清关申报 → 配置轨迹 → 配置税金 → 关联业务使用的配置。
每批货物：补齐小包资料 → 订舱并补齐主单资料 → 封包提交小包 → 创建航班提交主提单 → 查询轨迹、税金 → 核对逐票结果。
只需取消申报时，直接看第八节；不要通过删除本地单号来代替取消。
¶ 一、开始前准备
请先由管理员确认：
- 本机构已开通 Nimbus，能够选择 Nimbus 模板；需要现场选择申报账号时，已启用“自定义封包及航班 API 配置”。如果模板不可选或显示需开通，请联系系统管理员或客服，不要用其他模板替代。
- 已取得服务商提供的 App Key、Secret、尾程承运商，以及适用的申报类型；账号与使用环境一致，并已获小包申报、主提单申报、取消、轨迹及税金等所需接口权限。
- 操作账号具有相应的接口配置、封包／解封、创建／删除航班、轨迹及运单回传权限。
- 已准备好真实的收发件人、商品、包号、主提单、航班及结算代理资料。
¶ 功能与操作入口
| 要做什么 | 员工端入口 | 到哪里检查结果 |
|---|---|---|
| 提交小包清关资料 | 包号 → 封包 | 包号封包状态、包内运单的封包报文 |
| 提交空运主提单及关联子单 | 空运出口 → 创建航班 | 主单“其他单号1”、创建航班报文 |
| 查询小包清关轨迹 | 轨迹接口配置 Nimbus，再使用运单轨迹查询入口 | 对应小包运单的轨迹、抓取监控及报文 |
| 查询并保存税金 | 小包或空海运主单 → 运单回传 → 手动回传 | 各子单回传报文、日志及应付费用 |
| 取消小包申报 | 包号 → 解封 | 各票取消结果、解封报文及包号状态 |
| 取消主提单申报 | 空运出口 → 删除航班 | 主单取消航班报文及“其他单号1” |
这里的“小包申报”可用于系统中的快递、小包、专线运单，不是只能在“小包”模块操作。主提单申报仅支持空运出口；可从海运主单派发税金查询，不代表支持海运创建航班申报。
¶ 二、配置三个独立接口
申报、轨迹、税金分开配置。填写了一处凭据，不会自动替另外两处填写。
¶ 2.1 清关申报配置
第1步：点击右上角“菜单”。
第2步：点击“报价管理”。 位置见上一张图的编号2。
第3步：点击报价管理顶部的“转单 API”。 不选“查价API”。
第4步：确认当前在“转单API”页签。
第5步：点击底部“添加”。
第6步：在“基本”页签填写模板名称。 例如“Nimbus清关申报”，便于后续选择。
第7步：在“模板”下拉框选择“Nimbus”。
第8步：点击“Nimbus参数”页签。
第9步：填写 App Key、Secret 和尾程承运商。
第10步：选择本次业务的申报类型。
第11步：按下面的参数表补齐公式。
第12步：点击“确定”保存。
第13步：重新打开配置，核对所填资料是否保留。
图中为新建配置的实际界面，App Key、Secret 已遮挡。公式按下表的申报类型填写，不要为了通过校验随意填固定值。
| 参数 | 如何填写 |
|---|---|
| App Key、Secret | 使用 Nimbus 为当前环境提供的有效凭据 |
| 尾程承运商 | 按 Nimbus 要求填写，不能仅凭本系统渠道名称猜测 |
| 申报类型 | 在 T01、T11、T86、ECCF 中选择实际业务适用的一种 |
| 主提单发票号公式 | T01 必填，结果应为当前空运主提单的发票号 |
| 商品出口国家公式 | T01 必填，按当前商品的实际出口国家配置 |
| 制造商地址、城市、国家公式 | T01、T11 必填，按各商品的实际制造商资料配置 |
公式由熟悉本机构资料的管理员维护：商品公式读取当前商品，发票号公式读取当前空运主提单。固定文字需使用英文单引号，例如国家代码固定值写成 'CN'；只有实际资料确实相同，才可使用固定值。制造商名称、邮编、MID 和证书引用读取已有商品资料，不是全部通过这些公式填写。
保留原取号接口： 开启手选功能后，在封包和创建航班时选择本次 Nimbus 配置即可，无需把子单原来用于取号的转单／换单 API 改成 Nimbus。未开启手选的机构，仍沿用按子单渠道取配置的原方式；需要分开取号与申报时，先由管理员核对开通情况。
¶ 2.2 轨迹配置
第1步：点击“菜单”中的“轨迹接口”。 位置见总入口图的编号3。
第2步：在“基本”页签的“接口”下拉框选择“Nimbus”。
第3步：点击“参数”页签。
第4步：填写轨迹查询的 App Key。
第5步：填写轨迹查询的 Secret。
第6步：返回“基本”页签核对抓取条件和天数。
第7步：点击“确定”保存。
第8步：为需要查询的运单指定 Nimbus。 操作入口见第六节。
以上为当前界面实拍。Nimbus 轨迹凭据独立维护，不会自动读取封包配置。
¶ 2.3 税金查询配置
第1步：进入“报价管理”。
第2步：点击顶部“转单 API”，打开“报价对接设置”。
第3步：切换到“运单回传”页签。 不是“轨迹回传”。
第4步：点击底部“添加”。
第5步：在“API名称”中选择“Nimbus税金回传”。
第6步：填写便于识别的模板名称。
第7步：将“回传事件”仅设为“手动回传”。 空选或全选会监听全部事件，不要留空。
第8步：填写 App Key、Secret。
第9步：选择“税金应付费用科目”。 例如经财务确认的“关税”；科目需要提前在“费用名称”中维护。它表示查回来的税金在本系统记作哪一项应付费用。
第10步：点击“确定”保存。
第11步：在“报价管理”找到业务实际使用的代理渠道，打开渠道详情。
第12步：切换到“基本”页签。
第13步：在“运单回传”中选择刚保存的“Nimbus税金回传”配置。 是“运单回传”，不是上一行“轨迹回传”。
第14步：点击“确认”保存。
第15步：核对本次小包或主单使用的渠道和回传配置。 新增接口不会自动替所有运单绑定；若单票另有自定义配置，也要核对。
税金通过“手动回传”主动查询，不会因配置成功而自动定时抓取。费用币种固定为 USD，请勿为了凑平金额将其他币种直接按美元填写。
¶ 三、补齐申报资料
¶ 3.1 在小包运单中补资料
第1步：进入该票所属的“快递”“小包”或“专线”出口列表。
第2步：找到该票，双击打开运单详情。
第3步：点击“基本”页签。
第4步：点击底部“修改”。
第5步：核对客户单号、转单号、换单号、包号及发货实重。 按下面清单逐项核对，不要用别的号码代填。
第6步：向下找到收件人和发件人资料，补齐真实信息。
第7步：核对申报币种为 USD。
第8步：展开“申报信息”，核对商品资料。
第9步：点击“保存”。
¶ 每票小包检查清单
| 资料 | 检查要求 |
|---|---|
| 客户单号 | 必须填写；同一主单下不能重复 |
| 转单号 | 必须填写，作为尾程跟踪号码提交 |
| 换单号 | 有值时一并提交，不用拿客户单号代填 |
| 包号 | 每票必须对应唯一、非空包号，且与本次选择的包号一致 |
| 发货实重 | 必须有值，按公斤提交；不是只填写预报重量即可 |
| 整票及商品申报币种 | 均须为 USD；系统不会自动将其他币种换算为美元 |
| 申报商品 | 至少一条，商品名称、海关编码、数量、重量、单价等资料完整 |
| 收发件资料 | 姓名、邮编、地址、城市、州、国家等资料完整；T01 收件资料有特殊处理，见下文 |
不同单号不能互相混用。 为便于核对，以下使用完全虚构的示例：
| 本系统资料 | 示例 | 在申报中的用途 |
|---|---|---|
| 客户单号 | TEST000001 | 小包申报识别号 |
| 换单号 | TEST-REF-001 | 补充参考号，有值时提交 |
| 包号 | TEST-BAG-001 | 小包所属容器标识 |
| 转单号 | TEST-TRACK-001 | 尾程跟踪号码 |
| 分单号 | TEST-HAWB-001 | T01 另需提交的分单标识 |
| 空运主单的主提单号 | TEST-MAWB-001 | 主提单申报，以及后续轨迹、税金查询的主单身份 |
上述示例只用于理解字段关系，不是可直接提交给服务商的正式单号。
¶ 3.2 按申报类型额外准备
| 类型 | 额外注意事项 |
|---|---|
| T01 | 小包分单号；商品单位、原产国、总金额及出口国家；制造商名称、邮编、地址、城市、国家；主提单发票号及主单商业发件人、进口商资料 |
| T11 | 商品制造商名称、邮编、地址、城市、国家；不因 T11 而要求填写 T01 专用的发票号、出口国家公式 |
| T86、ECCF | 按基本资料及服务商实际要求准备，不强制套用 T01／T11 的制造商公式要求 |
- T01／T11 商品证书引用如果开始填写，产品 ID、版本 ID、认证人 ID 必须成组填写完整，不能只填其中一个。
- “生产厂商邮编”在运单详情“基本”页签的申报商品表格中维护；列较多时横向滚动查找。逐条商品补齐后，点击整票运单底部“保存”。
- T01 小包的收件对象为选填，收件税号未填时不提交该收件对象；这不免除 T01 主提单进口商的必填要求。
¶ 3.3 主提单与进口商资料
第1步：将本批小包订舱到同一个、正确的空运出口主提单。 同一票不能同时挂多个主单；订舱完成后再办下面的主单申报。
第2步：进入“空运”出口列表。 入口见第五节第一张图。
第3步：找到该主单，双击打开详情。
第4步：在“基本”页签点击底部“修改”。
第5步：填写主提单号（页面字段“提单号”），并核对“起飞地”和“目的地”。 主提单号不能用“订仓号”或“其他单号1”代替；本图账号未显示主提单号输入项，如你的页面也未显示，请由管理员核对该字段的查看权限。
第6步：填写航班号、预计起飞时间和预计到港时间。
第7步：点击“进口商/其它”。
第8步：切换到“进口商”页签。
第9步：按申报类型补齐进口商资料。
第10步：点击弹窗“确定”。
第11步：回到主单详情，点击底部“保存”。 仅关掉进口商弹窗还不够。
第12步：核对订舱子单清单，确认没有漏票或重复客户单号。
T01 的 EIN 填在图中“税号”，不能拿 VAT、EORI 或运输代理资料代替。填完还需保存主单；“保存为常用”不是保存当前运单的替代按钮。
T01 的商业发件人和进口商取自当前主单，不是从某一票子单随意取值，也不是把运输收货代理当作进口商。进口商需填写姓名、地址、城市、州、邮编、国家及该主体的美国 EIN 税号。
T86 主单进口商为选填：姓名、邮编、地址、城市、州、国家完整时才整组提交；未填或不完整时整组省略，不阻止创建航班，EIN 可选。
¶ 四、提交小包申报：封包
第1步：点击“菜单”中的“包号”。 位置见总入口图的编号4。
第2步：勾选本次要申报的包号。
第3步：点击底部“封包”。
第4步：已开启手选功能时，在“封包API配置”选择已保存的 Nimbus 配置。 对应下图编号1。
第5步：再打开“包号条码”选择“代理面单 - Nimbus”。 对应下图编号2，候选项会随有效配置更新。
第6步：核对本次包号及账号后，点击“确认”。
第7步：核对包号封包状态和包内逐票返回结果。 报文及日志查看入口见第十一节。
截图展示的是尚未选择账号的窗口。先选配置，再选条码：未选择有效配置时，上方可能只有“无需打印”和普通标签；不能选“无需打印”就认定已向 Nimbus 申报。没有 Nimbus 候选时，先按 2.1 保存申报配置，并核对自己是否有该配置的选择权限。
¶ 怎样确认成功
- 页面没有提示资料缺失或申报失败。
- 对应包号的封包状态已更新。
- 对接报文中的客户单号、换单号、包号和转单号与运单一致。
Nimbus 不会另外分配一个新的代理包号；系统用本地包号记录封包成功。没有新面单文件，不应单凭这一点判断申报失败。封包提交成功也不表示海关已经放行。
¶ 五、提交主提单申报：创建航班
第1步：点击顶部“空运”出口。
第2步：勾选本次已补齐资料、订舱子单的主单。
第3步：点击底部展开小三角。
第4步：在展开菜单找到“创建航班”。 菜单较长时在菜单内向下滚动。
第5步：点击“创建航班”。
第6步：核对所选主单后，确认页面提示。
第7步：已开启手选功能时，在“航班 API 配置”中选择本次 Nimbus 配置。
第8步：核对后点击弹窗“确定”。
第9步：查看主单创建航班报文，核对主提单及全部订舱子单。 报文入口见第十一节。
第10步：核对主单“其他单号1”。
打开选择窗口不等于已创建航班。选项只展示当前账号有权使用、且支持创建航班的配置；本次选择不改变子单原取号渠道。
¶ 怎样确认成功
创建成功后，主单“其他单号1”会记录本次主提单号，作为申报成功标记，不是代理返回了另一个新单号。请同时核对创建航班报文，不能只看一个字段有值。
若提示“其他单号1已存在”，先核对是否已经申报。需要重新申报时按实际业务先取消原申报，不要仅清空标记后反复提交。
¶ 六、查询清关轨迹
第1步：核对该票客户单号及其唯一关联的空运出口主提单号。
第2步：在“快递”“小包”或“专线”列表勾选要查询的票。
第3步：点击底部“轨迹对接设置”。
第4步：将“承运商”选择为“Nimbus”。 这个窗口的字段名称叫“承运商”，与接口配置页的“接口”不同。
第5步：点击“保存”。
第6步：回到列表，点击“立即爬取轨迹”。 位置见本节第一张图的编号2。
第7步：打开该票运单详情。
第8步：点击“轨迹”页签查看结果。
第9步：没有结果或提示失败时，检查抓取监控和本次请求、返回报文。
“轨迹接口”是管理员维护账号参数的入口；“轨迹对接设置”用于设置选中运单使用哪个轨迹接口，不是同一个窗口。请在快递、小包或专线列表选择需要查询的票。
查询使用“本票所属空运主提单号＋本票客户单号”，不是只按转单号查询。批量选择也会逐票使用各自所属的主单，不会共用第一票的主提单号。
查询的是小包清关轨迹，不是主提单轨迹。没有本站封包成功记录本身不会阻止查询，但必须有正确、唯一的主单关联。服务商没有匹配轨迹时不会凭空生成轨迹。
¶ 七、查询并保存税金
¶ 7.1 只查一票
第1步：核对该票的唯一空海运主单关联和结算代理。
第2步：核对该票能使用“Nimbus税金回传”配置。 配置与关联方法见2.3节。
第3步：在运单列表勾选该票。
第4步：点击列表底部展开小三角。
第5步：点击展开菜单中的“运单回传”。
第6步：核对所选运单和配置后，在确认窗口点击“确定”。
第7步：查看该票回传结果、报文和日志。 入口见第十一节。
第8步：打开该票运单详情，点击“费用”。
第9步：在应付费用中核对结算代理、费用科目、USD 币种和税金金额。
这是系统共用的确认窗口，界面可能显示平台订单回传提示；Nimbus 的本次用途是按主提单号和客户单号查税，不是要求该票必须由电商平台抓取。若该票还挂有其他监听“手动回传”的接口，本次操作也可能一并执行这些接口，正式点击前请核对。
¶ 7.2 从主单查询全部订舱子单
- 确认空运或海运主单已经订舱子单。
- 确认当前主单的运单回传配置为本次要使用的“Nimbus税金回传”。
- 勾选主单并执行手动回传。
- 等待各子单任务完成。
- 到每一票子单查看回传报文、日志及应付税金。
主单会将全部订舱子单加入查询队列，统一使用主单本次执行的回传配置；不要求每票子单都另挂同一个接口。每票仍需满足自身的查询身份与结算代理要求。
主单提示成功只代表任务派发成功，不代表子单税金全部查询成功。税金不会在主单上统一分摊，应付费用及失败原因都要到对应子单查看。
¶ 税金结果的判断
| 看到的情况 | 应如何理解 |
|---|---|
| 返回了完整、身份匹配的整票税金 | 按 USD 更新对应结算代理及科目的应付费用 |
| 与上次查询金额相同 | 不重复累计相同税金 |
| 税金金额变化 | 按现有费用处理规则更新；核对对应代理及科目，不是另加一遍原金额 |
| 返回缺少税金或主单／客户单号不匹配 | 不会当成零税金入账，查看子单错误和原始返回 |
| 明确返回税金为 0 | 与“没有返回税金”不同，按有效零税金结果处理 |
| 费用已锁定 | 记录原因并跳过入账，不直接覆盖，也不会在这里自动补差 |
系统保存服务商返回的整票税金，不再叠加商品明细中的税金。不要把整票税金和商品税金相加后再次录入。
¶ 八、取消申报
¶ 8.1 取消小包：解封
- 在“包号”列表选择需要取消的已封包包号。
- 点击“解封”。
- 按页面提示确认操作。
- 核对包内各票取消结果及解封报文。
- 确认全部成功后，检查封包成功标记已清除。
解封入口见第四节包号列表图的编号3。
取消按包内每票客户单号执行。部分成功时，不代表整包都取消；修正失败原因后重试，会跳过已经记录取消成功的票，全部成功后才清除整包标记。
¶ 8.2 取消主提单：删除航班
- 在“空运”出口列表选择已申报主单。
- 点击“删除航班”。
- 按页面提示确认取消。
- 查看取消航班报文。
- 确认成功后核对“其他单号1”已清除。
删除航班入口见第五节空运操作菜单图的编号2；先选正确主单，再展开菜单操作。
取消使用当前主单的主提单号。取消前不要随意修改主提单号，否则可能指向错误的申报。
¶ 保留原申报账号配置
手选申报成功后，系统会记录实际使用的 API 配置，后续解封或删除航班继续使用这份配置。取消完成前不要删除原配置、换掉原账号，或把模板改成其他接口。渠道后来改变，不意味着可以用另一个账号取消历史申报。
¶ 九、常见问题
¶ 1. 封包提示 USD 错误
核对整票和每条商品申报币种，并检查接口内的币种取值配置。系统不会将空币种、人民币或其他币种静默当成美元，也不会自动进行汇率换算。
¶ 2. 提示制造商资料缺失
先看申报类型。T01／T11 需要制造商名称、生产厂商邮编以及地址、城市、国家公式。只填公式而没有商品制造商名称、邮编，也不能通过。补齐后保存运单，再提交申报。
¶ 3. 提示包号或主提单关联不唯一
检查该票单件的包号和订舱关系。一票不能同时混用多个包号或多个主提单；不能为了通过校验而随意取第一个号码。
¶ 4. 主单回传成功，但看不到税金
先进入订舱子单，不是在主单上找分摊费用；再检查子单任务、报文、返回税金、结算代理和费用锁定状态。服务商返回“成功”但税金字段为空，也不会产生应付税金。
¶ 5. 提示鉴权失败或无接口权限
核对 App Key、Secret 与当前环境是否一致，再让 Nimbus 确认对应申报或查询权限。轨迹、税金、申报是独立配置，一项成功不能证明其他配置也正确。不要把密钥明文发到群里。
¶ 6. 查询不到轨迹
核对小包客户单号、关联空运主提单号及 Nimbus 账号；再查看服务商是否已有该票轨迹。海运关联不能直接用于这项空运小包轨迹查询。抓取任务已建立不等于已取得轨迹。
¶ 7. 提示原封包或航班 API 不存在／模板已改变
先恢复原申报所用配置，再核对取消业务。不要新建一个不同账号的配置替代历史账号，也不要仅删除本地成功标记。
¶ 十、虚构资料与报文样例
以下文件均使用重新构造的虚构资料，不含真实账号或客户数据。它们用于核对资料对应关系，不是导入模板，也不能直接提交申报、查询或取消。TEST 开头的单号、港口、承运商及海关编码均为占位值。
轨迹和税金两个文件展示的是查询参数，不是提交表单。申报报文只演示基础 T86 结构；T01／T11 需按正文补齐各自条件必填资料。凭据不放在这些文件中。
¶ 十一、查看报文、日志与附件
¶ 11.1 查看操作结果和失败原因
第1步：打开本次小包或主单详情。
第2步：点击“日志”。
第3步：按操作时间查找本次封包、航班、查询或取消结果。
¶ 11.2 查看接口报文与文件
第1步：点击运单详情的“文件”。
第2步：查找本次封包、解封、创建航班、取消航班、轨迹或回传相关文件。 当前票没有生成的文件不会凭空出现。
第3步：按文件名、类型及操作时间对应本次动作，再查看或下载。 不要把其他时间的成功报文当作本次成功。
如操作端另有“抓取监控”或报文查看入口，也应核对同一票、同一次操作的任务。无权查看时请管理员协助，不通过重复提交来判断结果。
¶ 11.3 向客服提供哪些信息
操作完成后，建议保留：机构、客户单号、包号、主提单号、操作时间、所用接口名称、页面结果及对应报文。税金异常另核对子单结算代理、费用科目、币种、金额及锁定状态。
提供给客服的截图和报文应遮挡 App Key、Secret、密码及其他登录凭据。页面提示与最终结果不一致时，以同一次操作的报文、任务结果和实际费用为依据，不通过反复提交来猜测是否成功。
返回：其他承运商／代理接口