Configuration application

Paramètres globaux de SwiftUP, organisés en trois onglets : « Général », « Périphériques » et « Paiements ».

Accessible parAdministrateur

Démo interactive

Parcourez l'écran de configuration ci-dessous : basculez entre les onglets, choisissez un type d'établissement (les modules activés changent), changez le thème avec aperçu en direct, réglez le clavier virtuel et le verrouillage, ou testez le tiroir-caisse dans l'onglet Périphériques. Tout est simulé.

⚙️ Configuration
🏢
Paramètres Société
Informations utilisées sur les factures, tickets et rapports PDF
▼
🏢
Logo de l'entreprise
PNG, JPG, SVG — recommandé 300×100 px
Raison sociale
Nom commercial
Téléphone
🏬
Type d'établissement
Adapte l'interface à votre activité automatiquement
▼
⌨️
Interface
Préférences d'affichage et de saisie
▼
🎨
Apparence
Choisissez le thème de l'interface — appliqué immédiatement
▼
📱
Serveur Mobile Waiter
Interface web pour la prise de commande sur téléphone / tablette
▼
Menu : Paramétrer → Configuration App (permission « Gérer les paramètres »). Chaque section est une carte repliable — cliquez sur son titre pour l'ouvrir ou la fermer. La barre « Rechercher un paramètre… » filtre les cartes de tous les onglets à la fois. Les onglets Général et Périphériques s'enregistrent avec le bouton « Sauvegarder » en bas ; l'onglet Paiements enregistre chaque changement immédiatement.

Les trois onglets

  • Général — Paramètres Société, Avoirs, Timbre fiscal, Devise par défaut, Type d'établissement, Interface, Apparence, Langue, Licence, Sauvegarde automatique, Plateforme Web (WebSocket), Serveur Mobile Waiter, Hub Cloud, Zone Danger.
  • Périphériques — Contrôle Imprimante, Tiroir-caisse, Terminal de paiement (TPE), Balance électronique, Email & Rapports.
  • Paiements — les modes de paiement.

Paramètres Société

  • Logo de l'entreprise (PNG, JPG, SVG — 300×100 px recommandé, fond transparent)
  • Raison sociale, Nom commercial
  • Adresse 1, Adresse 2, Ville, Code postal, Pays
  • Téléphone, Mobile, E-mail, Site Web
  • Matricule fiscal, Registre de commerce, Code TVA
  • Ces informations figurent sur les factures, tickets et rapports PDF.

Devise par défaut

Choisissez la devise utilisée pour tous les montants de l'application. Le changement s'applique partout après enregistrement. La liste des devises se gère dans Paramétrer → Devises.

Type d'établissement (mode de commerce)

Choisissez le mode le plus proche de votre activité : l'interface s'adapte automatiquement (certains menus apparaissent ou disparaissent). Le CRM clients est activé dans tous les modes.

  • Café / Bar — Tables, CRM
  • Restaurant — Tables, Impression cuisine, CRM
  • Boutique / Vêtements — Variantes, Code-barres, Stock, CRM
  • Parfumerie — Variantes, Code-barres, Stock, CRM
  • Électronique — Variantes, Code-barres, Stock, CRM
  • Épicerie — Code-barres, Dates d'expiration, Produits au poids, Stock, CRM
  • Mini Market — Code-barres, Dates d'expiration, Produits au poids, Stock, CRM
Changer le mode de commerce peut masquer des modules actifs (ex. : les Tables en passant en Boutique). Vérifiez votre configuration avant de confirmer « Changer de mode ».

Interface, apparence et langue

  • Clavier virtuel — afficher le clavier à l'écran lors de la saisie de texte (écrans tactiles).
  • Délai de verrouillage automatique — durée d'inactivité avant le verrouillage par code PIN, de 1 à 60 minutes (1 minute par défaut). Il ne peut pas être désactivé.
  • Apparence — 3 thèmes appliqués immédiatement : Blanc (clair), Sombre (neutre), Sombre Chaud (ambré).
  • Langue — Français, English ou العربية (arabe, affichage de droite à gauche), appliquée immédiatement.

Serveur Mobile Waiter

