2.9. Dokumenty

2.9.1. Faktury

LMS umożliwia wystawianie faktur automatycznie i ręcznie. Ręczne wystawienie faktury jest możliwe z menu 'Nowa faktura' w panelu 'Finanse'. Automatyczne wystawianie faktur wymaga włączenia tej opcji podczas przypisywania taryf użytkownikom. W takim wypadku zapisem faktur do bazy zajmuje się skrypt lms-payments lub demon lmsd

Do poprawnego działania i tworzenia wydruków wymagane jest ustawienie podstawowych opcji w sekcji [invoices] lms.ini:

Wygenerowane faktury można obejrzeć w dwojaki sposób: albo poprzez ikonkę drukarki na wykazie bilansu finansowego (ogólnego bądź pojedynczego użytkownika), albo poprzez 'Lista faktur' z menu 'Finanse'. W przypadku listy faktur, możliwe jest także filtrowanie faktur do wydruku.

2.9.1.1. HTML

Przy domyślnych ustawieniach faktury wyświetlane są w formacie html wg domyślnego szablonu. W sekcji [invoices] masz do dyspozycji jeszcze następujące opcje:

  • template_file

    Szablon faktury, który powinien znajdować się w katalogu templates. Domyślnie: invoice.html.

    Przykład: template_file = invoice-mynet.html

  • content_type

    Content-type dla faktury. Jeżeli wpiszesz tutaj 'application/octet-stream' to przeglądarka zechce wysłać plik do zapisania na dysku, zamiast go wyświetlić. Przydatne jeśli używasz własnego szablonu, który wygeneruje np.rtf'a lub xls'a. Domyślnie: 'text/html'

    Przykład: content_type = application/octet-stream

  • attachment_name

    Można podać nazwę pliku, jako który ma zostać zapisany gotowy wydruk. Domyślnie: pusta.

    Przykład: attachment_name = faktura.xls

Wynikowy dokument HTML zawiera oryginały i kopie, które są oddzielone znacznikami podziału strony poprzez CSS. Tak więc każda nowoczesna przeglądarka zgodna z CSS powinna bezproblemowo drukować faktury ładnie podzielone na strony. Funkcja ta była testowana na przeglądarkach Microsoft Internet Explorer 6.0, Opera 7.02 oraz Mozilla 1.3.

Notatka

Praktycznie każda przeglądarka internetowa ma możliwość konfiguracji wydruku, gdzie można wyłączyć funkcje takie jak drukowanie stopki i nagłówka, czy też adresu na wydruku.

2.9.1.2. PDF

Możliwe jest także tworzenie faktur jako pliki pdf. Przypisanie opcji type z sekcji [invoices] wartości 'pdf' spowoduje, że faktury zamiast w html'u będą tworzone jako pliki "portable data format". Opcja template_file spełnia podobną rolę jak dla faktur html'owych, z tym, że posiada predefiniowane wartości: 'standard' - faktura podstawowa (odpowiednik invoice.html) i 'FT-0100' - faktura przystosowana do drukowania na drukach FT-0100 zawierających druk polecenia przelewu. W opcji template_file można także wstawić nazwę pliku php, jednak ta możliwość jest przeznaczona dla zaawansowanych użytkowników, gdyż wymaga utworzenia pliku php, a nie tak jak w przypadku faktur html'owych szablonu Smarty.

Dane do druku polecenia przelewu są brane z sekcji [finances] pliku lms.ini. A oto dostępne opcje:
name - nazwa firmy
shortname - skrócona nazwa firmy
address - adres firmy
zip - kod pocztowy
city - miasto
account - numer konta bankowego

2.9.1.3. Automatyczne generowanie numeru konta bankowego

LMS umożliwia automatyczne generowanie numeru konta bankowego w standardzie IBAN zawierającego ID klienta. Funkcja ta może być używana do masowej identyfikacji płatności która jako usługa znajduje się w ofercie większości banków. Aby masowa identyfikacja była możliwa, należy podpisać umowę z bankiem z której potrzebne nam będą:

  • Numer rozliczeniowy banku

    zawsze stały dla każdego banku, złożony z 8 cyfr

  • Identyfikator rachunku

    identyfikator naszego wirtualnego rachunku, złożony z 4 cyfr

Gdy mamy potrzebne dane, możemy przejść do konfiguracji LMSa.

W sekcji [finances] ustawiamy:

  • iban

    określa czy numer konta na fakturach ma być zwykły czy generowany automatycznie (0|1)

  • account

    skrócony numer konta bankowego powstały przez połączenie numeru rozliczeniowego banku z identyfikatorem rachunku, numer ten musi się składać z 12 cyfr bez spacji i innych znaków.

Od tej pory jeśli używamy faktur PDF z szablonem FT-0100, lub drukujemy bloczki przelewu/wpłaty z menu Finanse -> Wydruki -> Faktury -> Drukuj polecenia przelewu/wpłaty, każdy wydruk będzie zawierał unikalny numer konta z zawartym ID naszego klienta.

2.9.2. Dowody wpłaty (KP)

Dowody wpłaty, ze względu na swoją specyfikę, posiadają podobne opcje konfiguracyjne jak faktury. W konfiguracji dowodów wpłaty można zdecydować o sposobie numeracji ustawiając w sekcji [receipts] nastepujące opcje:

2.9.2.1. HTML

Przy domyślnych ustawieniach dowody wpłaty wyświetlane są w formacie html wg domyślnego szablonu. W sekcji [receipts] masz do dyspozycji jeszcze następujące opcje:

  • template_file

    Szablon dowodu wpłaty, który powinien znajdować się w katalogu templates. Domyślnie: receipt.html.

    Przykład: template_file = mytempl/receipt.html

  • content_type

    Content-type dla druku. Jeżeli wpiszesz tutaj 'application/octet-stream' to przeglądarka zechce wysłać plik do zapisania na dysku, zamiast go wyświetlić. Przydatne jeśli używasz własnego szablonu, który wygeneruje np.rtf'a lub xls'a. Domyślnie: 'text/html'

    Przykład: content_type = application/octet-stream

  • attachment_name

    Można podać nazwę pliku, jako który ma zostać zapisany gotowy wydruk. Domyślnie: pusta.

    Przykład: attachment_name = receipt.xls