RemoFirst Common Errors

Overview

Implementation patterns for RemoFirst common errors — global HR and EOR platform integration.

Prerequisites

• Completed remofirst-install-auth setup

Instructions

Step 1: API Pattern

client = RemoFirstClient()
employees = client.get("/employees", params={"page_size": 10})
print(f"Employees: {len(employees['data'])}")

Output

• RemoFirst integration for common errors

Error Handling

Resources

• RemoFirst

Next Steps

See related RemoFirst skills for more workflows.

RemoFirst Core Workflow A

Overview

Employee onboarding workflow: create employee records, manage documents, handle country-specific compliance requirements.

Prerequisites

• Completed remofirst-install-auth

Instructions

Step 1: Create Employee Record

employee = client.post("/employees", {
    "first_name": "Alice",
    "last_name": "Johnson",
    "email": "alice@company.com",
    "country_code": "GB",  # United Kingdom
    "job_title": "Senior Engineer",
    "start_date": "2026-05-01",
    "salary": {
        "amount": 85000,
        "currency": "GBP",
        "frequency": "annual",
    },
    "employment_type": "full_time",
})
print(f"Employee created: {employee['id']}")

Step 2: Check Country Requirements

# Get country-specific onboarding requirements
requirements = client.get(f"/countries/GB/requirements")
for req in requirements["documents"]:
    print(f"  Required: {req['name']} — {req['description']}")
    # Examples: Passport, National Insurance Number, Bank Details, P45

Step 3: Submit Onboarding Documents

# Upload required documents
client.post(f"/employees/{employee['id']}/documents", {
    "document_type": "passport",
    "file_url": "https://secure-storage.com/passport.pdf",
    "expiry_date": "2030-12-31",
})

Step 4: Track Onboarding Status

status = client.get(f"/employees/{employee['id']}/onboarding")
print(f"Onboarding status: {status['status']}")  # pending, in_progress, completed
for step in status["steps"]:
    print(f"  {step['name']}: {step['status']}")

Output

• Employee record created with salary and country
• Country-specific requirements checked
• Documents uploaded for compliance
• Onboarding progress tracked

Error Handling

Resources

• …

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

RemoFirst Debug Bundle

Overview

Implementation patterns for RemoFirst debug bundle — global HR and EOR platform integration.

Prerequisites

• Completed remofirst-install-auth setup

Instructions

Step 1: API Pattern

client = RemoFirstClient()
employees = client.get("/employees", params={"page_size": 10})
print(f"Employees: {len(employees['data'])}")

Output

• RemoFirst integration for debug bundle

Error Handling

Resources

• RemoFirst

Next Steps

See related RemoFirst skills for more workflows.

RemoFirst Hello World

Overview

Implementation patterns for RemoFirst hello world — global HR and EOR platform integration.

Prerequisites

• Completed remofirst-install-auth setup

Instructions

Step 1: API Pattern

client = RemoFirstClient()
employees = client.get("/employees", params={"page_size": 10})
print(f"Employees: {len(employees['data'])}")

Output

• RemoFirst integration for hello world

Error Handling

Resources

• RemoFirst

Next Steps

See related RemoFirst skills for more workflows.

RemoFirst Install Auth

Overview

Set up RemoFirst API authentication for global HR and payroll integration. RemoFirst provides API access for enterprise customers.

Prerequisites

• RemoFirst enterprise account
• API credentials from RemoFirst support team
• Node.js 18+ or Python 3.9+

Instructions

Step 1: Get API Credentials

1. Contact RemoFirst support for API access
2. Receive API key and base URL
3. Note: Sandbox environment available for testing

Step 2: Configure Environment

# .env
REMOFIRST_API_KEY=your_api_key
REMOFIRST_BASE_URL=https://api.remofirst.com/v1

Step 3: Initialize Client

import os, requests

