KANCELARYJNY SYSTEM PODATKOWY Import kontrahentów w formacie xml. 1 z 12
Niniejszy dokument stanowi integralną część pakietu KANCELARYJNY SYSTEM PODATKOWY i jest chroniona przepisami praw autorskich. Producent zastrzega sobie prawo do zmian treści niniejszego dokumentu bez wcześniejszego powiadomienia. Rozpowszechnianie, kopiowanie, wykorzystywanie całości jak i fragmentów dokumentu jest zabronione. Dokumentacja techniczna i instrukcje użytkownika ulegają ciągłym zmianą ze względu na rozwój i modyfikacje systemu KSP. Najnowsze wersje dokumentów dostępne są na stronie WWW.KSP.COM.PL 2 z 12
Spis treści SPIS TREŚCI... 3 1. INFORMACJE OGÓLNE.... 4 2. KONTRAHENT... 5 3. PRZYKŁADOWY PLIK... 8 4. DODATEK IDENTYFIKATOR KRAJU... 9 3 z 12
1. Informacje ogólne. Rysunek 1-1 Ogólna struktura pliku importu Rysunek 1-2 Atrybuty grupy obiektów Import dostępny jest z modułu Dokumenty dedykowane z menu Import kontrahentów, jako typ danych źródłowych: 3Soft-Logotech (KSP Win) Kontrahenci Na rysunku 1 1 umieszczona jest ogólna struktura pliku importu. Między znacznikami <OBJECTS></OBJECTS> znajdują się obiekty występujące w imporcie, pogrupowane wg typu i umieszczone w kolejnych odpowiednich dla danego typu parach znaczników. Ponieważ dla importu kontrahentów jedynym importowanym typem obiektów są kontrahenci, więc jedyną parą znaczników znajdującą się wewnątrz grupy <OBJECTS></OBJECTS> są znaczniki <CONTRACTORS></CONTRACTORS> oznaczające kontrahentów. Atrybuty znaczników <CONTRACTORS> to: a) saving może przybierać wartości N lub T. Dla grup obiektów zawsze jest równe N. b) ID_OBCE identyfikator grupy obiektów. Może przybierać wartości: - CONTRACTORS kontrahenci W pliku importu dla każdego importowanego kontrahenta powinna być umieszczona jedna sekcja <CONTRACTOR></CONTRACTOR> Określenie niewymagany używane w tym dokumencie oznacza, że dany znacznik nie musi pojawić się w pliku eksportu. Separator dziesiętny w kwotach: przecinek Format daty: RRRR MM DD lub RRRR MM DD hh:mm:ss W sekcji <IMPORT firm_nip = department_nip = xml_version= > występują argumenty: firm_nip numer NIP firmy, z której przeprowadzony jest import department_nip - numer NIP oddziału firmy, z którego przeprowadzony jest import xml_version wersja pliku importu. Obecna wersja pliku importu to 2.0 4 z 12
2. Kontrahent Rysunek 2-1 Kontrahent 5 z 12
CONTRACTOR ID_OBCE identyfikator kontrahenta. Musi nim być numer NIP kontrahenta. Jeżeli kontrahent nie posiada numeru NIP wtedy argument ID_OBCE ma wartość pustą. CONTRACTOR ID_OBCE_2 identyfikator dodatkowy. Jest nim nazwa kontrahenta. Jest to argument opcjonalny i dodawany w przypadku, gdy nie istnieje argument CONTRACTOR ID_OBCE. Żeby kontrahent mógł być poprawnie zaimportowany musi być wypełniona przynajmniej jedna z wartości ID_OBCE, IDOBCE_2. KH_NAZWA nazwa kontrahenta KH_NIP numer NIP kontrahenta (niewymagany) KH_SYMBOLFK symbol konta FK kontrahenta KH_SKROT skrót kontrahenta KH_REGON numer regon kontrahenta (niewymagany) KH_PESEL numer PESEL kontrahenta (niewymagany) KH_OPIS opis kontrahenta (niewymagany) ADDRESS ismain="t" - adres główny kontrahenta. Kontrahent może mieć tylko jeden adres główny (niewymagany) ADDRESS ID_OBCE identyfikator (ID_OBCE) kontrahenta, którego dotyczy adres ADDRESS ID_OBCE_2 identyfikator dodatkowy (ID_OBCE_2) kontrahenta, którego dotyczy adres (jeżeli istnieje) KA_IDKR identyfikator kraju (niewymagany). Wartości identyfikatora zostały opisane w Dodatku KA_WOJEW województwo (niewymagany) KA_POWIAT powiat (niewymagany) KA_GMINA gmina (niewymagany) KA_KPOCZT kod pocztowy (niewymagany) KA_MIASTO miasto (niewymagany) KA_ULICA ulica (niewymagany) KA_NRDOM numer domu (niewymagany) KA_NRLOK numer lokalu (niewymagany) KA_TEL numer telefonu (niewymagany) KA_FAKS numer faksu (niewymagany) KA_TELKOM numer telefonu komórkowego (niewymagany) KA_MAIL adres email (niewymagany) KA_WWW adres www (niewymagany) ADDRESS ismain="n" adres dodatkowy kontrahenta. Kontrahent może mieć dowolną liczbę adresów dodatkowych (niewymagany) KA_IDRA identyfikator rodzaju adresu dodatkowego (niewymagany) KA_OPIS opis adresu dodatkowego (niewymagany) ACCOUNT ismain="t" rachunek główny kontrahenta. Kontrahent może mieć tylko jeden rachunek główny (niewymagany) ACCOUNT ID_OBCE - identyfikator (ID_OBCE) kontrahenta, którego dotyczy rachunek ACCOUNT ID_OBCE_2 - identyfikator dodatkowy (ID_OBCE_2) kontrahenta, którego dotyczy rachunek (jeżeli istnieje) RH_IDBK identyfikator banku (nazwa banku istniejącego w systemie KSP w słowniku banków) (niewymagany) RH_NRRACH numer rachunku (niewymagany) ACCOUNT ismain="n" rachunek dodatkowy kontrahenta. Kontrahent może mieć dowolną liczbę rachunków dodatkowych (niewymagany) RH_IDRR identyfikator rodzaju rachunku (niewymagany) 6 z 12
RH_NAZWA nazwa rachunku dodatkowego (niewymagany) RH_POSIADACZ posiadacz rachunku dodatkowego (niewymagany) RH_OPIS opis rachunku dodatkowego (niewymagany) 7 z 12
3. Przykładowy plik Rysunek 3-1 Przykładowy plik eksportu 8 z 12
4. Dodatek Identyfikator kraju KA_IDKR Kraj KA_IDKR Kraj 1 Polska 42 Bułgaria 2 Afganistan 43 Cape Verde 3 Afryka Południowa 44 Chile 4 Albania 45 Chiny 5 Algeria 46 Chorwacja 6 Andorra 47 Comoros 7 Angola 48 Cypr 8 Anguilla (U.K.) 49 Czad 9 Antarktyka 50 Czarnogóra 10 Antigua 51 Czuwaszja 11 Arabia Saudyjska 52 Dania 12 Argentyna 53 Diego Garcia (U.K. & U.S.) 13 Armenia 54 Dominika 14 Aruba (Holandia) 55 Dziewicze Wyspy Brytyjskie 15 Ashmore i Cartier Wyspy 56 Dziewicze Wyspy Stanów Zjednoczonych 16 Australia 57 Dżibuti 17 Austria 58 Egipt 18 Azerbejdżan 59 Ekwador 19 Azory (Portugalia) 60 Erytrea 20 Bahamy 61 Estonia 21 Bahrain 62 Etiopia 22 Baker Island 63 Wielka Brytania 23 Baleary 64 Falklandy 24 Bangladesz 65 Filipiny 25 Barbados 66 Finlandia 26 Baszkortostan 67 Francja 27 Belgia 68 Francuska Polynesia 28 Belize (Honduras Brytyjski) 69 Francuskie Ziemie Południowopolarne 29 Benin 70 Gabon 30 Bermudy (U.K.) 71 Gambia 31 Bhutan 72 Gazy Strefa 32 Białoruś 73 Ghana 33 Boliwia 74 Gibraltar (U.K.) 34 Bora Bora 75 Glorioso Islands 35 Botswana 76 Grecja 36 Bouvet Island 77 Grenada 37 Bośnia i Hercegowina 78 Grenlandia (Dania) 38 Brasilia 79 Gruzja 39 Brunei 80 Guam (U.S.) 40 Burkina Faso 81 Guernsey 41 Burundi 82 Gujana KA_IDKR Kraj KA_IDKR Kraj 9 z 12
83 Gujana Francuska 127 Korea Południowa 84 Gwadelupa (Francja) 128 Korea Północna 85 Gwatemala 129 Kostaryka 86 Gwinea 130 Kuba 87 Gwinea Bissau 131 Kuwejt 88 Gwinea Równikowa 132 Laos 89 Haiti 133 Lesotho 90 Hawaje (stan U.S.) 134 Liban 91 Heard Island & McDonald Islands 135 Liberia 92 Hiszpania 136 Libia 93 Holandia 137 Liechtenstein 94 Holenderskie Antily 138 Litwa 95 Honduras 139 Luksemburg 96 Hongkong 140 Łotwa 97 Howland Island 141 Macao (Portugalia) 98 Indie 142 Macedonia 99 Indonezja 143 Madagaskar 100 Irak 144 Malawi 101 Iran 145 Malediwy 102 Irlandia 146 Malezja 103 Islandia 147 Mali 104 Isle of Man 148 Malta 105 Izrael 149 Maroko 106 Jamajka 150 Marshall Islands 107 Jan Mayen 151 Martynika (Francja) 108 Japonia 152 Mauritania 109 Javis Island 153 Mauritius 110 Jersey 154 Mayotte (Francja) 111 Johnston Atoll 155 Meksyk 112 Jordania 156 Midway Islands 113 Juan de Nova Island 157 Mikronezja 114 Jugosławia 158 Monako (Księstwo) 115 Kambodża 159 Mongolia 116 Kamerun 160 Montserrat (U.K.) 117 Kanada 161 Mordowia 118 Katar 162 Morze Arktyczne 119 Kazachstan 163 Mozambik 120 Kenia 164 Mołdawia 121 Kingman Reef 165 Myanmar (Birma) 122 Kirgistan 166 Namibia 123 Kiribati (Republika) 167 Nauru 124 Kokosowe (Keeling) Wyspy 168 Nepal 125 Kolumbia 169 Nevis 126 Kongo (Zaire) 170 Niemcy KA_IDKR Kraj KA_IDKR Kraj 10 z 12
171 Niger 214 Seszele (Seychelles) 172 Nigeria 215 Sierra Leone 173 Nikaragua 216 Singapur 174 Nikumaroro (Gardener Island) 217 Somalia 175 Niue (Nowa Zelandia) 218 South Georgia & S. Sandwich Islands 176 Norfolk Island 219 Spratly Islands 177 Norwegia 220 Sri Lanka (Ceylon) 178 Nowa Kaledonia 221 St. Lucia 179 Nowa Zelandia 222 St. Pierre & Miquelon (Francja) 180 Oman 223 St. Vincent 181 Pakistan 224 Stany Zjednoczone Ameryki Północnej 182 Palau (Republika) 225 Stolica Święta (Miasto Watykańskie) 183 Palmyra Atoll 226 Suazi 184 Panama 227 Sudan 185 Papua Nowa Gwinea 228 Surinam 186 Paracel Islands 229 Svalbard 187 Paragwaj 230 Syria 188 Peru 231 Szkocja 189 Pitcairn Islands 232 Szwajcaria 190 Portoryko 233 Szwecja 191 Portugalia 234 Słowacja 192 Republika Afryki Centralnej 235 Słowenia 193 Republika Konga 236 Święta Helena (St. Helena, U.K.) 194 Republika Czeska 237 Tadżykistan 195 Republika Dominikańska 238 Tahiti (Francja) 196 Republika Salwadoru 239 Taiwan 197 Republika Fidżi 240 Tajlandia 198 Republika Jemeńska 241 Tanzania 199 Republika Komi (Rosja) 242 Tatarstan 200 Republika Buriacji 243 Tibet 201 Republika Autonomiczna Sacha (Jakucja) 244 Togo 202 Reunion (Francja) 245 Tokelau 203 Rosja 246 Tonga 204 Ruanda 247 Trinidad & Tobago 205 Rumunia 248 Tromelin Island 206 Sahara Zachodnia 249 Tunezja 207 Saint Kitts i Nevis 250 Turcja 208 Samoa Amerykańskie (U.S.) 251 Turkmenistan 209 Samoa Zachodnie 252 Turks & Caicos (U.K.) 210 San Marino 253 Tuvalu 211 Sao Tome & Principe 254 Udmurcja (Rosja) 212 Senegal 255 Uganda 213 Serbia 256 Ukraina KA_IDKR Kraj KA_IDKR Kraj 11 z 12
257 Urugwaj 273 Wyspy Caymany 258 Uzbekistan 274 Wyspy Cook'a 259 Vanuatu 275 Wyspy Faroe 260 Wake Island 276 Wyspy Kanaryjskie 261 Walia 277 Wyspy na Koralowym Morzu 262 Wallis and Futuna Islands 278 Wyspy Salomona 263 Wenezuela 279 Wyspy Szetlandzkie 264 West Bank 280 Wyspy Żółwie (Galapagos, Ekwador) 265 Wielkie Caymany (U.K.) 281 Włochy 266 Wietnam 282 Węgry 267 Wniebowstąpienia Wyspa 283 Zaire 268 Wspólnota Marianów Północnych (U.S.) 284 Zambia 269 Wybrzeża Kości Słoniowej (Ivory Coast) 285 Zanzibar & Pemba (Tanganika) 270 Wyspa Bożego Narodzenia 286 Zimbabwe 271 Wyspa Clipperton 288 Zjednoczone Emiraty Arabskie 272 Wyspa Navassa 12 z 12