Solavel 文档
中文

会计集成 (SolaCount)

最后更新

SolaHR 可以自动将其会计分录发送到 SolaCount:薪酬过账和付款、提前加班付款以及离职结算及其付款。除非打开交付,否则不会发送任何内容。已交付的分录之后永不更改;更正会作为冲销发送。

当账簿保存在SolaCount中且希望将工资成本、应付账款和付款记录在那里,而无需手工输入分录时使用。

#哪里可以找到

屏幕 如何打开 URL
集成设置 侧边栏 薪酬与补偿 → 薪酬设置,卡片 会计集成 (SolaCount) /payroll-settings
一次薪资计算的发放 在 工资单 中打开运行;卡片 会计交付 (SolaCount)(已批准、已锁定、已关闭或已付款的运行) /payroll/{id}

#所需套餐

两个应用都必须处于 Premium 或更高版本:

应用 包含该集成的套餐 功能
SolaHR Premium、Enterprise SolaCount 集成(hr.accounting_integration)
SolaCount Premium、Advanced、Enterprise SolaHR 集成(integrations.solahr)
  • 这涵盖薪资、预支款、提前支付的加班费、离职结算和员工报销单。
  • 它独立于 SolaCount 的开发者 API 访问:不需要 API 集成功能及其每日请求限额。
  • 如果 SolaHR 的套餐较低,卡片会显示“请将 SolaHR 升级到 Premium 或 Enterprise”。如果 SolaCount 的套餐较低,连接测试会显示“请将 SolaCount 升级到 Premium、Advanced 或 Enterprise”。

#降级之后

  • 已收到的任何内容都不会被隐藏或删除:SolaCount 保留这些凭证和报销申请,SolaHR 中的每次薪资运行也保留其发送历史。已记录的义务(应付薪资、多付款项、预支、结算)在套餐变更后仍会保留,并按顺序结清。
  • 新的薪资计提、加班费支付、结算、预支款支付和新的报销单不会发送。它们会连同原因一起留在 SolaHR 中等待,并在升级后发出。
  • 对于 SolaCount 已持有的分录,其付款、付款退回和冲销仍可正常处理,因此不会有应付款项未付。SolaCount 已持有的报销单仍在 SolaCount 中审核和付款,其状态也会继续同步。
  • 重复投递 SolaCount 已接收的分录会返回相同的结果,且不会创建任何新内容。

如果卡片显示“此功能的数据库更新尚未完成。”,说明更新尚未到达您的工作区。

#谁能做什么

行动 权限
连接、测试、暂停、恢复、更新密钥、断开连接 组织所有者,或被授予连接并管理 SolaCount 连接(hr.integrations.connect)权限的用户。同一人还需要在 SolaCount 中拥有对应权限(连接 SolaHR,employee_finance.connect)。
查看运行的交付和对账 查看薪资批次(hr.payroll.view)
重试失败的事件 批准工资运行(hr.payroll.approve)

#进行设置

连接可自助完成。无需复制密钥、ID 或地址,也无需在服务器上运行任何内容。您可以从任一应用开始:

  • 在 SolaHR 中:工资与薪酬 → 工资设置,连接 SolaCount卡片。
  • 在 SolaCount 中:Employee Finance → 连接 SolaHR。
  1. 打开卡片。SolaHR 会自动找到您组织的 SolaCount 工作区,并检查两者是否属于同一组织。
  2. 如果某个套餐等级过低,卡片会指出需要升级的应用(升级 SolaHR或升级 SolaCount)。系统不会自动升级任何内容。
  3. 检查科目。SolaHR 的每个角色(工资、应付净工资、保险、税款、预付款、现金或银行等)都需要一个 SolaCount 科目。建议项已标出,您可以更改任何一项。如果缺少科目,请点击在 SolaCount 中创建。必填角色必须选择;可选角色可以留空。
  4. 选择发送自此日期起的分录。更早日期的分录绝不会被发送,历史数据也不会被导入。
  5. 可选:勾选将员工报销发送到 SolaCount,并选择应付报销款科目。
  6. 点击连接。SolaHR 与 SolaCount 会在两者之间创建并交换安全密钥,然后运行真实的连接测试。测试通过后,卡片显示已连接。取消勾选立即开始发送,可先连接、稍后再开始发送。

#连接状态

状态 含义
未连接 尚未设置任何内容。请检查科目并点击连接。
需要审核 连接正常,但缺少必填科目或开始日期。请选择并保存。
已连接 分录正在发送,且最近一次测试已通过。
已暂停 连接正常但不发送任何内容;分录在 SolaHR 中等待。
需要升级 其中一个应用的套餐低于 Premium;卡片会指出是哪一个。
所需权限 您在卡片所指应用中没有连接权限。
需要注意 最近一次检查失败。请点击测试连接。

