opis plików wymiany danych systemu mobile
Transkrypt
opis plików wymiany danych systemu mobile
FHU Merko Krak€w Pliki wymiany danych wersja 10.6 OPIS PLIK€W WYMIANY DANYCH SYSTEMU SETMOBILE WERSJA 10.6 1 czerwca 2011 http://www.setmobile.pl/Dokumentacja/Pliki wymiany danych.pdf 1 FHU Merko Krak€w Pliki wymiany danych wersja 10.6 SPIS TRE•CI 1. 2. 3. 4. 5. 2 Za•adunek danych do komputera kieszonkowego ................................................................ 3 Roz•adunek komputera kieszonkowego................................................................................ 3 Formaty plik€w wej‚ciowych (do za•adunku) ........................................................................ 4 Formaty plik€w wyj‚ciowych (z roz•adunku) ......................................................................... 6 Plik operacji (transmisja pocztƒ elektronicznƒ) ..................................................................... 9 http://www.setmobile.pl/Dokumentacja/Pliki wymiany danych.pdf FHU Merko Krak€w Pliki wymiany danych wersja 10.6 1. Za‚adunek danych do komputera kieszonkowego Program komunikacyjno-zarzƒdzajƒcy (WinSET.EXE) wysy•a do komputera kieszonkowego z programem SETmobile podczas za•adunku dane utworzone na podstawie 6 plik€w: € plik towar€w (rozszerzenie *.TOW) € plik kontrahent€w (rozszerzenie *.KON) € plik nag•€wk€w zam€wie„ (rozszerzenie *.ZAN) € plik element€w zam€wie„ (rozszerzenie *.ZAE) € plik faktur zad•u…onych zad•u…e„ (rozszerzenie *.FDL) € plik z listƒ meldunk€w o sytuacji u kontrahenta (rozszerzenie *.SME) € oraz pliku definicji urzƒdzenia (rozszerzenie *.WEW) Plik *.TOW jest plikiem towar€w, na kt€rych b†dƒ dokonywane transakcje czyli stanowi odzwierciedlenie stanu magazynu. Plik *.KON jest plikiem kontrahent€w (czyli naszych klient€w), kt€rym b†dƒ wystawiane dokumenty transakcji np faktury. Plik *.FDL jest plikiem zad•u…onych faktur (lub innych transakcji) s•u…ƒcy u•atwieniu wystawienia kwit€w KP i orientacji o stanie realizacji zobowiƒza„ kontrahent€w. Pliki o rozszerzeniu *.ZAE i *.ZAN sƒ plikami zam€wie„ zebranych w czasie poprzedniego wyjazdu, kt€re umo…liwiajƒ automatycznie wystawianie faktur. Plik o rozszerzeniu *.SME jest listƒ tekstami meldunk€w, kt€rymi u…ytkownik SETmobile mo…e opisa‡ sytuacj† zastanƒ u kontrahenta (np jego nieobecno‚‡, ch†‡ zmiany zasad wsp€•pracy, itp). Po przetransmitowaniu danych do urzƒdzenia SET, nazwy plik€w zmieniane sƒ automatycznie poprzez zmian† ich rozszerzenia - dopisanie znaku tyldy na poczƒtku rozszerzenia np Test.~KO Szczeg€•owe formaty plik€w zosta•y opisane w punkcie 3. Przyk•adowe pliki zosta•y zamieszczone na p•ycie CD w folderze ˆBazaDemo‰ Uwaga: € wszystkie pliki muszƒ mie‡ takƒ samƒ nazw† i by‡ umieszczone w tym samym folderze. € do poprawnego za•adunku wymagane sƒ tylko trzy pliki (TOW, KON i WEW). Pozosta•e sƒ opcjonalne. 2. Roz‚adunek komputera kieszonkowego Przy odczytywaniu danych z komputera kieszonkowego tworzone sƒ przez program WinSET.EXE nast†pujƒce pliki: € plik nag•€wk€w transakcji (rozszerzenie *.TRN) € plik element€w transakcji (rozszerzenie *.TRE) € plik nag•€wk€w transakcji - format 2 (rozszerzenie *.UNA) € plik element€w transakcji - format 2 (rozszerzenie *.UEL) € plik nag•€wk€w zam€wie„ (rozszerzenie *.ZAN) € plik element€w zam€wie„ (rozszerzenie *.ZAE) € plik kwit€w KP i KW (rozszerzenie *.KPW) € plik nag•€wk€w kwit€w WZ (rozszerzenie *.WZN) € plik element€w kwit€w WZ (rozszerzenie *.WZE) € plik nag•€wk€w rozlicze„ za opakowania zwrotne (rozszerzenie *.OPN) € plik element€w rozlicze„ za opakowania zwrotne (rozszerzenie *.OPE) € plik paragon€w (rozszerzenie *.PAE) € plik opakowa„ zwr€conych (rozszerzenie *.ZWR) € plik meldunk€w (rozszerzenie *.MEL) € plik nowych klient€w (rozszerzenie *.NKN) W przypadku przesy•ania transakcji pocztƒ elektronicznƒ wykorzystywany jest plik operacji (rozszerzenie *.SD6) http://www.setmobile.pl/Dokumentacja/Pliki wymiany danych.pdf 3 FHU Merko Krak€w Pliki wymiany danych wersja 10.6 3. Formaty plikƒw wej„ciowych (do za‚adunku) Og€lne zasady budowy plik€w: € poszczeg€lne pola rozdzielone sƒ znakiem przecinka € ka…de pole musi by‡ uj†te w cudzys•€w € znakiem dziesi†tnym jest znak kropki. € ka…da linia ko„czy si† dwoma znakami o kodach ASCII 13 i 10 3.1 Plik towar€w (*.TOW) Lp Nazwa Wielko„… KOD 20 1 SWW 16 2 NAZWA 40 3 CENA 1 6.2 4 CENA 2 6.2 5 CENA 3 6.2 6 CENA 4 6.2 7 STAN 6.2 8 JM 5 9 VAT 2 10 AKT 11 CENA 5 6.2 12 CENA 6 6.2 13 CENA 7 6.2 14 CENA 8 6.2 15 CENA 9 6.2 16 CENA 10 6.2 17 CENA 11 6.2 18 CENA 12 6.2 19 CENA 13 6.2 20 CENA 14 6.2 21 CENA 15 6.2 22 CENA 16 6.2 23 CENA 17 6.2 24 CENA 18 6.2 25 CENA 19 6.2 26 CENA 20 6.2 27 Pola wewn†trzne muszƒ pozosta‡ puste. Opis Kod towaru Symbol SWW Nazwa towaru I cena sprzeda…y II cena sprzeda…y III cena sprzeda…y IV cena sprzeda…y (w wersji standardowej nieu…ywane) Stan magazynu Jednostka miary Podatek VAT (np. "23",‰8", ‰ZW‰) Pole wewn†trzne Kolejna cena sprzeda…y w wersji z cennikami Kolejna cena sprzeda…y w wersji z cennikami Kolejna cena sprzeda…y w wersji z cennikami Kolejna cena sprzeda…y w wersji z cennikami Kolejna cena sprzeda…y w wersji z cennikami Kolejna cena sprzeda…y w wersji z cennikami Kolejna cena sprzeda…y w wersji z cennikami Kolejna cena sprzeda…y w wersji z cennikami Kolejna cena sprzeda…y w wersji z cennikami Kolejna cena sprzeda…y w wersji z cennikami Kolejna cena sprzeda…y w wersji z cennikami Kolejna cena sprzeda…y w wersji z cennikami Kolejna cena sprzeda…y w wersji z cennikami Kolejna cena sprzeda…y w wersji z cennikami Kolejna cena sprzeda…y w wersji z cennikami Kolejna cena sprzeda…y w wersji z cennikami 3.2 Plik kontrahent€w (*.KON) Lp 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 4 Nazwa KOD NAZWA 1 NAZWA 2 ADRES 1 KOD POCZTOWY MIASTO ADRES 2 NIP REGON D†UG INNE P‚atnik Rabat domy„lny NOWY SKLEP Wielko„… 8 40 40 40 6 30 36 13 11 6.2 15 8 2.2 15 Opis Kod kontrahenta Pierwszy cz•on nazwy kontrahenta Drugi cz•on nazwy kontrahenta Pierwsza linijka adresu.(Ulica, nr domu,..) Kod pocztowy kontrahenta Miejscowo‚‡ kontrahenta Dodatkowe pole na adres Identyfikator NIP Identyfikator REGON Šƒczny d•ug kontrahenta Inne informacje o kontrahencie Powiƒzania z p•atnikiem Indywidualny rabat dla klienta [%] Pole wewn†trzne Kod sklepu http://www.setmobile.pl/Dokumentacja/Pliki wymiany danych.pdf FHU Merko Krak€w 16 17 18 19 20 21 22 23 24 25 email Konto Dostawca Odbiorca Termin P‚atno„… Cena domy„lna Limit Przek_term CENNIK_GOT Pliki wymiany danych wersja 10.6 200 40 2 1 2 6.2 2 2 Adres email klienta Nr konta bankowego klienta Pole wewn†trzne Pole wewn†trzne Domy‚lny termin p•atno‚ci (dni) Domy‚lny spos€b p•atno‚ci Numer domy‚lnej ceny lub numer cennika dla p•atno‚ci przelewem Limit niezap•aconych wydatk€w Dopuszczalne przekroczenie terminu p•atno‚ci (dni) Numer cennika dla p•atno‚ci got€wkƒ Pola wewn†trzne muszƒ pozosta‡ puste. 3.3 Plik nag•€wk€w zam€wie„ (*.ZAN) Lp 1 2 3 Nazwa KOD DATASYS DATA Wielko„… 8 10 10 4 5 6 7 8 9 10 11 12 13 NR_ZAM€WIENIA TERMIN_P†AT TYP_P†AT RODZAJ SUMA REZERWA1 REZERWA2 REZERWA3 SERIA_SET ZAP†ACONE 4 6 1 1 6.2 4 4 5 4 6.2 Opis Kod kontrahenta Systemowa data/godzina wystawienia transakcji RRMMDDHHMM Rok, miesiƒc zam€wienia, rok miesiƒc i dzie„ wystawienia transakcji RRMMRRMMDD Numer zam€wienia Proponowany termin p•atno‚ci RRMMDD Forma p•atno‚ci (patrz opis poni…ej) Nieu…ywane Suma do zap•aty, 6 cyfr przed, 2 po kropce Nieu…ywane Nieu…ywane Nieu…ywane Nazwa SETa (Seria transakcji) Kwota zap•acona za transakcj† 6 cyfr przed,2 cyfry po kropce Pole DATASYS jest nieu…ywane. Pole TYP_PŠAT przyjmuje warto‚ci: "G", "C", "P", "K", "V‰, "I" G-Got€wka, C-Czek, P-Przelew, K-Kredyt, V-Karta p•atnicza/kredytowa, I-Inne 3.4 Plik element€w zam€wie„ (*.ZAE) Lp 1 2 3 4 5 6 Nazwa KOD ILO•‡ CENA NUMER RABAT VAT Wielko„… 20 6.2 6.2 4 2.2 2 Opis Kod towaru Ilo‚‡ towaru, 6 cyfr przed, 2 po kropce Cena jednostkowa, 6 cyfr przed 2 po kropce Nr zam€wienia, 4 cyfry Udzielony rabat (od pozycji), 2 cyfry przed, 2 po kropce [%] Podatek VAT (np. "22",‰7", ‰ZW‰) 3.5 Plik zad•u…e„ (*.FDL) Format jak dla pliku *.ZAN. Pole DATASYS jest nieu…ywane. 3.6 Plik tekst€w meldunk€w (*.SME) Lp 1 Nazwa TEKST Wielko„… 255 Opis Tre‚‡ meldunku http://www.setmobile.pl/Dokumentacja/Pliki wymiany danych.pdf 5 FHU Merko Krak€w Pliki wymiany danych wersja 10.6 4. Formaty plikƒw wyj„ciowych (z roz‚adunku) Og€lne zasady budowy plik€w: € poszczeg€lne pola rozdzielone sƒ znakiem przecinka € ka…de pole musi by‡ uj†te w cudzys•€w € znakiem dziesi†tnym jest znak kropki. € ka…da linia ko„czy si† dwoma znakami o kodach ASCII 13 i 10 4.1 Plik nag•€wk€w transakcji (*.TRN) Lp 1 2 3 Nazwa KOD DATASYS DATA Wielko„… 8 10 10 4 5 6 7 8 9 10 11 12 13 14 15 16 17 NUMER TERMIN_P†AT TYP_P†AT RODZAJ SUMA REZERWA1 REZERWA2 REZERWA3 SERIA_SET ZAP†ACONE PIERW_NR PIERW_DATA Rabat_C Rabat_P 4 6 1 1 (-)6.2 4 4 5 4 6.2 4 6 2.2 2.2 Opis Kod kontrahenta Systemowa data/godzina wystawienia transakcji RRMMDDHHMM Rok, miesiƒc sprzeda…y ,rok miesiƒc i dzie„ wystawienia transakcji RRMMRRMMDD Numer dokumentu Termin p•atno‚ci RRMMDD Forma p•atno‚ci (patrz opis przy pliku *.ZAN) Rodzaj transakcji: "1"= faktura VAT, "2"= faktura VAT - korekta Suma do zap•aty, 6 cyfr przed, 2 po kropce Nieu…ywane Nieu…ywane Nieu…ywane Nazwa SETa (Seria transakcji) Kwota zap•acona za transakcj† 6 cyfr przed,2 cyfry po kropce Nr F. pierwotnej, pole wype•niane dla transakcji korygujƒcych Data F. pierwotnej RRMMDD, wype•niane dla transakcji korygujƒcych Udzielony rabat od faktury (od ca•o‚ci) [%] Udzielony rabat od faktury (przeliczany) [%] 4.2 Plik element€w transakcji (*.TRE) Lp 1 2 3 4 5 Nazwa KOD ILO•‡ CENA NUMER RABAT Wielko„… 20 6.2 6.2 4 2.2 Opis Kod towaru Ilo‚‡ towaru, 6 cyfr przed, 2 po kropce Cena jednostkowa, 6 cyfr przed 2 po kropce Nr dokumentu, 4 cyfry Udzielony rabat (od pozycji), 2 cyfry przed, 2 po kropce [%] 4.3 Plik nag•€wk€w transakcji ‹ format 2 (*.UNA) Lp 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 6 Nazwa DOKUMENT KOD DATASYS DATA_WYSTAW M_SPRZEDAZ TERMIN_P†AT NUMER TYP_P†AT SUMA SERIA_SET ZAP†ACONE PIERW_DATA PIERW_MIES PIERW_NR Rabat_C Wielko„… 2 8 10 6 4 6 4 1 (-)6.2 4 6.2 6 4 4 2.2 Opis Typ dokumentu: ˆFA‰ faktura ˆFK‰ faktura - korekta Kod kontrahenta Systemowa data/godzina wystawienia transakcji RRMMDDHHMM Data wystawienia faktury ˆRRMMDD‰ Miesiƒc sprzeda…y ˆRRMM‰ Termin p•atno‚ci RRMMDD Numer dokumentu Forma p•atno‚ci (patrz opis przy pliku *.ZAN) Suma do zap•aty, 6 cyfr przed, 2 po kropce Nazwa SETa (Seria transakcji) Kwota zap•acona za transakcj† 6 cyfr przed,2 cyfry po kropce Data wystaw. F. pierwotnej RRMMDD, (dla transakcji korygujƒcych) Miesiƒc sprzeda…y z F. pierw. RRMMDD, (dla transakcji korygujƒcych) Nr F. pierwotnej, (dla transakcji korygujƒcych) Udzielony rabatu od faktury (od ca•o‚ci) [%] http://www.setmobile.pl/Dokumentacja/Pliki wymiany danych.pdf FHU Merko Krak€w 16 Rabat_P Pliki wymiany danych wersja 10.6 2.2 Udzielony rabatu od faktury (przeliczany) [%] 4.4 Plik element€w transakcji ‹ format 2 (*.UEL) Lp 1 2 3 Nazwa DOKUMENT KOD ILO•‡ Wielko„… 2 20 6.2 4 CENA 6.2 5 6 7 8 NUMER ILO•‡_KOR CENA_KOR RABAT 4 6.2 6.2 2.2 Opis Typ dokumentu: ˆFA‰ faktura ˆFK‰ faktura - korekta Kod towaru Ilo‚‡ towaru, 6 cyfr przed, 2 po kropce (dla faktur korekt to ilo‚‡ z faktury oryginalnej) Cena jednostkowa, 6 cyfr przed 2 po kropce (dla faktur korekt to cena z faktury oryginalnej) Nr dokumentu, 4 cyfry Ilo‚‡ towaru po korekcie Cena jednostkowa po korekcie Udzielony rabat (od pozycji), 2 cyfry przed, 2 po kropce [%] 4.5 Plik nag•€wk€w zam€wie„ (*.ZAN) Format pliku jest identyczny z plikiem wej‚ciowym *.ZAN. Pole DATASYS jest u…ywane. 4.6 Plik element€w zam€wie„ (*.ZAE) Format pliku jest identyczny z plikiem wej‚ciowym *.ZAE. 4.7 Plik kwit€w KP i KW (*.KPW) Lp 1 2 3 4 5 6 Nazwa KOD DATASYS DATA NUMER SERIA_SET WP†ATA Wielko„… 8 10 6 4 4 (-)6.2 Opis Kod kontrahenta Systemowa data/godzina wystawienia transakcji RRMMDDHHMM Rok, miesiƒc, dzie„ sprzeda…y i data wystawienia RRMMDD Numer dokumentu Nazwa SETa (Seria transakcji) Kwota wp•acona, 6 cyfr przed, 2 po kropce, gdy ujemna to KW 4.8 Plik nag•€wk€w kwit€w WZ (*.WZN) Format pliku jest identyczny z plikiem wej‚ciowym *.TRN. 4.9 Plik element€w kwit€w WZ (*.WZE) Format pliku jest identyczny z plikiem wej‚ciowym *.TRE. 4.10 Plik nag•€wk€w opakowa„ zwrotnych (*.OPN) Pola 1 do 17 sƒ identyczne jak w pliku *.TRN. Wyst†puje jedno dodatkowe pole: 18 KOD_OPAK 1 Kod dokumentu: ˆ1‰ rozliczenie do faktury, ˆN‰ niezale…ne rozliczenie 4.11 Plik element€w opakowa„ zwrotnych (*.OPE) Lp 1 2 3 4 5 6 Nazwa KOD ZWR€CONO CENA NUMER KOD_OPAK POBRANO Wielko„… 20 6.2 6.2 4 1 6.2 Opis Kod opakowania Ilo‚‡ opakowa„ zwr€conych, 6 cyfr przed, 2 po kropce Cena jednostkowa, 6 cyfr przed 2 po kropce Nr dokumentu, 4 cyfry Kod dokumentu: ˆ1‰ rozliczenie do faktury, ˆN‰ niezale…ne rozliczenie Ilo‚‡ opakowa„ pobranych, 6 cyfr przed, 2 po kropce http://www.setmobile.pl/Dokumentacja/Pliki wymiany danych.pdf 7 FHU Merko Krak€w Pliki wymiany danych wersja 10.6 4.12 Plik element€w paragon€w (*.PAE) Lp 1 2 3 4 5 6 Nazwa KOD ILO•‡ CENA NUMER DATASYS RABAT Wielko„… 20 6.2 6.2 4 10 2.2 Opis Kod towaru Ilo‚‡ towaru, 6 cyfr przed, 2 po kropce Cena jednostkowa, 6 cyfr przed 2 po kropce (BRUTTO) Nr dokumentu, 4 cyfry Systemowa data/godzina wystawienia Udzielony rabat (od pozycji), 2 cyfry przed, 2 po kropce [%] 4.13 Plik raportu opakowa„ zwr€conych (*.ZWR) Lp 1 2 Nazwa KOD ILO•‡ Wielko„… 20 6.2 Opis Kod towaru Ilo‚‡ opakowa„, 6 cyfr przed, 2 po kropce 4.14 Plik raportu meldunk€w (*.MEL) Lp 1 2 3 Nazwa KOD DATASYS NR_MELDUNKU Wielko„… 8 10 4 Opis Kod kontrahenta Systemowa data/godzina wystawienia transakcji RRMMDDHHMM Nr meldunku z listy meldunk€w (*.SME) 4.15 Plik nowych klient€w (*.NKN) Format pliku jest identyczny z plikiem wej‚ciowym *.KON. 8 http://www.setmobile.pl/Dokumentacja/Pliki wymiany danych.pdf FHU Merko Krak€w Pliki wymiany danych wersja 10.6 5. Plik operacji (transmisja pocztˆ elektronicznˆ) Nazwa pliku za•ƒcznika tworzona jest nast†pujƒco: D_KKKK_NNNN.SD6, gdzie: D - typ dokumentu (F: faktura, Z: zam€wienie) KKKK - kod odbiorcy NNNN - numer dokumentu SD6 - rozszerzenie nazwy pliku np: F_SKP001_0028.SD6 Uwaga: kodowanie polskich znak€w jest w formacie Windows Latin 2. 5.1 Format pliku operacji (*.SD6): Og€lne zasady budowy plik€w: € poszczeg€lne pola rozdzielone sƒ znakiem przecinka € ka…de pole musi by‡ uj†te w cudzys•€w € znakiem dziesi†tnym jest znak kropki. € ka…da linia ko„czy si† dwoma znakami o kodach ASCII 13 i 10 NAG†€WEK: 1. Dane nag•€wka zapisane sƒ w jednej linii (pierwsza linia w pliku). 2. Nag•€wek zawiera podsumowanie danych dotyczƒcych ca•ego dokumentu. Lp 1 2 3 Nazwa KOD DATASYS DATA Wielko„… 8 10 10 4 5 6 7 8 9 10 11 12 13 14 15 16 17 NUMER TERMIN_P†AT TYP_P†AT RODZAJ SUMA POZYCJI REZERWA2 REZERWA3 SERIA_SET ZAP†ACONE PIERW_NR PIERW_DATA Rabat_C Rabat_P 4 6 1 1 (-)6.2 4 4 5 4 6.2 4 6 2.2 2.2 Opis Kod kontrahenta Systemowa data/godzina wystawienia transakcji RRMMDDHHMM Rok, miesiƒc sprzeda…y ,rok miesiƒc i dzie„ wystawienia transakcji RRMMRRMMDD Numer dokumentu Termin p•atno‚ci RRMMDD Forma p•atno‚ci (patrz opis przy pliku *.ZAN) Rodzaj transakcji: "1"= faktura VAT, "2"= faktura VAT - korekta Suma do zap•aty, 6 cyfr przed, 2 po kropce Liczba pozycji w dokumencie Nieu…ywane Nieu…ywane Nazwa SETa (Seria transakcji) Kwota zap•acona za transakcj† 6 cyfr przed,2 cyfry po kropce Nr F. pierwotnej, pole wype•niane dla transakcji korygujƒcych Data F. pierwotnej RRMMDD, wype•niane dla transakcji korygujƒcych Udzielony rabat od faktury (od ca•o‚ci) [%] Udzielony rabat od faktury (przeliczany) [%] POZYCJE towarowe: 1. Sƒ to linie od drugiej do (ilo‚‡ pozycji +1). Lp 1 2 3 4 5 Nazwa KOD ILO•‡ CENA NUMER RABAT Wielko„… 20 6.2 6.2 4 2.2 Opis Kod towaru Ilo‚‡ towaru, 6 cyfr przed, 2 po kropce Cena jednostkowa, 6 cyfr przed 2 po kropce Nr dokumentu, 4 cyfry Udzielony rabat (od pozycji), 2 cyfry przed, 2 po kropce [%] http://www.setmobile.pl/Dokumentacja/Pliki wymiany danych.pdf 9