公司:工作室信息和业务通用规则
这是工作室的身份信息页面,可设置名称、联系方式、标志和注册信息;这里还包含一些会改变系统行为的通用规则,例如何时生成会计分录、能否在未开启收银台的情况下完成账单,以及照片编辑器打开时的状态。本文介绍设置 → 公司中的常规选项卡,以及用于让其他系统与工作室集成的密钥选项卡API Key。此页面的其他选项卡(报表、公开页面、时间、节假日、考勤打卡)将在其他文章中介绍。
选项卡位于页面顶部,当前打开的选项卡会显示下划线。在手机上,选项卡会以按钮网格的形式显示:点按按钮即可全屏打开对应选项卡,保存按钮位于页面底部。
- 更新工作室的电话、邮箱或标志。
- 决定销售的会计分录是立即生成,还是等到收银台结账时再生成。
- 创建 API 密钥,让其他系统(如 ERP、自动化表格或网站)读取和写入工作室数据。
- 了解为什么必须开启收银台才能完成账单,或允许不启用此流程。
如果您无法修改公司信息,请让工作室所有者在访问权限 → 角色中为您开通权限。
步骤 1 — 编辑身份信息
Section titled “步骤 1 — 编辑身份信息”填写姓名、邮箱和联系 WhatsApp,选择默认语言(目录录入时使用的语言,也是自动翻译的基础语言),上传企业标志,并填写注册信息(CNPJ、注册信息、地址等自由文本)。连接了公司的 WhatsApp 后,还会显示通过 WhatsApp 通知已删除的项目。

步骤 2 — 选择会计分录的生成时间
Section titled “步骤 2 — 选择会计分录的生成时间”在会计分录中,选择为每笔销售立即生成分录(按每笔销售单独记录),还是在收银台结账时一次性生成当天所有分录(在收银台结账时)。

步骤 3 — 设置是否需要开启收银台才能完成账单
Section titled “步骤 3 — 设置是否需要开启收银台才能完成账单”在完成工单和账单中,选择完成账单时是否必须开启收银台(需要收银台已开启),或无需开启(不需要收银台)。通过注册创建的工作室默认设置为不需要收银台:付款通过账单处理,无需先开启收银台。

步骤 4 — 调整图片编辑器
Section titled “步骤 4 — 调整图片编辑器”展开图片调整,设置产品、服务和接待环节使用的照片编辑器的初始状态:是否默认勾选移除背景,以及裁剪框打开时是否已限制在照片中央区域。
同一列表中还有其他适用于特定场景的折叠面板:自取和配送(销售点的柜台订单)、定期收款(定期收款的建议罚款、利息、折扣和提前天数,以及账单说明)、收款提醒(到期前的邮件提醒和逾期催收),以及仅适用于巴西企业的服务电子发票(NFS-e)设置。

步骤 6 — 创建 API 密钥
Section titled “步骤 6 — 创建 API 密钥”在API Key选项卡中,点击新建密钥。填写一个能说明密钥用途的姓名,选择用户;如有需要,还可填写允许的 IP(每行一个;留空则接受任意 IP)和有效期(选择永不过期或过期时间并指定日期)。点击创建密钥后立即复制密钥:密钥不会再次显示。
如果要将密钥用于 AI(Claude Code、Gemini CLI、Cursor),还要勾选允许用作 AI 连接器。请参阅文章AI 连接器。
密钥会以所选用户的身份运行,拥有该用户在工作室中的全部权限,具体取决于其在访问权限 → 角色中的角色设置。因此,建议专门为集成创建一个用户,并为其设置仅开放必要权限的角色。其他系统每次调用时,都要在 Authorization: Bearer 请求头中附上密钥。
只有工作室管理员(拥有全部访问权限,或有权编辑角色和用户)才能创建、编辑或撤销密钥。其他用户只能查看密钥列表。

-
在选项卡底部点击保存,保存常规选项卡中的所有设置,包括折叠面板中的设置。此页面的其他选项卡(报表、公开页面、时间等)各有自己的保存按钮。
-
更改会计分录规则不会重新处理已经生成的分录,只会影响之后的销售。
-
可以随时点击垃圾桶图标撤销 API 密钥;使用该密钥的系统最多会在 30 秒内失去访问权限。如果密钥所属的用户在工作室中被停用,或密钥已过期,密钥也会自动失效。通过密钥所做的更改会在审计记录中显示来源为API 密钥。
常见错误与问题
Section titled “常见错误与问题”问:“按每笔销售单独记录”和“在收银台结账时”有什么区别?
**答:**选择前者时,每笔销售都会立即生成会计分录,账户流水会在当天持续更新。选择后者时,当天所有销售的分录会在收银台结账时一次性生成,单独生成的分录更少,但流水要等结账后才能反映当天的情况。
**问:**选择“需要收银台已开启”后会有什么变化?
**答:**只有在收银台已开启时才能完成账单;如果收银台未开启,就无法完成账单。选择“无需收银台”(工作室默认设置)后,团队可随时完成账单,适合日常不使用收银台开关流程的工作室。
问:在哪里设置罚款、利息和收款提醒?
答:在同一选项卡的定期收款(创建定期收入时建议使用的金额;已创建的合同会保留自己的金额)和收款提醒(在到期前和到期后自动发送邮件,设置会立即生效)折叠面板中进行设置。两项设置都通过该选项卡的保存保存。
**问:**API 密钥可以在系统中执行所有操作吗?
**答:**不可以。密钥只拥有所属用户在当前工作室中的权限。而且有些区域无论用户是否拥有全部权限,都不接受 API 密钥:登录和切换公司、密钥页面本身、Heya、支持页面和平台页面。如果其他系统收到“此路由不能使用 API 密钥。”提示,说明请求访问的就是这些区域之一。
**问:**密钥丢了,还能再查看吗?
**答:**不能。系统只保存密钥的指纹,不保存密钥本身。请撤销旧密钥并创建新密钥。
问:“注册信息”中可以填写什么?
**答:**可以填写任意文本,例如 CNPJ、州税务登记号,或其他适用于您工作室的信息。字段支持基础 HTML(粗体、换行、链接),因为这些内容也会显示在公开预约页面上;如果要让地图定位到正确地址,请只将地址用 <span data-map>...</span> 标记。
**问:**需要填写默认费率吗?
答:不需要,这是可选项(默认值为无)。只有使用特定税费类型并自动应用该税费的工作室才需要设置。
此页面的其他选项卡(报表、公开页面、时间、考勤打卡)目前还没有相关文章,之后会为每个选项卡单独编写文章。