RemoFirst Core Workflow B

Overview

Payroll workflow: process payroll runs, manage benefits, handle multi-currency payments, and generate invoices.

Prerequisites

Completed remofirst-core-workflow-a (employee onboarding)

Instructions

Step 1: Get Payroll Summary

payroll = client.get("/payroll", params={
    "month": "2026-03",
    "country_code": "GB",
})
print(f"Payroll for {payroll['period']}:")
print(f"  Employees: {payroll['employee_count']}")
print(f"  Total gross: {payroll['currency']} {payroll['total_gross']}")
print(f"  Total employer cost: {payroll['currency']} {payroll['total_employer_cost']}")

Step 2: Review Employee Payslip

payslip = client.get(f"/employees/{employee_id}/payslips", params={"month": "2026-03"})
print(f"Gross: {payslip['gross_salary']}")
print(f"Deductions: {payslip['total_deductions']}")
print(f"  Tax: {payslip['income_tax']}")
print(f"  National Insurance: {payslip['social_security']}")
print(f"Net pay: {payslip['net_salary']}")

Step 3: Manage Benefits

benefits = client.get(f"/employees/{employee_id}/benefits")
for benefit in benefits:
    print(f"  {benefit['type']}: {benefit['provider']} — {benefit['status']}")
    # Types: health_insurance, pension, dental, vision

# Add benefit
client.post(f"/employees/{employee_id}/benefits", {
    "type": "health_insurance",
    "plan": "premium",
    "start_date": "2026-04-01",
})

Step 4: Generate Invoice

invoice = client.get("/invoices/current")
print(f"Invoice #{invoice['number']}")
print(f"  Period: {invoice['period']}")
print(f"  Total: {invoice['currency']} {invoice['total']}")
print(f"  Due date: {invoice['due_date']}")

Output

Payroll summary with gross/net calculations
Employee payslips with tax breakdowns
Benefits enrollment and management
Invoice generation and tracking

Error Handling

Error	Cause	Solution
Payroll not ready	Missing employee data	Complete onboarding first
Currency mismatch	Wrong country payroll	Check country_code filter
Benefits unavailable	Country not supported	Check country benefit options

Resources

Next Steps

Error handling: remofirst-common-errors