RavenLedger supplied logo and wordmark
User guideSetup and everyday workflows

Documentation 0.26.0 | Application v1.1.537

← Back to website
Invoice and receipt field reference

Understand service invoice and customer receipt fields

Screen references, field implications and illustrative accounting relationships

Application v1.1.537Documentation 0.16.0

Use a customer invoice to record an amount due for services, a customer receipt to record money received into a bank account, and a receipt application to match that payment to the invoice line. These are separate records and actions. A saved receipt is not automatically an applied payment, and a saved document is not proof that its accounting journal has finished posting.

This chapter explains the regular invoice, receipt and application screens and their fields. It is a field reference, not a step-by-step posting or settlement procedure. Use your organisation's approved process for transaction entry and corrections.

Prerequisites and scope

Confirm CURRENT COMPANY before opening customer pages. Your administrator must grant the appropriate company/location, customer-transaction, receipt and report access. Use an active customer/trading partner, a permitted location, an approved service/non-stock item, and a bank account with the correct currency and accounting mappings. Review Receivables Options, customer receivable account, revenue/contra account, dates, tax defaults and posting configuration first.

This scenario uses the functional currency for both invoice and bank receipt, no tax or withholding, no discount, no stock, no fixed asset and no trade reference. Omitting tax is valid only for this synthetic scenario; it is not a conclusion about any real transaction's tax treatment. Foreign currency, inventory allocations, withholding, credit/debit notes, refunds, fiscal submissions and imports require their own verified scenarios.

The screenshots show blank regular forms. Some fields remain disabled until a location or ledger date is selected. The examples do not represent completed business transactions.

Illustrative amounts

Use fictional Raven Demo Services and Demo Customer only in an isolated training setup. Assume functional currency USD, an approved USD bank account, an open period and one non-stock service item. Use 15 October 2026 only if that is an approved open training date; otherwise use an agreed open date consistently.

StageExample valuesIllustrative balance
InvoiceQuantity 2, unit price USD 500, discount 0, no tax/WHTBase and total USD 1,000; initial unpaid amount USD 1,000.
ReceiptUSD 600 into the approved USD bank accountReceipt total USD 600; initially unapplied USD 600.
ApplicationApply USD 600 to the selected invoice lineInvoice remains unpaid USD 400; receipt unapplied becomes USD 0.

These figures illustrate the relationship between an invoice, a receipt and an application. Do not disable tax/fiscal settings to reproduce them.

Recognise the customer invoice screen

The regular form is available from Customer Transactions through Create New Customer Transaction, subject to your access. The header identifies the location, dates, customer and currency. Line fields identify the service, quantity, price, tax and accounting counterpart. Calculated totals are outputs, not balancing fields to overwrite.

Figure 1 Invoice header

Figure 1. Blank customer transaction header: location, dates, partner, addresses, currency, references, message and calculated totals.
Figure 1. Blank customer transaction header: location, dates, partner, addresses, currency, references, message and calculated totals.

Figure 2 Invoice line identity and pricing

Figure 2. Left side of the wide invoice table. Scroll horizontally in the application to see the remaining columns.
Figure 2. Left side of the wide invoice table. Scroll horizontally in the application to see the remaining columns.

Figure 3 Invoice tax and contra account

Figure 3. Overlapping middle view of quantity, price, discount, tax and contra-account controls.
Figure 3. Overlapping middle view of quantity, price, discount, tax and contra-account controls.

Figure 4 Invoice calculated line amounts

Figure 4. Overlapping view of contra account and calculated base, tax, total and withholding/net fields.
Figure 4. Overlapping view of contra account and calculated base, tax, total and withholding/net fields.
Figure 5. Right side of the invoice table, including remaining calculated amounts, sales-order/cost-centre and fixed-asset fields, plus line/form actions.
Figure 5. Right side of the invoice table, including remaining calculated amounts, sales-order/cost-centre and fixed-asset fields, plus line/form actions.

Invoice header field reference

Figure 1 shows all 24 regular header controls/displays, including Location. A required mark on a calculated display does not make it editable. Requirements and locks depend on the selected location, document state and approved setup.

