Temat:	PS3000 i Soleo - komunikacja z kasš przez FTP
Program:	PC-Market
Słowa kluczowe:	Dokumentacja urzšdzeń, Kasy

Zasada działania:
Komunikacja odbywa się przez pliki umieszczone na serwerze FTP. Każda kasa ma na serwerze swój własny podkatalog, którego nazwš jest numer unikatowy kasy np.:
FTP/PS3000/AFR05068290

1). W katalogu wymiany powinien się na stałe znajdować plik FTP/PS3000/AFR05068290/CFG.TXT. Może być pusty, ale być musi. PC-Market zakłada ten plik podczas kadego połšczenia, jeœli ten nie istnieje.

2). Podczas każdego połšczenia kasa zostawia w katalogu plik FTP/PS3000/AFR05068290/ECRID.TXT zawierajšcy informacje o tej kasie. W moim przypadku:
Dane identyfikacyjne urzšdzenia fiskalnego
Numer unikatowy: AFR05068290
Numer NIP: 000-000-00-00
Nazwa urzšdzania: PS3000 plus
Wersja urzšdzenia: 2.00
Nazwa systemu: OES
Wersja systemu: 1.30

3). Podczas każdego połšczenia kasa szuka w katalogu pliku FTP/PS3000/AFR05068290/REQrrrrmmddxxx.TXT. O pliku dalej w rozdziale Eksport.


Eksport:
Odbywa się to podobnie, jak w przypadku kas typu PC-POS, EuroPOS. Różnica polega na tym, że kasa nie odbiera danych w tym samym czasie, w którym sš one wysyłane przez PC-Marketa. Na przykład PC-Market wysyła tranmisję do kas o 16:00, a kasy odbierajš jš o godzinie 20:00, podczas zamykania sklepu. Tak więc PC-market nie ma natychmiastowej informacji np. o tym, ze kasa nie przyjęła jakichœ towarów. Informację tę pobierze podczas nastepnego eksportu. Z powodu tak działajšcego mechanizmy, PC-Market nie ma możliwoœci odznaczania toarów, których eksport się nie udał. jedynie informuje o tym w oknie podglšdu komunikacji następnego dnia.

Podczas połšczenia, kasa szuka w katalogu wymiany plików o nazwie FTP/PS3000/AFR05068290/REQrrrrmmddxxx.TXT. Wyjštkiem jest przypadek, gdy kasa jest œwieżo po zerowaniu pamięci - wówczas będzie szukała pliku FTP/PS3000/AFR05068290/RECrrrrmmddxxx.TXT. Za pierwszym razem po resecie kasy (po wysłaniu plików na FTP) należy ręcznie zmienić nazwę pliku REQ na REC.

xxx - numer kolejny pliku w danym dniu

Kasa zapamiętuje , na jakim numerze skończyła podczas ostatniego importu. Szuka więc pliku o kolejnym numerze. Jeœli ostatni import odbył się wczoraj, to w katalogu jest szukany plik z data wczorajszš o kolejnym numerze i plik z dnia dzisiejszego o numerze 000.

Czyli, jesli dzis jest 2007.03.14, a kasa ostatni raz odebrała import REQ20070313005.TXT, to poszuka w katalogu najpierw pliku REQ20070313006.TXT, a nastepnie REQ20070314000.TXT.

Algorytm generowania pliku REQ przez PC-Market:
REQYYYYMMDDxxx.TXT
REQ20080221000.TXT
Na FTP zostanie utworzony plik REQ o numerze o 1 wiekszym, niż pobrany z konfiuracji (parametr Nazwa ostatniego pliku REQ).
Jeœli jest to pierwszy REQ w dniu dzisiejszym, to będzie miał numer 000.
Jeœli na FTP znajduje się już plik o tej nazwie (jest to sytuacja awaryjna i w praktyce nie będzie występowała), to nowy REQ będzie miał najbliższy wolny numer.

Nazwa pliku REQ jest tworzona wg nastepujšcego algorytmu:
1). PCM pobiera nazwę pliku z konfiguracji i sprawdza, czy jest to plik REQ z dnia dzisiejszego.
a). Jeœli tak, to tworzy nazwę pliku REQ z numerem xxx o 1 większym
b). Jeœli nie, to tworzy plik REQ z numerem xxx = 000, z datš dzisiejszš
2). Sprawdza, czy na FTP już znajduje się plik REQ o tak przygotowanej nazwie. Jeœli tak, to inkrementuje numer aż do uzyskania unikalnej nazwy pliku REQ.
3). Tak przygotowany plik REQ umieszcza na FTP, a do konfiguracji zapisuje jego nazwę.




