remofirst-core-workflow-b

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

• RemoFirst Payroll
• Global Payroll Guide

Next Steps

Error handling: remofirst-common-errors