AppsPortal Posting Ledger

This is the consolidated business explanation of what Post records. Amount names are the local-currency values used by the command handlers. Every posting also stores the journal ID/code on the source document where supported, changes the source to Posted, and commits only after all linked effects succeed.

For ownership and delegation sequences, see Delegation and Interaction Contracts. For every known fallback chain, see Account Resolution Registry.

Sales Invoice

Commercial journal

Debit	Credit	Amount and resolution
Customer Receivable		Local Grand Total. Account: customer Receivable, then customer category Receivable.
Customer Discount		Local Total Discount when greater than zero. Account: customer Discount, then customer category Discount.
	Revenue	Each line's LocalTotalAfterDiscount + LocalDiscountAmount. Account: item Revenue, then item category Revenue, then Inventory Settings Items Revenue. When Inventory is unavailable, customer Sales then customer category Sales is used. Grouped by account and optional cost center.
Tax account	Tax account	Additive VAT is Credit; deductive tax is Debit. Account: Tax account, then Tax Group account.
Advance-payment detail tax	Advance Payment Tax	VAT transferred from linked advanced payments, when applicable.

Linked effects

• Posts Stock Out for non-service items: Debit COGS, Credit Warehouse GL; stock decreases.
• Creates payment-term due balances.
• Auto-reconciles eligible available Payment In amounts.
• Consumes customer and salesperson credit.
• Makes the document eligible for ETA/ZATCA submission; authority submission is a separate action.

Sales Return Invoice

Debit	Credit	Amount and resolution
Sales Return		Local Total After Discount. Account: customer Sales Return, then customer category Sales Return.
Tax account	Tax account	Reverses tax according to Tax Effect; account then group fallback.
	Customer Receivable	Local Grand Total. Customer then category Receivable.

Linked Stock In debits Warehouse GL and credits COGS, restores stock, updates source return quantities/status, and restores customer/salesperson credit.

Purchase Invoice

Debit	Credit	Amount and resolution
Goods in Transit		Storable Local Total After Discount. Inventory Settings Goods in Transit.
Service Expense		Service local amount. Item Expense, then item category Expense; optional cost center item then category.
Input VAT / tax		Additive purchase VAT; Tax account then Tax Group. Deductive effect is credited.
Landed-cost expense/tax		Grouped returned landed-cost amounts before inventory capitalization. Expense account item then category; VAT Tax account.
	Landed-cost vendor payable	Landed cost including VAT. Vendor Payable then vendor category Payable.
	Invoice vendor payable	Total debits after grouped lines. Vendor Payable then vendor category Payable.

Linked Stock In debits Warehouse GL and credits Goods in Transit/landed-cost counterpart, increases stock, applies UOM conversion/tracking, recalculates WMA/last purchase cost, creates vendor due balances, and links the Stock In and its journal.

Purchase Return Invoice

Debit	Credit	Amount and resolution
Vendor Payable		Total return credits. Vendor then category Payable.
Tax account	Tax account	Reverses original tax according to effect.
Goods in Transit / landed-cost expense		Debits created in linked Stock Out for returned value and returned landed-cost portions.
	Warehouse GL	Total stock cost removed by linked Stock Out.

Stock decreases using available warehouse/batch cost and tracking, source invoice returned quantities/status are updated, and excessive/duplicate returns are blocked.

Payment In

Debit	Credit	Amount and resolution
Treasury account or Bank Account GL		Payment total received. Hub selection determines the account.
	Customer Receivable	Customer then category, for customer detail.
	Vendor Payable	Vendor then category, for vendor detail.
	Explicit Other GL	For PaidBy.Other.
Commission expense	Treasury/Bank	Configured commission amount/account.
Commission VAT	Treasury/Bank	Configured VAT amount/account.

Post also creates a Treasury or Bank transaction header/details, assigns its sequence, decreases Payment detail Amount To Reconcile when reconciled, applies eligible invoice/opening/asset balances, and marks Posted.

Payment Out

Debit	Credit	Amount and resolution
Customer Receivable		Customer then category, when paying/refunding customer.
Vendor Payable		Vendor then category, when paying vendor.
Explicit Other GL		For other payment detail.
Commission expense/VAT		Configured payment-method accounts.
	Treasury account or Bank Account GL	Payment total plus counterpart effects.

Post creates Treasury/Bank transaction records and rejects a resulting negative hub balance.

