Skip to main content

Invoice_Invoiced_String

Invoice_Invoiced_String = 'Invoiced'

Example​

procedure ScriptEvent(var Value: variant);
begin
  Value := GetInvoiceStatusNum(Invoice_Invoiced_String); // 1
end;

Usage​

Invoice_Invoiced_String provides the exact Invoiced text paired with invoice lifecycle-status value 1 and recognised by Velox invoice-status conversion.

Value

PropertyValue
Script typeString
Exact literalInvoiced
Numeric partner1 through Invoice_Invoiced
Database representationInvoice_Status.Description for row 1

Additional Technical Info​

Invoice_Invoiced_String is the canonical script-visible text Invoiced paired with invoice lifecycle-status value Invoice_Invoiced = 1. Use it when a script needs the Velox name for this lifecycle state or an input to invoice-status conversion.

The string names a lifecycle state. It does not change an invoice, validate a record or send an event.

Implementation

Velox declares and registers the exact String literal Invoiced. GetInvoiceStatusNum compares input with this literal by Delphi SameText, making the conversion case-insensitive for this ASCII token. GetInvoiceStatusCode returns this exact casing for numeric value 1.

The fresh-build Invoice_Status table stores Invoiced in its Description column. The table does not have a separate Code column.

Behaviour

Pass Invoice_Invoiced_String to GetInvoiceStatusNum when converting the canonical name. An external value such as INVOICED is also recognised by that converter, but the constant itself retains the exact Invoiced spelling and casing.

Unlike the numeric Invoice_Invoiced name, Invoice_Invoiced_String is not registered in the Velox constant tag map. Use the numeric name in <!...!> configuration tags; do not expect <!Invoice_Invoiced_String!> to expand.

Edge cases and quirks

  • GetInvoiceStatusNum ignores letter case but does not trim whitespace. ' Invoiced' and Invoiced therefore return Null.
  • A direct script string comparison is not a substitute for the converter unless the calling context defines the required case behaviour.
  • Invoice_Hdr.StatusNum stores the numeric lifecycle key. The separate Invoice_Hdr.Status column uses the general issue/presentation status domain and does not store this text.
  • The same word may appear as presentation text elsewhere; use this constant only for the invoice lifecycle-status family.

Side effects

Reading or comparing Invoice_Invoiced_String has no I/O or state-changing side effect. Conversion uses a fixed in-process mapping and does not query Invoice_Status.

Errors

Reading the constant does not raise an error. The converter returns Null for unknown or whitespace-padded text rather than raising an invoice-specific exception.

Performance and concurrency

This is an immutable compiled string. Normal access and the fixed three-value converter are constant-time for practical purposes and carry no shared mutable Velox state.

Remarks

The example is source-reviewed and non-destructive. Use the exact constant when constructing canonical output even though the reverse converter accepts different letter casing.

Related entries

Created 2026-07-15