CoolCMS API

InvoicePresenter extends BasePresenter

in package

• Application

uses InvoiceFormTrait, InvoiceCreditNoteFormTrait, InvoicerSelectDataTrait, SellerPickerTrait, CustomerPickerTrait, PaymentPickerTrait, InvoiceTemplatePickerTrait, PickerHostTrait, AdminFormHelpersTrait, AdminEditFormComponentsTrait

Invoice administration (`/admin/invoicer/invoice`).

Table of Contents

Constants

LOGIN_BACKLINK  : string = 'backlink'

Login page parameter with the key of the stored request to return to ({@see loginReturnArgs()}).

DEFAULT_ITEMS_PER_PAGE  : mixed = 20

Items per page of admin lists when the DB setting is missing.

FORM_BACK_SUBSECTION  : mixed = 'formBack'

Session subsection mapping a key to the previous page URL of edit forms.

SESSION_NAMESPACE  : mixed = 'admin'

BLOCKED_EXTENSIONS  : mixed = ['php', 'php3', 'php4', 'php5', 'php7', 'php8',...

Extensions that must not be uploaded into the web-served folder; otherwise an editor upload would mean running foreign code on the server. It is no content whitelist (the editor uploads what is needed), only a safeguard against executable files.

CREDIT_NOTE_COLLECTIONS  : array<string|int, mixed> = ['items', 'shippers', 'paymentMethods']

Row collections that carry a quantity (same as `CreditNoteLedger`).

EDITOR_PAGE_LIMIT  : mixed = 500

Listing cap; the dialog is a suggester, not a paged list.

EDITOR_PAGE_TARGETS  : mixed = ['front:system:page:show']

Routes the editor may link to: text pages only.

EDITOR_UPLOAD_FOLDER  : mixed = 'editorUploads'

Editor root (relative to the `uploads/` root). Changing it to `''` would open the whole `uploads/` tree to the manager; the editor user could then reach (and delete) files of other modules such as products and avatars.

IMAGE_EXTENSIONS  : mixed = ['jpg', 'jpeg', 'png', 'gif', 'webp', 'avif', '...

Extensions the file manager shows as a preview instead of a document icon.

LOCALE_MAP  : mixed = ['cs' => 'cs_CZ', 'en' => 'en_US', 'sk' => 'sk_...

Maps the short language code to the full locale of the registered NEON sources.

PRICE_PATTERN  : string = '\s*-?\d{1,7}([.,]\d{1,3})?\s*'

Price mask for `decimal(10,3)`: up to 7 integer digits, 0-3 decimals.

QUANTITY_PATTERN  : string = '\s*-?\d{1,6}([.,]\d{1,2})?\s*'

Quantity mask for `decimal(8,2)`: up to 6 integer digits, 0-2 decimals, comma or dot, surrounding spaces tolerated.

Properties

$accessTokenValidator  : AccessTokenValidator

Signature and expiry alone are not enough: a revoked token (`jti` on the deny-list) that has not expired yet would keep the session logged in although the Api guard rejects the same token. Same contract as {@see \App\Core\Traits\Api\Presenters\JwtAuthTrait::checkJwtAuth()}, one implementation.

$adminFormActionsFactory  : FormActionsFactory

$adminLangNavFactory  : LangNavFactory

$adminLanguageManager  : LanguageManager

$adminPageManager  : AdminPageManager

$authManager  : AuthManager

$authStorageManager  : AuthStorageManager

$authUserManager  : UserManager

Admin `UserManager` for {@see UserManager::login()}. A module must not read through another module, so admin has its own `login()` that calls the same Api endpoint (`api/system/auth/login`).

$columnSchema  : ColumnSchema

Limits of the real database columns for {@see guardColumns()}.

$container  : Container

$customerManager  : CustomerManager

$deviceDetector  : DeviceDetector

$editorAutosaveScope  : EditorAutosaveScope

Scope of the editor autosave drafts, see {@see \App\Core\Security\EditorAutosaveScope}.

$editorLinkPageManager  : PageManager

NOTE: own property name. `$pageManager` already exists on presenters (`PagePickerTrait`), and two `#[Inject]` properties of the same name would collide in the trait composition.

$editorUploadManager  : FileSystemManager

NOTE: own property name, not `$fileSystemManager`.

$eventDispatcher  : EventDispatcher

$formSubmissionGuard  : FormSubmissionGuard

One-time submission tokens of "add" forms, see {@see guardFormSubmitOnce()}.

$jwtManager  : JwtManager

$languageContext  : LanguageContext

$languageManager  : LanguageManager

$localizationContext  : LocalizationContext

$localizationManager  : LocalizationManager

$loginDeviceCookie  : LoginDeviceCookie

Cookie of a known device for the password login throttle ({@see self::rememberLoginDevice()}).

$modalWindowFactory  : ModalWindowFactory

Injected through Nette presenter inject (after construction), not the constructor.

$paymentManager  : PaymentManager

$picker  : string

Picker mode of a list; when not empty, the presenter renders its `show` grid as a selection modal (no add/edit/delete/checkboxes, each row has a select button) in the minimal `@picker.latte` layout.

$pickerExclude  : int

Id of the record that cannot be selected in picker mode (its select button is hidden).

$pickerExcludeSubtreeLft  : int

`lft`/`rgt` bounds of a whole subtree whose nodes cannot be selected in picker mode.

$pickerExcludeSubtreeRgt  : int

$presenterContext  : PresenterContext

$privilegeManager  : PrivilegeManager

$queryCacheContext  : QueryCacheContext

Query cache policy for the whole admin request; `startup()` disables it.

$routerDispatcher  : RouterDispatcher

$sellerManager  : SellerManager

$settingContext  : SettingContext

$settingManager  : SettingManager

$themeContext  : ThemeContext

$themeManager  : ThemeManager

$themeResolver  : DefaultThemeResolver

$translator  : ITranslator

$translatorSessionResolver  : Session

$userManager  : UserManager

$adminPageEntity  : AdminPage|null

$billingLines  : array<int, object>

$currencies  : array<int, object>

$debugMode  : bool

$invoicerDefaultUnit  : string

$invoicerDuePeriod  : int

$invoiceTypes  : array<int, object>

$languages  : array<int, object>

$localizations  : array<int, object>

$paymentMethods  : array<int, object>

$paymentRegions  : array<int, object>

$pdfVariantOptionsData  : array<int, NotTranslate>

$productionMode  : bool

$productTypes  : array<int, object>

$savedEntityId  : int|null

Id of the record just saved; set by the `$processData` callback in `createForm()` after a successful save.

$translatorDomain  : string

$userTypes  : array<int, object>

$apiBridge  : ApiBridge

$billingLineManager  : BillingLineManager

$countryManager  : CountryManager

$creditNoteError  : string|null

`errorCode` from the Api preview (`orderOwned`, `sourceNotIssued`, ...).

$creditNotePreview  : array<string, mixed>|null

Basis of the manual credit note form from the Api (`credit-note-preview`); `null` means no credit note can be issued for the invoice (reason in {@see $creditNoteError}).

$currencyManager  : CurrencyManager

$dataGridFactory  : DataGridFactory

$editedInvoice  : Invoice|null

$emailDefaultBody  : string

$emailDefaultSubject  : string

$emailManager  : EmailManager

$invoiceManager  : InvoiceManager

$invoiceSupplyKindDefaultId  : int|null

Default supply kind of a new line; `null` when the code list offers none.

$invoiceSupplyKindOptions  : array<int, string>|null

Options of the supply kind select on a line (loaded once per request).

$invoiceTaxManager  : InvoiceTaxManager

$invoiceTemplateManager  : InvoiceTemplateManager

$invoiceTypeManager  : InvoiceTypeManager

$isLoggingIn  : bool

$paymentMethodManager  : PaymentMethodManager

$paymentRegionManager  : PaymentRegionManager

$pdfTemplateManager  : PdfTemplateManager

$pickerFactory  : PickerFactory

$prefillFromTemplate  : bool

Prefill from the template picker (signal `useTemplate`); allows applying defaults outside a plain GET.

$productTypeManager  : ProductTypeManager

$sendEmailInvoice  : Invoice|null

$theme  : Theme|null

$userPrivileges  : array<int, string>

$userTypeManager  : UserTypeManager

Methods

__construct()  : mixed

actionAdd()  : void

actionCreditNote()  : void

Shows the form of a manual credit note for an issued invoice.

actionDownloadPdf()  : void

Streams the invoice PDF through a PHP proxy; the real disk path is never published (and the PDF directory need not be under the document root).

actionEdit()  : void

actionSendEmail()  : void

beforeRender()  : void

createComponent()  : IComponent|null

flashFormOwnErrors()  : void

Flashes form-level errors (`$form->getOwnErrors()`) as `danger` messages.

flashRejectedUploads()  : void

Flashes one `warning` listing the files the Api rejected (type, dimensions, unreadable) after a successful save of a form with a dropzone ({@see UploadRejection}).

formatLayoutTemplateFiles()  : array<string|int, mixed>

Admin version of {@see \App\Core\Traits\Front\Presenters\ThemeInitTrait::formatLayoutTemplateFiles()}.

getAdminPageEntity()  : AdminPage|null

getContainer()  : Container

getFormBackUrl()  : string

Returns the stored previous page URL for the key, used by the `cancel` link in the template.

getInvoiceSupplyKindProto()  : array{options: array, defaultId: int|null}

Returns the options and the default kind for the client prototype of a new line (`lineProto`).

getModalWindow()  : ModalWindow

getRouterDispatcher()  : RouterDispatcher

getTranslator()  : ITranslator

guardFormSubmitOnce()  : void

Protects a form against a double submit: one rendered form saves at most once.

handleChangeLocale()  : void

handleEditorCreateFolder()  : void

Creates a subfolder in `folder` (path relative to the editor root).

handleEditorDelete()  : void

Deletes a file or (recursively) a folder. An empty path would point to the editor root, which cannot be deleted.

handleEditorFiles()  : void

Sends the folder listing for the editor file manager. The `folder` parameter is a path relative to the editor root (empty means the root).

handleEditorPages()  : void

Sends the page list for the link dialog as JSON `{"pages": [{id, label, url}, ...]}` sorted by label.

handleEditorRename()  : void

Renames a file or folder (`path` relative to the editor root).

handleEditorUpload()  : void

Accepts a file from the editor (field `file`, multipart POST; optional `folder` = subfolder of the editor root) and sends JSON `{"location": "/www/uploads/editorUploads/..."}`, the format TinyMCE expects from `images_upload_handler`.

handleLock()  : void

Explicitly locks the invoice (irreversible).

handleLogout()  : void

handleSignOut()  : void

handleUseTemplate()  : void

Rebuilds the add form from the chosen template and redraws it (template picker signal).

hasServiceByType()  : bool

Returns whether the container has a service of the given type.

initializeTranslator()  : void

isAddAction()  : bool

Tells whether the current action creates a record: `add` and the `add<Something>` actions (`addMenu`, `addKey`). Derived from the server context only, like {@see formSubmitPrivilege()}.

isAllowed()  : bool

Returns whether the logged-in user has the given privilege.

isSubmitOnceForm()  : bool

Tells whether the form was protected by {@see guardFormSubmitOnce()}.

loginWithCredentials()  : void

Logs in with username and password; called only by the login form (after validation and CSRF).

publishFieldErrors()  : void

Publishes element errors of a failed submit to the client.

redirectToFormBack()  : void

Redirects to the stored previous page and discards the key.

renderAdd()  : void

renderCreditNote()  : void

renderEdit()  : void

renderSendEmail()  : void

renderShow()  : void

resolveFormBackKey()  : string

Returns the previous-page key: from the URL if present (survives the update redirect), otherwise on a plain GET render of the edit page stores `Referer` in the session under a new random key.

runSubmitOnce()  : bool|null

Runs a saving step of a form under its one-time token (a form without the token just runs it).

setConfigParameters()  : void

setTranslator()  : $this

startup()  : void

typedComponent()  : T

Returns a subcomponent with a verified type.

authorize()  : void

Authorization hook; by default requires the `:Admin` privilege.

authorizeFormSubmit()  : void

Gate for writing presenter forms built by `createForm()`.

authorizeListing()  : void

Gate for reading lists.

checkAdminAccess()  : void

Entry gate to the admin: a guest is sent to login; a logged-in user without `:Admin` is sent to login with an error.

checkAuthentication()  : void

checkCurrentPrivilege()  : void

Builds the key from the current request (`:Admin:<Module>:<Presenter>:<action>`) and checks it. `getName()` already contains the `Admin:...` prefix, so only one leading colon is added.

checkPrivilege()  : void

Checks a specific privilege; throws 403 when denied.

createComponentAdminFormActions()  : FormActions

createComponentAdminLangNav()  : LangNav

createComponentCreditNoteForm()  : Form

createComponentEditForm()  : Form

createComponentGrid()  : DataGrid

createComponentModalWindow()  : ModalWindow

createComponentPicker()  : Multiplier<string|int, Picker>

createComponentSendEmailForm()  : Form

createForm()  : Form

Creates an edit form with the standard actions and a return to the previous page.

currentLangId()  : int|null

Returns the current language id (for picker labels etc.), null when unknown.

customerDeliveryPicker()  : PickerConfig

customerPicker()  : PickerConfig

domainTranslator()  : PrefixedTranslator|null

Returns a translator prefixed with the presenter domain, or `null` (empty domain or a translator other than Contributte).

formSubmitPrivilege()  : string

Builds the e-mail sending form, which belongs to its own action `sendEmail` with the same-named key ({@see actionSendEmail()}, {@see processSendEmail()}), not to `edit`, which {@see BasePresenter::formSubmitPrivilege()} would derive otherwise. The exception applies to this form only; `editForm` still goes through add/edit.

getAdminItemsPerPage()  : int

Returns the default items per page of admin lists from the DB setting `admin.itemsPerPage` (module System = 1), falling back to {@see DEFAULT_ITEMS_PER_PAGE}.

getAdminLayout()  : string

Returns the layout name; in picker mode ({@see $picker}) the `show` grid uses the minimal `@picker.latte` (no sidebar/header) so the opener fetch returns only the table.

getFormBackFallback()  : string

Returns the return URL when the previous page is unknown; override in a presenter without a `show` action.

getFormLanguages()  : array<int, Language>

Returns the languages for multilingual form fields (admin `LanguageManager`).

getSessionKey()  : string

Returns a session key string, e.g. 'front.auth.step1'.

getSessionSection()  : SessionSection

Returns a Nette\SessionSection instance using a dynamically built session key.

guardColumns()  : void

Gates every text and number field of the form by the real column it writes to ({@see \App\Core\Forms\ColumnGate::guard()}): an oversized value is an error at the field, never a database error that closes the entity manager (admin walkthrough A1, A14).

initializePresenterContext()  : void

intOrNull()  : int|null

Converts mixed to int or null (an empty or zero value becomes null).

invoiceTemplatePicker()  : PickerConfig

isSameSiteRequest()  : bool

Tells whether the request comes from the own site (Nette SameSite cookie); protects GET actions with a side effect.

loadInvoicerSelectData()  : void

loadUserPrivileges()  : void

Loads all privileges of the logged-in user with one database query. Call it right after `checkAdminAccess()` in `startup()` (the user is guaranteed to be logged in by then).

logout()  : void

parseDateTime()  : DateTime|null

Converts a `datetime-local` input or text value to `DateTime`, or null when empty or unparsable.

paymentPicker()  : PickerConfig

pickers()  : array<string, PickerConfig>

sellerPicker()  : PickerConfig

setTranslatorDomain()  : void

setupTemplateTranslator()  : void

Sets a translator prefixed with the presenter domain into the template (as Front components do, see {@see \App\Core\Base\BaseComponent::setup()}).

str()  : string

Safely converts a mixed form value to string.

strOrNull()  : string|null

Converts mixed to string or null (an empty string is stored as null).

templateItemDescriptions()  : array<string, array<int, string|null>>

Returns item descriptions of the template for a new invoice from a template: the form does not render a description, so {@see InvoiceFormTrait::buildItems()} looks them up here on save.

templateItemKey()  : string

Key of a template item to form row pair: code + name.

addCustomerBlock()  : void

addDeliveryBlock()  : void

addEmailBlock()  : void

addGiftsMultiplier()  : void

Same gate as {@see addItemsMultiplier()}, limit for gifts.

addInvoiceHeaderFields()  : void

addInvoiceTaxFields()  : void

Panel "VAT": manual override of the tax treatment.

addItemsMultiplier()  : void

The row count limit is read from the raw HTTP data (`onAnchor`, see {@see MultiplierLimits::guard()}), with `$maxCopies` as the second line of defense against materialization.

addLineControls()  : void

addNullableSelect()  : SelectBox

addPaymentMethodBlock()  : void

addSellerBlock()  : void

addShipperBlock()  : void

addVouchersMultiplier()  : void

Same gate as {@see addItemsMultiplier()}, limit for vouchers.

applyInvoiceTax()  : bool

Applies the invoice VAT from the engine plus the manual override.

applyLine()  : void

applyNewInvoiceDefaults()  : void

New invoice (no template): dates today and today + `duePeriod`, `IN_INVOICE` e-mail defaults.

billingLineOptions()  : array<int, NotTranslate>

buildGifts()  : ArrayCollection<int, InvoiceGift>

buildInvoiceFromTemplate()  : Invoice|null

buildInvoiceTaxPanel()  : array<string, mixed>|null

Returns data of the VAT panel as ready-made strings for the template (no calculation in Latte).

buildItems()  : ArrayCollection<int, InvoiceItem>

buildPaymentMethods()  : ArrayCollection<int, InvoicePaymentMethod>

buildShippers()  : ArrayCollection<int, InvoiceShipper>

buildVouchers()  : ArrayCollection<int, InvoiceVoucher>

canOfferCreditNote()  : bool

Mirrors the Api conditions of a manual credit note source ( {@see \App\UI\Api\Invoicer\Models\Generators\InvoiceGenerator::manualCreditNoteSource()}): a numbered, non-credit invoice without an order. UX only; the Api is authoritative.

copyLine()  : void

countryOptions()  : array<string, string>

Returns ISO country options for the customer select: active countries, CZ and SK first.

createIdentity()  : SimpleIdentity|null

createMultiplierComponent()  : Multiplier<string|int, IComponent>

Creates a multiplier for the component.

createNewComponentInstance()  : IComponent|null

Creates a new component instance without adding it to the presenter; used by the multiplier.

createStandardComponent()  : IComponent|null

Creates a standard component (not a multiplier).

creditNoteTypeIds()  : array<int, int>

creditNoteTypeOptions()  : array<int, string>

Returns the credit types from the preview (id => key) translated to invoice type names.

currencyOptions()  : array<int, NotTranslate>

customerDeliveryFieldMap()  : array<string, string>

customerFieldMap()  : array<string, string>

Returns the mapping data key (from {@see customerPrefillData()}) to billing field. Shared by the picker (client `fieldMap`) and the server-side prefill (snippet redraw after a pick).

customerLabel()  : string

customerPrefillData()  : array<string, string>

dateOrNull()  : DateTime|null

`<input type=date>`: strict parser (see `StrictDateInput`), not `new DateTime()`.

dateOrToday()  : DateTime

Parses a date or falls back to today for a truly empty field.

defaultCreditNoteTypeId()  : int|null

Returns the default type: `DOBROPIS` (the corrective tax document), otherwise the first one offered.

defaultCurrencyShortcut()  : string

defaultUnit()  : string

editorBreadcrumb()  : array<int, array{label: string, path: string}>

Builds the breadcrumb navigation: cumulative segment paths.

editorLinkLangId()  : int

Returns the language used to pick labels and URLs (default 1, Czech).

editorPageLabel()  : string

Returns the page label: title, otherwise name, otherwise `#id`.

editorPageRoute()  : Route|null

Returns the first page route the editor may link to. A page may have several (many-to-many); the whitelisted one is taken, not the first in order, so a page with both `Page:show` and `Page:form` ends up on the right one.

editorPageUrl()  : string|null

Returns the front end address of a page. The router builds it from the page route, so `/o-nas` and any prefix come out on their own.

editorParentFolder()  : string|null

Returns the parent folder (null in the editor root).

editorPath()  : string|null

Converts a client path (relative to the editor root) to an Api path (relative to the `uploads/` root).

editorUploadName()  : string|null

Builds a safe and unique file name. Sanitization copies the Api layer rules (webalize of the base and of the extension), so the name returned in the URL is exactly the name the file is stored under. The random suffix prevents collisions: `writeFile()` overwrites the same name without asking, so two different `obrazek.jpg` files would overwrite each other.

editorUploadUrl()  : string

Returns the public URL of a file. `$path` is relative to the `uploads/` root (so it includes `editorUploads/`), the same shape as other uploads in the system.

ensureEditorRoot()  : void

Creates the editor root folder; when it already exists the Api returns false and nothing happens.

expireIdleLogin()  : bool

Returns whether the login expired from inactivity. If so, revokes the tokens (like a logout), clears the `auth` section, logs out the Nette identity and returns true; otherwise moves the activity stamp forward.

findInvoice()  : Invoice|null

firstItemVat()  : string|null

Returns the rate of the first line of the invoice, used to prefill the manual override field.

firstLineDefaults()  : array<string, mixed>

flashInvoiceEmailAfterSave()  : void

Outcome of the e-mail sent by the Api right after the save (`saveInfo.invoiceEmail`); nothing when no e-mail was due (not checked, already sent).

getClientIp()  : string

giftDefaults()  : array<int, array<string, mixed>>

initializeMetaTags()  : void

Fills the template with the title, meta tags and HTML text of the page from the translation (`PageText`) of the current language, for the layout (like the Front {@see \App\Core\Traits\Front\Presenters\PageInitTrait}).

initializePage()  : void

invoiceTemplateLabel()  : string

invoiceTypeNameOptions()  : array<int, string>

Returns a map of invoice types `id => name` for the grid column/filter.

invoiceTypeOptions()  : array<int, NotTranslate>

isDevelopment()  : bool

isInvoiceEdit()  : bool

Whether a saved invoice (has id) is edited; add and template prefill (transient copy) return false.

isInvoiceLocked()  : bool

Whether the invoice is locked: its own state `lockedDatetime`, set only by the Api (e-mail dispatch, credit note or cancellation of the invoice, explicit lock).

languageOptions()  : array<int, NotTranslate>

lineDefaults()  : array<int, array<string, mixed>>

lineRow()  : array<string, mixed>

loadCustomer()  : Customer|null

Loads the customer including contacts for the server-side prefill of the invoice snapshot.

loadEmailDefaults()  : void

Prefills the subject/body of the e-mail sent from the administration ({@see InvoiceEmailTemplate::Admin}, falls back to the automatic template) by language. Admin `EmailManager` is plain CRUD and reads the translation.

loadFormData()  : void

loadInvoiceSupplyKinds()  : void

Loads the line supply kind options and the default kind (mirror of {@see InvoiceTemplateFormTrait::loadInvoiceTemplateSupplyKinds()}).

loadLocalization()  : Localization|null

loadPdfVariantOptions()  : array<int, NotTranslate>

loadSeller()  : Seller|null

Loads the seller with contacts, accounts and tax status history for the server-side prefill of the invoice snapshot.

localizationCurrencyKey()  : string|null

Admin ignores the localization currency (it takes the language only).

localizationOptions()  : array<int, NotTranslate>

Returns localization options: the amount format on the invoice.

loginReturnArgs()  : array<string, string>

Remembers the request of a logged-out user so the login can return to it ({@see storeRequest()}, `backlink` of the login page, restored by `AuthStorageTrait::redirectAfterLoginAction()`).

logoutNetteUser()  : void

parsePickerName()  : array{0: string, 1: list}

Splits a picker instance name into the config key plus row indexes (multiplier and nested multiplier). `parentId` -> `['parentId', []]`; `address_2` -> `['address', ['2']]`; `parameter_1_0` -> `['parameter', ['1','0']]` (nested).

paymentLabel()  : string

paymentMethodOptions()  : array<int, NotTranslate>

paymentRegionOptions()  : array<int, NotTranslate>

pdfVariantMatrixJson()  : string

Returns the JSON matrix of the PDF variant choice for the dependent select: `{invoiceTypeId: {"pt_pr_bvt_suv": variantId}}` (axes: productType, paymentRegion, buyerVatType, sellerUseVat).

pdfVariantOptions()  : array<int, NotTranslate>

pdfVariantTreatmentMatrixJson()  : string

Returns the JSON matrix of PDF variants by VAT treatment code: `{invoiceTypeId: {"<code>" | "*": variantId}}`, only rows with a selected variant.

processCreditNote()  : bool

Issues the credit note through the Api; redirects on success, returns false (with a flash) otherwise.

processFailedLogin()  : void

processInvalidToken()  : void

processLogin()  : void

processLoginException()  : void

processMissingToken()  : void

processSendEmail()  : bool

processSuccessfulLogin()  : void

processValidToken()  : void

productTypeOptions()  : array<int, NotTranslate>

readLoginDeviceToken()  : string|null

Returns the raw known-device cookie for the Api login (the Api verifies its signature).

redirectAfterLoginAction()  : void

After a login attempt: a successful login returns to the request remembered before the login (`backlink`, {@see PrivilegeCheckTrait::loginReturnArgs()}), otherwise to the dashboard; a failed one stays on the login page and keeps the way back.

refreshNetteIdentity()  : bool

Refreshes the token of the same logged-in user: identity data (token, name, email) are overwritten in the stored object without `login()`, so neither the session id nor the form CSRF tokens change. The identity is stored in the session section as an object; the change is written at the end of the request.

rememberLoginDevice()  : void

After a successful login (password or OAuth) issues or renews the known-device cookie ({@see LoginDeviceCookie}): a signed proof that this browser has already logged in to the account. The next login sends it to the Api ({@see self::processLogin()}), and above the account limit the password from this browser is still verified, so foreign attempts do not lock out the owner. HttpOnly, SameSite=Lax, Secure on HTTPS; lifetime from `ratelimit.loginDevice.cookieLifetime`.

resolveCustomerLabel()  : string|null

resolveInvoicerSetting()  : string

resolveInvoiceTemplateLabel()  : string|null

resolveLoginErrorMessage()  : string

Resolves the flash message of a failed login.

resolvePaymentLabel()  : string|null

resolveSellerLabel()  : string|null

revokeTokensOnLogout()  : void

Calls the Api logout (revokes the refresh family and deny-lists the access `jti`) for the tokens of the current session. Fail-open on purpose: any failure is only logged, because the local logout must not stay unfinished.

rows()  : iterable<string|int, array<string, mixed>|ArrayHash<string|int, mixed>>

saveInvoiceForm()  : bool

saveLockedInvoice()  : bool

Saves a locked invoice: only the allowed fields are written by a direct update (no recalculation, no new PDF). Other form values are dropped and the admin gets an explanation.

sellerLabel()  : string

sellerPrefillData()  : array<string, string>

setInvoiceFormDefaults()  : void

setNetteUser()  : void

snapshotLineIdentity()  : InvoicePaymentMethod}

Snapshot of the lines before the full replace, indexed by id, so `build*()` can pull in columns the form does not render (line identity).

statusOptions()  : array<string, string>

storeEditorUpload()  : bool

Stores a file; the target folder may not exist (first upload into the root), so after a failure the root is created once and the write is retried. Deeper subfolders are created by the editor user through `editorCreateFolder`.

suggestCustomers()  : array<int, array{id: int, label: string, data: array}>

suggestInvoiceTemplates()  : array<int, array{id: int, label: string}>

suggestPayments()  : array<int, array{id: int, label: string, data: array}>

suggestSellers()  : array<int, array{id: int, label: string, data: array}>

taxTreatmentOptions()  : array<string, NotTranslate>

Returns treatment code options for the manual override: translated names from the form domain (`form.fields.taxOverrideCode.codes.<CODE>`), ordered as the enum.

trInvoice()  : string

Translates a key in the form domain to a final string (for fields with `setTranslator(null)`).

tryRefresh()  : bool

Tries an auto-refresh for an expired access token. If the session holds a refresh token and the Api accepts it, stores the new pair in the session and returns true; otherwise returns false and the caller cancels the session.

userTypeOptions()  : array<int, NotTranslate>

voucherDefaults()  : array<int, array<string, mixed>>