FieldEntry or sourcePurpose and implication
LocationRequired permitted location selectionSets operational context and location-specific options; do not assume another site's accounts, defaults or permissions apply.
Transaction NumberSystem generated/read-onlyIdentifies the saved transaction; it is not the customer's PO number or a field to invent.
Ledger DateRequired date after LocationDetermines accounting-period context. A closed-period error requires review, not bypass.
Transaction DateRequired document dateRecords when the invoice/document is dated; distinguish it from posting and receipt dates.
Transaction TypeSelect Invoice for this task; locked on an existing transactionDetermines invoice versus note behavior and sign/discount restrictions. Do not convert a saved invoice by relabelling it.
Transaction CurrencySelected/default currency; foreign-currency editing depends on setupDenominates customer amounts. It is not necessarily the company's functional currency.
Supporting DocumentOptional accepted file, maximum 20 MBAttaches evidence. Accepted types shown are Excel, Word, PDF, JPG/PNG, CSV and ZIP. Uploading is not an import or fiscal acceptance.
Trading PartnerRequired actual active customer resultSupplies the customer context, addresses, accounts and applicable defaults. Typed text alone is not a selected master record.
Bill To AddressRead-only from the partnerShows the billed-party address. Review the master when wrong; it is not a free-text correction here.
Ship To AddressRead-only from the partnerShows the delivery/service destination reference; it does not allocate stock or choose a warehouse.
DescriptionHeader narrativeIdentifies the document's purpose for review; it does not replace line item or account selection.
Customer PO NumberOptional approved customer referenceHelps matching to the customer's purchase order. It is not the system transaction number or a link to your own purchase order.
Payment Terms (days)Approved number of days, potentially defaultedRecords credit terms used by receivables logic. Confirm the resulting due date and aging; entering terms does not record payment.
FX Rate OverrideConditional; locked for functional currencyConverts to functional currency under the document's rate convention. Do not invent a rate or use it to force totals to match.
Transaction StatusSystem/read-onlyReflects the transaction's saved/payment state. A status is not independent evidence of journal completion or fiscal acceptance.
Functional Total Incl. TaxCalculated/read-onlyShows invoice total in functional currency; distinguish it from the transaction-currency amount.
Functional Net ReceivableCalculated/read-onlyShows the functional receivable measure. Review withholding recognition and actual journal treatment, not only this label.
Withholding TaxCalculated/read-only; recognition label shown beneathShows the configured WHT measure. The recognition timing can differ by setup; no WHT applies in the fictional example.
Net Receivable after WHTCalculated/read-onlyShows the net amount after displayed withholding treatment, not automatically the gross legal invoice or amount already collected.
Paid AmountCalculated/read-onlyShows recorded settlement/application in transaction currency; an unrelated bank receipt is not sufficient to mark an invoice paid.
Functional Paid AmountCalculated/read-onlyShows settlement in functional currency. Cross-currency/FX scenarios require separate reconciliation.
Unpaid AmountCalculated/read-onlyShows the remaining invoice balance in transaction currency. Reconcile it to open lines and applications.
Functional Unpaid AmountCalculated/read-onlyShows the remaining functional balance, which can differ from a simple currency-label substitution.
Custom MessageOptional/defaulted document messageMay be used on the customer document. Review copied/defaulted wording and never enter secrets or inappropriate internal notes.

Invoice line field reference

Figures 2 to 5 overlap so all regular line columns can be located. The Transaction columns menu controls presentation; hiding a column does not remove its data or requirement. Horizontal scrolling is necessary on this wide form.