Import:
Kasa jest tak ustawiona, że za każdym razem, gdy połšczy się z serwerem FTP, zostawia na nim swoje aktualne dane o sprzedaży. Dane te sš zostawiane w plikach:
SANrrrrmmddhhmm.txt - spis treœci (lub ANS, jesli w katalogu wymiany był REQ)
RU--rrrrmmddhhmm.txt - dane o sprzedazy towarów
Rd--rrrrmmddhhmm.txt - dane o sprzedaży opakowań
Rk--rrrrmmddhhmm.txt - paragony szczeółowe
ERU--rrrrmmddhhmm.txt - log błędów powstałych podczas wykonywania raportu sprzed. towarów
ERd--rrrrmmddhhmm.txt - log błędów powstałych podczas wykonywania raportu sprzed. opakowań
ERk--rrrrmmddhhmm.txt - log błędów powstałych podczas wykonywania raportu paragonów szczegółowych

W zależnoœci od tego, czy w katalogu wymiany znajduje sie plik REQ dla kasy, moze ona powyższe pliki przesyłać pod nazwami, w których zamiast listerki R występuje Q. Np.: QU--... ,Qk..., EQU--..., EQk--...

Mimo, że kasa pozwala na takš możliwoœć, to PC-Market nie wymusza wykonywania raportów o sprzedazy na kasie poprzez umieszczanie rozkazów w plikach typu REQ. Tak więc, jesli na kasie nie będzie włšczony eksport raportów o sprzedaży, to nie będš one docierały do PC-Marketa.

Konfiguracja PC-Market:



Numer unikatowy kasy - komunikacja z kasš odbywa się przez katalog wymiany na serwerze o tej nazwie. Kasa po pierwszym połšczeniu z serwerem FTP sama założy ten katalog, więc jest to łatwy sposób na uzyskanie tego numeru.

FTP: Adres, Port, Login Hasło - parametry połšczenia z serwerem FTP.
FTP: Tryb pasywny - zalecamy komunikację w trybie aktywnym. Uzyte kontrolki Borlanda majš czasem brzydki zwyczaj zawieszania się w trybie pasywnym.
FTP: Katalog wspólny kas - (np. /FTP/PS3000) katalog wymiany z kasami. W katalogu tym będš znajdowały się podkatalogi o nazwach zgodnych z numerami unikatowymi kas.
FTP: Timeout komunikacji - timeout, który dajemy bibliotece komunikacyjnej na jakškolwiek operację. Po upływie tego czasu uznaje one, że serwer nie odpowiada.
FTP: Poziom raportowania komunikacji - domyœlnie powinien być wyłšczony. Pozwala na œledzenie połšczenia FTP.

Towary z cenš zamkniętš wysyłaj do działu 41 - Dział 41 może być na kasie traktowany jako dział asortymentów akcyzowych. Na takie towary kasa nie pozwoli udzielić rabatu.
Nazwa ostatniego pliku REQ - nazwa ostatnio umieszczonego na FTP pliku REQ. Kolejny będzie mial numer utworzony wg algorytmu opisanego powyżej.
Numer klawisza szybkiej sprzedaży - jeœli wskazano np. pole Opis1 karty towaru, to liczba wpisana w to pole będzie wysyłana jako numer klawisza szybkiej sprzedaży tego towaru.


Konfiguracja kasy:
Szczegółowa konfiguracja kasy jest opisana w instrukcji FTP_Menadżer_instrukcja_użytkownika.pdf. Poniżej skrócony opis i zalecane wartoœci niektórych parametrów:

Modem (realizacja połšczenia z internetem):
4511 - zdefiniować port, do którego jest podłšczony Modem (u mnie COM4)
4514 - definiować konfiguracje modemu U mnie:
Prędkoœć: 19200,
Cišg init. modemu: AT&FE0X0
Polecenie połšcz: ATDT21 (numer telefonu Dial-Up 21)
Użyj połšczenia PPP: zaznaczony
PPP Uzytkownik: ppp
PPP Hasło: ppp
PPP Typ logowania: (PAP - dla połšczenia z WIN XP, Terminal dla połšczenia TPSA 0W202122)
PPP OpóŸnienie nad.: 1000msek

