Initial accounting reports documentation

This commit is contained in:
GiorgioCALLIGARO
2026-05-05 16:32:55 +02:00
commit 72a2c2d04f
25 changed files with 3515 additions and 0 deletions

View File

@@ -0,0 +1,181 @@
# AP-001 Supplier Balance Report
## 1 Objective
Provide a summarized view of outstanding supplier balances at a selected closing date.
The report is used for:
- accounts payable monitoring;
- supplier balance review;
- reconciliation between the accounts payable subledger and the general ledger;
- payment preparation review;
- period-end and year-end closing analysis.
---
## 2 Users
- accounting department;
- accounts payable team;
- treasury or payment team;
- finance department;
- auditors;
- financial controlling.
---
## 3 Frequency
- daily;
- weekly payment review;
- monthly closing;
- year-end closing;
- ad hoc audit requests.
---
## 4 Parameters
Required parameters:
- `closing_date`
Optional parameters:
- `counterparty`
- `currency`
- `entity`
- `include_zero_balances`
Execution scope:
- the report is generated for the current entity unless an entity filter is explicitly supported by the ERP context;
- supplier balances are calculated as of `closing_date`;
- only accounts payable supplier balances are in scope.
---
## 5 Filters
- accounting closing date equal to `closing_date`;
- supplier or supplier range;
- currency;
- entity, when supported;
- include or exclude zero-balance suppliers based on `include_zero_balances`.
Out of scope filters:
- ageing bucket;
- payment status;
- invoice due date.
These are handled by `AP-002 Supplier Ageing Report` or `AP-003 Supplier Account Movements`.
---
## 6 Sorting
Default sorting:
1. `supplier`
2. `transaction_currency`
Secondary sorting:
- `supplier_name`
- `base_currency`
---
## 7 Grouping
Default grouping:
- `supplier`
- `transaction_currency`
Totals should be displayed by:
- supplier;
- transaction currency;
- base currency;
- report total.
Presentation requirements:
- each supplier should be displayed once per transaction currency;
- debit, credit and balance columns should be displayed side by side;
- opening balance and movement columns are mandatory;
- suppliers with zero closing balance should be excluded when `include_zero_balances = false`, unless they have movements or open items that must remain visible for reconciliation;
- blocked, inactive or archived suppliers should be displayed when they have a non-zero balance or non-zero debit or credit amounts;
- detailed invoice-level open items are out of scope for this report and belong to `AP-002 Supplier Ageing Report`.
- drill-down should be available from each supplier balance to supplier account movements, accounting documents and source documents when available.
---
## 8 Output Structure
Required columns:
| Column | Description |
| --- | --- |
| `entity` | Legal entity or company code |
| `supplier` | Supplier account code |
| `supplier_name` | Supplier legal or commercial name |
| `posting_status` | Posting status scope included in supplier balances, when exposed by the ERP |
| `transaction_currency` | Original transaction currency |
| `base_currency` | Functional or company base currency |
| `opening_balance_transaction_currency` | Opening supplier balance in transaction currency |
| `debit_transaction_currency` | Debit movement in transaction currency |
| `credit_transaction_currency` | Credit movement in transaction currency |
| `closing_balance_transaction_currency` | Closing supplier balance in transaction currency |
| `opening_balance_base_currency` | Opening supplier balance in base currency |
| `debit_base_currency` | Debit movement in base currency |
| `credit_base_currency` | Credit movement in base currency |
| `closing_balance_base_currency` | Closing supplier balance in base currency |
| `last_posting_date` | Last accounting posting date included in the supplier balance |
| `last_document_number` | Last accounting document number included in the supplier balance, when available |
Amount sign convention for this report:
- supplier payable balances are presented as positive credit balances;
- supplier debit balances, advances or overpayments are presented as negative balances;
- debit amounts are positive and credit amounts are negative when movement columns are shown.
---
## 9 Estimated volume
Medium.
The report is a summarized subledger report. It should contain one summarized line per supplier and transaction currency, not detailed invoice-level movements.
---
## 10 Export formats
- CSV
- XLSX
- PDF
XLSX and CSV are primary review and reconciliation formats. PDF is used for closing documentation and audit review.
---
## 11 Controls / reconciliation rules
- Supplier balance totals should reconcile with the accounts payable control accounts in the general ledger for the same current entity and closing date.
- Supplier balances in base currency should reconcile with the AP subledger total for the same closing date.
- Suppliers excluded by `include_zero_balances = false` should not change report totals.
- Supplier debit balances, advances or overpayments should remain visible and should not be netted against other suppliers.
- Blocked, inactive or archived suppliers should remain visible when they have a non-zero balance or non-zero debit or credit amounts.
- The report should retain enough references to reconcile from supplier balance summary to detailed supplier account movements.
- Drill-down from a supplier balance should reconcile to `AP-003 Supplier Account Movements` for the same current entity, supplier, currency and selected closing date.
---
## 12 Open questions
- Which ERP source will define the mapping between supplier balances and AP control accounts? This information is currently unknown.
- Should `posting_status` be displayed in the first implementation? This depends on the target ERP capabilities.