Field or controlEntry or sourcePurpose and implication
Line #System line identityDistinguishes lines and their applications/links; do not confuse it with a document number. Figure 2.
Item CodeChoose an actual active item resultSupplies item identity and related defaults. Use a non-stock service item for this task; an inventory item requires allocation. Figure 2.
DescriptionRead-only item-derived displayDescribes the selected line item; its placeholder does not mean it can be edited here. Correct the approved master if needed. Figure 2.
QuantityPositive quantity for an invoice; precision validatedMultiplies unit price and drives quantity effects. The proposed service example uses 2. Credit-note signs belong to a separate task. Figures 2-3.
UOMRead-only populated unitIdentifies what the quantity measures. Do not assume a service unit equals a stock unit. Figures 2-3.
PriceItem/default or authorised overrideUnit price can be locked by Receivables Options. Commercial price precision is not necessarily the displayed total's decimal precision. Figures 2-3.
Discount percentEditable only where allowed; 0 to 99.99 shownReduces the invoice base under the calculation rules. Debit/credit-note discounts are restricted; use 0 in this example. Figures 2-3.
Discount amountCalculated/read-onlyShows the monetary discount from the percentage; do not treat it as a second independent discount. Figures 2-3.
Tax CodeActual code choice, or deliberate approved clearingDetermines tax/WHT calculations. Pending/failed tax preview or typed-but-unselected code blocks safe saving; no-tax must be justified. Figure 3.
Contra AccountApproved default or permitted actual account choiceDetermines the line's accounting counterpart, normally approved service revenue here. Override and fixed-asset locks must be respected. Figures 3-4.
Base AmountCalculatedCheck quantity, price and discount before reviewing tax. It is not a manually entered balancing value. Figures 3-4.
Chargeable TaxCalculatedShows chargeable tax from the selected treatment; tax detail and totals must reconcile. Figure 4.
Total Amount including TaxCalculatedShows gross line total under the system's calculation. Distinguish it from net cash due after WHT. Figure 4.
Withholding TaxCalculatedShows configured withholding for this line; review recognition timing. Figure 4.
Net Receivable after WHTCalculatedShows the line's net receivable measure. It is not proof that an application or payment has occurred. Figures 4-5.
SO LineConditional sales-order line selectionLinks the invoice line to an order when applicable. It is not required for the standalone service example unless your workflow requires it. Figure 5.
Cost CenterConditional permitted cost-centre selectionAdds analytical attribution where the account and setup allow/require it; it does not replace the contra account. Figure 5.
Is FAFixed-asset disposal indicatorChanges the line into the asset-disposal path. Leave clear for the service example; it is not a generic item checkbox. Figure 5.
FA DisposalConditional disposal-event linkRequired for a fixed-asset line; not used for an ordinary service invoice. Do not fabricate an event to satisfy validation. Figure 5.
ActionsContext-dependent line actionsRemove unsaved erroneous lines or use the supported saved-record action. Credit applications, stock allocations, trade references and fiscal actions require separate verified instructions. Figure 5.

Recognise the customer receipt screen

The regular form is available from Customer Receipts through Create New Customer Receipt, subject to your access. It identifies the customer, bank account, receipt amount, currency, dates and references. Bank details come from the selected bank master and are not free-text beneficiary instructions.

The receipt starts Unapplied. Its journal work can be queued after save. A receipt report, saved number or success message alone does not prove that bank and unapplied-control balances have updated in the ledger.

Figure 6 Receipt identity and bank details

Figure 6. Blank receipt's location, dates, customer/address and bank-detail fields. The receipt number is generated on save; bank details are populated from a selected bank account.
Figure 6. Blank receipt's location, dates, customer/address and bank-detail fields. The receipt number is generated on save; bank details are populated from a selected bank account.

Figure 7 Receipt amounts and references

Figure 7. Receipt financial totals, unapplied/refunded displays, customer/bank references and Description. Disabled controls reflect the blank pre-location stage.
Figure 7. Receipt financial totals, unapplied/refunded displays, customer/bank references and Description. Disabled controls reflect the blank pre-location stage.

Receipt header field reference

Figures 6 and 7 cover all 26 regular receipt header fields/displays. The transaction-line picker is described separately below. Miscellaneous receipts, refund and reverse modes have different controls and must not be inferred from this regular-receipt task.

