Skip to content
D
Documentation

Principal invoices

reference
10 min readUpdated

A principal invoice is an invoice record that you review through the Principal invoices list and its status views. The list includes All, Upcoming, Receivable, and Paid. A considered-paid invoice appears under Paid; an invoice returned to due appears under Due.

At a glance

Use this page to review a principal invoice record, update it when permitted, and manage its payment or deduction information. The separate list and record areas support different tasks.

If you need to…Go to
Open the principal-invoice listFind and open a principal invoice
Export the selected status viewExport the current principal-invoice list
Find fields and totalsRecord fields and totals
Edit an invoice recordUpdate the principal-invoice record
Review payment or deduction informationManage payments, deductions, and paid status
Add a deduction or principal paymentAdd a deduction or principal payment
Review the general invoice status flowInvoice lifecycle
Record a separate paymentRecord a payment
Review purchase invoices or outgoing paymentsPayables

The list is for choosing a status view and selecting an existing invoice. The record is for reviewing invoice information and, when permitted, updating the record or managing related financial information.

Before you start

Principal invoice work depends on subscription access, the selected list layout, the record state, and your role.

What to checkWhat it changes
Subscription and layoutAll, Upcoming, Receivable, and Paid appear when the subscription includes the area and the minimum layout is open.
Invoice detailsActions require an existing invoice and an applicable status.
Editing accessSave and Save and Close are available when the record is not opened with an input ID and your account passes the edit-permission check.
List columnsThe visible headers come from the chosen list layout, so another account can show different columns.
RolePrincipal Payments is unavailable to a principal user.

Deductions require at least due status. Payment and considered-paid actions have their own status conditions. Use the status shown on the record and the controls that appear there before choosing related work.

Note: Principal invoices is separate from the general invoice lifecycle and from Payables. Use the page that owns the next task instead of treating a status tab as a lifecycle transition.

Find and open a principal invoice

Choose a status view and open an existing invoice when its row can be selected.

Prerequisites

  • The Principal invoices area is included in your subscription.
  • The list layout is open and an existing invoice row is available.

Steps

  1. Open the Principal invoices page.

  2. Select the status view that answers your question.

    If you need to review…Select
    All invoice statusesAll
    Upcoming invoicesUpcoming
    Receivable invoicesReceivable
    Paid invoicesPaid
  3. Confirm that the chosen status view and its table are visible.

    If the status view cannot load, the page displays Load data failed: <error message>.

    The Principal invoices list with the All status view selected
  4. Select the existing invoice row you need to review.

  5. Confirm that the invoice details open before choosing an action.

Result: The chosen status view is on screen, or the existing invoice record is open for review.

Export the current principal-invoice list

After the status view is open, export its current rows.

Prerequisites

  • A Principal invoices status view is open.
  • Export is available on the list page.

Steps

  1. Select Export.

  2. Review the export page.

  3. If list options are presented, use Filter Row and Group Panel according to the arrangement you need.

    The export surface for the selected Principal invoices list

Result: The export page for the selected list is open.

Understand the principal-invoice screen

The screen has a list page for status views and a record page for invoice details. The record also exposes related tabs and status actions when the record conditions allow them.

The list page shows Tracking Principal Invoices, the status filters, and Refresh, Table Layout, and Settings. The record page contains invoice fields, amount information, related tabs, and Consider As Paid and Consider As Not Paid when their conditions are met.

AreaWhat it is forConditions that affect it
Principal invoices listChoose All, Upcoming, Receivable, or Paid, then review rows.Subscription and minimum-layout conditions control the status filters.
Invoice recordReview or edit fields for an existing invoice.The record must exist; edit actions also require edit permission.
CommentsOpen comments related to the record.The record cannot be upcoming or awaiting principal payoff, and comments access must be available.
DeductionsReview deduction entries and, where allowed, add one.The record must be at least due and meet the deduction conditions.
Principal PaymentsReview principal-payment entries and, where allowed, add one.The record cannot be upcoming or awaiting principal payoff, and the reader cannot be a principal user.
Last ModificationsOpen the record modification history.The record cannot be upcoming or awaiting principal payoff.

The list table uses the columns from your chosen layout. The invoice details use their own fields and related tables.

List columns

The same 12 headers appear in All, Upcoming, Receivable, and Paid:

First set of headersSecond set of headers
Invoice No.Job No.
AccountDue Date
Invoice Amount €Invoice Amount
Paid AmountPaid Amount €
Due AmountDue Amount NaN
Total Sales PriceStatus

The list can also include Item descrption and Amount. Work from the headers visible in your current list; other saved layouts can show a different set of columns.

The runtime columns visible for the current Principal invoices layout

Record fields and totals

An invoice record brings together parties, dates, identifiers, description, note, and amount information. Open an existing record before using these fields.

FieldTypeRequirement
ClientTextRequired only when company configuration makes it required.
VendorTextRequired only when company configuration makes it required.
Shipment DateDateOptional.
Invoice DateDateOptional.
Order DateDateOptional.
Delivery DateDateOptional.
End UserTextOptional.
Salesperson ResponsibleTextOptional.
Product TypeTextOptional.
Vendor Order No.TextOptional.
Client Order No.TextOptional.
Invoice No.TextRequired only when company configuration makes it required.
Job TitleTextOptional.
Item DescriptionTextOptional.
NoteTextRequired only when company configuration makes it required.

