Ö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: PickerDistance içindeki oyuncular bir ad etiketi alır, yalnızca NearbyDistance içindekiler seçilebilir. Sonra tutar, açıklama (en az MinDescription harf), 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

#İlgili sayfalar