Settings Guide

Configure your business, sales, accounting, and integrations from a single Settings panel.

πŸ“‘ 15 Settings Tabs

🏒
Business

The Business tab holds your company's identity β€” the information that appears on invoices, quotations, and receipts.

Business settings tab
Business tab β€” logo, company details, and tax registration
πŸ“Έ Business Logo

Upload a logo that appears on all printed documents. Supports PNG, JPG up to 2 MB.

πŸ“ Business Name

The legal trading name shown on tax invoices and quotations.

πŸ“§ Email & Phone

Contact details displayed on customer-facing documents.

πŸ”’ TIN Number

Your Tax Identification Number β€” required for VAT returns and customs.

πŸ’‘
Non-taxable businesses: Toggle "Is this business not taxable?" to disable all tax calculations. This is useful for small exempt businesses or internal cost centres.
βš™οΈ
General

The General tab controls how numbers, currencies, and dates appear throughout the application.

General settings tab
General tab β€” decimal places, currency symbol, and date format
πŸ”’ Decimal Places

Number of decimal places for monetary values. Set to 0 for Vanuatu Vatu (whole numbers only).

πŸ’² Currency Symbol

The symbol displayed next to amounts β€” e.g. VT for Vatu, $ for USD.

πŸ“… Date Format

Choose between DD/MM/YYYY, MM/DD/YYYY, or YYYY-MM-DD.

⚠️
Changing decimal places affects how existing values are displayed, not stored. The database always keeps full precision.
🧾
Sales

The Sales tab configures how prices and stock warnings behave when creating invoices, quotations, and proforma invoices.

Sales settings tab
Sales tab β€” tax-inclusive pricing and low-stock warnings
πŸ’² Prices Inclusive of Tax

When enabled, the sell price you enter for products includes VAT. The system automatically calculates the net amount and tax split on invoices.

⚠️ Warn When No Stock

Shows a warning when adding a product to an invoice that has zero or negative available stock.

πŸ’‘
In Vanuatu, most retail prices are tax-inclusive by law. Enable this toggle to ensure customer-facing prices include 15% VAT.
πŸ“¦
Stock

The Stock tab lets you choose how the cost of goods is calculated when inventory is sold.

Stock settings tab
Stock tab β€” costing method selection
πŸ“Š Costing Method

Last Cost β€” uses the most recent purchase price as the cost of goods sold.

πŸ“Š Average Cost

Calculates a weighted average of all purchase costs. More accurate for volatile pricing.

⚠️
The costing method affects COGS (Cost of Goods Sold) calculations and gross profit reporting. Changing this setting does not recalculate historical transactions.
πŸš€
Initial Setup

The Initial Setup tab is used once when onboarding a new business. It lets you record opening stock quantities and opening accounting balances before you start trading.

Initial Setup tab
Initial Setup β€” opening stock and accounting configuration
  1. Opening Stock β€” Enter the quantity and value of inventory you already have on hand. This creates the initial inventory journal entry.
  2. Opening Accounting β€” Enter opening balances for all accounts (bank, receivables, payables, etc.) to match your previous accounting system.
πŸ”’
Once completed, both sections are locked and cannot be edited again. Verify all numbers carefully before confirming.
πŸ›οΈ
Tax

The Tax tab manages tax rates applied to products and services. Each product references a tax rate for invoice calculations.

Tax settings tab
Tax tab β€” tax rate management with SDC label mapping and default selection
πŸ“‹ Tax Rate Table

View all configured tax rates with name, percentage, SDC label, and default status.

⭐ Default Rate

One rate can be marked as default β€” new products automatically inherit this rate.

🏷️ SDC Labels

Each tax rate has a label (A, E, F, etc.) received from the SDC. Labels appear on fiscal receipts next to the tax value (e.g. A = 15%). New labels are added automatically when the SDC configuration changes.

πŸ’‘
Common setup in Vanuatu: VAT 15% (default for taxable items) and No Tax 0% (for exempt items or services). Tax labels are assigned by the SDC and mapped to POS tax rates during the Test Connection step. The SDC defines what rate each label/category has. All tax amounts are rounded to whole Vatu (no decimals) using standard rounding rules.
πŸ’³
Payments

The Payments tab manages the payment methods available when recording customer payments. All configured payment types are registered and sent to the SDC during fiscalization.

Payments settings tab
Payments tab β€” manage, reorder, and activate payment types
  1. Add payment types β€” Cash, Card, Bank Transfer, Cheque, Mobile Money, etc.
  2. Reorder β€” Drag payment types to change the order they appear in the payment dialog.
  3. Deactivate β€” Disable payment types you don't use instead of deleting them.
πŸ”
VSMS (Vanuatu Sales Management System)

The VSMS tab configures the connection to the V-SDC (Virtual Sales Data Controller) or E-SDC for fiscal invoice verification as required by Vanuatu tax regulations.

VSMS settings β€” SDC connection
VSMS Settings β€” ESDC URL, ESDC Token, PIN, and Test Connection for mutual authentication
🌐 ESDC URL

The URL of the E-SDC or V-SDC endpoint (found on the TaxCore control panel). The POS uses HTTP for E-SDC (local) and HTTPS for V-SDC (cloud).

πŸ”‘ ESDC Token

The authentication token for the E-SDC, available on the TaxCore control panel.

πŸ“‹ Accreditation Number

The POS accreditation number assigned during the TaxCore accreditation process (also shown on the TaxCore control panel).

πŸ” PIN

The smartcard access PIN used to identify against the SDC. Found on the TaxCore control panel. ⚠️ Maximum 5 attempts β€” entering the wrong PIN too many times will lock the smartcard. If locked, you can unlock it from the TaxCore control panel.