View File

@@ -0,0 +1,219 @@
# AP-002 Supplier Ageing Report
## 1 Objective
Provide an ageing analysis of supplier payables based on open supplier items at a selected closing date.
The report is used for:
- accounts payable follow-up;
- payment planning;
- overdue payable monitoring;
- supplier balance review;
- reconciliation with supplier balances;
- audit and closing review.
---
## 2 Users
- accounts payable team;
- accounting department;
- treasury or payment team;
- finance department;
- auditors.
---
## 3 Frequency
- daily;
- weekly payment review;
- monthly closing;
- year-end closing;
- ad hoc audit requests.
---
## 4 Parameters
Required parameters:
- `closing_date`
Optional parameters:
- `counterparty`
- `currency`
- `entity`
- `document_number`
- `supplier_invoice_number`
- `ageing_basis`
- `include_not_due_items`
- `include_debit_balances`
- `view_mode`
Execution scope:
- the report is generated for the current entity unless an entity filter is explicitly supported by the ERP context;
- open supplier items are calculated as of `closing_date`;
- only accounts payable supplier open items are in scope.
Ageing basis:
- ageing should be calculated from due date by default;
- posting date should also be available as a selectable ageing basis;
- document date ageing may be supported if the ERP exposes the required date.
View mode:
- `view_mode = detailed` should display open item details;
- `view_mode = summarized` should display supplier and ageing bucket totals without document-level detail.
---
## 5 Filters
- open items as of `closing_date`;
- supplier or supplier range;
- currency;
- entity, when supported;
- accounting document number or supplier invoice number;
- ageing bucket;
- include or exclude not-due items based on `include_not_due_items`;
- include or exclude supplier debit balances based on `include_debit_balances`;
- detailed or summarized output based on `view_mode`.
Out of scope filters:
- fully settled items after `closing_date`;
- detailed supplier movement history.
Detailed supplier movement history is handled by `AP-003 Supplier Account Movements`.
---
## 6 Sorting
Default sorting:
1. `supplier`
2. `transaction_currency`
3. `ageing_bucket_order`
4. `due_date`
5. `document_number`
Secondary sorting:
- `posting_date`
- `document_date`
---
## 7 Grouping
Default grouping:
- `supplier`
- `transaction_currency`
- `ageing_bucket`
Totals should be displayed by:
- supplier;
- ageing bucket;
- transaction currency;
- base currency;
- report total.
Default ageing buckets:
- not due;
- 0-30 days overdue;
- 31-60 days overdue;
- 61-90 days overdue;
- over 90 days overdue.
Presentation requirements:
- each open item should be assigned to exactly one ageing bucket;
- supplier debit balances, advances or overpayments should remain visible and should not be netted against other suppliers;
- open item details should be available to support payment planning and audit review;
- summarized view should hide document-level fields and display totals by supplier, transaction currency and ageing bucket;
- totals should reconcile with `AP-001 Supplier Balance Report` for the same closing date and filters.
- drill-down should be available from summarized ageing buckets to open item details, accounting documents and source documents when available.
---
## 8 Output Structure
Required columns:
| Column | Description |
| --- | --- |
| `entity` | Legal entity or company code |
| `supplier` | Supplier account code |
| `supplier_name` | Supplier legal or commercial name |
| `transaction_currency` | Original transaction currency |
| `base_currency` | Functional or company base currency |
| `document_number` | Accounting or AP document number |
| `supplier_invoice_number` | Supplier invoice number as provided by the supplier |
| `document_type` | Document type, such as supplier invoice, credit note, debit note or payment |
| `posting_status` | Posted, non-posted or other ERP posting status, when exposed by the ERP |
| `posting_date` | Accounting posting date |
| `document_date` | Source document date |
| `due_date` | Payment due date |
| `ageing_basis_date` | Date used to calculate ageing |
| `days_overdue` | Number of days overdue at `closing_date` |
| `ageing_bucket` | Ageing bucket label |
| `ageing_bucket_order` | Sort order of the ageing bucket |
| `open_amount_transaction_currency` | Open amount in transaction currency |
| `open_amount_base_currency` | Open amount in base currency |
| `reference` | External or source reference |
| `description` | Document or item description |
Amount sign convention for this report:
- open payable amounts are presented as positive credit balances;
- supplier debit balances, advances or overpayments are presented as negative amounts;
- open amounts should not be netted across suppliers.
---
## 9 Estimated volume
High.
The report may contain a large number of open items and should support filtering before generation.
---
## 10 Export formats
- CSV
- XLSX
- PDF
XLSX and CSV are primary payment planning, review and reconciliation formats. PDF is used for closing documentation and audit review.
---
## 11 Controls / reconciliation rules
- Total open amount in base currency should reconcile with `AP-001 Supplier Balance Report` for the same current entity, closing date and filters.
- Each open item should be assigned to one ageing bucket only.
- Items not due at `closing_date` should be included or excluded according to `include_not_due_items`.
- Supplier debit balances should remain visible when `include_debit_balances = true`.
- Fully settled items as of `closing_date` should be excluded.
- Supplier invoice items should be identifiable by both `document_number` and `supplier_invoice_number` when the supplier invoice number is available.
- If the ERP exposes posting status, non-posted operational AP events should be clearly identified through `posting_status`.
- Open item totals should reconcile with the AP subledger open item balance.
- Drill-down from a summarized ageing bucket should reconcile to the detailed open items included in the same bucket and then to the related accounting or AP document.
---
## 12 Open questions
- Which ageing buckets should be configurable by users, and which should be fixed by default? This depends on ERP functionality and is currently unknown.
- Which ERP status defines whether an item is open as of `closing_date`? This information is currently unknown.
- Should `posting_status` be displayed in the first implementation? This depends on the target ERP capabilities.

