Uzgadnianie przelewów bankowych: instalacja i konfiguracja

Instalacja

Zainstaluj moduł w Moduły > Menedżer modułów > Załaduj moduł, przesyłając plik ZIP, albo skopiuj folder dfbankreconcile do katalogu /modules/ sklepu i kliknij Zainstaluj.

Podczas instalacji moduł tworzy cztery tabele (importy, przelewy, przypisania do zamówień, przypomnienia), dodaje zakładkę Uzgadnianie bankowe w menu Zamówienia i rejestruje hook strony zamówienia. Dane do przelewu w przypomnieniach są uzupełniane z natywnego modułu płatności przelewem, jeśli jest skonfigurowany.

W sklepie nic się nie zmienia, dopóki nie zaimportujesz wyciągu: żadna płatność nie jest rejestrowana i żadne przypomnienie nie jest wysyłane, bo przypomnienia są domyślnie wyłączone.

Cztery ekrany modułu

• Oczekiwane przelewy: zamówienia oczekujące na przelew, z wiekiem, kwotą do zapłaty, wysłanymi przypomnieniami i datą następnego przypomnienia. U góry cztery wskaźniki: kwota oczekująca, przelewy do sprawdzenia, przelewy dopasowane i przypomnienia wysłane w ciągu 30 dni.
• Uzgadnianie: zaimportowane przelewy filtrowane zakładkami (Do sprawdzenia, Dopasowany, Częściowy, Zignorowany, Wszystkie), z propozycjami zamówień i akcjami.
• Importuj wyciąg: przesyłanie pliku i historia importów.
• Przypomnienia: podsumowanie ustawień, adres URL zadania cron oraz dziennik przypomnień i anulowań.

Konfiguracja

Otwórz konfigurację przyciskiem Ustawienia na pasku narzędzi modułu lub z menedżera modułów.

Dopasowanie i zatwierdzanie

• Statusy zamówień oczekujących na przelew: zamówienia w tych statusach są porównywane z zaimportowanymi przelewami. Domyślnie status oczekiwania na płatność przelewem. Przytrzymaj Ctrl, aby zaznaczyć kilka.
• Status po pełnej płatności: domyślnie „Płatność przyjęta”.
• Status po płatności częściowej: pozostaw „Zachowaj obecny status” lub wybierz utworzony przez siebie osobny status. W każdym przypadku płatność jest rejestrowana w zamówieniu.
• Automatycznie zatwierdzaj pewne dopasowania i Minimalny wynik do automatycznego zatwierdzenia: patrz następna sekcja.
• Tolerancja kwoty: różnica, przy której kwota jest uznawana za dokładną, domyślnie 0,01.
• Akceptowana różnica na opłaty bankowe: przelew niższy od kwoty do zapłaty maksymalnie o tę wartość rozlicza zamówienie. Przydatne przy przelewach zagranicznych, z których bank klienta potrąca opłaty. Domyślnie 0, co wyłącza tę regułę.
• Szukaj zamówień złożonych w ciągu ostatnich: domyślnie 120 dni. Starsze zamówienia nie są proponowane.
• Wyślij klientowi e-mail o statusie: wysyła e-mail przypisany do statusu „Płatność przyjęta”, gdy zamówienie zostaje opłacone.

Import CSV

Pliki OFX i CAMT.053 nie wymagają ustawień. W przypadku CSV pozostaw pola kolumn puste: moduł znajduje wiersz nagłówka w pierwszych 40 wierszach i rozpoznaje typowe nazwy kolumn w 8 językach, w tym Data operacji, Data księgowania, Opis, Tytuł, Kwota i Kontrahent. Jeśli eksport nie zostanie rozpoznany, ustaw Separator kolumn, Format daty i numery kolumn, licząc od 1:

• Kolumna daty.
• Kolumna kwoty dla kwoty ze znakiem albo Kolumna uznań i Kolumna obciążeń, jeśli bank je rozdziela.
• Kolumny opisu: jedna lub kilka kolumn oddzielonych przecinkami, na przykład 3,4. Są łączone w tekst, który jest analizowany.

Wynik i automatyczne zatwierdzanie

Każdy przelew jest porównywany z zamówieniami oczekującymi na płatność, złożonymi najpóźniej w dniu przelewu. Punkty się sumują:

• Znaleziono numer referencyjny zamówienia w tytule: 60 punktów. Wyszukiwanie pomija spacje i znaki interpunkcyjne, więc numer rozdzielony przez bank na dwie części też zostanie znaleziony.
• Znaleziono numer zamówienia po słowach Zamówienie, ZAM, Order, CMD, Commande, Bestellung, Pedido, Ordine lub Encomenda: 45 punktów.
• Dokładna kwota: 35 punktów. Kwota pomniejszona o opłaty bankowe, w ramach ustawionej tolerancji: 30 punktów.
• Znaleziono nazwę klienta (nazwisko, firma lub nazwisko z adresu rozliczeniowego, co najmniej 4 znaki): 15 punktów.
• Jedyne zamówienie na tę kwotę, bez numeru referencyjnego ani numeru zamówienia: 10 punktów.
• Kilka zamówień w jednym przelewie: gdy tytuł zawiera kilka numerów referencyjnych, których suma odpowiada kwocie, dodawana jest propozycja zbiorcza z wynikiem 95.

