Özellikler
Hesap Defteri
Hesap Defteri fatura uygulaması: fatura kesmek ve ödemek, taksitler, tekrarlayan faturalar, gecikme cezası, şirket fatura yetkileri, otomatik tahsilat ve Config.Billing.
Hesap Defteri (billing) bir karakterin ve şirketinin faturalarını tutar. Ayarlar apps/billing/config.lua (Config.Billing) ve apps/billing/config_server.lua içindedir.
#Oyuncu ne yapabilir
- Aldığı ve gönderdiği faturaları durumlarıyla görür, tek bir Öde düğmesi olan fatura sayfasını açar. Taksitli bir fatura her seferinde bir taksit ya da tamamı olarak ödenir.
- Üç adımda fatura keser. İlk adım dünyada bir oyuncu seçmektir:
PickerDistanceiçindeki oyuncular bir ad etiketi alır, yalnızcaNearbyDistanceiçindekiler seçilebilir. Sonra tutar, açıklama (en azMinDescriptionharf), ayrıntılar, taksitler, ödeme süresi, isteğe bağlı tekrarlama süresi ve en fazla üç resim bağlantısı. - Gönderdiği faturaları tek tek ya da toplu iptal eder (en fazla
MaxBulkCancel). - Hesap sayfasını görür: tahsilat bakiyesi, hesap resmi (
AllowProfiles) ve son altı ay. Kişisel faturalarda ödenen para tahsilat bakiyesinde bekler ve bu sayfadan nakit olarak çekilir. - Şirket için: şirket adına fatura keser, şirkete gelen faturaları kasadan öder, kasa defterini görür. Bunu kimin yapabileceği aşağıdaki rütbe kurallarıyla belirlenir.
Resmi Defter kanun cezalarını burada fatura olarak yazar, İşletme uygulaması da aynı faturaları paylaşır.
#Ne gerekir
| Gereksinim | Notlar |
|---|---|
| Sinyal | Okumak alma sinyali; kesmek, ödemek ve iptal etmek gönderme sinyali ister |
| Para | Kişisel ödemeler Config.MoneyAccount hesabından (varsayılan cash) çıkar. Şirket ödemeleri şirket kasasından çıkar |
| Meslekler | Şirket faturası Config.Company.Jobs içindeki mesleklerde çalışır |
#Ayarlar
| Anahtar | Varsayılan | Ne yapar |
|---|---|---|
Enabled |
true |
Uygulamayı açar |
AllowPersonalSend |
false |
Oyuncular kendi adlarına fatura kesebilir. Kapalı: yalnızca şirketler keser |
AllowPersonalReceive |
true |
Oyuncular fatura alabilir |
AllowCreateUI |
true |
Uygulamadan fatura kesme. Kapalı: faturaları yalnızca export'lar ve diğer uygulamalar oluşturur |
MaxAmount |
100000 |
Dolar cinsinden en büyük fatura |
MinDescription / MaxDescription / MaxDetails |
8 / 240 / 3000 |
Metin uzunlukları |
MaxInstallments |
24 |
Fatura başına taksit |
MaxPeriodDays / MaxRecurringDays |
365 / 365 |
En uzun ödeme süresi ve tekrarlama süresi |
PageSize |
12 |
Sayfa başına fatura |
NearbyDistance |
5.0 |
Metre: alıcı bu kadar yakın olmalı |
EnforceNearby |
true |
Server fatura yazılırken mesafeyi yeniden ölçer |
PickerDistance |
15.0 |
Metre: bu kadar yakındaki oyuncular seçicide ad etiketi alır |
DuplicateWindowSeconds |
120 |
Bu süre içinde iki kez gönderilen aynı fatura reddedilir |
CompanySend |
'member' |
Şirket adına kimin fatura kesebileceği: 'member', 'boss' ya da bir rütbe numarası |
CompanyManage |
'boss' |
Şirket faturalarını kimin yönetebileceği |
JobPermissions |
{} |
Mesleğe göre değiştirme, örn. { sheriff = { send = 1, manage = 3 } } |
Blacklisted |
{} |
Mesleğe göre engel, örn. { newspaper = { send = true } } |
Commission |
{} |
Meslek ve rütbeye göre kesenin payı, örn. { sheriff = { [2] = 0.05, all = 0.02 } }. Fatura yazılırken sabitlenir |
MaxAttachments / ImageHosts |
3 / {} |
Fatura başına resim bağlantısı; boş adres listesi herkese açık HTTPS adreslerine izin verir |
MaxBulkCancel |
50 |
Tek seferde iptal edilen fatura |
AllowProfiles |
true |
Hesap resimleri |
Penalty |
{ Enabled = false, InitialPercent = 10, HourlyPercent = 0.5, MaxPercent = 100 } |
Vadesi geçen faturalara gecikme cezası |
SweepInterval |
60000 |
Vadesi gelen ve zamanlanmış faturaların kontrolü arasındaki ms |
Enforcement |
{ Enabled = true, GraceMinutes = 30 } |
Bundan eski ödenmemiş faturalar CheckUnpaidInvoices export'u için engelleyici sayılır |
Collection |
Enabled = false, IntervalSeconds = 3600, GraceMinutes = 60, MaxPerRun = 1000, Reserve = 0, Companies = false |
Vadesi geçen faturaların otomatik tahsilatı |
Hooks |
Sent, Paid, Cancelled |
Fatura gönderilince, ödenince ya da iptal edilince çağrılan fonksiyonlar |
Patron İşletme uygulamasında bir pay belirlemişse ya da Config.Company.InvoiceShare.default 0'dan büyükse, şirket faturalarında Commission yerine o pay kullanılır.
#Otomatik tahsilat
Collection.Enabled = true iken server, vadeden GraceMinutes sonra vadesi geçen tutarları oyundaki oyunculardan alır; fatura ve tur başına en fazla MaxPerRun dolar alır ve cepte Reserve dolar bırakır. Asla eksiye düşürmez ve çevrimdışı oyuncuların kayıtlarına dokunmaz. Companies = true şirket kasalarından da tahsil eder.
#Kancalar
luaHooks = {
Sent = function(src, invoiceId) end,
Paid = function(src, invoiceId, amount) end,
Cancelled = function(src, invoiceId) end,
},
#Yalnızca server ayarları
apps/billing/config_server.lua:
| Anahtar | Varsayılan | Ne yapar |
|---|---|---|
API.AllowedResources |
{} |
Fatura export'larını çağırabilen resource'lar |
API.AllowDistanceOverride |
false |
Export'larla oluşturulan faturalar mesafe kuralını atlayabilir |
API.MaxRequests / API.WindowSeconds |
30 / 10 |
Export çağrıları için hız sınırı |
API.MaxPayloadBytes |
16384 |
En büyük export verisi |
Logs |
açık, ana webhook'a düşer | Bu uygulamanın Discord logu |