Client, Vendor, Invoice No., and Note are configurable required fields. Check the required marker on this record rather than treating all four as universally required. Amount information appears in the invoice amount area and in the deduction and payment grids.

Payment, deduction, and paid-status fields

The related dialogs collect different financial information.

DialogRequired fieldsLimits or choices
Principal paymentPayment amount, Payment Date, and commentAmount must be greater than 0 and cannot exceed the due invoice amount. Payment Date cannot be later than today.
Principal deductionDeduction amount, Deduction reason, and commentAmount must be greater than 0 and cannot exceed the due invoice amount.
Considered paidFor Sure Paid, Probably Paid, and Reason For Consideration As PaidEach field is required before the paid-status save path.

The Deduction reason choices are Late Delivery, Technical Reason, Missed Parts, Missed Services, and Unreasoned.

Update the principal-invoice record

Change editable invoice fields on an existing record.

Prerequisites

  • The existing principal invoice record is open.
  • The record is opened without an input ID.
  • Your account passes the record's edit-permission check.

Steps

  1. Enter the new invoice number in Invoice No..

  2. Choose how to save the record.

    If you want to…Select
    Keep the record openSave
    Save the record and leave the pageSave and Close
  3. If validation stops the save, correct the fields marked as required and repeat your selected save option.

A successful record update displays Your request was completed successfully. A validation failure displays Check validation.

Result: The record is saved with the success message, or it remains open with Check validation so you can correct it.

Manage payments, deductions, and paid status

After reviewing the record fields, use the related tab that matches the financial work.

Prerequisites

  • An existing principal invoice record is open.
  • The record status and your role permit the related work.

Steps

  1. Select the related tab that matches the work.

    If you need to…Select
    Review commentsComments
    Review or add deductionsDeductions
    Review or add principal paymentsPrincipal Payments
    Review record changesLast Modifications
  2. Review the table columns in the chosen tab.

  3. If Deductions is available, use it only when the invoice has reached at least due status.

  4. If Principal Payments is available, use it only when you are not a principal user.

  5. Choose the permitted financial branch from the table below.

    If you need to…Continue with
    Consider the invoice paidConsider an invoice paid
    Return an invoice to dueReturn an invoice to due
    Add a deduction or principal paymentAdd a deduction or principal payment

Result: The permitted related-work tab is open, or its unavailable condition explains why that branch cannot be used for the current record.

Consider an invoice paid

Use Consider As Paid when an existing record has a positive outstanding amount and its status is eligible for the considered-paid branch.

Prerequisites

  • An existing record is open on its standalone details page.
  • The record is not upcoming or already paid.
  • The applicable status guards permit the action.
  • The outstanding amount is positive.

Steps

  1. Select Consider As Paid.
  2. Enter the required information in For Sure Paid, Probably Paid, and Reason For Consideration As Paid.
  3. Select Save in the dialog.
  4. Confirm that the record returns to its paid-status branch.

Result: The considered-paid information is saved and the invoice is shown in the paid-status branch.

Return an invoice to due

Use Consider As Not Paid for an invoice that is currently considered paid.

Prerequisites

  • An existing record is open.
  • The record is currently considered paid.

Steps

  1. Select Consider As Not Paid.
  2. Confirm that the record returns to the due branch.

The considered-paid status appears under Paid. The corresponding due status appears under Due.

Result: The invoice is shown under Due.

Add a deduction or principal payment

Choose one entry path after opening the permitted related tab.

Prerequisites

  • An existing record is open on a permitted, standalone details page.
  • For a deduction, Deductions is active and the record is not paid or considered paid.
  • For a principal payment, Principal Payments is active and the record status permits payment.

Steps

  1. Follow the applicable path.

    Entry pathActions
    DeductionIn Deductions, enter the deduction amount. Select a Deduction reason. Enter the required comment. Select Save.
    Principal paymentIn Principal Payments, enter the payment amount. Enter Payment Date and the required comment. Select Save.

For either amount, enter a value greater than 0 that does not exceed the due invoice amount. A successful save displays Your request was completed successfully; a payment validation failure displays Check validation.

Result: The new deduction or principal payment is saved and appears in its related grid, or the dialog remains open with the validation message so you can correct the entry.

When a principal-invoice action fails

Use the message on screen to correct the value or choose the appropriate page.

What you seeWhat to do
This Field Is RequiredEnter a value in the field marked as required, then repeat the action.
Amount must be greater than 0 and can't exceed due invoice amountEnter an amount greater than 0 and no greater than the due invoice amount.
Check validationCorrect the highlighted payment or record fields, then repeat the save action.
Load data failed: <error message>Read the error message, then reload the Principal invoices page.
Updating error <error>Read the error text, correct the record, and repeat the update.
Deductions Reasons failed to loadReload the deduction area and retry when the choices are available.
Are you sure you want to delete this payment?Read the confirmation and continue only if you intend to remove the payment.
Are you sure you want to delete this deduction?Read the confirmation and continue only if you intend to remove the deduction.

If a related tab or action is absent, check the record status and whether your role permits the branch.

After reviewing a principal invoice

When you finish the list and record work, continue to the page that owns the next task.

If you need to…Continue to
Follow the general invoice status flowInvoice lifecycle
Record a separate paymentRecord a payment
Review purchase invoices or outgoing paymentsPayables

Was this page helpful?

Need help using the product?

Principal invoices — PAMS Fresh Generation