Przykłady: numer referencyjny i dokładna kwota dają 95. Numer zamówienia, dokładna kwota i nazwa dają 95. Dokładna kwota i nazwa bez numeru referencyjnego dają 50, albo 60, jeśli to jedyne zamówienie na tę kwotę.

Przelew jest zatwierdzany automatycznie podczas importu, jeśli automatyczne zatwierdzanie jest włączone, najlepsza propozycja rozlicza zamówienie, jej wynik osiąga próg (domyślnie 90) i wyprzedza drugą o co najmniej 15 punktów. Pozostałe przelewy z propozycją o wyniku co najmniej 40 otrzymują status Propozycja, reszta Brak dopasowania.

Import wyciągu

1. Pobierz wyciąg z rachunku w bankowości internetowej w formacie CSV, OFX, QFX lub CAMT.053 XML.
2. Otwórz ekran Importuj wyciąg, wybierz plik (maksymalnie 20 MB) i kliknij Importuj i dopasuj.
3. Komunikat wyniku podaje liczbę odczytanych przelewów przychodzących, wierszy już zaimportowanych, zamówień automatycznie oznaczonych jako opłacone i przelewów do sprawdzenia. Następnie otwiera się ekran Uzgadnianie.

Zachowywane są tylko uznania. Każdy wiersz jest identyfikowany po dacie, kwocie i tytule: wiersz już zaimportowany jest liczony jako duplikat i pomijany. Możesz więc co tydzień importować wyciąg z bieżącego miesiąca bez tworzenia duplikatów. W plikach CAMT.053 paczka kilku przelewów jest dzielona na pojedyncze przelewy z nazwą każdego zleceniodawcy.

Sprawdzanie propozycji

Zakładka Do sprawdzenia pokazuje oczekujące przelewy posortowane według wyniku. Dla każdego przelewu kolumna Zamówienia wyświetla do 5 propozycji z numerem referencyjnym, klikalnym numerem zamówienia, klientem i firmą, kwotą do zapłaty, ewentualną różnicą, wynikiem i uzasadnieniem. Etykieta Płatność częściowa lub Nadpłata oznacza kwotę różną od należności.

• Zatwierdź: rejestruje płatność w proponowanym zamówieniu. Gdy kwota różni się od należności, moduł prosi o potwierdzenie.
• Zatwierdzanie zbiorcze: zaznacz przelewy lub Zaznacz wszystkie propozycje, a następnie kliknij Zatwierdź pierwszą propozycję zaznaczonych przelewów.
• Przypisz: wpisz numer referencyjny lub numer zamówienia, albo kilka oddzielonych spacją lub przecinkiem w przypadku przelewu zbiorczego.
• Ignoruj: dla przelewu, który nie dotyczy zamówienia, na przykład zwrotu od dostawcy. Pozostaje widoczny w zakładce Zignorowany i można go przywrócić, co ponownie uruchamia jego dopasowanie.

Przycisk Dopasuj ponownie przelicza propozycje wszystkich oczekujących przelewów, na przykład po nowych zamówieniach. Pole wyszukiwania filtruje przelewy po tytule, zleceniodawcy, numerze referencyjnym zamówienia lub dokładnej kwocie, na przykład 1 234,56.

Co jest rejestrowane w PrestaShop

Zatwierdzenie dodaje do zamówienia natywną płatność, widoczną w zakładce Płatności, na fakturze i w eksportach księgowych. Metoda płatności to metoda zamówienia, ID transakcji to referencja bankowa z wyciągu (FITID w OFX, referencja banku w CAMT) lub w jej braku DFBR- z numerem przelewu, a data to data operacji. Jeśli faktura już istnieje, płatność jest z nią powiązana.

Jeśli kwota rozlicza zamówienie, z uwzględnieniem tolerancji, otrzymuje ono status po pełnej płatności. Zmiana statusu wykorzystuje zarejestrowaną płatność i nie tworzy drugiej. W przeciwnym razie płatność jest częściowa: zamówienie otrzymuje status po płatności częściowej, jeśli jest ustawiony, pozostała kwota jest widoczna, a kolejny przelew uzupełni płatność.

Zamówienia podzielone między kilku przewoźników mają wspólny numer referencyjny. Moduł traktuje je jako jedno zamówienie: kwota do zapłaty jest sumą zamówień, płatność jest rejestrowana w pierwszym, tak jak robi to PrestaShop, a wszystkie zmieniają status.

Blok na stronie zamówienia

Strona szczegółów zamówienia oczekującego na płatność lub takiego, które otrzymało przelew, wyświetla blok Przelew bankowy: pozostałą kwotę do zapłaty, otrzymane przelewy z datą, kwotą i tytułem, wysłane przypomnienia oraz przycisk Wyślij przypomnienie o płatności.