SwiftUP héberge un serveur web local pour la prise de commande sur téléphone / tablette, sur le même réseau Wi-Fi.

  • État « Serveur en ligne / Serveur arrêté » avec boutons « Démarrer » / « Arrêter ».
  • Port du serveur (1024–65535, 3002 par défaut) — sauvegardez puis redémarrez le serveur pour appliquer un nouveau port.
  • 3 QR codes d'accès : Waiter (interface serveur), Admin (panneau admin), Client (commande en ligne), chacun avec son lien à copier.
  • « Imprimer QR Codes » avec un nombre de copies (1 à 10).
  • Adresse du serveur mobile à copier, et un guide rapide : scanner le QR code, choisir une table, les articles, envoyer — la commande apparaît instantanément dans le POS.

Hub Cloud et Plateforme Web

  • Hub Cloud — état du token, Code POS (xPosCode), QR code d'accès à l'application connectée, token JWT, et liste en lecture seule des utilisateurs web synchronisés (à gérer dans Équipe → Utilisateurs Web).
  • Plateforme Web — serveur WebSocket pour un tableau de bord externe : port, nombre de clients, code de connexion (« Nouveau code »), adresse directe et QR code.

Zone Danger

« Réinitialiser les données » supprime définitivement toutes les sessions, tickets, paiements, mouvements de caisse et de stock. Les catégories, produits et variantes ne sont pas touchés. Carte visible uniquement pour le Super administrateur ; l'opération est refusée dès qu'il existe des opérations fiscalisées. Irréversible.

Contrôle Imprimante (onglet Périphériques)

  • Mode d'impression : « Impression directe » (ticket envoyé silencieusement via le pilote Windows) ou « Choisir à chaque ticket » (la boîte d'impression SwiftUP s'ouvre, vous voyez le ticket et choisissez l'imprimante).
  • Format du papier : Thermique 80 mm ou Thermique 58 mm.
  • Imprimante par défaut : une imprimante Windows ou « Automatique / imprimante système » ; bouton d'actualisation de la liste.
  • Bouton « Test Ticket » pour envoyer un ticket de test, puis « Enregistrer ».

Tiroir-caisse

  • Mode de connexion : USB ou RJ11 / COM.
  • En RJ11 / COM : port COM (liste actualisable), vitesse (baud : 9600 à 115200), broche du tiroir 0 ou 1.
  • Test : sauvegardez d'abord, puis cliquez sur « Ouvrir le tiroir ».
  • Le code PIN exigé pour ouvrir le tiroir se règle par utilisateur (Équipe → Utilisateurs → « Exiger le code PIN pour ouvrir le tiroir »).

Terminal de paiement (TPE)

  • Activer l'intégration du terminal ; désactivée, les paiements carte sont simplement enregistrés.
  • Mode : ECR — TCP/IP (recommandé), SDK fabricant (avancé) ou Manuel — saisie caissier.
  • Identifiant terminal (TID), adresse IP, port, encadrement (JSON / ligne, STX / ETX, préfixe de longueur).
  • « Détection auto », « Tester la connexion » et bascule automatique en manuel si le terminal est injoignable.

Balance électronique

  • Connexion : Port série (COM / RS-232), USB, TCP/IP réseau (adresse IP:Port) ou Simulateur (développement).
  • Marque (optionnel), port, vitesse (baud), unité (kg ou g).
  • « Activer la balance » affiche le panneau de pesée dans l'écran de vente.
  • « Connecter » / « Déconnecter » et « Sauvegarder la balance ».

Email & Rapports

Envoi automatique des rapports de session par email. L'écran ne comporte qu'un champ : « Destinataires (séparés par virgule) », par exemple patron@example.com, comptable@example.com. Le serveur d'envoi (SMTP) n'est pas réglable dans cet écran.

Modes de paiement (onglet Paiements)

  • Activer ou masquer chaque mode dans le POS
  • Choisir le libellé, l’icône, la couleur et l’ordre
  • Définir ouverture tiroir, impression automatique et rendu monnaie
  • Exiger un client ou une référence
  • Acheminer les paiements compatibles vers le terminal TPE
  • Restaurer les réglages par défaut

Timbre fiscal & législation applicable

Nouveau — v2.0.9

Le timbre fiscal (droit de timbre) est un montant fixe ajouté après le total TTC : Total TTC + timbre = montant dû. Il n'est jamais soumis à la TVA, jamais remisé, et n'affecte ni le stock ni les marges. Il se règle dans l'onglet « Général », carte « Timbre fiscal » (tapez « timbre » dans la barre de recherche de l'écran).

Intérêt : chaque document (ticket, devis, commande client, bon de livraison, facture, avoir) porte exactement le timbre voulu, sans calcul manuel, et la législation choisie empêche toute erreur ou tout contournement — dans les réglages comme à la caisse.