class RemoFirstClient:
    def __init__(self):
        self.base_url = os.environ["REMOFIRST_BASE_URL"]
        self.headers = {
            "Authorization": f"Bearer {os.environ['REMOFIRST_API_KEY']}",
            "Content-Type": "application/json",
        }

    def get(self, path, params=None):
        resp = requests.get(f"{self.base_url}{path}", headers=self.headers, params=params)
        resp.raise_for_status()
        return resp.json()

    def post(self, path, data):
        resp = requests.post(f"{self.base_url}{path}", headers=self.headers, json=data)
        resp.raise_for_status()
        return resp.json()

client = RemoFirstClient()

Step 4: Verify Connection

company = client.get("/company")
print(f"Connected! Company: {company['name']}")
print(f"Countries: {len(company.get('active_countries', []))}")

Output

• API credentials configured
• Client initialized with authentication
• Connection verified

Error Handling

Resources

• RemoFirst
• Global HR Solutions

Next Steps

First API call: remofirst-hello-world

RemoFirst Local Dev Loop

Overview

Implementation patterns for RemoFirst local dev loop — global HR and EOR platform integration.

Prerequisites

• Completed remofirst-install-auth setup

Instructions

Step 1: API Pattern

client = RemoFirstClient()
employees = client.get("/employees", params={"page_size": 10})
print(f"Employees: {len(employees['data'])}")

Output

• RemoFirst integration for local dev loop

Error Handling

Resources

• RemoFirst

Next Steps

See related RemoFirst skills for more workflows.

RemoFirst Prod Checklist

Overview

Implementation patterns for RemoFirst prod checklist — global HR and EOR platform integration.

Prerequisites

• Completed remofirst-install-auth setup

Instructions

Step 1: API Pattern

client = RemoFirstClient()
employees = client.get("/employees", params={"page_size": 10})
print(f"Employees: {len(employees['data'])}")

Output

• RemoFirst integration for prod checklist

Error Handling

Resources

• RemoFirst

Next Steps

See related RemoFirst skills for more workflows.

RemoFirst Rate Limits

Overview

Implementation patterns for RemoFirst rate limits — global HR and EOR platform integration.

Prerequisites

• Completed remofirst-install-auth setup

Instructions

Step 1: API Pattern

client = RemoFirstClient()
employees = client.get("/employees", params={"page_size": 10})
print(f"Employees: {len(employees['data'])}")

Output

• RemoFirst integration for rate limits

Error Handling

Resources

• RemoFirst

Next Steps

See related RemoFirst skills for more workflows.

RemoFirst Sdk Patterns

Overview

Implementation patterns for RemoFirst sdk patterns — global HR and EOR platform integration.

Prerequisites

• Completed remofirst-install-auth setup

Instructions

Step 1: API Pattern

client = RemoFirstClient()
employees = client.get("/employees", params={"page_size": 10})
print(f"Employees: {len(employees['data'])}")

Output

• RemoFirst integration for sdk patterns

Error Handling

Resources

• RemoFirst

Next Steps

See related RemoFirst skills for more workflows.

RemoFirst Security Basics

Overview

Implementation patterns for RemoFirst security basics — global HR and EOR platform integration.

Prerequisites

• Completed remofirst-install-auth setup

Instructions

Step 1: API Pattern

client = RemoFirstClient()
employees = client.get("/employees", params={"page_size": 10})
print(f"Employees: {len(employees['data'])}")

Output

• RemoFirst integration for security basics

Error Handling

Resources

• RemoFirst

Next Steps

See related RemoFirst skills for more workflows.

RemoFirst Upgrade Migration

Overview

Implementation patterns for RemoFirst upgrade migration — global HR and EOR platform integration.

Prerequisites

• Completed remofirst-install-auth setup

Instructions

Step 1: API Pattern

client = RemoFirstClient()
employees = client.get("/employees", params={"page_size": 10})
print(f"Employees: {len(employees['data'])}")

Output

• RemoFirst integration for upgrade migration

Error Handling

Resources

• RemoFirst

Next Steps

See related RemoFirst skills for more workflows.