GetOrderTypeNumForInvoiceType

Function GetOrderTypeNumForInvoiceType(const aInvoiceTypeCode : string) : Variant;

Example

procedure ScriptEvent(var Value: variant);
begin
  Value := GetOrderTypeNumForInvoiceType('CustomerInvoice'); // 1
end;

Usage

GetOrderTypeNumForInvoiceType maps a Velox invoice type code to its corresponding numeric order type.

Parameters and result

Item	Type	Description
aInvoiceTypeCode	string, const	Canonical invoice type code. Matching is case-insensitive but otherwise exact.
Result	Variant	Order type integer for a recognized input, otherwise Null.

Behaviour and edge cases

• Invoice direction, not debit/credit polarity, selects the order type. Customer invoice and credit both become SalesOrder; supplier invoice and credit both become PurchaseOrder.
• Matching ignores ASCII letter case but does not trim. Whitespace, punctuation differences, empty text and unknown/custom type codes return Null.
• The function recognizes source-family codes only. Passing SalesOrder, PurchaseOrder or numeric text is not an identity conversion and returns Null.
• The result describes type/direction only; it does not copy, create, validate or change an order.
• The mapping is not extensible through customer configuration.
• Test VarIsNull before treating the result as a valid order type.

Additional Technical Info

GetOrderTypeNumForInvoiceType converts a invoice type code into the order type number that represents the same customer/supplier direction. It is a compiled business mapping; it does not inspect a document, order record, trading party or database configuration.

Complete transformation

Input invoice type code	Order type code	Order type number
CustomerInvoice	SalesOrder	1
CustomerCredit	SalesOrder	1
SupplierInvoice	PurchaseOrder	2
SupplierCredit	PurchaseOrder	2

Implementation

The function tests each supported input with installed Delphi SameText. It returns the integer Type_SalesOrder or Type_PurchaseOrder constant. The final branch returns Null. There is no intermediate call to another public conversion function.

Side effects, errors and performance

The function is pure, performs no I/O and runs over a small fixed comparison chain. Ordinary unmatched string input returns Null.

Related entries

• GetOrderTypeForInvoiceType returns the same directional mapping as a code.
• GetInvoiceTypeCode documents the reciprocal invoice type number/code domain accepted here.
• GetOrderTypeCode and GetOrderTypeNum convert within the output order-type domain.
• Embarcadero: System.SysUtils.SameText
• Free Pascal: SameText

Created 2026-07-15