承运商与承运商账号：维护承运商档案和账号凭证

每家承运商建一份档案，再在档案下按 Client 维护发货账号和 API 凭证——打单算价时永远用对账号。

Docklify 把承运商分成两层维护。承运商档案（Master Data → Carriers）记录"这家是谁"：名称、SCAC、运输方式和支持的服务。承运商账号（Master Data → Carrier Accounts）记录"怎么用它发货"：按 Client 一个一个建，里面存账号号和打单算价用的 API 凭证。两层分开的好处是：一份档案可以服务多个 Client，同一个 Client 对同一家承运商也可以有多个账号。

第一步：新建承运商档案#

1. 打开 Master Data → Carriers，点"+ 新增承运商"。
2. 在"基本信息"里填名称（必填），状态选 ACTIVE（启用）、INACTIVE（停用）或 EXCEPTION（异常）。
3. 在"联系信息"里填运输方式（必填，逗号分隔，如 "Ground, Air"）和默认运输方式（必填）。
4. 把手头有的标识和联系信息补上：配送服务、SCAC、USDOT、MC Number、合作方 SCAC、邮编覆盖、联系人、电话、邮箱。这家承运商不允许混装时，勾上"禁止混装"。
5. 在"E-pro 管理"里选这家承运商是应用到所有仓库还是指定仓库，最后点"创建"。

回到列表页（Master Data → Carriers），可以按名称、SCAC、MC Number、USDOT 和状态筛选，能看到每家承运商有多少个服务，还能点"导出"把列表下载成 CSV。

第二步：维护承运商支持的服务#

1. 在列表里点承运商名称打开编辑页——表单下方有一张独立的"支持的快递服务"卡片。
2. 点"+ 新增服务"，一行一个服务：服务代码（如 UPS_GROUND）和服务名称（如 UPS Ground）必填，中文名和运输天数选填。
3. 用"启用"勾选框可以不开删除就停用某个服务；最后点"保存服务"。行尾的 ✕ 是删除（会先弹确认）。

• 先保存承运商、再加服务——服务卡片挂在已存在的承运商下面。
• 这些服务就是 Packing Station 打单算价时可选的服务，代码要按承运商的官方写法填，别自己改名。

第三步：给 Client 建承运商账号#

1. 打开 Master Data → Carrier Accounts，点"+ 新增承运商账号"。
2. 在"基本信息"里选承运商、选这个账号属于哪个 Client、填账号号（三项都必填）。名称和公司选填，是给自己看的备注。
3. 按实际情况勾选：只用于退货的账号勾"退货账号"，自家账号勾"House 账号"，还在用承运商沙盒联调时勾"测试模式"。
4. 填"地址"区（地址行、城市、州/省、邮编、国家、电话）——这是挂在这个账号上的地址；承运商用得到的时候，Smart Post Hubid 和单独的退货账号也填在这里。
5. 在"API 凭证"区填承运商给这个账号发的凭证：新建时 API Client ID 和 API Client Password 必填；API Token、Track API Key、Track API Secret 按承运商的要求填。
6. 点"创建"。回到列表就能看到账号挂在对应 Client 下，并显示模式（测试模式/生产模式）和状态。

凭证是加密存储的，任何页面都不会显示出来——账号列表只显示 API Client ID，密码和密钥永远不露面。编辑账号时（Master Data → Carrier Accounts → 点账号号），已保存的密码框会提示"已设置密码（留空保持不变）"：不改就留空，旧值原样保留。编辑页还有"停用/启用"按钮，可以在不删账号的前提下把账号切到 INACTIVE 或 ACTIVE。

第四步：在 Integration 里接通打单账号#

1. 打开 Integration → Carriers，点"新建账号"。用搜索框从目录里选承运商——目录里标了每家的类型（小包裹、零担或整车）和对接方式。
2. 填账号号，选面单模式——"API（实时费率/面单）"走承运商 API 算价打单，"离线（手工录单号）"则手工录入运单号——再勾上这个账号可以用的服务。
3. 填"密钥凭证"区（字段按承运商的登录方式变化，如 API 密钥/客户端 ID 与密钥、账号密码或访问令牌）；想让它成为优先选用的账号，勾"设为默认承运商"。已保存的凭证不会再显示出来，留空就是保持原值。
4. 保存后，在列表的行操作里管理账号："启用开关"打开或关闭账号，"测试连通"跑一次连通测试并把时间记在"最近测试"列，编辑/删除也在同一行（删除会连同保存的凭证一起删掉）。

如果测试结果带"模拟"角标，说明这次是模拟测试、没有真的调承运商——把它当作流程演练；填好真实凭证后再跑一次测试。这个 Integration 页上的账号就是 Docklify 其他地方发货时读的同一批账号，只维护这一处，不用两边对账。

本文用到的 Docklify 功能#

• 承运商档案（筛选 + CSV 导出）—— Master Data → Carriers（/master-data/carriers）
• 承运商的支持服务清单 —— Master Data → Carriers → 打开一家承运商 → 支持的快递服务
• 按 Client 维护的承运商账号（含加密 API 凭证）—— Master Data → Carrier Accounts（/master-data/carrier-accounts）
• 打单承运商连接：目录、面单模式、默认账号与测试连通 —— Integration → Carriers（/integration/carriers）