FTP Menadżer (realizacja połšczenia przez internet z serwerem FTP):
45161 - ustawić parametry połšczenia do serwera FTP. U mnie:
Host FTP: 192.168.0.199
Port Serwera: 21 (21, to standardowy port serwerów FTP)
Login: insoft
Hasło: insoftp
Œcieżka na serwerze: FTP/PS3000
Połšcz uzywajšc: DIAL-UP
Opcje:
1. Folder rap. /NrUn - zaznaczony (ważne - tak ustawić)
2. Folder zadań - zaznaczony (wazne - tak ustawić)

FTPMenadżer (opcje pracy)
45162 - definiować dowolnie w zaleznoœci od potrzeb. U mnie zaznaczone:
1. Aktywny
5. Druk.raport.poł.
45164 - zdefiniować dokładnie, jak poniżej:
Lista do wysłania -> 15. sprzedaz PLU
Lista do wysłania -> 16. Zamówienia
Lista do wysłania -> 17. Sprzedaż opak.
Lista do wysłania -> 23. Paragonów-k

Na kasie, FTP Menadżera włšcza się w menu 1321. Wyłšcza się opcjš menu 1322. Przy powyższych ustawieniach powinien natychmiast rozpoczšc działanie: przez modem połšczyć się z serwerem Dial-Up, nastepnie przez internet z serwerem FTP i odpowiednim katalogiem.


Konfiguracja serwera Dial-up na Windows XP:
W moim przypadku, do testów uruchomiłem serwer dial-up na komputerze pod Windows XP. Do komputera podłšczony modem. Na tym samym komputerze miałem uruchomiony serwer CeasarFTP 0.99g.

Dial-up na WinXP konfiguruje się przez dodanie nowego Połšczenia sieciowego (Utwórz nowe połšczenie) -> konfiguruj połšczenie zaawansowane-> Zaakceptuj połšczenia przychodzšce. Pula numerów IP przydzielanych klientom i serwerowi nie ma żadnego znaczenia w konfiguracji kasy. W konfiguracji adresu FTP na kasie należy nadać rzeczywisty adres IP tego komputera. W moim wypadku pula przydzielanych adresów, to było 192.168.0.12 do 192.168.0.13. Podczas połšczenia peer-peer kasa dostawała adres 192.168.0.13, mój komputer adres 192.168.0.12, jednak adres mojego serwera FTP należało zdefiniować na kasie jako 192.168.0.199 - czyli realny adres mojego komputera.

Import:
Import paragonów jest możliwy od wersji 7.2.107.0 .

Podczas importu zawsze jest analizowany plik z paragonami szczegółowymi. Jednakże , zależnoœci od niżej wymienionych parametrów dane sš odpowiednio zapisywane do bazy:

Kontrola-> Obsługa kas...-_ Import sprzedaży z kas-> PS3000FTP - Import szczegółowy paragonów
Jeœli ustawiony na TAK, to paragony sš zapisywane w bazie PC-Marketa (w tablicy Paragon). Jeœli jest ustawiony na NIE, to dane o paragonach szczegółowych sa jedynie analizowane w celu uzyskania takich informacji, jak: iloœc paraognów, koszyków, raport godzinowy, utargi w formach płatnoœci

Kontrola-> Obsługa kas...-_ Import sprzedaży z kas-> PS3000FTP - Import sprzedaży przez bufor paragonów
Jeœli ustawiony na TAK, to dane o sprzedanych towarach nie sš uzyskiwane z plikow RU, Rd, QU, Qd (liczników PLU), lecz z pliku paragonów szczegółowych (Rk, Qk). Dane o sprzedaży wg licznikiow PLU sš ignorowane.

Aby uzyskać najbardziej wiarygodne dane zalecam ustawienia tych parametrów w nastepujšcy sposób:
PS3000FTP - Import szczegółowy paragonów - TAK
PS3000FTP - Import sprzedaży przez bufor paragonów - TAK

Formy płatnoœci do dokumentu UTARG oraz do rozliczenia kasjera sš mapowane 1:1 z jednym wyjštkiem: Jeœli zapłacono bonem (lub innš formš, z której nie wydaje się reszty), to teoretyczna reszta jest uwzględniana w formie płatn. "inne" ze znakiem ujemnym. Jeœli z formy płatnoœci wydaje się resztę, to jest ona normalnie potršcana z gotówki.