Fund Transfer

Step	Debit	Credit
Source Payment Out	Fund Transfer Contra	Source Treasury/Bank
Destination Payment In	Destination Treasury/Bank	Fund Transfer Contra

Both sides and their bank/treasury transaction records are committed together. The contra account must be configured and nets to zero in local value.

Payment Reconciliation

No new cash journal is created. The Payment In journal already recorded the money. Post reduces Payment Detail Amount To Reconcile, reduces the selected Sales/Asset/Open-Balance due balances, creates reconciliation records, updates fully-reconciled flags, and marks the reconciliation Posted.

Manual Stock In and Stock Out

Document	Debit	Credit
Manual Stock In	Warehouse GL	Operational Tag GL
Manual Stock Out	Operational Tag GL, grouped by line cost center	Warehouse GL

Posting also updates item/warehouse/batch quantities, available inbound layers, WMA/last purchase cost as applicable, tracking history, journal link, and status.

Stock Transfer

Linked document	Debit	Credit
Issued warehouse Stock Out	Goods in Transit	Issued Warehouse GL
Target warehouse Stock In	Target Warehouse GL	Goods in Transit

The transfer is quantity-neutral across the company, preserves cost/tracking, links both stock documents, and updates the transfer request to Partially Transferred or Done.

Inventory Reconciliation

Variance	Debit	Credit
Shortage	Inventory Settings COGS	Warehouse GL
Surplus	Warehouse GL	Inventory Settings Goods in Transit

The current implementation does not use the configured Adjustment account for these variance journals. It creates linked posted Stock Out/Stock In documents and closes the warehouse count lock.

Inventory Opening Balance

The current handler increases stock quantity/value and updates WMA/last purchase costs but creates no journal. The accounting opening position must therefore be handled separately or the implementation changed after Finance confirmation.

Fixed Asset Purchase

Debit	Credit
Asset account per line, from Asset Group	Vendor Payable from vendor/category
Tax account for input VAT

Post activates/updates asset acquisition values and links the purchase journal.

Fixed Asset Purchase Return

Debit Vendor Payable; credit Asset account and tax reversal. When returning depreciated value, debit Accumulated Depreciation and credit Depreciation Expense, resolving each from asset then asset group. Source return status becomes Partial or Full.

Fixed Asset Sale

Debit Customer Receivable; remove asset cost and accumulated depreciation; post the difference between proceeds and net book value to Profit/Loss; credit output VAT. Asset and accumulated accounts resolve asset then group. P/L resolves asset, group, then Fixed Assets settings. Due balances are created from payment terms.

Fixed Asset Sales Return

Credit Customer Receivable; restore asset cost/accumulated depreciation position; reverse P/L and VAT; restore asset lifecycle state; update original sale return quantities/status.

Asset Depreciation

Debit Depreciation Expense; credit Accumulated Depreciation using configured asset-group accounts. Update accumulated depreciation and net book value per asset and record the posted depreciation period.

Asset Disposal

Remove Asset cost, remove Accumulated Depreciation, and post residual Net Book Value/proceeds difference to P/L. Account fallback is asset then group, with settings fallback for P/L. Asset status becomes Disposed.

Journal Entry

Post makes the user-entered balanced debit/credit lines effective. Reverse creates a new linked journal with every debit and credit exchanged; it does not edit the original. Source-generated payment journals use dedicated reversal validation against source document ID/code.

Customer and Vendor Opening Balances

These features validate their detail total and debit/credit nature against an already-linked Opening Balance Journal line, then mark the subledger opening balance Posted. Unpost is blocked when later posted transactions exist.

Orders, workflows, reports, and master data

• Sales/Purchase Order Post records an approved commitment and remaining fulfillment quantities; it creates no GL, cash, receivable/payable, or stock movement.
• Workflow Submit/Approve/Reject changes approval state/audit only; final transaction Post performs accounting.
• Reports, dashboards, templates, preferences, roles, and master-data Save create no journal unless their feature page explicitly states otherwise.

Unpost and reversal standard

Unpost is allowed only for the expected Posted state, open source and linked periods, reversible/non-reversed journal, intact linked records, and no later dependent transaction. It creates a reversal journal or returns an eligible direct journal to Draft according to the handler, reverses bank/treasury/reconciliation/credit effects, restores balances, and preserves audit links. Any locked/missing downstream target blocks the entire operation.