Réglages

  • Législation applicable — liste : « Générique (aucune contrainte) » ou « Tunisie ». Elle fixe les timbres imposés par la loi.
  • Une ligne par type de document : Ticket, Devis, Commande client, Bon de livraison, Facture, Avoir.
  • Sur chaque ligne : l'interrupteur « Appliquer le timbre fiscal » et le champ « Montant » (0 ou plus, jusqu'à 3 décimales).
  • Par défaut, aucun type ne porte de timbre, sauf ce qu'impose la législation choisie.

Verrouillé, minimum ou libre

  • 🔒 Verrouillé (puce « Fixé par la loi ») — la loi fixe le montant : ni ce réglage ni la caisse ne peuvent le changer.
  • ⬆️ Minimum (« Minimum légal : … ») — le timbre s'applique toujours ; il peut être augmenté, jamais descendre sous le minimum.
  • 🔓 Libre — votre réglage décide ; un utilisateur autorisé peut le modifier pour une seule vente, avec un motif.
  • Législation « Tunisie » : la Facture est verrouillée à 1,000 TND. Les autres types restent libres.
  • Législation « Générique » : aucun type n'est contraint.

Configurer le timbre fiscal

  1. 1Ouvrez Configuration application → onglet « Général » → carte « Timbre fiscal ».
  2. 2Choisissez la « Législation applicable ». Les types imposés affichent la puce « Fixé par la loi » et ne sont pas modifiables.
  3. 3Pour chaque autre type, activez « Appliquer le timbre fiscal » si nécessaire et saisissez le « Montant ».
  4. 4Enregistrez la configuration.
  5. 5Au POS, faites une vente test du type concerné et vérifiez la ligne « Timbre fiscal » et le « Montant dû ».
La législation est un réglage distinct : modifier l'adresse ou le pays de la société ne change pas les contraintes légales. Une nouvelle installation démarre sur « Tunisie » ; lors de la mise à jour, elle est réglée une seule fois sur « Tunisie » si le pays de la société ou la devise par défaut est tunisien, sinon sur « Générique ». Vérifiez-la après l'installation.
Le réglage s'applique aux nouveaux documents et aux brouillons. Un document émis conserve le timbre avec lequel il a été émis, et une vente déjà réglée garde le sien. Chaque changement de législation est enregistré dans le journal d'audit.

Avoirs : facture obligatoire ou non

Dans le même onglet, la carte « Avoirs » contient l'option « Un avoir doit référencer une facture » (activée par défaut). Activée : un avoir ne peut être émis que depuis une facture émise. Désactivée : un avoir peut aussi être créé seul pour un client.

Un avoir sans facture ne réintègre pas de stock et ne peut être remboursé que sur le compte client (pas en espèces ni par carte). Il exige toujours un client et l'identité fiscale de la société.
Voir aussi : Point de Vente (modifier le timbre d'une vente), Configuration ticket (impression selon le type de document), Rôles (permission « Modifier le timbre fiscal d'une vente »).

Mises à jour automatiques

SwiftUP vérifie s'il existe une nouvelle version auprès du serveur de licences au démarrage, puis toutes les 6 heures tant que l'application reste ouverte. Hors connexion, la vérification échoue silencieusement.

  • Icône cloche dans l'en-tête : ouvre le panneau « Mises à jour » — « Vous êtes à jour » ou « Une nouvelle version … est disponible », avec la version actuelle.
  • Bouton « Rechercher des mises à jour » pour vérifier immédiatement.
  • Quand une version est disponible, une notification s'affiche avec « Télécharger la mise à jour » : le lien de l'installateur s'ouvre dans votre navigateur.
  • Une mise à jour obligatoire reste affichée et ne peut pas être fermée.
  1. 1Cliquez sur la cloche puis « Rechercher des mises à jour ».
  2. 2Si une version est proposée, cliquez sur « Télécharger la mise à jour ».
  3. 3Clôturez votre session de caisse, fermez SwiftUP et lancez le nouvel installateur téléchargé (voir la page Téléchargement).
  4. 4Au redémarrage, vérifiez la version affichée dans la cloche.
Une mise à jour obligatoire ne peut pas être ignorée : planifiez son installation en dehors des heures de service.
Lors d'une mise à jour qui modifie la base, SwiftUP prend automatiquement un instantané de la base et vérifie son intégrité avant la migration.

FAQ