findscripter 何时使用
适用于在 Odoo 企业版中配置或排障人力与薪酬：
- 搭建包含毛工资、扣减项、净工资的薪资结构（salary structure）。
- 配置年假、病假、公共假日等休假政策与配额分配。
- 排查工资条金额错误、规则贡献缺失（如某条 salary rule 未生效）。
- 设置薪酬日记账，使其正确过账到会计。
不该用的边界：
- 社区版（Community）不含
hr_payroll模块，本技能不适用。 - 跨国混合薪酬（员工分布在不同国家）需各自独立结构与本地化，不在此覆盖。
- 不负责生成税务申报（W2、941、州 SUI/SDI 等），Odoo 本身也不直接出申报表。
- 通过工资条做的费用报销（里程、居家办公）需自定义 salary input，标准文档未覆盖。
步骤
- 先装本地化：在建任何自定义规则前，安装对应国家的薪酬本地化模块（如
l10n_us_hr_payroll、l10n_mx_hr_payroll），它已内置税务结构。 - 建合同：为每位员工建立 active 的 Employee Contract，填对起止日期与工资，否则无法生成工资条。
- 建薪资结构与规则：
Payroll → Configuration → Salary Structures → New，自上而下排列规则（顺序决定计算依赖）。 - 配休假类型与配额：
Time Off → Configuration → Time Off Types建类型，再Time Off → Managers → Allocations分配初始额度。 - 跑批与过账：验证薪酬批次后由 Odoo 自动生成会计分录，过账到薪酬日记账。
- 调试：若金额异常，逐条核对规则公式、类别（Category）与 input 取值，必要时取消重生成批次。
指令
薪资规则常用写法（公式按规则代码引用上游结果）：
Code | Name | Formula | Category
BASIC | Basic Wage | contract.wage | Basic
GROSS | Gross | BASIC | Gross
SS | Social Security (6.2%) | -GROSS * 0.062 | Deduction
MED | Medicare (1.45%) | -GROSS * 0.0145 | Deduction
FIT | Federal Income Tax | -GROSS * inputs.FIT_RATE.amount | Deduction
NET | Net Salary | GROSS + SS + MED + FIT | Net
- 用 salary input 传变量：
inputs.ALLOWANCE.amount、inputs.FIT_RATE.amount，把奖金、津贴、预扣税率等按员工动态传入，而非硬编码进公式。 - 联邦个税率：标准美国本地化不暴露单一
l10n_us_w4_rate字段，应用 salary input 按员工传率，或安装 OCA 社区模块l10n_us_hr_payroll（正确处理 W4 报税身份）。
示例
休假类型配置（Time Off → Configuration → Time Off Types → New）：
Name: Annual Leave / PTO
Approval: Time Off Officer
Leave Validation: Time Off Officer（单审批）；或 "Both" 走 HR + Manager 双审批
Allocation: ☑ 员工可自行分配，Requires approval: No
Negative Balance: Not allowed（不允许负余额）
初始配额：Time Off → Managers → Allocations → New
Employee / Time Off Type: Annual Leave / PTO / Allocation: 15 days
Validity: Jan 1 – Dec 31（当年）
薪酬过账结果（验证批次后自动生成）：
Debit Salary Expense Account $5,000.00
Credit Social Security Payable $310.00
Credit Medicare Payable $72.50
Credit Federal Tax Payable (varies)
Credit Salary Payable $4,617.50+
支付净工资时：
Debit Salary Payable $4,617.50
Credit Bank Account $4,617.50
雇主税（FUTA、SUTA 等）单独过账为独立分录。
注意事项
- 不要手改已过账工资条：需更正时取消并重新生成整个批次。
- 在扣减规则里用
contract.wage前，先确认结构是月薪还是年薪，核对合同的工资周期，避免按错口径计算。 - 归档而非删除旧薪资结构：在用的工资条引用其结构，删除会导致引用断裂。
- Odoo Payroll 仅企业版可用，社区版无
hr_payroll。 - 美国合规（W2、941、州 SUI/SDI）需基础本地化之外的额外模块。
互见
- 领域/ERP 其他 Odoo 配置技能（会计、合同管理）。
- 各国薪酬本地化模块文档：
l10n_*_hr_payroll、OCA 社区仓库。
采编自 sickn33/antigravity-awesome-skills（MIT）。