| name | ifrs-revenue-recognition |
| description | IFRS 15 (full IFRS) and Section 23 (IFRS for SMEs) revenue recognition for Chwezi systems. Covers contract identification, performance obligations, transaction price, allocation, timing of recognition, contract assets and liabilities, refunds, warranties, principal-vs-agent, and disclosures. Use when revenue, sales contracts, subscription billing, multi-element arrangements, deferred revenue, retention, percentage of completion, agency fees, or revenue disclosures are in scope. |
IFRS Revenue Recognition (IFRS 15 / Section 23)
Overview
Revenue recognition policy in Chwezi systems follows IFRS for SMEs Section 23 by default and IFRS 15 for full-IFRS entities. The two standards converge on outcome for most simple sales; they diverge on multi-element, long-duration, and variable-consideration contracts.
Required first reads
doctrine/accounting-finance-doctrine.mddoctrine/references/ifrs-for-smes-default.md (Section 23)doctrine/references/full-ifrs-overlay.md (IFRS 15)doctrine/references/tax-vat-and-returns.md (VAT interaction)doctrine/references/chart-of-accounts.md
Section 23 (IFRS for SMEs) summary
Revenue from sale of goods is recognised when:
- The entity has transferred to the buyer the significant risks and rewards of ownership.
- The entity retains no continuing managerial involvement to the degree usually associated with ownership.
- The amount of revenue can be measured reliably.
- It is probable that the economic benefits will flow to the entity.
- The costs incurred can be measured reliably.
Revenue from rendering of services is recognised by reference to the stage of completion when the outcome can be estimated reliably. Otherwise, recognise revenue only to the extent of recoverable expenses incurred.
Construction-type contracts use the percentage-of-completion method when outcome is reliable.
Interest, royalties, and dividends have specific rules (effective-interest, accrual, right-to-receive).
IFRS 15 five-step model
- Identify the contract(s) with a customer.
- Identify the performance obligations in the contract.
- Determine the transaction price.
- Allocate the transaction price to the performance obligations.
- Recognise revenue when (or as) the entity satisfies a performance obligation.
When to apply which
The entity's Framework: header determines the standard:
- IFRS → IFRS 15.
- IFRS for SMEs → Section 23.
Where outcome is materially the same, the system uses one engine; the framework header drives disclosure differences.
Build implications
Contract / performance-obligation model
- Contract entity persists the customer agreement, term, and total price.
- Performance obligations are line-level rows: distinct goods or services promised. Each carries an allocated transaction price and a recognition method (point-in-time or over-time).
- Recognition triggers per performance obligation: delivery, acceptance, time elapsed, milestone, customer use, %-of-completion measure.
Transaction price
- Fixed and variable components (discounts, rebates, incentives, performance bonuses, penalties).
- Variable consideration estimated at expected value or most-likely-amount; constrained to highly probable amounts.
- Significant financing component recognised separately where the contract spans more than one year and the time-value-of-money is material.
- Non-cash consideration at fair value.
- Consideration payable to a customer (rebates, slotting fees) deducted from revenue unless it is payment for a distinct good or service.
Allocation
- Stand-alone selling prices used to allocate the transaction price across performance obligations.
- Where stand-alone is not observable, adjusted-market, expected-cost-plus-margin, or residual approach.
Timing
- Point-in-time: when control transfers (delivery, acceptance, transfer of risks and rewards under Section 23).
- Over-time: when one of the IFRS 15 over-time criteria is met; output method or input method to measure progress.
- Construction-type: Section 23 mandates % of completion when outcome reliable.
Contract assets and liabilities
- Contract asset when entity has performed but not yet billed (unbilled receivable).
- Contract liability (deferred revenue / customer advance) when entity has been paid but not yet performed.
- Trade receivable only when an unconditional right to consideration exists.
Refunds, warranties, returns
- Refund liability and right to recover product asset for expected returns.
- Assurance-type warranties: provision under IAS 37 / Section 21.
- Service-type warranties: separate performance obligation.
Principal vs agent
- The entity is a principal if it controls the good or service before transfer; otherwise an agent earning a commission.
- Indicators: primary responsibility for fulfilment, inventory risk, pricing discretion, credit risk.
- Principal recognises gross revenue; agent recognises net commission.
Disclosures
- Disaggregation of revenue (by category, geography, market, type, contract duration).
- Contract balances roll-forward.
- Performance obligation descriptions and timing.
- Significant judgements.
- Costs to obtain or fulfil a contract (capitalised vs expensed).
CoA implications
| Concept | Account |
|---|
| Revenue | 4000 / 4100 / sub-accounts by line. |
| Sales returns | 4200 (contra). |
| Trade discounts | 4300 (contra). |
| Contract asset | 1320 Other Receivables (or a dedicated 1330-range account). |
| Contract liability / deferred revenue | 2200 Customer Advances / Deferred Revenue. |
| Refund liability | new account under 2200-range. |
Evidence Produced
| Category | Artifact | Format | Example |
|---|
| Correctness | IFRS 15 judgement matrix | Markdown using references/advanced-ifrs15-judgement-matrix.md | docs/ifrs-workpapers/ifrs15-<id>.md |
| Release evidence | Contract balance and disclosure reconciliation | Markdown decision record | docs/ifrs-workpapers/revenue-<period>.md |
| Right-to-recover product | new asset under 1500-range inventory. | | |
| Costs to obtain a contract (capitalised) | new intangible asset account (Section 23 generally expenses; IFRS 15 may capitalise). | | |
VAT interaction
VAT applies at the point of supply per the country's VAT Act; this may not coincide with IFRS 15 / Section 23 recognition. The posting service records the tax effect at the VAT point of supply (output VAT on supply) and the revenue effect per IFRS / Section 23; the two effects sit on different journal lines. The VAT return uses the supply date; the revenue report uses the recognition date.
Forbidden patterns
- Recognising revenue when the conditions in step 5 / Section 23.14 are not met (blocker).
- Recognising gross when the entity is acting as agent (blocker).
- Cash-basis revenue presented as IFRS-compliant (blocker).
- Mixing percentage-of-completion and completed-contract within the same project type (blocker without policy change).
- Deferred revenue collapsed into trade payables (blocker).
Acceptance evidence
- Contract registry with performance obligations and recognition triggers.
- Allocation worksheet for multi-element contracts.
- Variable-consideration estimation log with reviewer.
- Contract-balances roll-forward.
- Recognition journals tested for trigger-driven posting.
- Disclosure pack generated.
Files
SKILL.md.references/section-23-summary.md.references/ifrs-15-five-step.md.examples/multi-element-software-licence-plus-support.md.references/advanced-ifrs15-judgement-matrix.md.examples/variable-consideration-and-modification.md.
Last reviewed: 2026-05-12. Next review due: 2026-11-12.
Prerequisites
- Load
doctrine/accounting-finance-doctrine.md before applying this skill.
- Load
governance/finance-accounting-quality-gate.md when the output is a release, client artefact, SRS, SDS, proposal, business plan, or implementation plan.
- Use
doctrine/source-register/ for final statutory, tax, payroll, FX, EFRIS, eTIMS, or authority-template values.
Inputs
| Artifact | Produced by | Required? | Validation |
|---|
| Finance context map | finance-module-audit | Required | Entity, framework, jurisdiction, modules, users, and deployment context are named. |
| Doctrine baseline | Doctrine owner | Required | Doctrine version and reporting framework are stated. |
| Source-register snapshot | tax-statutory-source-register-and-country-packs | Required for final statutory output | Entries are verified-current or reviewer-approved verified-with-caveat. |
| Ledger/posting context | ledger-posting-engine-core | Required when postings are affected | Posting boundary, CoA mappings, control accounts, dimensions, and period state are known. |
Outputs
| Artifact | Consumed by | Acceptance evidence |
|---|
| Skill-specific decision record | Implementer, reviewer, quality gate | Scope, assumptions, chosen treatment, rejected alternatives, and caveats are recorded. |
| Implementation or workflow contract | Software, SRS, SDS, proposal, or business-plan engine | Contract names inputs, outputs, controls, evidence, and failure conditions. |
| Acceptance evidence | Finance quality gate | Tests, fixtures, examples, source links, reviewer sign-off, or evidence-pack references are present. |
| Plain-language explanation | Client, owner, manager, operator | Business meaning is stated before technical accounting treatment where client-facing. |
Decision Rules
- Prefer IFRS for SMEs for typical SME entities unless full IFRS, local law, donor requirements, or client policy requires otherwise.
- Treat every money-touching workflow as ledger, control, reconciliation, evidence, and reporting scope.
- Do not finalize statutory values without source-register support and reviewer status.
- Use business-language output for operators and accountant-language output for ledger, reporting, and audit users.
- Escalate uncertain framework, tax, or statutory interpretations to the required reviewer role instead of presenting them as final.
Acceptance Evidence
- Inputs and outputs above are present or explicitly marked not applicable.
- Relevant quality-gate blockers have been checked and no blocker remains unresolved.
- Examples or fixtures cover at least one happy path and one failure or caveat path for this skill's domain.
- Reviewer role, review date, and open caveats are recorded for release-grade artefacts.
Anti-Patterns
- Treating draft planning assumptions as final statutory or accounting facts.
- Hiding tax, payroll, FX, or authority-template caveats in prose instead of source-register state.
- Producing technically correct accounting output without a plain-language layer for non-accountant users.
- Closing a remediation or implementation item without observable evidence.
Required References
doctrine/accounting-finance-doctrine.md.governance/finance-accounting-quality-gate.md.docs/reference-manifest.md for declared reference states.- Domain-specific references listed earlier in this skill.
Examples
- Include at least one normal workflow example for this skill's domain.
- Include at least one exception, rejection, reversal, stale-source, or reviewer-caveat example where the domain can fail.
Review Metadata
Last reviewed: 2026-05-15. Next review due: 2026-11-15.