View File

@@ -0,0 +1,225 @@
# AP-003 Supplier Account Movements
## 1 Objective
Provide the detailed list of accounting movements posted to supplier accounts over a selected date range.
The report is used for:
- supplier account review;
- reconciliation of supplier balances;
- investigation of supplier invoices, credit notes, debit notes and payments;
- audit review;
- support for payment preparation and supplier statement review.
---
## 2 Users
- accounts payable team;
- accounting department;
- treasury or payment team;
- finance department;
- auditors.
---
## 3 Frequency
- daily;
- weekly payment review;
- monthly closing;
- year-end closing;
- ad hoc audit requests.
---
## 4 Parameters
Required parameters:
- `date_from`
- `date_to`
Optional parameters:
- `counterparty`
- `currency`
- `entity`
- `document_number`
- `supplier_invoice_number`
- `document_type_filter`
- `include_settled_items`
Execution scope:
- the report is generated for the current entity unless an entity filter is explicitly supported by the ERP context;
- supplier movements are selected between `date_from` and `date_to`;
- only accounts payable supplier account movements are in scope.
---
## 5 Filters
- posting date between `date_from` and `date_to`;
- supplier or supplier range;
- currency;
- entity, when supported;
- accounting document number or supplier invoice number;
- document type based on `document_type_filter`;
- include or exclude settled items based on `include_settled_items`.
Default document type filter values:
- `all`: all supplier account movements;
- `invoices`: supplier invoices only;
- `payments`: supplier payments only;
- `credit_debit_notes`: supplier credit notes and debit notes only.
Out of scope filters:
- ageing bucket;
- due-date ageing;
- summarized supplier balance only.
Ageing analysis is handled by `AP-002 Supplier Ageing Report`. Summarized supplier balances are handled by `AP-001 Supplier Balance Report`.
---
## 6 Sorting
Default sorting:
1. `supplier`
2. `transaction_currency`
3. `posting_date`
4. `document_number`
Secondary sorting:
- `document_date`
- `due_date`
- `journal_entry_number`
- `voucher_number`, when available
---
## 7 Grouping
Default grouping:
- `supplier`
- `transaction_currency`
Totals should be displayed by:
- supplier;
- transaction currency;
- base currency;
- report total.
Presentation requirements:
- each supplier movement should be displayed as a separate line;
- opening balance rows should be displayed by supplier and transaction currency;
- closing balance rows should be displayed by supplier and transaction currency;
- opening balances are mandatory for all executions;
- running balances should be calculated line by line between opening and closing balance rows;
- supplier invoices, credit notes, debit notes and payments should remain visible as separate movements.
- the selected `document_type_filter` should restrict the movement population without changing the displayed `document_type` value.
---
## 8 Output Structure
Required columns:
| Column | Description |
| --- | --- |
| `entity` | Legal entity or company code |
| `supplier` | Supplier account code |
| `supplier_name` | Supplier legal or commercial name |
| `transaction_currency` | Original transaction currency |
| `base_currency` | Functional or company base currency |
| `posting_date` | Accounting posting date |
| `document_date` | Source document date |
| `due_date` | Payment due date, when available |
| `journal` | Accounting journal |
| `journal_entry_number` | Journal entry sequence or identifier |
| `document_number` | Accounting or AP document number |
| `supplier_invoice_number` | Supplier invoice number as provided by the supplier |
| `purchase_invoice_number` | ERP purchase invoice number, when different from the accounting document number |
| `vendor_reference` | Vendor reference or external supplier reference, when available |
| `document_type` | Document type, such as supplier invoice, credit note, debit note or payment |
| `posting_status` | Posted, non-posted or other ERP posting status, when exposed by the ERP |
| `description` | Document or movement description |
| `reference` | External or source reference |
| `debit_transaction_currency` | Debit movement in transaction currency |
| `credit_transaction_currency` | Credit movement in transaction currency |
| `balance_transaction_currency` | Running supplier balance in transaction currency |
| `debit_base_currency` | Debit movement in base currency |
| `credit_base_currency` | Credit movement in base currency |
| `balance_base_currency` | Running supplier balance in base currency |
| `settlement_status` | Open, partially settled, settled or reversed status, when available |
| `settlement_date` | Settlement or clearing date, when available |
| `entered_date` | Entry creation date |
| `entered_by` | User who created the entry |
`document_number` is the mandatory accounting audit reference. `supplier_invoice_number` is required for supplier invoice identification when available. `purchase_invoice_number` and `vendor_reference` should be displayed when the ERP uses separate purchase invoice or vendor reference fields. `reference` is an informational reference.
Optional reference columns:
| Column | Description |
| --- | --- |
| `voucher_number` | Internal AP voucher or workflow reference, only when the ERP distinguishes it from `document_number` and `supplier_invoice_number` |
`voucher_number` should not duplicate `supplier_invoice_number`. It should be displayed only if it provides a distinct internal AP processing reference.
Amount sign convention for this report:
- debit movements are displayed as positive amounts;
- credit movements are displayed as negative amounts;
- running balances are calculated using this debit-positive and credit-negative convention;
- supplier debit balances, advances or overpayments are presented as negative balances.
---
## 9 Estimated volume
High.
The report may contain a large number of supplier movement lines and should support filtering before generation.
---
## 10 Export formats
- CSV
- XLSX
- PDF, including all detail columns
CSV and XLSX are primary analysis and reconciliation formats. PDF is used for audit review and supplier account documentation.
---
## 11 Controls / reconciliation rules
- Opening balance plus movements should reconcile to closing balance by supplier and transaction currency.
- Closing balances should reconcile with `AP-001 Supplier Balance Report` for the same current entity, `date_to` and filters.
- Movement totals should reconcile with the accounts payable subledger for the selected date range.
- Movement totals in base currency should reconcile with the related general ledger AP control accounts for the selected date range.
- Settled items should be included or excluded according to `include_settled_items`.
- Document type filtering should apply according to `document_type_filter`, with `all` as the default value.
- Supplier invoice movements should be identifiable by `document_number` and `supplier_invoice_number` when the supplier invoice number is available.
- When exposed by the ERP, `purchase_invoice_number` and `vendor_reference` should provide additional supplier-side identification for invoice reconciliation.
- If the ERP exposes posting status, non-posted operational AP events should be clearly identified through `posting_status`.
- Each line should retain enough audit references to trace back to the accounting document and source document where available.
---
## 12 Open questions
- Which ERP status values should map to `settlement_status`? This information is currently unknown.
- Which ERP document type values should map to `invoices`, `payments` and `credit_debit_notes`? This information is currently unknown.
- Does the ERP expose `purchase_invoice_number`, `vendor_reference`, or both as distinct fields from `supplier_invoice_number`? This information is currently unknown.
- Should `posting_status` be displayed in the first implementation? This depends on the target ERP capabilities.