# Supplier onboarding

URL: /systems/supplier-onboarding · Id: `system:supplier-onboarding`

> Supplier onboarding recruits Suppliers: applications, identity and background checks, tax details, Agreements and a first assignment.

Supplier onboarding recruits [Suppliers](/business/nouns/supplier): applications, identity and background checks, tax details, [Agreements](/business/nouns/agreement) and a first assignment. A Supplier goes active only when every check has passed.

## Summary
| Part | This System |
| --- | --- |
| Group | Commerce and fulfillment |
| Status | Beta: it works, and its Verbs may still change |
| Shelf | Wakes: offered once its Event fires |

You can ask:

- “Onboard a new supplier”
- “Run a background check on this supplier”
- “Suspend this supplier”
- “Which suppliers are still waiting on paperwork?”

## What you get
| Part | This System |
| --- | --- |
| Starts | Opt-in: it wakes with the Product Templates that need it ([Marketplace](/products/templates/marketplace), [Licensed-human marketplace](/products/templates/licensed-marketplace), [E2E managed service](/products/templates/managed-service)). |
| Wakes | On [`Human.remitted`](/business/events/Human.remitted) when the payout goes to a supplying Human. |
| Built from | [Identity](/code/platform/identity), [Integrations](/code/platform/integrations), [Workflows](/code/platform/workflows), [Party screening](/systems/legal-and-corporate/party-screening), [Background checks](/systems/people/background-checks) |

## Nouns it owns
| Noun | Definition |
| --- | --- |
| [Supplier](/business/nouns/supplier) | A Supplier is a Person or Company that delivers work through a Startup’s human supply: recruited, credentialed, and paid out. |

## Verbs
| Verb | Object | Approval | Event |
| --- | --- | --- | --- |
| [Human.recruit](/business/nouns/human/recruit) | [Human](/business/nouns/human) | None | [`Human.recruited`](/business/events/Human.recruited) |
| [Human.onboard](/business/nouns/human/onboard) | [Human](/business/nouns/human) | None | [`Human.onboarded`](/business/events/Human.onboarded) |
| [Human.suspend](/business/nouns/human/suspend) | [Human](/business/nouns/human) | None | [`Human.suspended`](/business/events/Human.suspended) |

## Events
| Direction | Event | How |
| --- | --- | --- |
| Emits | [`Human.recruited`](/business/events/Human.recruited) | By [Human.recruit](/business/nouns/human/recruit) |
| Emits | [`Human.onboarded`](/business/events/Human.onboarded) | By [Human.onboard](/business/nouns/human/onboard) |
| Emits | [`Human.suspended`](/business/events/Human.suspended) | By [Human.suspend](/business/nouns/human/suspend) |

## States
None.

## Who operates it
| Part | This System |
| --- | --- |
| Accountable | [Supply Manager](/agents/operations/supply-manager) |
| Team | [Operations Team](/agents/operations) |
| Seat | A role agent holds it until a Human is seated. |
| Autonomy | `supervised` |
| Also calls its Verbs | [People Lead](/agents/people/people-lead), [Recruiter](/agents/people/recruiter) |

## Approvals and limits
| Verb | Rule | Detail |
| --- | --- | --- |
| [Human.recruit](/business/nouns/human/recruit) | Limit for the [Recruiter](/agents/people/recruiter) | 10 calls per month |

## Processes that use it
| Process | How it uses it |
| --- | --- |
| [Supply](/workflows/processes/supply) | A step calls [Human.recruit](/business/nouns/human/recruit) |
| [Hiring](/workflows/processes/hiring) | A step calls [Human.recruit](/business/nouns/human/recruit) |
| [Staffing](/workflows/processes/staffing) | A step calls [Human.onboard](/business/nouns/human/onboard) |

## Rail underneath
Stripe’s products (Stripe’s names): **Connect**.

| Capability | Runs on |
| --- | --- |
| [Background checks](/systems/people/background-checks) | verifications.services |

## Views and dashboards
| View | Shows | Metrics |
| --- | --- | --- |
| The [Supply Manager](/agents/operations/supply-manager)’s view | The Metrics its accountable Role answers for. | [Fill rate](/agents/operations#fill-rate) |

## Access
What each Access level may call here.

| Access level | May call |
| --- | --- |
| `owner` | Every Verb (8) |
| `admin` | Every Verb (8) |
| `member` | Every Verb (8) |
| `viewer` | Read only (2 of 8) |

## Import and export
None.

## Fees and pricing
None.

## Availability and limits
| Part | This System |
| --- | --- |
| Status | Beta: it works, and its Verbs may still change |

## Compliance notes
Each Supplier is verified by Stripe before the first payout and signs their Agreement before the first job; who to accept stays the founder’s.

Controls it carries:

- [Worker competence](/systems/trust-and-governance/controls/worker-competence)
- [Fraud screening](/systems/trust-and-governance/controls/fraud-screening)
- [Authenticated Actions](/systems/trust-and-governance/controls/authenticated-actions)
- [Task-bound access](/systems/trust-and-governance/controls/task-bound-access)
- [Boundary protection](/systems/trust-and-governance/controls/boundary-protection)
- [Upstream review](/systems/trust-and-governance/controls/upstream-review)
- [Action completion](/systems/trust-and-governance/controls/action-completion)

## Related Systems
- [Credentialing](/systems/credentialing)
- [Earnings](/systems/payouts)
- [Dispatch](/systems/dispatch)
- [Matchmaking](/systems/matching): also holds [Supplier](/business/nouns/supplier)

## Example
A [Marketplace](/products/templates/marketplace) of video editors receives 90 applications in a week at `/join`. Supplier onboarding verifies identity, runs background checks on the 40 who pass a test edit, collects tax details and signs each Agreement. The first job goes out the day a Supplier activates.