StoreSettlement Worker - Configuration Parameters Documentation
For End Users and System Administrators
Overview
This document describes all configuration parameters for the StoreSettlement worker in POS Services. The StoreSettlement worker generates daily settlement files containing financial and operational data from the point-of-sale system. These files are used for accounting, reconciliation, and reporting purposes.
Settlement files contain various transaction codes (like IKU, IVA, B01, etc.) that represent different types of financial data. Each parameter below controls whether specific codes appear in the settlement file and how they are calculated.
...
Core Settlement Parameters
SettlementType
Purpose: Determines the level of detail in settlement reporting - whether settlements are generated per store, per operator (cashier), or per workstation (cash register).
...
Impacted Code(s): All settlement codes - shifts the time boundary for all transaction queries
...
Feature Enable/Disable Parameters
StoreSettlementEnableNonsale
...
Impacted Code(s): IV1-IV9 (with reason code breakdown)
...
Item Transaction Parameters
StoreSettlementEnabledItemTransactionTypes
...
Impacted Code(s): IV1 (Breakage), IV2 (InternalUse), IV3 (DockingArea), IV4 (StockAdjustment), IV5 (Inventory), IV6 (InternalTransfer), IV7 (Return), IV8 (Complaint), IV9 (Shrinkage)
...
VAT and Tax Parameters
StoreSettlementVatCodes
Purpose: Maps internal settlement codes to VAT/tax rates used in your country.
...
Impacted Code(s): IW1-IW5
...
Reason and Action Code Parameters
StoreSettlementBreakageReasonAndActionCodes
...
Impacted Code(s): I01-I99, U01-U99
...
Payment and Card Parameters
StoreSettlementCreditPaymentIssuerIds
...
Impacted Code(s): C01-C99
...
Coupon and Value Code Parameters
StoreSettlementCouponTypes
...
Impacted Code(s): Value code balance calculations
...
Deposit and Refund Parameters
StoreSettlementDepositRefundOutItemGroups
...
Impacted Code(s): IUP, IIP, IA1-IA5, IB1-IB5
...
Prize Payout Parameters
StoreSettlementPrizePayoutItemGroups
...
Impacted Code(s): IP1-IP5, IPR
...
Cash Drawer and Control Parameters
StoreSettlementCashDrawerTenderControlTypes
...
Impacted Code(s): IDR, IKI, IIN, IUT, INS, IBL, IQP, IEP
...
Price Channel Parameters
StoreSettlementGroceriesOnlinePriceChannel
...
Impacted Code(s): IC1-IC5
...
Operator and Cashier Parameters
StoreSettlementUnknownCashierNumber
...
Impacted Code(s): All operator-level codes when operator is missing
...
Complete Settlement Code Reference
| Code Range | Description |
|---|---|
| K01-K99 | Payment by credit/debit card type |
| B01-B99 | Balance per tender type (counted/registered) |
| S01-S99 | Sales per tender type (cash, card, check, etc.) |
| IM1-IM4 | Sales grouped by VAT rate (main VAT reporting) |
| IA1-IA5 | Deposit refunds IN by VAT rate |
| IB1-IB5 | Deposit fees OUT by VAT rate |
| IZ1-IZ5 | Delayed payment by VAT rate |
| IP1-IP5 | Prize payout by VAT rate |
| IC1-IC5 | Groceries online by VAT rate |
| IW1-IW5 | Webshop sales by VAT rate |
| IV1-IV9 | Item transactions (breakage, inventory, etc.) |
| IDR, IKI, IIN, IUT | Cash management (drop, paid in/out) |
| INO | NonSale total |
| N00-N99 | NonSale turnover by type |
| IKU | Number of customers |
| IVA | Number of items sold |
| IRE | Returns |
| IRM, IRK, IRP | Discounts by type |
| IGK, IG1 | Gift cards (own/foreign) |
| Q01-Q99 | Coupon types |
| R01-R99 | Alternative payment types |
| S01-S99 | SoftPay card types |
| C01-C99 | CoopPay card types |
| NO1-NO2, SE1-SE2, etc. | Currency breakdown codes |
| CNO, CSE, CEU, COT | Cash by currency |
| IVI, IVU | Inbound/outbound change fund |
| ING | Grand total (EOBD) |
| IRC, IRS | Fallback codes |
...
Parameter Summary Table
| Parameter | Default | Key Codes Affected |
|---|---|---|
| SettlementType | Operator, Store, Workstation | All codes |
| StoreSettlementOutputDirectory | c:\temp\ | File system |
| StoreSettlementPeriodType | Date | All codes |
| StoreSettlementTimeOffset | 0:00 | All codes |
| StoreSettlementEnableNonsale | false | INO, N00-N99, O00-O99, P00-P99 |
| StoreSettlementEnableCurrencyBalance | false | NO1-NO2, SE1-SE2, DA1-DA2, etc. |
| StoreSettlementEnableInboundOutboundChange | false | IVI, IVU |
| StoreSettlementEnablePaymentCardInCurrency | false | K codes with currency |
| StoreSettlementEnableCashInCurrency | false | CNO, CSE, CEU, COT |
| StoreSettlementEnableFallbacks | false | IRC, IRS |
| StoreSettlementEnableGrandTotal | false | ING |
| StoreSettlementHasItemTransactionReasonCodes | false | IV1-IV9 with reasons |
| StoreSettlementEnabledItemTransactionTypes | Empty | IV1-IV9 |
| StoreSettlementVatCodes | IM1=25;IM2=0;IM3=14;IM4=99 | IM1-IM4 |
| StoreSettlementDelayedPaymentVatRates | Empty | IZ1-IZ5 |
| StoreSettlementDepositRefundVatRates | Empty | IA1-IA5, IB1-IB5 |
| StoreSettlementPrizePayoutVatRates | Empty | IP1-IP5 |
| StoreSettlementGroceriesOnlineVatRates | Empty | IC1-IC5 |
| StoreSettlementWebShopVatRates | Empty | IW1-IW5 |
| StoreSettlementCouponTypes | Empty | Q01-Q99 |
| StoreSettlementPaymentCardTypes | Empty | R01-R99 |
| StoreSettlementPaymentCardsS | Empty | S01-S99 |
| StoreSettlementPaymentCardsC | Empty | C01-C99 |
| StoreSettlementPrizePayoutItemGroups | Empty | IP codes |
| StoreSettlementDepositRefundOutItemGroups | Empty | IUP, IIP, IA/IB codes |
| StoreSettlementCashDrawerTenderControlTypes | Empty | IDR, IKI, IIN, IUT, etc. |
| StoreSettlementGroceriesOnlinePriceChannel | Empty | IC codes |
| StoreSettlementUnknownCashierNumber | 9999 | Operator-level codes |
...
Configuration Examples by Business Type
Standard Retail Store
<add key="SettlementType" value="Store, Workstation" />
<add key="StoreSettlementOutputDirectory" value="c:\LPOS\Settlements\" />
<add key="StoreSettlementPeriodType" value="Date" />
<add key="StoreSettlementVatCodes" value="IM1=25;IM2=15;IM3=0" />
<add key="StoreSettlementEnabledItemTransactionTypes" value="Breakage,Inventory" />Multi-Currency Border Store
<add key="SettlementType" value="Store, Operator" />
<add key="StoreSettlementEnableCurrencyBalance" value="true" />
<add key="StoreSettlementEnablePaymentCardInCurrency" value="true" />
<add key="StoreSettlementEnableCashInCurrency" value="true" />
<add key="StoreSettlementEnableDeliveredBalanceInCurrency" value="true" />Grocery Store with Online Orders
<add key="StoreSettlementGroceriesOnlinePriceChannel" value="ShopAndGoCheckTerminal" />
<add key="StoreSettlementGroceriesOnlineVatRates" value="IC1=25.00;IC2=15.00;IC3=0.00" />
<add key="StoreSettlementDepositRefundOutItemGroups" value="1,8" />
<add key="StoreSettlementDepositRefundVatRates" value="1=25.0;2=0.0" />24-Hour Fuel Station
<add key="StoreSettlementTimeOffset" value="6:00" />
<add key="StoreSettlementDelayedPaymentReasonAndActionCodes" value="(16,11)" />
<add key="StoreSettlementDelayedPaymentVatRates" value="IZ1=25.0;IZ2=15.0" />
<add key="StoreSettlementCashDrawerTenderControlTypes" value="Drop,PayedIn,PayedOut,Float" />...
Validation Checklist
Before Deploying Configuration Changes:
Configuration File Syntax:
- ☑ All parameters use correct XML syntax
- ☑ Quotation marks properly paired
- ☑ Semicolons and commas in right places
Parameter Values:
- ☑ VAT rates match legal requirements
- ☑ Reason/action code pairs exist in database
- ☑ Item group numbers are valid
- ☑ Price channel keys match system values
Directory and Permissions:
- ☑ Output directory exists
- ☑ Service account has write permission
- ☑ Sufficient disk space available
Testing:
- ☑ Test in development environment first
- ☑ Compare output with manual calculations
- ☑ Verify all expected codes appear
- ☑ Check totals match POS reports
...
Version History
Document Version: 1.0 (Confluence-Optimized)
Last Updated: 2025
Applicable to: POS Services StoreSettlement Worker
Configuration Files: App.config, POSServices.Workers.exe.config
...