Share Admin Setup

Use this sequence when introducing or revising a share product.

1. Review The Seeded Type Taxonomy

Open Administration → Shares → Type Taxonomy.

This page is for review, not ongoing end-user maintenance. It shows the seeded share types and the flag profiles attached to them.

Use it to confirm:

• product group
• product type
• key characteristics
• the number of flags attached to each type

The platform flag definitions and type-level flag assignments are seeded. They are not managed from the normal shares administration flow.

2. Configure Tax Rules First When Taxation Is Enabled

Open Administration → Shares → Tax Configs.

Create approved tax configurations before you create or edit a product that uses the TAXATION_ENABLED flag.

Use this page for share-domain tax rules such as:

• dividend withholding
• capital gains tax
• transfer tax
• stamp duty

The share product does not use a pricing profile as its tax link anymore. It now links to an approved and currently effective share tax configuration.

3. Create The Share Product

Open Administration → Shares → Share Products.

Configure the base product information:

• name
• taxonomy
• currency
• par value
• issue limits
• dividend policy
• governance defaults
• membership and contribution fields
• pricing profile
• tax configuration

Then use Runtime Flags & Integrations to review the flags loaded from the selected type and apply only the permitted product-level overrides.

Pricing vs Tax Linkage

Use the two lookups differently:

• Pricing Profile: fees, rates, valuations, and other pricing-engine behavior
• Tax Configuration: approved share tax rates and effective-date tax treatment

If the resolved runtime flags enable:

• PRICING_INTEGRATION_ENABLED, the product must have a valid approved active pricing profile
• TAXATION_ENABLED, the product must have a valid approved effective tax configuration

The backend now enforces both rules during create and update.

4. Review The Runtime Preview

Before saving or approving the product, review the preview for:

• available workflows
• account components
• dividend behavior
• governance rights
• lending restrictions
• pricing and taxation dependencies

If the preview is wrong, adjust the selected product overrides or review whether the chosen share type is the right one.

5. Complete GL Setup

Use:

• Administration → Shares → GL Links
• Administration → Shares → Posting Rules

These two layers are both required:

• GL links tell PinkApple which standing accounts the product uses
• posting rules define how operational events become journals

Without complete GL setup, a share transaction may validate operationally but fail when the accounting event is posted.

6. Apply Business Unit Restrictions

Use Administration → Shares → BU Restrictions if the product should only operate in specific business units.

7. Validate Related Domain Dependencies

Check the external domains that the product expects to use:

• Clients for member, employee, KYC, age, and segment restrictions
• Pricing for fee, valuation, and tier logic
• Shares Tax Configs for share-product withholding and other share tax rules
• Loans for share-backed lending rules
• Deposits / Cash for funding and dividend payout routing
• Governance for meetings and voting execution

8. Test Transaction Outcomes

Before production use, test at least:

• immediate posting
• approval-routed posting
• rejected posting
• returned posting where applicable
• future-dated posting if allowed

Confirm that ownership state changes only happen after the GL outcome becomes terminal POSTED.

Operational Validation Example

The current product flow behaves like this:

• if taxation is enabled but no tax configuration is linked, product create/update is rejected with TAXATION_ENABLED requires a valid approved Share Tax Configuration on the share product
• if a legacy product still has taxation enabled but no linked tax config, runtime policy now returns a TAX_PROFILE_REQUIRED blocker
• if pricing and tax links are valid, product creation succeeds, but readiness can still remain blocked until GL links and posting rule maps are completed

Operational Note

If a share transaction goes through GL approval or scheduled future posting, PinkApple preserves the transaction intent first and applies ownership effects only after the final posting outcome succeeds. This prevents balances from changing before the accounting event is actually accepted.