Przypomnienia o nieotrzymanych przelewach

Ustawienia

• Wysyłaj przypomnienia o płatności: domyślnie wyłączone.
• Terminy przypomnień (dni po zamówieniu): do 5 terminów oddzielonych przecinkami, domyślnie 3,7,14. Ostatni wysyła e-mail z ostatnim przypomnieniem. Dwa przypomnienia dla tego samego zamówienia dzielą co najmniej 2 dni.
• Nie przypominaj o zamówieniach starszych niż: domyślnie 30 dni, aby nie pisać do klientów ze starych zamówień w dniu włączenia przypomnień.
• Wysyłaj kopię przypomnień do: opcjonalny adres ukrytej kopii.
• Dane bankowe w przypomnieniach: właściciel rachunku, IBAN, BIC i adres banku.
• Anuluj nieopłacone zamówienia po: domyślnie 0, co wyłącza anulowanie. Zamówienie opłacone częściowo nigdy nie jest anulowane. Anulowanie przywraca produkty na stan.

Przypomnienie nie jest wysyłane dla zamówienia, które przelew czekający na sprawdzenie proponuje z wynikiem co najmniej 40: pieniądze prawdopodobnie dotarły. Wynik zadania podaje, ile zamówień z tego powodu pominięto.

Zadanie cron

Ekran Przypomnienia i konfiguracja pokazują adres URL zadania chroniony tokenem. Zaplanuj codzienne wywołanie w swoim hostingu:

0 9 * * * curl -s "https://www.twoj-sklep.pl/module/dfbankreconcile/cron?token=TWOJ_TOKEN" > /dev/null

Odpowiedź to JSON z liczbą wysłanych przypomnień, anulowanych zamówień, pominiętych zamówień i błędów. Przycisk Uruchom teraz uruchamia to samo zadanie z zaplecza. Przycisk Wygeneruj nowy token w konfiguracji unieważnia poprzedni adres URL.

E-maile

Moduł zawiera dwa szablony, bankwire_reminder i bankwire_reminder_final, w HTML i tekście, w 8 językach. E-mail jest wysyłany w języku zamówienia lub po angielsku, jeśli ten język nie jest dostępny. Zawiera kwotę do zapłaty, wartość zamówienia, Twoje dane do przelewu i prośbę o podanie numeru referencyjnego w tytule. Ostatnie przypomnienie informuje, że zamówienie może zostać anulowane. Zmienne dostępne do dostosowania szablonów w mails/: {firstname}, {lastname}, {order_name}, {order_date}, {amount_due}, {total_paid}, {bank_details}, {bank_details_html}.

Możesz też w dowolnym momencie przypomnieć klientowi przyciskiem Przypomnij na ekranie Oczekiwane przelewy lub ze strony zamówienia. Każda wysyłka trafia do dziennika przypomnień.

Rozwiązywanie problemów

„Nie udało się odczytać pliku”

Nie rozpoznano wiersza nagłówka pliku CSV. Otwórz plik w arkuszu kalkulacyjnym, zanotuj numery kolumn daty, kwoty (lub uznań i obciążeń) i opisu, a następnie wpisz je w sekcji Import CSV konfiguracji.

„W tym pliku nie znaleziono żadnej operacji”

Plik został odczytany, ale nie zawiera wiersza z użyteczną datą i kwotą. Sprawdź format daty (dzień/miesiąc/rok lub miesiąc/dzień/rok) i czy wyciąg nie jest pusty.

Oczywisty przelew nie ma propozycji

Sprawdź, czy zamówienie ma jeden z obserwowanych statusów, zostało złożone przed datą przelewu i w okresie wyszukiwania oraz ma tę samą walutę co wyciąg. Po poprawieniu statusu kliknij Dopasuj ponownie.

„Zamówienie nie oczekuje już na płatność”

Od importu zamówienie zmieniło status lub zostało opłacone, na przykład innym przelewem. Dopasuj ponownie, aby odświeżyć propozycje.

Przypomnienia nie są wysyłane

Sprawdź, czy przypomnienia są włączone, czy adres URL cron jest wywoływany (przycisk Uruchom teraz pozwala to przetestować), czy zamówienia są młodsze niż ustawiony maksymalny wiek i czy sklep wysyła e-maile, w Zaawansowane > E-mail.

Kompatybilność

• PrestaShop 8.0 do 9.x, ten sam plik ZIP obsługuje obie wersje.
• Multisklep: importy i przelewy należą do aktywnego sklepu.
• Formaty: CSV, TXT, OFX i QFX 1.x i 2.x, CAMT.053. Format MT940 nie jest obsługiwany.
• Architektura ModuleAdminController, bez zależności Composer.
• Interfejs i e-maile po polsku, angielsku, francusku, hiszpańsku, niemiecku, włosku, niderlandzku i portugalsku.