BusinessMade

These are the endpoints behind BusinessMade: hiring through offboarding, timesheets through payroll, and a double-entry ledger underneath it. Several dozen controllers, several hundred routes, and 57 bm_* datatypes.

This page is the API surface. For what each area does and how to use it, read the product docs:

Setup and seeding

Start here on a new tenant — nothing else works well against an empty chart of accounts.

Scenarios and modules are the templated paths — apply an industry profile rather than configuring every piece by hand.

Employees

Filtered views: /department/:department, /location/:location, /status/active, /supervisor/:supervisorId, /skill/:skillName.

Per-employee records — time off, reviews, training, skills and onboarding tasks — hang off /business-made/employees/:id/….

Reports: /reports/headcount, /reports/anniversaries, /reports/birthdays, and /employees/training/expired.

Timesheets and time clock

Approval flow — POST /business-made/timesheets/:id/<action> for submit, approve, reject, reopen. Entries are managed at /:id/entries[/:entryId].

Reports: /reports/summary/:employeeId, /reports/team-status, /reports/missing.

/reports/missing is the one that matters before running payroll.

Payroll

Two controllers — payroll.controller (34 routes) and payroll-config.controller (50) — sharing the /business-made/payroll prefix.

Runs

The sequence is create → calculate → approve → process. parallel-check re-computes independently and compares — a self-check before money moves.

Call blockers before calculate: it lists what would make the run wrong — missing timesheets, unverified bank accounts, incomplete tax setup.

Pay stubs

Employee payroll profiles

Direct deposit requires a verified account; adding one is not enough.

Employer tax setup

Reports

Configuration — earning types, deduction types, tax rules, pay periods and schedules — lives in payroll-config.controller. Datatypes: bm_earning_type, bm_deduction_type, bm_tax_rule, bm_pay_period, bm_payroll_schedule, bm_payroll_run, bm_pay_stub, bm_payroll_profile, bm_tax_form.

Government e-filing

Owner, ConfigAdmin or RootAdmin only (anyone else gets 403 EFILE_ADMIN_ONLY). For the how-to, see Contractors, taxes, forms and filings and Set up government filing.

IRS API connections, one per program — iris (1099 filing), tinm (TIN Matching) or eservices. The private key is write-only and never returned; a connection starts on the IRS test system, and production is refused until the owner turns on allowProduction. test requests a token and reports the stage that failed with the IRS error code. Every transmission is recorded as a submission; files/:kind downloads its payload or ack.

IRIS 1099 e-filing (1099-NEC or 1099-MISC), against the IRS test (ATS) system. prepare builds and validates only; transmit sends it; refresh asks the IRS for the acknowledgement now (a queue job also polls). No response carries the transmission XML — it holds payee TINs.

IRS TIN Matching for 1099 payees: interactive for up to 25 payees, bulk for up to 100,000 (or scope: "all_1099_payees"). Each answer is written on the payee record as tinMatch.

The SSA EFW2 W-2 wage file, built from the year's W-2s for upload to Business Services Online. It needs the BSO User ID in the employer setup (EFW2_BSO_USER_ID_MISSING otherwise) and is recorded as an e-file submission.

Full specifications: Government e-filing.

Books

Double-entry accounting, split across a reporting controller and a posting controller that share /business-made/books.

Accounts and journals

A journal is created in draft and only affects the ledger once posted.

Reports

P&L and balance sheet also render as PDF: /reports/pl/pdf, /reports/balance-sheet/pdf.

Automatic posting

Commerce activity posts to the ledger through a configurable account map, so a sale in the storefront becomes journal entries without manual work.

Repair tools, for when the ledger and the source records disagree:

balance-drift detects the divergence; repair corrects it. resume-postings re-runs postings that failed and were parked.

Datatypes: ledger_account, ledger_entry, journal_entry.

Period close

Checklist-driven. lock freezes the period; reopen unfreezes it. Run books/reports/close-check first.

Bills and vendors

Accounts payable — bills, payments and vendors (bm_bill, bm_bill_payment, bm_vendor). Receivables live on the commerce side, under invoices.

Recruitment

Job postings, applicants, interviews and offers (bm_job_posting, bm_applicant, bm_interview, bm_offer). Feeds onboarding on acceptance.

Onboarding and offboarding

Offboarding (21 routes) covers exit checklists and exit interviews — bm_offboarding, bm_exit_interview.

Leave

29 routes covering leave types, policies, balances and requests — bm_leave_type, bm_leave_policy, bm_leave_balance, bm_leave_request.

Simple time-off requests can also go through POST /business-made/employees/:id/time-off/request, which is the same data reached from the employee record.

Benefits

Waiving is a recorded decision, not an absence of one — which is what open-enrollment compliance needs.

Performance and learning

Performance (31 routes) — goals, reviews and PIPs (bm_goal, bm_performance_review, bm_pip).

Learning (32 routes) — courses, certifications, learning paths and enrollments (bm_course, bm_certification, bm_learning_path, bm_course_enrollment).

Compensation

28 routes — salary grades, compensation changes and bonuses (bm_salary_grade, bm_compensation_change, bm_bonus).

Organization

32 routes — departments, positions and org charts (bm_department, bm_position, bm_org_chart).

Documents and policies

31 routes — employee documents, policies and acknowledgements (bm_employee_document, bm_policy, bm_policy_acknowledgement). Acknowledgements are the audit trail that someone read the handbook.

Workforce readiness

Requirement rules (bm_requirement_rule) say what a person must have — a certification, a signed policy, a completed training — and what happens where it is missing. Each rule sets an effect per gate: scheduler, clockIn, pos, kitchenStation, payroll and access. kitchenStation is labelled Work station: it covers moving a ticket at any station on a work line — prep line, assembly, service bay — not only a kitchen; the key keeps its name so stored rules still apply. access withholds role and group grants at sign-in until the requirement is met. check returns the answer a gate would give, for screens that want to show it first.

Schedules

Shift scheduling (bm_schedule), 22 routes. Pairs with the time clock: scheduled versus actual is what /timesheets/reports/team-status compares.

Work orders

Field service — labor and materials on a job, linked to a customer (bm_work_order).

Employee self-service

Employees reach their own data through StaffPortalModule rather than these controllers:

Profile, pay method, schedule, timesheets, payslips and W-2 — scoped to the signed-in employee.