Do paragonów œcišgnietych z kasy mozna wystawić fakturę. Jednak taki paragon musi być wczeœniej œcišgnięty z kasy do bazy PC-Marketa przy pomocy normalnego importu z włšczonym parametrem PS3000FTP - Import szczegółowy paragonów (paragon musi się znajdować w tablicy Paragon).

Importy sš zapisywane do bazy PCM w podziale: osobny dokument importu na każdy dzień. W przypadku paragonów szczegółowych jako data sprzedaży pobierana jest data wystawienia paragonu. W przypadku importu po licznikach PLU, data sprzedazy jest data wycišgnieta z nazwy pliku raportu (np. Rd--rrrrmmddhhmm.txt).

Karty stałego klienta sš obsługiwane wg "nowej metody" opisanej w dokumencie -> .
W tej metodzie maska kodu karty jest zdefiniowana w konfiguracji sterownika w PCM, a nie jest œciagana z kasy.
Kody kart stałego klienta sš zapisywane w tablicy Paragon jako numer klienta zapisany w sekcji kkkk.... Np.
290yymmkkkkrx - maska kodu karty
2900812123411 - pełny kod karty stałego klienta
1234 - numer klienta zapisywany do bazy PC-Market


Import zamówień:
Opisany tutaj ->

Wiadomoœci SMS:
1). Wiadomoœci do kasy można wprowadzić w oknie konfiguracji kasy, na zakładce F7 -> Wiadomoœć SMS:



Maksymalnie można wprowadzić 8 wiadomoœci tekstowych. Po wprowadzeniu wiadomoœci i naciœnięciu klawisza Zapisz, należy jeszcze zapisać okienko nadrzędne (konfiguracji) przy pomocy Zapisz lub Zastosuj (od wersji 7.2.107.134 stosowna poprawka, aby użytkownik nie zapomniał). Wprowadzone wiadomoœci sš zapisywane w bazie danych. Nie ma możliwoœci podglšdnięcia wpisanych wczeœniej wiadomoœci. Klawisz Usuń wszystkie wiadomoœci kasuje wszystkie wczeœniej wprowadzone wiadomoœci.

2). Wiadomoœci odebrane z kasy pojawiš się w oknie importu danych z kas:





Programowanie kasjerów:
Pola z karty kasjera w PC-Market sš programowane na kasie w nast. sposób:

<PC-Market> <Kasa>
Numer kasjera -> Numer kasjera
Nazwisko -> Nazwa
Rola -> Rola (KASJER-rola 1, NADZÓR-rola 2, MANAGER-rola 3, SERWIS - rola 4)
Kod karty ident. -> Hasło

Uwaga! Od wersji EPROM SP7 Novitus zapowiada zmianę formatu przesyłanych numerów kasjera w paragonach. Będzie wymagana zmiana w naszym sterowniku. Z tego powodu należy uważać na zgodnoœć EPROM ze sterownikiem (opis poniżej).


Lista rzeczy nieobsługiwanych na kasie przez FTP:
- nie œcišgamy statusu zalogowanego kasjera
- nieobsługiwane wpłaty i wypłaty - chyba tego się nie da zrobić przez FTP, bo raport kasjera się nie zeruje, a bufor paragonów nie obsługuje wpłat/wypłat
- nie sš obsługiwane inne waluty

Błędy zauważone na kasie:
1). (Soleo 1.30SP2) Problem z małymi. dużymi literami podczas komunikacji FTP. Na niektórych serwerach kasa nadpisuje nazwy plików o nazwach różnišcych sie wielkoœciš liter. Zgłoszone Novitusowi -> . Trzeba uważać, żeby nie włšczać na kasie nadmiarowych raportów w konfiguracji FTP Managera.
2). (Soleo 1.30SP2) Błędnie przesyłane rekordy paragonów szczegółowych dla kasjera nr 12. Problem rozwišzałem po naszej stronie. (zobacz pkt. "Programowanie kasjerów powyżej"). Zgłoszone Novitusowi ->


Uwaga na wersję EPROM! program FTP Manager jeszcze zmienia się w czasie. Praca przez sterownik na wersjach wczeœniejszych, niż podano w okienku konfiguracji urzšdzenia może spowodować problemy. Numer wersji jest zapisany w opisie sterownika:



Powyższy zapis oznacza, że ta wersja sterownika była testowana z Soleo 1.10 OES 1.30 SP2 i teoretycznie powinna pracować poprawnie z wersjami póŸniejszymi tej kasy.


Instrukcja od Novitusa: