Finance Reference Data (FIN)

The fin submodule of com owns the cross-cutting financial reference data used by sales, purchasing, and accounting flows: cost components, credit ratings, terms of payment, and terms of invoice. It exposes only one cross-module lookup — findTermsOfPaymentByCodeMandatory — and otherwise provides standard CRUD pages for administrators to maintain the entries.

Concepts

Cost Component

A named bucket of cost (for example "material", "labour", "freight"). Used by costing/pricing logic to attribute amounts to a category.

Credit Rating

A named risk classification attached to partners. Each rating may carry a UI warning style so high-risk customers stand out in the UI.

Terms of Payment

A named payment-due policy: how many days after invoice the payment is due, and whether advance payment is required.

Terms of Invoice

A named invoicing policy: whether invoices are combined per period and how often invoices are emitted.

Entities

FIN entities

Cost Component (CostComponent)

A named cost bucket.

FieldDescription

code

Business key (up to 8 characters).

description

Human-readable name.

Credit Rating (CreditRating)

A named credit-risk classification.

FieldDescription

code

Business key (up to 3 characters).

description

Human-readable name.

warningStyle

Optional Style from sys.scr used to mark records with this rating in the UI.

Terms of Payment (TermsOfPayment)

A named payment-due policy.

FieldDescription

code

Business key (up to 3 characters).

description

Human-readable name.

dueDays

Optional number of days after invoice when payment is due.

advancePayment

Whether the policy requires payment in advance. Default false.

Terms of Invoice (TermsOfInvoice)

A named invoicing policy.

FieldDescription

code

Business key (up to 3 characters).

description

Human-readable name.

combinedInvoice

Whether multiple deliveries are combined onto a single invoice for the period.

invoiceFrequency

How often invoices are emitted — see Invoice Frequencies below.

Invoice Frequencies (InvoiceFrequency)

CodeNameMeaning

D

Direct

Each delivery is invoiced immediately.

W

Weekly

Deliveries in a week are invoiced together.

M

Monthly

Deliveries in a month are invoiced together.

Functionality

Mandatory terms-of-payment lookup

TermsOfPaymentReaderService exposes both an optional and a mandatory lookup of TermsOfPayment by code. The mandatory variant raises a business exception when the code does not exist; this is the seam other modules use when a missing terms-of-payment value should fail loudly. All other entities are read directly through their generated readers.

Public API

COM_FIN_QueryApi

Read-side facade.

MethodDescription

findTermsOfPaymentByCodeMandatory(HasTrace, Code3)

Terms of payment by code; raises a business exception if not found.

COM_FIN_CommandApi

This submodule does not provide a command API class. Cost components, credit ratings, and the two terms entities are maintained through their default CRUD pages.

ViewModel actions

The submodule defines view models for the four entities but does not declare any custom UI actions.