Create a CRM opportunity
Goal
Open a new pipeline opportunity against an existing customer/party.
Who it is for
Clerk with crm.manage.
Preconditions
- Module crm; at least one active pipeline stage.
- Party already exists (create customer first, or convert a lead).
- Options may require Expected close and/or Next step.
Steps
- Open CRM → Work → Pipeline → New opportunity (modal).
- Enter Title (required).
- Select Party and Stage (required).
- Set Value and Currency (currency defaults to tenant base currency), Expected close, Next step, Next step due, Source, Owner, Notes.
- Optionally add line items (item, description, quantity > 0, unit price) — required later for Convert to quote.
- Save. Opportunity starts Open.
Result
Deal appears on the stage column. Next: move stages or win / lose / convert.
Hard stops
- 422
expected_close_required/next_step_requiredwhen Options enforce them. unknown_party/unknown_stageif IDs invalid.