#管理连接

  • 测试连接会与 SolaCount 运行一次真实的签名检查。
  • 暂停发送 / 恢复发送用于停止和重新开始投递。SolaCount 已收到的分录仍保留在那里。
  • 更新连接密钥会替换密钥并立即测试;发送不会中断。
  • 断开连接会停止发送并移除对 SolaCount 的访问。已收到的分录保留在 SolaCount 中,您选择的科目会保留,以便日后重新连接。

技术详情卡片以只读方式显示连接状态;密钥永远不会显示。

#账户指南

卡片上的每个账户都会显示其状态、一行用途说明和运作方式部分:账户类型、使用时机、示例、哪些情况会改变余额、留空时会怎样,以及何时适合使用单独账户。SolaHR 和 SolaCount 显示相同的指引。

状态 含义
已配置 已保存且有效;用于新分录。
建议 由 SolaCount 提议,等待您确认;连接或保存时才会保存。
使用默认 没有单独账户:“使用默认账户:6101 工资费用”。
尚未使用 您的 SolaHR 数据尚未使用它;卡片会说明哪项操作最先需要它。
现在必填 请选择或创建账户;在此之前,所列分录无法发送。
未使用 目前没有 SolaCount 分录使用它;留空是安全的。
账户 类型 必填 留空时
工资费用 费用 始终 无法发送工资分录。
应付净工资 负债 始终 无法发送工资分录。
现金或银行 资产 始终需要(绝不会替您选择) 无法发送付款分录。
应付保险费 负债 当工资包含社会保险时 分录等待中。
应付所得税 负债 当工资包含所得税时 分录等待中。
员工预支应收款 资产 当员工有预支款时 分录等待中。
加班费支付过渡账户 负债或资产 当加班费在工资发放前支付时 分录等待中。
代扣的第三方扣款 负债(公司贷款则为资产) 当工资包含福利、法定或贷款还款扣款时 分录等待中;绝不会计入工资账户。
津贴、加班、雇主保险费用 费用 非必填(默认账户) 使用工资费用。
罚款和工资扣款 收入或费用 非必填(默认账户) 减少工资费用。
服务终止费用 费用 非必填(默认账户) 使用工资费用。
应付结算款 负债 非必填(默认账户) 使用应付净工资。
员工应收款(多付款项) 资产 在冲销已向某人付款的已支付工资批次之前 在选定之前,冲销会被拒绝。
舍入差异 费用或收入 仅当分录存在舍入差额时 该分录会等待;没有差额的分录永远不需要它。
预支款期初余额的对冲账户 所有者权益、负债或资产 仅用于历史预支款期初分录 其他情况下不使用。

#为所有受支持的流程准备账户

已就绪的内容列出每个流程(工资、付款、保险、税费、预支、工资发放前已付的加班费、代扣扣款、结算、冲销已支付的工资批次、舍入、报销、历史预支),标明已就绪,或仍需哪些账户。

默认使用完整设置。已有科目会被复用,已保存的选择保持不变。受支持流程所需但科目表中缺少的每个科目都会显示为确认后创建,并列出代码、名称和类型;也可以改选现有科目。选择银行或现金科目(绝不会替您选择)和开始日期,然后点击准备并连接(已连接时为准备并保存)。这一次确认会创建所列科目,在 SolaHR 和 SolaCount 中保存完整映射,测试连接,并在您要求时开始发送。只有两个应用都确认已保存的设置后才会提示成功;如有步骤失败,消息会说明是哪一步,您可以直接重试,不会重复创建任何内容。不会创建余额、日记账分录或期初分录。取消勾选完整设置即为最小设置;卡片会列出届时未就绪的流程。

#币种与就绪状态

分录以 SolaHR 的薪资币种过账,该币种同时也是 SolaCount 中分录的本位币。因此,SolaHR 的薪资币种必须与 SolaCount 中组织的本位币一致。从其他币种换算的薪资行不会发送,也绝不会以汇率 1 过账。不同币种需要另行设计换算方案,目前尚不可用。

两个应用显示相同的就绪状态行,例如“连接正常 · 尚未就绪,无法过账薪资”(测试失败时为“连接不正常”),后面只列出阻碍过账的事项。连接正常与可过账薪资是两回事:

检查 以下情况未就绪
订阅 其中一个套餐不包含该集成。
权限 您在任一应用中缺少连接权限。
货币 薪资币种与 SolaCount 的本位币不同(例如薪资为 USD,SolaCount 为 AED),或其他币种的记录需要复核。
凭据与连接状态 未连接、签名密钥不一致,或最近一次测试失败或从未运行。
开始日期 尚未保存开始日期。
付款来源 尚未选择用于发放工资的现金或银行账户(不会替您选择)。
映射 所需账户仅为建议,尚未保存。

