- Documentation
- 06Jeu
Virements des salairesJeu
Verser en jeu les fiches de paie d’une période validée : banques prises en charge, historique bancaire, débit du compte de société, jamais deux fois.
Les virements des salaires versent en jeu, sur le compte en banque du personnage de chaque agent, les fiches de paie d’une période validée dans le module Salaires. Rien ne part tout seul : une personne habilitée prépare les virements, les vérifie, puis les envoie.
L’activer
Section intitulée « L’activer »- Dans Configuration › Jeu › Intégrations, active Virements des salaires.
- Facultatif : Débiter le compte de société. Chaque virement est alors retiré du
compte de société du service (celui de son premier métier relié, par exemple
police). Il faut une banque qui gère ces comptes (voir le tableau). - Coupe la paie automatique du framework pour les métiers payés par SuperMDT
(salaire des grades à 0 dans
qbx_core/shared/jobs.lua,qb-core/shared/jobs.luaou la tablejob_gradesd’ESX). Sinon, tes agents sont payés deux fois.
Sous l’interrupteur, SuperMDT indique la banque détectée, si le virement apparaîtra dans l’historique bancaire du joueur, et si la banque sait débiter un compte de société.
Verser une période
Section intitulée « Verser une période »- Dans Salaires, ouvre une période validée et figée.
- Dans Virements en jeu, clique sur Créer les virements : un virement par fiche de paie, vers le personnage de l’agent dont le métier est relié à ce service.
- Vérifie la liste et le Montant préparé. Annuler la préparation (à maintenir) retire tout sans rien envoyer.
- Maintiens Envoyer N virements appuyé pour confirmer.
Chaque ligne suit son état :
| État | Ce qu’il veut dire |
|---|---|
| Préparé | Pas encore envoyé. |
| En attente de connexion | Le personnage n’est pas en jeu : le virement part à sa prochaine connexion. |
| En cours | Parti vers le jeu. |
| Versé | Payé ; la ligne indique s’il est Dans l’historique bancaire. |
| Échec | Avec le motif : fonds insuffisants sur le compte de société, banque qui refuse, aucun personnage relié au service… |
Réessayer les échecs relance les virements en échec, sauf un résultat incertain.
Jamais deux fois
Section intitulée « Jamais deux fois »Chaque virement a un identifiant unique, retenu par la passerelle même après un redémarrage du serveur : il n’est jamais versé deux fois. Un versement interrompu par un arrêt brutal est marqué Résultat incertain : vérifie le solde en jeu ; il n’est jamais relancé tout seul.
Qui peut le faire
Section intitulée « Qui peut le faire »Préparer, envoyer, annuler et relancer : la permission Salaires › Envoyer les virements, dans le service de la période ; sans elle, l’état des virements reste lisible mais sans boutons d’action. Les réglages de Configuration › Jeu : administrateurs de l’organisation, ou Administration déléguée › Régler le jeu (voir Les permissions). Tout est inscrit au journal d’audit.
Compatibilité
Section intitulée « Compatibilité »Testé en jeu essayé en jeu sur un vrai serveur. Vérifié sur le code écrit d’après le code source ou l’API native du script, couvert par les tests de la passerelle, pas encore essayé en jeu. Expérimental d’après la documentation publique de l’éditeur, jamais essayé : vérifie-le sur ton serveur avant de t’y fier.
Dans tous les cas, l’argent est versé sur le compte « bank » du framework. La banque change deux choses : la ligne dans l’historique de l’application bancaire, et le débit du compte de société.
| Framework | Banque | État | Historique du joueur | Débit du compte de société |
|---|---|---|---|---|
| ESX, QBCore, Qbox | Renewed-Banking | Vérifié sur le code | Oui | Oui (compte du métier) |
| QBCore | qb-banking | Vérifié sur le code | Oui | Oui (compte de métier) |
| ESX | esx_banking + esx_addonaccount | Vérifié sur le code | Oui (appli esx_banking ; Wallet de sd-phone s’il est démarré) | Oui (society_ + métier) |
| ESX | esx_addonaccount seul | Vérifié sur le code | Seulement dans sd-phone s’il est démarré | Oui |
| ESX, QBCore | okokBanking (V2) | Expérimental | Oui | Oui |
| ESX, QBCore, Qbox | qs-banking (Quasar) | Expérimental | Une ligne d’activité (montant dans le texte) | Oui |
| ESX, QBCore, Qbox | fd_banking | Expérimental | Non | Oui |
| ESX, QBCore | snipe-banking | Expérimental | Oui | Oui |
| ESX, QBCore, Qbox | tgg-banking | Expérimental | Oui (si le personnage a un compte tgg-banking) | Oui |
| ESX, QBCore, Qbox | Aucune banque reconnue (repli sur le framework) | Vérifié sur le code | Non | Non : avec le débit activé, les virements échouent |
Avec les banques prises en charge, le personnage doit être en jeu au moment du versement ; sinon le virement attend sa connexion.
Ton script est personnalisé ?
Section intitulée « Ton script est personnalisé ? »| Ta banque… | Résultat |
|---|---|
| garde le solde « bank » du framework (cas de toutes les banques ci-dessus) | Le virement est versé, avec ou sans ligne d’historique selon le tableau. |
| n’est pas dans le tableau | Repli sur le framework : versé, mais sans historique ni débit du compte de société. |
| tient son propre solde, sans le framework | Le versement va sur le compte « bank » du framework, que ta banque n’affiche peut-être pas. |
Dépannage
Section intitulée « Dépannage »| Ce que tu vois | Cause | Que faire |
|---|---|---|
| En attente de connexion | Le personnage payé n’est pas en jeu (ou un autre personnage est chargé) | Il part à la prochaine connexion de ce personnage. |
| Résultat incertain | Le serveur s’est arrêté pendant le versement | Vérifier le solde en jeu ; jamais relancé tout seul. |
| Versé mais absent de l’historique | Repli sur le framework | Installer une banque prise en charge, ou l’accepter. |
| « La banque ne sait pas débiter le compte de société » | Débit activé avec une banque qui ne le gère pas | Couper le débit, ou changer de banque. |
| « Fonds insuffisants sur le compte de société » | Le compte du service est trop bas | Approvisionner le compte, puis Réessayer les échecs. |
| Agents payés deux fois | Paie automatique du framework encore active | Salaire des grades à 0 pour ces métiers. |