Skip to main content
System settings control the core behavior of your BMS Point-of-Sale system, including regional preferences, session security, payment methods, and receipt printing.

​
Accessing system settings

Navigate to Manager Dashboard → System Settings to configure these options. Manager role is required.
Changes to system settings take effect immediately after saving and apply to all active POS sessions.

​
Regional settings

Configure how dates and numbers are displayed throughout the system.
​
dateFormat
string
default:"MM/DD/YYYY"
Date format used throughout the systemAvailable options:
  • MM/DD/YYYY - US format (12/31/2024)
  • DD/MM/YYYY - International format (31/12/2024)
  • YYYY-MM-DD - ISO format (2024-12-31)
​
decimalSeparator
string
default:"."
Character used to separate decimal places in numbers
​
thousandsSeparator
string
default:","
Character used to separate thousands in numbers

​
Session and security

Control session timeout and security features.
​
autoLogoutMinutes
number
default:"30"
Minutes of inactivity before automatic logoutMinimum: 5 minutes for system stability
Setting auto-logout too short may disrupt cashier workflow. Recommended minimum is 15 minutes for retail environments.

​
Payment methods

Configure which payment methods are available in the POS system.
​
availablePaymentMethods
string
default:"Cash,Card,ETF/Digital"
Comma-separated list of payment methods available at checkoutQuick presets:
  • Standard: Cash,Card,ETF/Digital
  • Cash Only: Cash
  • Digital Only: Card,ETF/Digital
​
defaultPaymentMethod
string
default:"Cash"
Payment method selected by default when processing transactionsMust be one of the available payment methods configured above.

​
Transaction controls

Security and approval settings for transactions.
​
requireManagerApprovalForDiscount
boolean
default:"false"
When enabled, cashiers must enter a manager PIN to apply discounts
​
soundEffectsEnabled
boolean
default:"true"
Enable audio feedback for button presses and successful transactions

​
Receipt content

Customize the information displayed on customer receipts.
​
receiptHeaderText
string
Main header displayed at the top of receiptsExample: WELCOME TO BMS PET STORE
Business name is managed separately in Tax Settings. The receipt header is for additional welcome messages or branding.
​
storeLocation
string
Store address or location identifier printed on receiptsExample: 123 Main Street, City, State 12345
​
phoneNumber
string
Store contact phone number printed on receiptsExample: +63 123 456 7890
​
receiptFooterText
string
Message displayed at the bottom of receiptsExample: Thank you for your purchase! Visit us again soon.

​
Printing configuration

Control how receipts are formatted and printed.
​
receiptPaperSize
string
default:"80mm"
Thermal receipt paper sizeFixed at 80mm for optimal thermal printing. This setting cannot be changed.
​
receiptFontSize
string
default:"Normal"
Font size for receipt textAvailable options:
  • Small - Compact text, fits more content
  • Normal - Standard readable size
  • Large - Enhanced readability
​
receiptTemplateLayout
string
default:"Standard"
Overall layout and detail level for receiptsAvailable layouts:
  • Compact - Minimal layout, fits more on small receipts
  • Standard - Balanced layout with all essential info
  • Detailed - Comprehensive layout with full product details
Use the Preview Template button to see how each layout looks.
​
receiptCopies
number
default:"1"
Number of receipt copies to print automatically
​
emailReceiptEnabled
boolean
default:"false"
Enable the option to email receipts to customers
​
defaultReceiptEmail
string
Pre-filled email address for receipt deliveryOnly used when email receipts are enabled.

​
Printing options

Control automatic printing behavior.
​
printReceiptAutomatically
boolean
default:"true"
Automatically send receipts to printer after payment completion
​
showReceiptPreview
boolean
default:"false"
Display receipt preview before sending to printerUseful for reviewing receipt accuracy before printing.
​
showReceiptBarcode
boolean
default:"true"
Include transaction barcode on receipts for easy returns processingRecommended to keep enabled for streamlined return lookups.

​
Product management

Configure product categories for inventory organization.
​
productCategories
string
Comma-separated list of product categories available in inventory managementQuick presets:
  • Pet Store Comprehensive: Pet Food,Pet Toys,Pet Accessories,Pet Medicine,Pet Grooming,Pet Treats,Pet Beds,Pet Carriers,Pet Collars & Leashes,Pet Bowls & Feeders
  • Pet Store Basic: Pet Food,Pet Toys,Pet Accessories,Pet Medicine
  • Dog & Cat Focused: Dog Food,Cat Food,Dog Toys,Cat Toys,Dog Accessories,Cat Accessories,Pet Medicine,Pet Treats
  • General Retail: Food & Beverages,Electronics,Clothing,Home & Garden,Books,Toys & Games,Sports,Health & Beauty
Consistent categories help with inventory organization, reporting, and finding products quickly during checkout.

​
API endpoint

GET /api/settings/system
POST /api/system-settings
Example request: 
{
  "dateFormat": "MM/DD/YYYY",
  "autoLogoutMinutes": 30,
  "defaultPaymentMethod": "Cash",
  "availablePaymentMethods": "Cash,Card,ETF/Digital",
  "receiptHeaderText": "WELCOME TO BMS PET STORE",
  "storeLocation": "123 Main St, City, State",
  "phoneNumber": "+63 123 456 7890",
  "receiptFooterText": "Thank you for your purchase!",
  "printReceiptAutomatically": true,
  "receiptCopies": 1,
  "receiptPaperSize": "80mm",
  "receiptFontSize": "Normal",
  "receiptTemplateLayout": "Standard",
  "showReceiptBarcode": true,
  "requireManagerApprovalForDiscount": false,
  "soundEffectsEnabled": true,
  "productCategories": "Pet Food,Pet Toys,Pet Accessories"
}

​
Next steps

Build docs developers (and LLMs) love

Get started for freeTalk to us