只有所有检查都通过,连接才显示为已连接。如果币种不一致,在创建任何科目或密钥之前连接就会被拒绝。预支同样使用薪资币种。发薪币种没有汇率的员工会被排除在薪资运行之外,请参阅薪资运行。

如果连接后币种不再一致(任一应用中的币种发生了变化),薪资批准会被拒绝并指明两种币种,已记录的凭证会因currency_mismatch而等待;它们会被保留,并在币种再次一致后按顺序仅发送一次。

#HR 操作前的检查

启用集成后,SolaHR 会在以下操作之前检查该操作的分录所需的账户:

  • 批准或关闭在批准时记录成本的工资批次,
  • 批准离职结算,
  • 冲销已支付的工资批次。

如果缺少账户,该操作会被拒绝,并说明账户名称、用途以及选择位置(工资设置 → 连接 SolaCount)。仅该操作被拒绝。已经发生的付款(工资、提前支付的加班费、预支、结算付款)始终会被记录;其分录会等待,直到选定账户。如果设置后账户在 SolaCount 中被停用,受影响的分录会附带说明并等待,一旦选定有效账户即会发送。

#罚款与代扣的第三方扣款

  • 罚款和工资扣款包括考勤和迟到扣款、纪律处分罚款、手动扣款和工资调整。这笔钱由雇主留存。留空时,它会减少工资费用:员工只是赚得更少。如需单独报告罚款,请使用收入账户。不要使用负债账户:没有人对这笔钱享有债权。
  • 代扣的第三方扣款包括福利、法定和贷款还款扣款。这笔钱需要转付给他人,因此会过账到专门的账户,绝不会减少工资费用。请选择应付给服务提供方、主管机构或放款方的账户;如果贷款由贵公司发放,请选择该贷款的应收账户。

#等待账户的分录

如果您在连接后才开始使用保险、税款、预支款、提前加班或代扣扣款,受影响的分录不会被发送到其他账户。它会在 SolaHR 中等待,并显示消息“此分录正在等待 SolaCount 中的……账户”。请在连接 SolaCount中选择该账户,分录就会自动发送。

#示例分录

在账户下方,示例分录(仅供说明)展示示例金额(工资 1,000)如何使用表单中所选账户过账,规则与真实分录相同。不会创建、过账或支付任何内容。

#发送的内容

活动 触发时机
薪酬已记账 / 薪酬已冲销 运行变为付费运行/付费运行通过其支持的校正工作流程被撤销。仅批准不会将工资过帐事件排队。
薪酬已支付 / 薪酬付款已冲销 某次计算被标记为已支付 / 支付被撤销。
加班已支付 / 加班付款已冲销 加班费提前支付,在工资单之前,参见 加班。
结算已过账 / 结算已冲销 离职结算已批准 / 已冲销,参见 离职。
结算已付款 / 结算付款已冲销 记录 / 冲销一笔结算付款。

薪酬分录中的工资费用是期间实际赚取的报酬。

更正后的薪资(已付运行的新修订版)以更正当日为日期,与其所取代修订版的冲销一致,因此已报告的期间不会同时显示原始数字和更正后的数字。薪资更正同时会收回该运行的预支扣回,请参阅预支。

#发送顺序

付款、银行退款、结算付款或手动预支还款,只有在其所结算的凭证被 SolaCount 接受之后才会发送。在此之前,它在 SolaHR 中等待(“waiting_for_original”),并在之后立即发出,不占用重试次数。预支的支付及其凭证是同一步:如果凭证被拒绝(例如受套餐限制),预支保持原有状态,而不是在未发送任何内容的情况下被支付。

#执行工资运行

在最终运行中,会计交付 (SolaCount) 列出每个可用事件,其中包含 金额、状态、尝试、 SolaCount条目和详细信息。

状态 含义
待处理 / 发送中 正在交付队列中等待。
已交付 已被 SolaCount 接受;显示分录编号。
将重试 临时故障;下次尝试 显示时间。
失败 已停止重试。修复原因(例如错误的科目 ID),然后点击 重试:“事件已放回交付队列”。
已跳过 日期早于发送事件起始日期,或者是从未发送的日记账冲销。被跳过的事件将不包含在对账中。

与 SolaCount 对账按每种日记账(薪资、付款、加班费付款、结算、应退还的多付款项、银行退款、预支支付、预支还款、员工报销申请)比较SolaHR 合计与已送达 SolaCount的金额、等待发送的金额、SolaCount 总账中的金额以及差异。状态为一致、等待发送、送达需要关注或会计差异。在发送起始日期之后的凭证之前结束的期间的薪资不计入。