πŸ”— Test Connection

Verifies mutual authentication between the POS and the SDC using the PIN. On success, the POS receives configuration parameters including available tax rates and labels.

🏷️ Tax Rate Mapping

After a successful connection, the SDC tax rates are auto-detected and mapped to local tax configuration. Tax labels (A, E, F, etc.) come directly from the SDC.

VSMS settings β€” SDC tax rate mapping
SDC Tax Rate Mapping β€” tax rates and labels received from the SDC after successful authentication
πŸ’‘
Configuration source: All VSMS settings (ESDC URL, ESDC Token, Accreditation Number, and PIN) are available on the TaxCore control panel. Enter them exactly as shown. Tax labels are mapped from POS tax rates to SDC categories β€” the POS never uses tax rates other than those defined by the SDC for each category.
ℹ️
System Information

Click the application logo in the sidebar to access System Information. This screen displays:

System Information screen
System Information β€” manufacturer, software version, serial number, and VSMS status
🏒 Developer

ReefStack Technologies β€” the software developer.

πŸ“¦ Software Version

Application version and build number for support and audit purposes.

πŸ”’ Serial Number

Unique device/installation identifier.

πŸ” VSMS Status

SDC connection status and registered TIN.

πŸ€–
AI

The AI tab configures integration with OpenAI for intelligent features like product descriptions, categorization, and smart suggestions.

AI settings tab
AI tab β€” OpenAI API configuration and model selection
πŸ”‘
Enter your OpenAI API key to enable AI-powered features. The key is stored securely and only used for your business's requests.
πŸ”Œ
API

The API tab manages API keys for programmatic access and webhook endpoints for real-time notifications.

API settings tab
API tab β€” key management and webhook configuration
πŸ”‘ API Keys

Generate and revoke API keys for external integrations. Keys are scoped to your business.

πŸ”— Webhooks

Configure webhook URLs to receive real-time notifications for events like new invoices or payments.

πŸ–¨οΈ
Printers

The Printers tab configures POS receipt printers and label printers connected to your terminal.

Printers settings tab
Printers tab β€” POS printer and label printer configuration
  1. Receipt Printer β€” Configure ESC/POS-compatible thermal printer (USB, Bluetooth, or network).
  2. Label Printer β€” Set up a barcode/price label printer for shelf labeling.
  3. Paper Size β€” Choose 58mm or 80mm receipt width.
βœ‰οΈ
Email Template

The Email Template tab customizes the default email sent when you email invoices, quotations, or receipts to customers.

Email Template settings tab
Email Template tab β€” subject line and body editor with variables
  1. Subject Line β€” Customizable with variables like {{invoice_number}}, {{customer_name}}, {{total}}.
  2. Email Body β€” Rich text editor with dynamic placeholders for personalized messages.
πŸ—„οΈ
Database

The Database tab provides low-level database management tools β€” migrations, backups, and maintenance.

Database settings tab
Database tab β€” migration status and backup controls
🚨
This tab is intended for advanced users and administrators only. Running migrations or modifying the database schema can cause data loss if used incorrectly.
πŸ“₯
Import / Export

The Import / Export tab lets you bulk-import products, customers, and transaction data from CSV files, or export your catalog for backup or migration.

Import tab
Import β€” upload CSV or ZIP files with product and transaction data
Export tab
Export β€” download product catalog as CSV or ZIP
πŸ“€ Export Catalog

Download products, customers, invoices, or chart of accounts as CSV files.

πŸ“₯ Import Catalog

Upload CSV files to bulk-create products, customers, or inventory. Includes preview and validation before committing.

πŸ“‚ Transaction Data Import

Import transaction line items from CSV files containing article ID, price, quantity, and other necessary information. Items are matched to the product catalog automatically.

πŸ“Š Import History

View all past imports with the option to undo. Ensures data integrity for bulk operations.

πŸ“‹
Import CSV files using the column headers expected by the system. The import wizard will validate your data and show a preview before committing any changes.
πŸ“…
Scheduled Reports

The Scheduled Reports tab lets you configure recurring reports that are automatically generated and sent by email at scheduled times.

Scheduled Reports tab
Scheduled Reports β€” list of configured reports with frequency, period, send time, and recipients

Each report card shows the report type, frequency, period, send time, and recipient emails. Use the toggle switch to enable or disable a report without deleting it.

Creating a Report

Click ADD REPORT to open the configuration dialog:

Add Scheduled Report dialog
New Scheduled Report dialog β€” configure report type, frequency, period, send time, and recipients
πŸ“Š Report Type

Sales Summary β€” total sales, tax, and payment breakdown.
Sales by Product β€” sales grouped by product.
Sales by Category β€” sales grouped by category.
Customer Balance β€” point-in-time snapshot of outstanding customer balances (no period selection).
Payment Received β€” all payments received in the period.

πŸ” Frequency

Daily β€” sent every day at the configured time.
Weekly β€” sent on the selected day of the week (Mon–Sun).
Monthly β€” sent on the selected day of the month (1–31).

πŸ“… Period

Previous β€” covers the completed period (yesterday, last week, last month).
Current β€” covers the ongoing period so far (today, this week, this month).

πŸ• Send Time

The time the report is generated and emailed, in GMT+11 (Vanuatu time).

πŸ“§ Recipient Emails

One or more email addresses separated by commas. Reports are sent as HTML emails.

πŸ’‘
Reports are generated server-side and delivered as HTML emails. You can create multiple reports with different types, frequencies, and recipients.
πŸ’Ύ
Don't forget to save! After making changes on any tab, click the Save icon (πŸ’Ύ) in the top-right corner of the Settings page. Unsaved changes will be lost when you navigate away.