WHMCS számlázz add-on modul

Tartalomjegyzék:

• 1. Telepítési útmutató
  
• 2. Konfiguráció
  
  • 2a. WHMCS
    
  • 2b. szamlazz.hu
    
• 3. Tippek
  
• 4. Frissítési útmutató
  
  • 4.a 1.3.7 -> 2.0.0
    
  • 4.b 2.0.9 -> 2.0.10
    

Telepítési útmutató:

• A helyi rendszer cron mappájába másolja be a crons mappa tartalmát.
  
• A lang/overrides/english_szamlazz.php tartalmát másolja be a lang/overrides/english.php fájlba. (Ha még nem létezik, hozza létre.)
  
• A lang/overrides/hungarian_szamlazz.php tartalmát másolja be a lang/overrides/hungarian.php fájlba. (Ha még nem létezik, hozza létre.)
  
• Cserélje le a következő sablon fájlt az aktív sablon könyvtárában: clientareainvoices.tpl a zip-ben található templates/template_name/clientareainvoices.tpl sablon fájlra.
  
• A modules/addons mappába másolja be a modules/addons/szamlazzhu mappát.
  
• A modules/addons/szamlazzhu/license_sample.php fájlt nevezze át license.php-re és a portálon található licensz kulcsot másolja be a $szamlazzhu_licensekey változó értékeként.
  
• Aktiválja a modult a WHMCS adminisztrációs felületén (Setup - Addon Modules), töltse ki a beállításokat.
• Hozza létre a beállításokban megadott munkakönyvtárakat.
  
• Hozza létre a beállításokban megadott client custom fieldeket. (Ez a WHMCS felületén a Settings->System Settings->Custom Fields-en tehető meg.)
  
• További információ a custom fieldekről a konfiguráció cím alatt.
  
• Állítsa be a cront a crontab file-ban, hogy kb. 5 percenként indítsa el a /whmcs/crons/szamlazz_ipn.php file-t.
  
• Állítsa be a Számlázz.hu ipn url-jét a whmcs/modules/addons/szamlazzhu/ipn.php file-ra.
• Nézze át az ajánlott szamlazz.hu konfigurációs lehetőségeket.
  

Konfiguráció:

WHMCS

• Számlázz API kulcs: A szamlazz.hu felületén található
  
  
• Invoice prefix: amennyiben egy számlatömbként kezelné, meg kell egyezni a szamlazz.hu felületén beállított prefix értékével
  
• Számla megjegyzés: minden kiállított számla alján szerepelni fog. Példaszöveg:
  Kérjük, hogy átutalásos fizetésnél a Közlemény rovatban tüntesse fel a számla sorszámát! Késedelmes fizetés esetén késedelmi kamatot számítunk fel, melynek mértéke a mindenkori jegybanki alapkamat kétszerese, de legalább 40 EUR. Köszönjük, hogy igénybe vette szolgáltatásainkat!
  
• Fizetett számla megjegyzés: A magyar jogszabályok szerint kötelező ráírni a számlára,hogy fizetve, amennyiben az nem igényel további pénzügyi teljestést. Példaszöveg:
  FIZETVE! Pénzügyi teljesítést nem igényel!
  
• Client Custom field beállítási mezők
  Minden custom field esetén egy “|” (pipe) karakter választja el a változó nevét, illetve a felületen megjelenítendő nevet. Példák:
  
  • Client Custom Field: Számla fizetési határideje:
    
    • field name: szamlazzszladuedays|Fizetési határidő (nap)
      
    • type: textbox
      
    • opciók: admin only
      
  • Client Custom Field: Számlázás kikapcsolása:
    
    • field name: szamlazzuserdisabled|Szamlazz.hu számlázás letilt
      
    • type: checkbox
      
    • opciók: admin only
      
  • Client Custom Field: Számla a díjbekérő helyett
    
    • field name: no_proforma|Számla díjbekérő helyett
      
    • type:checkbox
      
    • description: Ennek az ügyfélnek automatikusan számlát küldünk díjbekérő helyett
      
    • opciók: admin only
      
  • Client Custom Field: Papír alapú számla
    
    • field name: paperinvoice|Papír alapú számla
      
    • type: checkbox
      
    • opciók: admin only
      
  • Client Custom Field: Számla nyelve
    
    • field name: invoicelang|Számlázás nyelve
      
    • type: dropdown
      
    • select options: Magyar,English
      
    • opciók: admin only
      
  • Client Custom Field: Egyedi számla megjegyzés
    
    • field name: invoicenote|Számla egyedi megjegyzés
      
    • type: Text Box
      
    • opciók: admin only, show on invoice
      
  • Client Custom Field: Mindig a default számlaszám használata (opcionális):
    
    • field name: force_default_acc|Default számlaszám használata
      
    • type: checkbox
      
    • opciók: admin only
      

Szamlazz.hu

• Számlázási beállítások:
  
  • Kapcsolja be a “Rendelésszám ismétlődésének tiltása” beállítástt.
    
  • Kapcsolja ki a "Díjbekérő automatikus számlázása" beállítást.
    
  • (opcionális) Kapcsolja be a “Díjbekérő automatikus törlése” beállítást.
    
  • (opcionális) Kapcsolja be “A számlaértesítő e-mailhez csatoljuk a számla PDF-et” beállítást.
    
• Számlázás alapadatok:
  
  • Töltse ki az “IPN üzenet internetcíme” beállítást a modulban található ipn.php-ra mutató elérési úttal. (példáúl: https://www.zts.hu/modules/addons/szamlazzhu/ipn.php)
    

Tippek:

• Biztonsági szempontból érdemes megváltoztatni az ipn.php fájl nevét.
  
• A Számla Agent SDK a többi munka mappához hasonlóan kimozgatható a docrooton kívülre, de a szervernek írás joga kell hogy legyen a mappához. Ebben az esetben a konfigurációban a "SzamlaAgent helye" beállítást át kell állítani az adott mappára.
  
• Ne frissítse külön a Számla Agent SDK-t, mindig az addonhoz csomagolt verziót használja.
  

Frissítési útmutató:

1.3.7 -> 2.0.0:

• Ajánlott WHMCS verzió: 7.7.1
• Töltse ki az új modul beállításokat
• Hozza létre az ezeknek megfelelő mappákat és client custom fieldeket
• Törölje a nem használt client custom fieldeket (számlaszám, közösségi számlaszám)
• Kapcsolja ki az adószám ellenőrzést (tax number validation) a WHMCS-ben (Setup / Payments / Tax Configuration / Vat Settings / VAT Number Validation)
• Törölje az eddigi admin usert
• Állítsa be a cront, hogy kb. 5 percenként indítsa el a /whmcs/crons/szamlazz_ipn.php file-t
• Állítsa be a Számlázz.hu ipn url-jét a whmcs/modules/addons/szamlazzhu/ipn.php file-ra

2.0.9 -> 2.0.10

• A license_sample.php fájlt nevezze át license.php-re
• A régi license.txt fájlből a license kulcsot másolja be a license.php $szamlazzhu_licensekey változó értékeként.
• Törölje a régi license.txt fájlt