当交付关闭时,卡片显示“此组织的交付到SolaCount已关闭”。

#工作示例

{Organization name}在 SolaCount 中记账。所有者打开工资设置 → 连接 SolaCount,接受建议的科目,用在 SolaCount 中创建创建缺少的应付结算款科目,将发送自此日期起的分录设为 2026 年 11 月 1 日,然后点击连接。卡片显示已连接。11 月工资获批且工资实际发放后,将该批次标记为已支付。这会同时将“工资已过账”和“工资已支付”加入队列。请确认两者都变为“已送达”并带有 SolaCount 分录编号,且对账显示“一致”。

#员工报销单

开启将员工报销单发送到 SolaCount,即可把已批准的费用报销单交给 SolaCount 审核、过账和付款。该开关默认关闭。报销单、收据和状态的运作方式请参见费用。

#薪资应计模式

选择薪资成本在 SolaCount 中何时入账。

  • 付款时为默认设置。运行标记为已付时,两笔凭证都会发送:日期为发薪期末的成本凭证,以及日期为付款日的付款凭证。
  • 批准时在运行获批时发送成本凭证;付款凭证在付款时随后发送。您需要选择一个开始日期。该日期之前月份的运行保持原模式,且任何运行都不会被发送两次。

#新增科目映射

  • 员工应收款(多付款项)是资产科目,用于记录员工收到但本不应得的款项,例如已支付的运行被冲销之后。
  • 预支款期初余额抵销是用于平衡期初分录的科目,针对会计开始前已存在的预支款。

#预支款会计

设置预支款会计起始日期。自该日期起,SolaHR 会为预支款发放、预支款暂停以及手动登记的还款发送日记账。更早发放的预支款按下文的历史处理决定办理。

#历史预支款

打开历史预支款对账报表。它列出起始日期之前所有未清的预支款。然后由财务管理员为整个组织作出一次性决定。

  • 已手工入账:您的账簿中已包含这些预支款,因此不发送任何内容。
  • 一笔期初分录:用一条日记账记录未清余额合计。
  • 每笔预支款一笔期初分录:为每笔预支款单独生成一条日记账。

该决定与您审阅的报表绑定。如果之后预支款发生变化,您必须重新审阅报表。历史预支款绝不会被自动发送。

#冲销已支付的薪资运行

  • 冲销已支付的运行会将其标记为已冲销。由于款项已经离开银行,它不会冲销银行付款。
  • 每位员工的实发工资会在员工应收科目中记为多付款项,即员工应归还的金额。
  • 如果员工确实把钱退回银行,请在该运行上登记银行退款,这会减少多付款项。
  • 重新发放已冲销的运行以创建新版本。其工资首先用于结清该运行自身未清的多付款项。其他月份的多付款项不会被自动抵销。

#计划任务

  • 向 SolaCount 的投递每 5 分钟运行一次,并重试失败的项目。
  • 状态对账每小时运行一次,修正任何漏掉状态更新的报销单或日记账。

#提示与常见问题

问题 原因 解决方法
没有任何信息传递到 SolaCount。 发放已关闭,或事件早于开始日期。 打开交付;检查发送事件的日期从起。
需要升级 —— “不包含 SolaHR 集成” SolaCount 低于 Premium,或其订阅已到期。 请将 SolaCount 升级到 Premium、Advanced 或 Enterprise,或续订。
卡片显示“请将 SolaHR 升级到 Premium 或 Enterprise”。 SolaHR 低于 Premium。 请升级 SolaHR。
分录以“plan_required”状态等待。 两个套餐之一低于 Premium。 请升级消息中指明的应用;之后分录会自动发送。
卡片显示需要注意。 与 SolaCount 的最近一次检查失败。 点击测试连接;如果仍然失败,请点击更新连接密钥。
“目前无法连接到 SolaCount。” 临时网络问题。 请稍后重试。
连接后需要审查。 缺少必填科目或开始日期。 请在卡片上选择并保存。
报销单未送达 SolaCount。 投递已关闭,或 SolaCount 中未启用报销单(“此 SolaCount 组织未启用员工报销单”)。 在 SolaHR 中开启投递,并在 SolaCount 中启用报销单。
事件显示为失败。 SolaCount 拒绝它,通常是因为未映射或错误的科目。 修复映射后,重试。
对账显示 交付后已更改。 运行在其分录交付后被更改。 与财务部门一起审查本机工资更正/冲销工作流程和实际事件历史记录。仅批准不会发送新的工资日记帐。

#业务解决方案和示例

遵循完整的业务工作流程 了解先决条件、应用程序切换、预期余额和常见异常。