FieldEntry or sourcePurpose and implication
LocationRequired permitted selectionSets the receipt's operating context. Existing applications can lock it. Figure 6.
Ledger DateRequired accounting dateSets the receipt's ledger period; closed-period restrictions apply. Figure 6.
Receipt NumberGenerated/read-only on saveIdentifies the receipt within company/location numbering; not a bank reference. Figure 6.
Receipt DateRequired payment/document dateRecords when money was received; distinguish it from ledger and application dates. Figure 6.
Receipt StatusSystem/read-only; initially UnappliedTracks application/refund/reversal state, not bank-statement reconciliation or guaranteed GL completion. Figure 6.
Supporting DocumentOptional accepted evidence file, maximum 20 MBLinks evidence to the receipt; it does not create another receipt, import a statement or prove funds cleared. Figure 6.
CustomerRequired actual active customerDetermines whose receipt and eligible transactions are being settled; avoid merely matching a similar name. Figure 6.
Bill To AddressRead-only customer informationHelps confirm identity. Correct the master through the customer workflow if inaccurate. Figure 6.
Ship To AddressRead-only customer informationProvides the customer's destination context; not a payment beneficiary instruction. Figure 6.
Bank AccountRequired actual configured bank accountDetermines the bank and unapplied-receipt accounting mappings. Its currency must match the receipt currency. Figure 6.
Bank NameRead-only bank-master displayConfirms which bank was selected; does not create or validate a bank account. Figure 6.
Account NumberRead-only bank-master displayConfirms the selected account. Protect real account details in screenshots and customer material. Figure 6.
Account TypeRead-only bank-master displayDescribes the selected bank account; it is not the chart-of-account classification for the invoice. Figure 6.
Swift CodeRead-only bank-master displayShows a stored routing reference; it is not evidence of an executed transfer. Figure 6.
IBANRead-only bank-master displayShows the configured bank identifier where applicable. Do not infer it is verified or required for every country. Figure 6.
Total AmountRequired positive amount for a regular receiptRecords cash received in receipt currency. Refunds use a different flow/sign rule. Figure 7.
CurrencyRequired/defaulted subject to setupMust match the selected bank account's currency; not just the customer's invoice currency. Figure 7.
FX Rate OverrideConditional; disabled for functional currencyConverts receipt to functional currency. The fictional same-currency example uses 1; foreign-currency rates need separate review. Figure 7.
Functional Total AmountCalculated/read-onlyFunctional equivalent of the receipt amount; review rounding and saved rate. Figure 7.
Unapplied AmountCalculated/read-onlyReceipt-currency amount not yet consumed by applications/refunds; not the customer's total debt. Figure 7.
Functional Unapplied AmountCalculated/read-onlyFunctional counterpart of the unapplied receipt balance. Figure 7.
Refunded AmountCalculated/read-onlyTracks receipt amounts refunded under the separate refund workflow; do not edit it to clear an imbalance. Figure 7.
Functional Refunded AmountCalculated/read-onlyFunctional counterpart of refunded amounts; not additional money received. Figure 7.
Customer ReferenceOptional, browser limit 50 charactersRecords the customer's payment/remittance reference for matching. It is not the receipt number. Figure 7.
Bank ReferenceOptional, browser limit 50 charactersRecords the bank's reference for evidence/reconciliation; it does not reconcile a bank statement automatically. Figure 7.
DescriptionOptional, limit 100 charactersExplains the receipt for accounting review; do not store unnecessary personal or sensitive data. Figure 7.

Understand receipt applications

Select Transaction Line is available only for an eligible saved receipt/customer state. An application identifies the exact target document and line, its currency, the cash applied and the accounting dates. Apply Receipt is separate from Save Receipt: saving the receipt alone does not settle an invoice.

Figure 8 Receipt application controls

Figure 8. Blank receipt application area: transaction-line picker, table headings and Save Receipt/Apply Receipt buttons.
Figure 8. Blank receipt application area: transaction-line picker, table headings and Save Receipt/Apply Receipt buttons.

Application and lookup field reference

Figure 8 shows the empty table and picker. The reference below explains the application fields; no populated application row appears in this image.

