Planning SOA

Before you start

• The group's client file is up to date.
• For planning advice, the group has scenarios labelled Status quo and Recommended (and any Alternatives). See Plan with the assistant.
• A completed risk assessment is on file for each member receiving advice, or you are ready to record an adviser override.
• Your firm has an SOA template set up (Settings → Templates).

Where to find it

• Left sidebar → Document Library → Add Documents → Generate Digital Documents.
• Or open a group → Documents → Add Documents → Generate Digital Documents.
• In the Generate Documents window: choose the Household, set Select Document Type to SOA, select Generate with AI, then under Choose AI workflow select Planning.

Work through the eight stages

1. 1

   Step 1: Client: Who is this advice for?

   Confirm the household, adviser, document name and the members covered by this SOA.
2. 2

   Step 2: Scope: What advice are you giving?

   Choose the advice areas, document type, template and engagement context.
3. 3

   Step 3: Scenarios (optional): Choose the planning scenarios

   Select the status quo, the main recommendation and any alternatives used in the modelling.
4. 4

   Step 4: Risk (optional): Confirm the risk position

   Use the completed assessment on file, or record an explicit adviser override for each member.
5. 5

   Step 5: Position: Confirm the client position

   Review the client context, goals and current products that anchor the advice.
6. 6

   Step 6: Evidence (optional): Choose supporting evidence

   Review the notes and interactions Wealthie will use when drafting. Untick anything that should not be used.
7. 7

   Step 7: Advice: Build the recommendations

   Record your structured advice. Where the advice covers KiwiSaver or investment products, use KiwiSaver & investment products to select the current and recommended product for each member. These selections are used as facts in the SOA, so Wealthie does not choose products for you.
8. 8

   Step 8: Review: Review and generate

   Set the writing instructions and implementation plan, then confirm the inputs. Turn on Review structure first if you want to approve the section outline before Wealthie writes it. Select Generate SOA.

Generate and check the draft

1. 1

   Step 1: Approve the outline (if you chose to review it)

   Turn sections on or off, add notes, then select Generate full document.
2. 2

   Step 2: Wait for generation

   A progress window shows each phase, from planning the structure to drafting the narrative and assembling the document. Drafting is the longest step.
3. 3

   Step 3: Edit and check in the SOA editor

   The draft opens in the editor. Check every section, figure and recommendation before you issue it.

What you should see

• A draft SOA in the group's SOA folder, opened in the editor.
• Projection figures in the draft come from the selected scenarios.

What is saved or sent

• Generation creates a draft. Drafts are never visible to the client and nothing is emailed by generating.
• Drafts use the current records. When you issue the SOA, its figures are frozen as a snapshot. Changing the client file or scenarios later does not change the issued document.
• To change an issued SOA, use Revise issued document, which creates a new editable draft. The issued document is never changed in place.

If something goes wrong

Generate SOA is unavailable

The wizard lists the items to complete under Complete these items before generating. Common causes are missing product selections (risk profiles, providers, funds, actions and suitability notes) or an incomplete scenario selection (a valid status quo and main recommendation).

Generation failed

The progress window shows Generation failed and the phase where it stopped. Select Resume from where it failed, or Retry the previous phase too if the earlier phase's output looked wrong.

I closed the window after a failure

The failed run stays in the Document Library's SOA folder. Use Retry generation to resume it, or Open wizard to reload your previous inputs, adjust them and generate again. You can dismiss a failed run you no longer need.

Some sections didn't generate

Wealthie lists the sections that failed and will open empty. Choose Open editor anyway and complete them yourself, or cancel and generate again.