SaleFlex
Open-Source Ecosystem for Modern Retail
SaleFlex brings together in-store checkout, back-office management, and central API integration in one modular platform. Designed to scale from a single register to a multi-store chain — with offline-first reliability built in from the ground up.
Applications
Database Models
Supported Databases
License — Free Forever
PyPOS v1.0.0b7
Ecosystem Components
Each component can run independently or together as a fully integrated retail platform.
SaleFlex.PyPOS
Touch-Screen Point-of-Sale Application
v1.0.0b7 Beta — Active DevelopmentA modern Python and PySide6 (Qt) POS application designed for store-floor checkout operations. Supports multiple payment methods, loyalty programs, campaign evaluation, customer management, and real-time inventory — all with offline-first reliability.
SaleFlex.OFFICE
Back-Office Management Application
Foundation Implemented — Active DevelopmentA desktop back-office console for managers and administrators. Provides spreadsheet-style workspaces for cashier, product, campaign, customer, loyalty, warehouse, and POS terminal management. Runs in standalone or GATE-connected mode.
SaleFlex.GATE
Central API Hub and Integration Gateway
Target Architecture — In DevelopmentA Django and Django REST Framework central hub providing multi-tenant company, store, and terminal management. Acts as the integration gateway for ERP, loyalty, campaign, and payment adapters — keeping edge clients thin and simple.
Core Capabilities
Everything you need to run a modern retail operation — out of the box.
Multi-Payment Processing
Cash, credit/debit card, mobile, prepaid, loyalty bonus, on-account, bank transfer — including split-tender transactions.
Inventory Management
Real-time stock tracking, low-stock alerts, goods receipt, manual adjustment, and movement history — all per warehouse location.
Loyalty Programs
Tiered membership (Bronze / Silver / Gold / Platinum), earn and redeem points at checkout, full point movement audit per customer.
Campaign Engine
Basket, product, time-based, Buy-X-Get-Y, and payment-method campaigns. Coupon activation with per-customer and global usage limits.
Customer Management
Customer search, new customer creation, sale assignment, activity history, loyalty point movements, and segment auto-assignment.
End-of-Day Closure
ESC/P printer receipts and Z-reports, closure lifecycle management, and country-specific closure templates (Turkey, USA, EU).
Offline-Resilient Operations
Uninterrupted sales during connectivity loss. Offline outbox pattern ensures zero data loss when the network returns.
Dynamic Form System
Database-driven form and control definitions. Virtual keyboard, numeric pad, dual-function buttons, and tab controls — all configurable.
Integration Layer
Ready-made adapter architecture for GATE hub, ERP (SAP, Oracle, Logo), payment gateways, and campaign modules.
How the Ecosystem Works Together
A three-layer architecture — from the store floor to the central cloud.
Store Floor
Cashiers run daily sales and payment operations on SaleFlex.PyPOS. Operates on local SQLite with no mandatory network dependency.
Store Operations
Managers use SaleFlex.OFFICE to define products, campaigns, and customers — distributing master data to POS terminals over REST/JSON.
Central Services
SaleFlex.GATE manages the company → store → terminal hierarchy and exposes versioned REST APIs to all clients.
External Integrations
ERP, loyalty platforms, payment gateways, and campaign systems connect through GATE so edge clients stay thin and simple.
Platform Principles
Modular by Design
Use only the components you need. Add more as your operations grow. No component is a hard dependency of another.
Offline-Resilient
Sales continue even when the network is down. Data is queued locally and synchronized automatically when connectivity returns.
API-First Integration
REST and JSON contracts form the common language between all components, making external adapters straightforward to build.
Multi-Store Ready
Start with a single register and scale to a multi-store chain. The architecture is designed for this growth from day one.
Role-Aware Access
Cashier, manager, and admin responsibilities are separated by product boundaries. Each user sees only what they need.
Open Source Foundation
All SaleFlex repositories are publicly available under the MIT license — free for personal and commercial use with attribution.
Deployment Profiles
Choose the configuration that fits your current needs and grow from there.
Standalone
PyPOS only — no central dependency required. Ideal for a single terminal or a small business getting started quickly.
Office-Connected
PyPOS + OFFICE — store-level coordination, reporting, and local master data management. Works without internet access.
Gate-Connected
Full stack — central APIs, multi-tenant tenancy, and remote access. The complete feature set for multi-store chains.
Open Source and Community-Friendly
SaleFlex repositories are open, transparent, and evolving in public.
The MIT license allows personal and commercial use — completely free, forever.
Explore the Repositories
Browse source code and documentation for each module on GitHub.
Contribute
Report bugs, request features, or submit pull requests to help the project grow.
Ready to Build with SaleFlex?
Follow the Getting Started guide for installation steps, or visit the Applications page to compare what each module offers.