Field or controlEntry or sourcePurpose and implication
Select Transaction LineEligible saved receipt/customer onlyChooses an outstanding invoice/debit line; typing search text does not apply money.
Application Line NumberSaved/system identityDistinguishes the receipt's individual applications.
Transaction TypeSelected target/read-onlyConfirms which kind of customer transaction is being settled.
Transaction NumberSelected target/read-onlyConfirms the document number; pair it with type and line number.
CurrencyTarget transaction currency/read-onlyCan differ from receipt currency in a separately reviewed FX case.
Transaction Line NumberSelected target/read-onlyIdentifies the exact outstanding line, not only the document header.
Transaction DateRequired application-row dateDates the application record; verify the saved value.
Ledger DateRequired application-row accounting dateDetermines accounting-period treatment; verify actual application and journal dates.
Net Cash AppliedApplication cash amount against the targetConsumes the receivable's cash-settlement portion, not automatically its gross amount where WHT applies.
Settlement WHTCalculated treatmentDisplays withholding recognised with settlement where configured; not extra cash received.
Receipt Applied AmountAmount consumed in receipt currencyReview both currencies; it is locked to the corresponding value in a same-currency case.
Cross Currency RateCalculated/read-onlyRelates receipt-currency and target-currency amounts. It is not a free balancing field.
Functional Applied AmountCalculatedShows functional settlement used for reconciliation; distinguish it from cash in either foreign currency.
Gain/LossCalculatedShows FX difference where applicable; validate its sign and linked journal in an FX-specific scenario.
ActionsState/permission dependentRemove unsaved picks or use supported Update/Journal/Gain-Loss links for saved applications. Removing a saved application changes settlement and is not a harmless display action.
Application columnsPresentation controlHides/shows columns, not their underlying requirements or financial effects.
Save ReceiptSaves the receipt headerDoes not by itself settle the chosen invoice line.
Apply ReceiptSaves new application rows for a saved eligible receiptChanges settlement and triggers related accounting; requires final review before action.

The transaction-line lookup also displays Location, Transaction Type, Transaction Number, Currency and Line Number to identify the target. Gross Open Receivable is the outstanding gross target amount; Projected WHT is expected withholding under its treatment; Net Cash Receipt is the projected cash requirement; Functional Net Cash is that cash measure in functional currency. Do not confuse those lookup previews with saved application results.

Illustrative accounting relationship

The normal same-currency/no-tax path uses the configured account bindings, not account names typed into the document. The released receipt/application code uses the bank account's mapped bank and unapplied-receipt accounts, and the customer's mapped receivable account.

EventExpected debitExpected credit
Service invoice USD 1,000Customer receivable 1,000Approved service revenue 1,000
Receipt USD 600Mapped bank account 600Mapped unapplied-receipt control 600
Apply receipt USD 600Mapped unapplied-receipt control 600Customer receivable 600

The illustrative balances are customer receivable 400, bank debit 600, service revenue credit 1,000 and zero net unapplied control for this receipt/application pair. Actual records must reconcile after all related journals have completed. Compare invoice open lines, receipt applications, customer statement, GL transactions and mapped controls on the same dates, company, location and currency basis.

A saved receipt or application status alone does not establish GL completeness, bank reconciliation or fiscal acceptance. If journals are missing or pending, retain document identities and ask the administrator to investigate processing rather than creating duplicate documents or manual balancing journals.

Corrections and common problems

ProblemSafe response
Fields stay disabledSelect Location and Ledger Date first; check setup, document state and role. Do not bypass locks.
Item/tax text is not acceptedChoose a real list result, or deliberately clear tax only when approved. Resolve pending tax previews.
Wrong customer, bank, currency or accountStop before saving. If already saved, review applications, locks and correction options before editing.
Receipt saved but invoice remains unpaidCheck whether a receipt application was actually saved to that invoice line.
Cannot change a receipt headerApplied, refunded, reversed or locked receipts have restrictions. Use the supported application/correction workflow with accounting review.
Connection times out after Save or ApplyCheck the list and saved record first; a timeout does not prove failure. Avoid duplicate submissions.
Open balance differs from the simple exampleReview tax/WHT recognition, discounts, currency/rates, partial applications, refunds, dates, filters and journal completion.

Do not use credit/debit notes, refunds, reversals, application deletion or company deletion as interchangeable corrections. Applied receipts have additional restrictions. Use the approved correction procedure for the document and country, with accounting review of tax, discounts, applications and fiscal status.