> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 自定义客户门户、访问控制和税率

> 在 AgencyHandy 中为客户登录和注册页面打造品牌形象，按角色控制侧边栏可见性，并为发票和结账配置税率。

AgencyHandy 让您深度掌控客户所见所感——从他们登录时看到的第一个页面，到登录后可浏览的平台栏目。本页面涵盖四个相互关联的配置区域：**登录门户**、**注册门户**、**侧边栏与访问控制**以及**税率**。这些设置共同帮助您为工作区中的每位用户打造精致、符合角色定位的体验。

<Note>
  本页面所有设置均需要**超级管理员**或**管理员**权限。请在左侧边栏导航至**工作区配置**以访问各设置区域。
</Note>

***

<Tabs>
  <Tab title="登录门户">
    ## 登录门户

    登录门户是您的客户和团队成员访问 AgencyHandy 工作区时看到的登录页面。自定义登录门户可确保客户获得的第一印象完全符合品牌形象——包含您机构的图片、标题和宣传语。

    ### 可自定义的内容

    | 元素      | 描述             | 限制                    |
    | ------- | -------------- | --------------------- |
    | **标题**  | 显示在登录页面顶部的主标题  | 最多 120 个字符            |
    | **图片**  | 页面上展示的品牌照片或插图  | PNG、JPG、JPEG——最大 5 MB |
    | **副文本** | 显示在登录字段下方的简短说明 | 最多 300 个字符            |

    ### 自定义登录门户的步骤

    <Steps>
      <Step title="打开登录门户设置">
        在左侧导航栏中点击**工作区配置**，然后从子菜单中选择**登录门户**。
      </Step>

      <Step title="输入自定义标题">
        在**标题**字段中输入您希望显示的标题。保持简洁且切题——例如，*"欢迎回到\[机构名称]"* 或 *"您的客户门户"*。最多 120 个字符。
      </Step>

      <Step title="上传品牌图片">
        点击上传区域，或拖放图片文件（PNG、JPG 或 JPEG，最大 5 MB），为登录页面添加视觉元素。该图片通常显示在登录表单旁边。

        <Tip>
          使用能代表您机构的高质量图片——团队照片、简洁的品牌插图或专业背景图。确保文件大小低于 5 MB 以避免上传错误。
        </Tip>
      </Step>

      <Step title="添加副文本">
        在**副文本**字段中，编写一段简短的文字显示在登录字段下方——例如欢迎语、支持联系方式或简短的宣传语。请控制在 300 个字符以内。
      </Step>

      <Step title="预览并保存">
        使用预览功能查看登录页面布局。满意后，点击**保存**（或**更新**）以应用更改。更改立即生效。
      </Step>
    </Steps>

    ### 重置为默认设置

    在登录门户页面点击**重置默认设置**，可移除所有自定义内容并恢复 AgencyHandy 原始登录页面。

    <Warning>
      重置为默认设置不可撤销。所有自定义标题、图片和副文本将被永久删除。如果不确定，请点击**取消**——未保存的更改将被丢弃，但当前已保存的设置保持不变。
    </Warning>

    ### 最佳实践

    * 保持标题简洁且具有欢迎感——客户在登录前就能看到它，确保给人以安心的感觉。
    * 使用能代表您机构的专业图片。避免使用与品牌脱节的通用库存图片。
    * 保存前在不同屏幕尺寸上预览，确保图片和文字布局正确。
    * 如果图片上传失败，请确认其格式（PNG、JPG、JPEG）和大小（低于 5 MB）是否符合要求。
  </Tab>

  <Tab title="注册门户">
    ## 注册门户

    注册门户是新客户在您的工作区创建账户时看到的注册页面。自定义注册门户可从客户与您机构平台的第一次接触开始，打造一致的品牌体验。

    ### 可自定义的内容

    | 元素      | 描述             | 限制                    |
    | ------- | -------------- | --------------------- |
    | **标题**  | 显示在注册页面顶部的主标题  | 最多 120 个字符            |
    | **图片**  | 页面上展示的品牌照片或插图  | PNG、JPG、JPEG——最大 5 MB |
    | **副文本** | 显示在注册字段下方的简短说明 | 最多 300 个字符            |

    ### 自定义注册门户的步骤

    <Steps>
      <Step title="打开注册门户设置">
        在左侧导航栏中点击**工作区配置**，然后从子菜单中选择**注册门户**。
      </Step>

      <Step title="输入自定义标题">
        在**标题**字段中输入欢迎新客户的标题。例如，*"开始使用\[机构名称]"* 或 *"创建您的客户账户"*。最多 120 个字符。
      </Step>

      <Step title="上传品牌图片">
        点击上传区域，或拖放图片文件（PNG、JPG 或 JPEG，最大 5 MB）。该图片将与注册表单一同显示在注册页面上。

        <Tip>
          在登录门户和注册门户图片上使用相同的视觉风格和色调，以在两个页面之间创造统一的体验。
        </Tip>
      </Step>

      <Step title="添加副文本">
        在**副文本**字段中编写简短的辅助说明——例如注册后的预期流程说明，或简短的价值主张。最多 300 个字符。
      </Step>

      <Step title="预览并保存">
        使用预览选项查看注册页面效果。点击**保存**（或**更新**）立即应用更改。
      </Step>
    </Steps>

    ### 重置为默认设置

    在注册门户页面点击**重置默认设置**，可移除所有自定义内容并恢复 AgencyHandy 原始注册页面。

    <Warning>
      此操作无法撤销。所有自定义标题、图片和副文本配置将被永久删除。
    </Warning>

    ### 最佳实践

    * 让注册标题的语气与您整体的客户沟通风格保持一致——专业、友好，或两者兼顾。
    * 保持副文本内容聚焦：告诉新客户注册后会发生什么（例如，*"注册成功后，我们的团队将在 24 小时内发送欢迎邮件给您。"*）。
    * 保存更改后自行测试注册流程，确认页面效果和功能符合预期。
  </Tab>

  <Tab title="侧边栏与访问">
    ## 侧边栏与访问控制

    侧边栏与访问设置允许您精确控制每个用户角色在左侧导航菜单中可以看到的内容。您可以将菜单项重命名为符合您机构术语的名称，将默认图标替换为自定义图标，并按角色切换任意菜单栏目的可见性。最终为每位登录用户打造简洁、专属的操作界面。

    ### 可配置的角色

    * 客户
    * 超级管理员
    * 管理员
    * 经理
    * 受托人
    * 自定义（您在角色与权限中创建的任何自定义角色）

    ### 自定义侧边栏菜单项的步骤

    <Steps>
      <Step title="打开侧边栏与访问设置">
        前往**工作区配置**，然后从设置菜单中选择**侧边栏与访问**。
      </Step>

      <Step title="点击自定义">
        点击面板顶部的**自定义**按钮。当前侧边栏菜单项的完整列表将显示在**主要**类别下。
      </Step>

      <Step title="重命名菜单项">
        点击任意菜单项的文本字段并输入新标签。例如，将"仪表盘"重命名为"概览"，或将"CRM"重命名为"联系人"。点击**保存**以应用新名称。
      </Step>

      <Step title="更改菜单图标">
        点击菜单项名称旁边的图标。弹出窗口将显示一组图标选项——从图标库中选择一个，或上传自定义的 32×32 像素图片以使用您自己的品牌图标。点击**保存**以应用。
      </Step>
    </Steps>

    ### 配置基于角色的可见性的步骤

    <Steps>
      <Step title="点击编辑访问权限">
        点击**编辑访问权限**按钮（位于**自定义**按钮旁边）。您将看到每个可用角色对应的标签页。
      </Step>

      <Step title="选择角色">
        点击您要配置的角色标签页——例如**客户**。
      </Step>

      <Step title="切换菜单项可见性">
        对于列出的每个菜单项，使用切换开关为所选角色显示或隐藏它。例如，您可以对客户隐藏**发票**和**订阅**，同时让管理员和经理可以看到这些内容。
      </Step>

      <Step title="保存更改">
        点击**保存**。更新后的可见性设置立即生效——用户在下次页面导航或重新登录后即可看到变化。
      </Step>

      <Step title="如需重置为默认设置">
        点击任意角色标签页上的**重置为默认值**，可恢复该角色的原始可见性设置。
      </Step>
    </Steps>

    <Tip>
      简洁、精简的侧边栏可以改善客户体验。只向客户展示他们需要的内容——例如**仪表盘**、**订单**和**消息**——可以减少困惑，防止他们误入仅供内部使用的栏目。
    </Tip>

    ### 角色配置示例

    | 角色    | 建议可见栏目           |
    | ----- | ---------------- |
    | 客户    | 仪表盘、订单、消息、发票（如需） |
    | 经理    | CRM、项目、工时表、任务    |
    | 受托人   | 仪表盘、任务、项目、消息     |
    | 超级管理员 | 所有栏目（无限制）        |

    ### 重要说明

    * \*\*更改即时生效：\*\*角色可见性更新在用户刷新页面或重新登录后立即生效。
    * \*\*权限最高的角色优先：\*\*如果用户拥有多个角色，权限最广的角色将优先生效。
    * \*\*自定义图标：\*\*上传 32×32 像素的图片，使侧边栏与您机构的品牌视觉保持一致。
    * \*\*命名一致性：\*\*使用全团队都能理解的清晰、一致的命名规范——避免使用新团队成员不熟悉的缩写或内部术语。
  </Tab>

  <Tab title="税率">
    ## 税率

    税率功能让您可以创建、管理和应用税务配置，覆盖您的服务、订阅和发票。您可以设置多种税类——增值税、商品与服务税、销售税等——支持按国家和州设置不同税率，支持含税和不含税两种定价模式，并可根据客户位置在结账时自动应用。

    <Note>
      只有**超级管理员**和**管理员**才能创建、编辑或删除税务配置。
    </Note>

    ### 税务概念速览

    | 概念        | 定义                                        |
    | --------- | ----------------------------------------- |
    | **不含税**   | 税费在结账时叠加在标价之上（例如：$100 + 10% 税费 = $110 合计） |
    | **含税**    | 税费已包含在向客户显示的价格中（例如：\$110 合计价格已包含税费）       |
    | **税务 ID** | 您机构的企业税务识别号码，显示在发票上                       |

    ### 第 1 步：创建税率

    <Steps>
      <Step title="打开税率">
        前往**工作区配置**，然后点击**税率**标签页。
      </Step>

      <Step title="点击 + 新建税率">
        点击 **+ 新建税率**按钮，将弹出一个表单。
      </Step>

      <Step title="填写税务信息">
        填写以下字段：

        * **标题 / 税种**（*必填*）：输入描述性名称，例如：标准增值税、优惠商品与服务税或美国销售税。最多 255 个字符。
        * **税务 ID**（*可选*）：您机构的企业税务识别号码。最多 20 个字符。
        * **本国**：选择此税率主要适用的国家。
        * **本国通用税率 %**（*可选*）：您本国的默认税率。
        * **按国家设定的税率**（*可选*）：按国家添加税率，可选填州、邮政编码和百分比。适用于为多个税务管辖区客户提供服务的机构。
      </Step>

      <Step title="设置状态">
        将税率切换为**激活**，使其立即可用于服务和发票。设置为**停用**可保存配置但暂不应用于新购买。
      </Step>

      <Step title="保存">
        点击**保存**。该税率将显示在您的税率列表中，现可链接到服务。
      </Step>
    </Steps>

    <Tip>
      税率百分比最多支持 4 位小数。0% 的税率是有效的——可用于零税率商品，或需要列出税率但金额为零的合规场景。
    </Tip>

    ### 第 2 步：将税率链接到服务

    <Steps>
      <Step title="打开服务进行编辑">
        导航至**服务**，创建新服务或编辑现有服务。
      </Step>

      <Step title="前往附加信息部分">
        在服务设置向导中进入第 3 步（附加信息）。
      </Step>

      <Step title="为服务添加税率">
        点击**添加税率**，从已配置的列表中选择一种或多种税类。选择税率以**含税**还是**不含税**方式应用于此服务。此设置适用于服务上所有已链接的税率，包括设置费和附加项。
      </Step>
    </Steps>

    ### 第 3 步：税率的应用方式

    税率可以在**结账时自动应用**，也可以**在发票上手动应用**：

    **自动（结账）**

    * 链接到服务的税率将根据客户的账单地址自动计算。
    * 客户必须在结账时提供国家、州和邮政编码，才能应用基于位置的税率。
    * 对于 Stripe 印度账户，完整的位置信息（国家、州、邮政编码）为必填项。

    **手动（发票）**

    * 手动创建发票时，点击**添加税率**选择要应用的税率。
    * 账单地址字段自动填充。
    * **只有不含税的税率**可应用于手动发票——此流程不支持含税税率。

    ### 发票税务显示

    每张包含税率的发票都会显示以下信息：

    * **税率名称**——您输入的标签（例如：增值税、商品与服务税）
    * **税率百分比**——应用的税率（例如：15%）
    * **税额**——计算出的收费金额

    ### 管理现有税率

    * \*\*编辑税率：\*\*点击列表中的税率条目，更新其标题、税率或国家规则。更新仅适用于未来的发票和购买。
    * \*\*删除税率：\*\*已删除的税率将不再应用于新的购买或订阅，但已包含该税率的现有发票不受影响。
    * **停用税率：**将税率设为**停用**，可在不删除配置的情况下停止将其应用于新购买。

    ### 重要说明

    * \*\*优惠券折扣在税前计算：\*\*客户使用折扣优惠券时，税率将基于折后价格计算，而非原价。
    * \*\*每项服务可添加多个税率：\*\*您可以为单项服务附加多种税率（例如同时使用增值税 + 商品与服务税）。
    * \*\*税率适用于附加项和设置费：\*\*如果您的服务包含设置费或附加项，税率也将应用于这些金额。
    * **自动填充客户位置：**如果客户在其个人资料中已保存账单国家和州，结账时这些字段将自动填充。但在结账过程中修改位置信息**不会**更新客户的个人资料。
    * \*\*基于邮政编码的州份识别：\*\*对于美国客户，系统可以通过邮政编码自动识别所在州，并在已配置的情况下应用正确的区域税率。
  </Tab>
</Tabs>