Załącznik nr 10 do SOPZ: Protokół wymiany danych (Interface) Protokół wymiany danych pomiędzy Systemem Wykonawcy a Systemem Przekazywania Zgłoszeń

Transkrypt

1 Załącznik nr 10 do SOPZ: Protokół wymiany danych (Interface) Protokół wymiany danych pomiędzy Systemem Wykonawcy a Systemem Przekazywania Zgłoszeń

2 Spis treści Wstęp... 3 Definicje... 4 Certyfikaty i bezpieczeństwo... 4 Synchronizacja czasu pomiędzy maszynami... 5 Podstawowe typy obiektów... 6 Słowniki... 6 Wymiana danych... 7 Przebieg komunikacji... 7 Częstotliwość odpytywania web serwisu Systemu Wykonawcy... 7 Czas oczekiwania na dane z web serwisu Systemu Wykonawcy... 7 Metody... 8 Metoda listazmianmgo... 8 Metoda listazmianpojemnikow Metoda listaaktualnychharmonogramow Metoda listaodbiorow Początkowe zasilenie danymi Systemu Odbiorcy Lista posesji Słowniki Lista MGO Lista Pojemników Lista Harmonogramów Aktualizacja danych w trakcie realizacji Umowy Załącznik nr 1 Słowniki Słownik typu odpadów Słownik typów pojemników Słownik częstotliwości odbioru odpadów Słownik typu nieruchomości Słownik typu zabudowy Słownik statusów odbiorów odpadów Słownik uwag

3 Słownik typów modyfikacji danych Załącznik nr 2 - Pliki XSD ListaZmianMgo ListaZmianPojemnikow listaaktualnychharmonogramów ListaOdbiorow Załącznik nr 3 Scenariusz podstawowych przykładów użycia listazmianmgo Odpytanie o listę zmian dla Miejsc Gromadzenia Odpadów jakie zaszły w Marcu 2017 roku Dwukrotna zmiana danych podstawowych (częstości odbioru odpadów) dla tego samego MGO o id 11 w Marcu 2017 roku Archiwizacja MGO o id 35 w Marcu 2017 roku Dodanie nowego MGO o id 41 w Marcu 2017 roku Zmiana listy posesji powiązanych z danym MGO listazmianpojemnikow Przeniesienie Pojemnika na inne MGO o id Dwukrotna zmiana danych podstawowych (typ odpadów) pojemnika o RFID EC2E7E Archiwizacja Pojemnika Dodanie nowego pojemnika o RFID DAA7F listaaktualnychharmonogramow Lista aktualnych harmonogramów zaplanowanych do realizacji na tydzień Lista aktualnych harmonogramów zaplanowanych do realizacji na dany tydzień w przypadku, gdy pewne harmonogramy zostały uprzednio zmodyfikowane Archiwizacja danego harmonogramu listaodbiorow Lista odbiorów z danego dnia i sektora Spis tabel

4 Wstęp Niniejszy dokument opisuje specyfikację techniczną protokołu wymiany danych pomiędzy Systemem Wykonawcy a Związkiem Międzygminnym Gospodarki Odpadami Aglomeracji Poznańskiej. 3

5 Definicje 1. Miejsce Gromadzenia Odpadów (MGO) - należy przez to rozumieć część nieruchomości przeznaczoną do gromadzenia odpadów komunalnych (w tym zbieranych w sposób selektywny), w którym umieszczone zostały pojemniki lub worki, spełniające wymogi zapisane w Rozporządzenia Ministra Infrastruktury z dnia 12 kwietnia 2002 r. w sprawie warunków technicznych, jakim powinny odpowiadać budynki i ich usytuowanie (t.j. Dz. U. z 2015 r., poz. 1422); 2. Postępowanie - postępowanie o udzielenie zamówienia publicznego dotyczące Sektora nr. przeprowadzone w trybie przetargu nieograniczonego, o którym mowa w ustawie z dnia 29 stycznia 2004 r. Prawo zamówień publicznych (t.j. Dz. U. z 2015 roku, poz ze zm.); 3. System Wykonawcy - system oparty na oprogramowaniu służącym do zarządzania danymi pozyskiwanymi z systemów monitoringu Wykonawcy, opartych o system nawigacji GPS, system radiowej identyfikacji pojemników i kontenerów i system ważenia, umieszczonych na pojazdach używanych przez Wykonawcę do realizacji przedmiotu zamówienia (Monitoring i Kontrola Systemu Identyfikacji MKSI). System służący do gromadzenia i analizy danych otrzymywanych automatycznie z pojazdów Wykonawcy, takich jak położenie i stan pojazdu, z systemu RFID, z systemu wagowego, z terminali pokładowych itp.; 4. System Przekazywania Zgłoszeń (SPZ) informatyczny system Związku Międzygminnego, służący do komunikowania się z Wykonawcą; 5. Umowa - umowa zawarta między Zamawiającym a Wykonawcą dotycząca odbioru i transportu zmieszanych odpadów komunalnych i odpadów ulegających biodegradacji, ze szczególnym uwzględnieniem bioodpadów oraz odbioru, transportu i zagospodarowania odpadów komunalnych zbieranych selektywnie z nieruchomości, na których zamieszkują oraz nieruchomości, na których nie zamieszkują mieszkańcy, a powstają odpady komunalne położonych na terenie Sektor nr wchodzącego w skład Związku Międzygminnego Gospodarka Odpadami Aglomeracji Poznańskiej w wyniku Postępowania; 6. Wykonawca lub Odbiorca odpadów komunalnych - podmiot wybrany w wyniku Postępowania; 7. Związek lub Zamawiający - należy przez to rozumieć Związek Międzygminny Gospodarka Odpadami Aglomeracji Poznańskiej ; Certyfikaty i bezpieczeństwo W celu zapewnienia bezpieczeństwa konieczne jest używanie autoryzacji przy wywołaniu każdej metody protokołu z danymi uwierzytelniającymi: użytkownik i hasło. System Wykonawcy na podstawie tych informacji powinien autoryzować dostęp do danych. Hasło oraz nazwa użytkownika nadawane są przez System Wykonawcy. Hasło oraz nazwa użytkownika dostarczana jest do Zamawiającego jako zaszyfrowana kluczem informacja. Procedura dostarczenia informacji autoryzacyjnych powinna wyglądać następująco: 1. Hasło oraz nazwa użytkownika powinny być zaszyfrowane kluczem; 2. Informacje w takiej formie powinny zostać przesłane na wskazany adres mksi@goap.org.pl; 3. Dostarczenie danych autoryzacyjnych powinno nastąpić nie później niż na tydzień przed terminem rozpoczęcia Umowy; 4. Hasło oraz nazwa użytkownika powinny być zmieniane co 6 miesięcy. 4

6 W przypadku uzasadnionego podejrzenia utraty bezpieczeństwa danych autoryzacyjnych należy nadać nowe hasło i nazwę użytkownika zgodnie z punktami 1 i 2. Dodatkowo komunikacja powinna przebiegać z użyciem protokołu HTTPS z szyfrowaniem z użyciem TLS w wersji minimum 1.1. Certyfikaty używane w transmisji danych pomiędzy Systemem Wykonawcy a Zamawiającym muszą być autoryzowane przez zaufany urząd certyfikacyjny (CA). Sugerowane urzędy certyfikacyjne to pozycje z listy Mozilli i Narodowe Centrum Certyfikacji. Niedopuszczalne jest użycie kluczy samo podpisanych. Synchronizacja czasu pomiędzy maszynami Protokół wymiany danych wymaga synchronizacji zegarów systemowych pomiędzy: urządzeniami Systemu Wykonawcy, z których pobierane są dane niezbędne do realizacji Umowy; urządzeniami przesyłającymi dane (tj. urządzeniami udostępniającymi web serwis) niezbędnymi do realizacji Umowy; urządzeniami Systemu Przekazywania Zgłoszeń z web serwisu dotyczących realizacji Umowy w Systemie Wykonawcy. W celu zapewnienia jak najlepszej synchronizacji zegarów systemowych wymagana jest synchronizacja z zewnętrznymi serwerami za pomocą protokołu NTP i posiadającymi status Stratum1 dla strefy czasowej CET, Polska, Warszawa. Aktualną listę można znaleźć tutaj: Lista serwerów, z którymi należy synchronizować maszyny jest następująca: Tabela 1 Lista zewnętrznych serwerów o statusie Stratum1 dla strefy czasowej CET, Polska, Warszawa. Lista zewnętrznych serwerów o statusie Stratum1 dla strefy czasowej CET, Polska, Warszawa.* Opis serwera Nazwa hosta Adres IP Priorytet Zegar atomowy na sieciach optycznych, Krajowe Laboratorium Fizyki Atomowej i ntp.fizyka.umk.pl Optycznej, UMK, Toruń, Polska Zegar atomowy na Rubidzie, Warszawa, Polska ntp.ntp-servers.com Zegar DUAL GPS, Warszawa, Polska time.coi.pw.edu.pl *Lista zewnętrznych źródeł synchronizacji czasu może ulec zmianie zgodnie z zapisami z SOPS. Serwery powinny być odpytywane według najwyższego priorytetu. Synchronizacja czasu powinna odbywać się co najmniej raz na godzinę. Poniżej przedstawiono przykładowy plik.csv służący do przesłania Wykonawcy listy zewnętrznych źródeł synchronizacji czasu. Wymagane pola: nazwa hosta, adres ip, priorytet. Tabela 2 Plik csv zawierający dane o liście źródeł synchronizacji czasu. "ntp.fizyka.umk.pl";" ";"3" "ntp.ntp-servers.com";" ";"2" "time.coi.pw.edu.pl";" ";"1" 5

7 Podstawowe typy obiektów Poniżej przedstawione są typy podstawowych wartości, na temat których System Przekazywania Zgłoszeń pobierane dane od Wykonawcy. Pojazd dane dotyczące pojazdu wykorzystywanego przez Wykonawcę do realizacji Umowy; MGO dane dotyczące Miejsca Gromadzenia Odpadów; Posesja dane dotyczące posesji, których właściciele zadeklarowali korzystanie z usługi odbioru odpadów; Pojemnik dane dotyczące pojemnika; Harmonogram harmonogram odbioru odpadów komunalnych od właścicieli nieruchomości, na których zamieszkują mieszkańcy oraz właścicieli nieruchomości, na których nie zamieszkują mieszkańcy, a powstają odpady komunalne; Odbiór dane dotyczące odbioru danego pojemnik na konkretnym MGO. Słowniki Słowniki, które są używane w celu wymiany informacji zapewniane są przez Zamawiającego i dostarczane do Wykonawcy w formie plików.csv. Zawierają pozycje, którym odgórnie nadane są identyfikatory (id). Słowniki przesłane Wykonawcy mają ustandaryzowaną strukturę. Każdy słownik zawiera pola: id, nazwa oraz opis. Struktura słownika tj. liczba oraz nazwa atrybutów opisujących pozycję z słownika jest niezmienna. Wpisy w słownikach nie mogą zostać usunięte. Nowe pozycję mogą być tylko dodawane wraz z nadaniem dla nich nowego, unikalnego identyfikatora (id) oraz nazwy i opisu. Zestawienie słowników: TYPY_ODPADÓW - Słownik typu odpadów, TYPY_POJEMNIKÓW - Słownik typów pojemników, TYPY_CZĘSTOŚCI_ODB - Słownik częstotliwości odbioru odpadów, TYPY_NIERUCHOMOŚCI Słownik typów nieruchomości, TYPY_ZABUDOWY Słownik typów zabudowy, STATUS_ODBIORU - Słownik statusów odbiorów odpadów, UWAGI - Słownik uwag, TYPY_MODYFIKACJI_DANYCH - Słownik typów modyfikacji danych. 6

8 Dokładne opisy struktury słowników oraz ich zawartości znajdują się w załączniku nr 1 Słowniki. Wymiana danych Wymiana danych pomiędzy Systemem Wykonawcy a Systemem Przekazywania Zgłoszeń realizowana będzie przez web serwis oparty o protokół SOAP. Dane przesyłane od Wykonawcy do Zamawiającego będą w formacie XML. Dla każdej z zdefiniowanych w protokole metod należy przesłać do web serwisu Wykonawcy dane uwierzytelniające (login, hasło) oraz odpowiednie argumenty danej usługi. Przebieg komunikacji 1. Zgodnie z ustalonym planem System Przekazywania Zgłoszeń łączy się z Systemem Wykonawcy przez wywołanie odpowiedniej usługi podając dane uwierzytelniające (login, hasło) oraz odpowiednie argumenty usługi. 2. System Wykonawcy w odpowiedzi na zapytanie Systemu Przekazywania Zgłoszeń udostępnia informacje o nowych, zaktualizowanych danych spełniających warunki zapytania określone przez podane w zapytaniu argumenty. 3. W przypadku, jeśli nie ma nowych danych spełniających warunki zapytania wymiana danych zostaje zakończona. 4. W sytuacji, gdy w Systemie Wykonawcy znajdują się nowe dane spełniające warunki zapytania zostają one przesłane w formacie XML do Zamawiającego. 5. W przypadku wystąpienia błędów Zamawiający zapoznaje się z nimi i informuje o nich System Wykonawcy. 6. Użytkownik Systemu Wykonawcy weryfikuje, analizuje i usuwa błędy. Częstotliwość odpytywania web serwisu Systemu Wykonawcy Usługi oferowane przez System Wykonawcy powinny być w stanie przekazywać dane niezbędne do realizacji Umowy z odpowiednimi częstotliwościami przedstawionymi w tabeli 3. Tabela 3 Częstotliwość odpytywania web serwisu Wykonawcy. Nazwa usługi listazmianmgo listazmianpojemnikow listaaktualnychharmonogramow listaodbiorow Częstotliwość Co 30 minut Co 30 minut Raz na dobę Co 30 minut Czas oczekiwania na dane z web serwisu Systemu Wykonawcy Usługi oferowane przez web serwis Systemu Wykonawcy powinny być w stanie przekazać dane w czasie nie większym niż 15 minut od chwili odebrania zapytania z Systemu Przekazywania Zgłoszeń. 7

9 Metody Metoda listazmianmgo Metoda zwraca listę zmian, dodania lub archiwizacji jakie zaszły dla MGO. Lista zwracana jest w postaci dokumentu XML. Lista zawiera zaktualizowane dane po zmianie, dla których data data-migracji należy do przedziału obustronnie domkniętego [data-od, data-do]. Dla każdej zmiany danych musi być podana informacja o tym, kiedy napłynęła ona do Systemu Wykonawcy (tj. uzupełniona musi być wartość pola datamigracji). Wraz z modyfikacją każdej informacji dotyczącej MGO należy przesłać w osobnym rekordzie nowe, zaktualizowane dane MGO po zmianie wraz z wypełnionym polem daty data-modyfikacji podającą chwilę wprowadzenia zmiany. Każda zmiana powinna być reprezentowana przez pojedynczy rekord. Tabela 4. Parametry wywołania metody listazmianmgo. Nazwa Typ danych Opis Parametru login String Login użytkownika. haslo String Hasło użytkownika. sektor-nr Integer Numer sektora, dla którego mają zostać pobrane dane. data-od 1 DateTime Data, od której interesują Odbiorcę zmiany, które zaszły dla MGO. Data podana jest w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO-8601 dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-ddthh:mm:ss+01:00 data-do 1 DateTime Data, do której interesują Odbiorcę zmiany, które zaszły dla MGO. Data podana jest w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO-8601 dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-ddthh:mm:ss+01:00 1 zakładamy, że data-od <= data-do. Tabela 5 Atrybuty plików XML zawierających wyniki wywołania metody listazmianmgo. Atrybut Typ danych Czy Opis wymagane mgo-id Integer TAK Unikalny identyfikator MGO w Systemie Wykonawcy. pos-ids Integer TAK Aktualna lista identyfikatorów posesji przypisanych do tego MGO na podstawie listy posesji udostępnionej przez Zamawiającego. Lista powinna zawierać unikalne identyfikatory posesji bez duplikatów. data-modyfikacji DateTime TAK Data modyfikacji danych MGO w Systemie Wykonawcy. Data powinna być podana w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-ddthh:mm:ss+01:00 typ-modyfikacji Integer TAK Identyfikator typu dokonanych zmian z słownika TYP_MODYFIKACJI_DANYCH. 8

10 data-migracji DateTime TAK Data zarejestrowania informacji w Systemie Wykonawcy jako gotowej do pobrania. Data powinna być podana w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-ddthh:mm:ss+01:00 czest-odb Integer TAK Identyfikator typu częstotliwości odbioru odpadów z słownika TYPY_CZĘSTOTLIWOŚCI_ODB. Zmiana danych MGO wymusza podanie wartości data-modyfikacji, mówiącej o chwili zajścia zmian. Dane podstawowe MGO (dane, które charakteryzują dane MGO i mogą modyfikacji w trakcie realizacji Umowy): pos-ids czest-odb Dla każdej zmiany danych należy podać typ zmian na podstawie słownika TYP_MODYFIKACJI_DANYCH. W sytuacji, gdy zmienione zostały dane MGO należy przesłać: aktualne dane po zmianie, wartość data-modyfikacji, czyli chwilę w której zaszły zmiany, wartość data-migracji, czyli chwilę w której zmiany zostały zarejestrowane w Systemie Wykonawcy, jako typ-modyfikacji podać wartość 1. W sytuacji, gdy dodano nowe MGO należy przesłać: aktualne dane nowego MGO, wartość data-modyfikacji, czyli chwilę w której zostało utworzone nowe MGO, wartość data-migracji, czyli chwilę w której zmiany zostały zarejestrowane w Systemie Wykonawcy, jako typ-modyfikacji podać wartość 2. W sytuacji, gdy archiwizowano istniejące MGO należy przesłać: aktualne dane nowego MGO, wartość data-modyfikacji, czyli chwilę w której zostało zarchiwizowane istniejące MGO, wartość data-migracji, czyli chwilę w której zmiany zostały zarejestrowane w Systemie Wykonawcy, jako typ-modyfikacji podać wartość 3. UWAGA: nie można zarchiwizować nieistniejącego MGO lub MGO, które już jest zarchiwizowane. Podsumowanie: Każdy wpis zwracany przez metodę musi mieć podaną wartość data-modyfikacji i datamigracji oraz typ-modyfikacji. 9

11 Ważne jest rozróżnienie dwóch dat: data-modyfikacji i data-migracji. W systemach rozproszonych może dojść do sytuacji, że z uwagi na czasowy brak komunikacji z serwerem data modyfikacji danych nie musi być datą tożsamą z datą zarejestrowania ich w Systemie Wykonawcy. Z punktu widzenia Zamawiającego odbierającego dane z Systemu Wykonawcy istotne jest posiadanie informacji kiedy dane zostały faktycznie zarejestrowane w Systemie Wykonawcy jako nowe i gotowe do pobrania. Tabela 6 Przykładowa struktura XML odpytania usługi listazmianmgo. listazmianmgo XML Przykład i struktura odpytania usługi <zapytanielistazmianmgo> <data-do> t08:34:20+01:00</data-do> <data-od> t16:34:20+01:00</data-od> <haslo>f/r5jy2]pt]%aevc</haslo> <login>nd923@6/u[hvpcbd</login> <sektor-nr>1</sektor-nr> </zapytanielistazmianmgo> Tabela 7 Przykładowa struktura XML odpowiedzi z metody listazmianmgo. listazmianmgo XML Przykład i struktura <listazmianmgo xmlns:xs=" <zmianamgo id="1"> <mgo-id>12</mgo-id> <typ-zabud>1</typ-zabud> <pos-ids> <pos-id> </pos-id> <pos-id>321413</pos-id> <pos-id>142144</pos-id> <pos-id>143245</pos-id> </pos-ids> <data-modyfikacji> t10:20:00+01:00</data-modyfikacji> <typ-modyfikacji>2</typ-modyfikacji> <data-migracji> t10:20:56+01:00</data-migracji> <czest-odb>7</czest-odb> </zmianamgo> <zmianamgo id="2"> <mgo-id>5</mgo-id> <typ-zabud>0</typ-zabud> <pos-ids> <pos-id>143242</pos-id> <pos-id> </pos-id> <pos-id>154354</pos-id> <pos-id>16465</pos-id> </pos-ids> <data-modyfikacji> t11:20:18+01:00</data-modyfikacji> <typ-modyfikacji>3</typ-modyfikacji> <data-migracji> t11:21:43+01:00</data-migracji> <czest-odb>4</czest-odb> </zmianamgo> </listazmianmgo> 10

12 Metoda listazmianpojemnikow Metoda zwraca listę zmian, dodania lub archiwizacji jakie zaszły dla pojemników. Lista zwracana jest w postaci dokumentu XML. Lista zawiera zaktualizowane dane po zmianie, dla których data data-migracji należy do przedziału obustronnie domkniętego [data-od, data-do]. Tabela 8 Parametry wywołania metody listazmianpojemnikow. Nazwa Typ danych Opis Parametru login String Login użytkownika. haslo String Hasło użytkownika. sektor-nr Integer Numer sektora, dla którego mają zostać pobrane dane. data-od 1 DateTime Data, od której interesują Odbiorcę zmiany, które zaszły dla Pojemnika. Data podana jest w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO-8601 dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-ddthh:mm:ss+01:00 data-do 1 DateTime Data, do której interesują Odbiorcę zmiany, które zaszły dla Pojemnika. Data podana jest w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO-8601 dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-ddthh:mm:ss+01:00 1 zakładamy, że data-od <= data-do. Tabela 9 Atrybuty plików XML zawierających wyniki wywołania metody listazmianpojemnikow. Atrybut Typ danych Czy wymagane Opis pojemnik-id Integer TAK Unikalny (w obrębie rejonu) identyfikator pojemnika w Systemie Wykonawcy. mgo-id Integer TAK Identyfikator MGO w Systemie Wykonawcy, w którym ustawiono pojemnik. rfid String TAK Unikalny kod RFID pojemnika nadawany przez Operatora. UWAGA: pole nie może być NULL. RFID musi mieć postać zapisanego w kodzie szesnastkowym unikalnego kodu binarnego identyfikatora. RFID zapisany w kodzie szesnastkowym powinien mieć maksymalną długość 24 znaków. Identyfikator nie powinien być dodatkowo kodowany w żaden inny sposób. odpady-typ Integer TAK Identyfikator frakcji z słownika TYPY_ODPADÓW. pojemnik-typ Integer TAK Identyfikator typu pojemnika z słownika TYPY_POJEMNIKOW. data-modyfikacji DateTime TAK Data modyfikacji danych dotyczących pojemnika w Systemie Wykonawcy. Data powinna być podana w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-ddthh:mm:ss+01:00 typ-modyfikacji Integer TAK Identyfikator typu dokonanych zmian z słownika TYP_MODYFIKACJI_DANYCH. data-migracji DateTime TAK Data zarejestrowania informacji w Systemie Wykonawcy jako gotowej do pobrania. 11

13 Data powinna być podana w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-ddthh:mm:ss+01:00 Zmiana danych pojemnika wymusza podania wartości data-modyfikacji, mówiącej o chwili zajścia zmian. Dane podstawowe Pojemników (dane, które charakteryzują dany pojemnik i mogą ulec modyfikacji w trakcie realizacji Umowy): mgo-id odpady-typ pojemnik-typ Dla każdej zmiany danych należy podać typ tych zmian na podstawie słownika TYP_MODYFIKACJI_DANYCH. W sytuacji, gdy zmienione zostały dane pojemnika należy przesłać: aktualne dane po zmianie, wartość data-modyfikacji, czyli chwilę w której zaszły zmiany, wartość data-migracji, czyli chwilę w której zmiany zostały zarejestrowane w Systemie Wykonawcy, jako typ-modyfikacji podać wartość 1. W sytuacji, gdy dodano nowy pojemnik należy przesłać: aktualne dane nowego pojemnika, wartość data-modyfikacji, czyli chwilę w której został utworzony nowy pojemnik, wartość data-migracji, czyli chwilę w której zmiany zostały zarejestrowane w Systemie Wykonawcy, jako typ-modyfikacji podać wartość 2. W sytuacji, gdy archiwizowano istniejący pojemnik należy przesłać: aktualne dane nowego pojemnika, wartość data-modyfikacji, czyli chwilę w której zarchiwizowano istniejący w systemie pojemnik, wartość data-migracji, czyli chwilę w której zmiany zostały zarejestrowane w Systemie Wykonawcy, jako typ-modyfikacji podać wartość 3. UWAGA: Nie można zarchiwizować nieistniejącego pojemnika lub pojemnika, który już jest zarchiwizowany. Ważne jest rozróżnienie dwóch dat: data-modyfikacji i data-migracji. W systemach rozproszonych może dojść do sytuacji, że z uwagi na czasowy brak komunikacji z serwerem data modyfikacji danych nie musi być datą tożsamą z datą zarejestrowania ich w Systemie Wykonawcy. Z punktu widzenia Odbiorcy Danych z Systemu Operatora istotne jest posiadanie informacji kiedy dane zostały faktycznie zarejestrowane w Systemie Operatora jako nowe i gotowe do pobrania. 12

14 Tabela 10 Przykładowa struktura XML odpytania usługi listazmianpojemnikow. listazmianpojemnikow XML Przykład i struktura odpytania usługi <zapytanielistazmianpojemnikow> <data-do> t00:05:00+01:00</data-do> <data-od> t00:10:12+01:00</data-od> <haslo>f/r5jy2]pt]%aevc</haslo> <login>nd923@6/u[hvpcbd</login> <sektor-nr>1</sektor-nr> </zapytanielistazmianpojemnikow> Tabela 11 Przykładowa struktura XML odpowiedzi z metody listazmianpojemnikow listazmianpojemnikow XML - Przykład i struktura <listazmianpojemnikow xmlns:xs=" <zmianapojemnika id="1"> <pojemnik-id>12</pojemnik-id> <mgo-id>12</mgo-id> <rfid> ec2e7c0</rfid> <odpady-typ>6</odpady-typ> <pojemnik-typ>25</pojemnik-typ> <data-modyfikacji> t11:59:12+01:00</data-modyfikacji> <typ-modyfikacji>2</typ-modyfikacji> <data-migracji> t11:12:00+01:00</data-migracji> </zmianapojemnika> <zmianapojemnika id="2"> <pojemnik-id>9</pojemnik-id> <mgo-id>47</mgo-id> <rfid> ec2e7e2</rfid> <odpady-typ>6</odpady-typ> <pojemnik-typ>25</pojemnik-typ> <data-modyfikacji> t11:59:16+01:00</data-modyfikacji> <typ-modyfikacji>2</typ-modyfikacji> <data-migracji> t09:45:01+01:00</data-migracji> </zmianapojemnika> </listazmianpojemnikow> Metoda listaaktualnychharmonogramow Metoda pobiera listę pełnych harmonogramów odbioru pojemników z Miejsc Gromadzenia Odpadów. Lista zwracana jest w postaci dokumentu XML. Lista zawiera harmonogramy, dla których data należy do przedziału obustronnie domkniętego [data-od, data-do]. Tabela 12 Parametry wywołania metody listaaktualnychharmonogramow. Nazwa Typ danych Opis Parametru login String Login użytkownika. haslo String Hasło użytkownika. sektor-nr Integer Numer sektora, dla którego realizowane będą harmonogramy. 13

15 data-od 1 Date Data, od której zaplanowane są realizacje harmonogramów. Data, od której interesują Odbiorcę zmiany, które zaszły dla Pojemnika. Data podana jest w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO-8601 dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-dd+01:00 data-do 1 Date Data, do której zaplanowane są realizacje harmonogramów. Data, do której interesują Odbiorcę zmiany, które zaszły dla Pojemnika. Data podana jest w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO-8601 dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-dd+01:00 1 zakładamy, że data-od <= data-do. Tabela 13 Atrybuty plików XML zawierających wyniki wywołania metody getschedulelist. Atrybut Typ danych Czy wymagane Opis harm-id Integer TAK Identyfikator harmonogramu z Systemu Wykonawcy. data Date TAK Planowana data realizacji. Data powinna być podana w formacie Data z przesunięciem względem czasu UTC zgodnie ze standardem ISO-8601 dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-dd+01:00 odpady-typ Integer TAK Identyfikator typu frakcji z słownika TYPY_ODPADÓW. mgo-ids Integer TAK Aktualna Lista identyfikatorów MGO z Systemu Wykonawcy, które obejmuje harmonogram. Lista powinna zawierać unikalne identyfikatory MGO bez duplikatów. pojazd-id Integer NIE Identyfikator pojazdu z Systemu Wykonawcy. data-modyfikacji DateTime TAK Data modyfikacji danych dotyczących harmonogramu w Systemie Wykonawcy. Data powinna być podana w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO-8601 dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-ddthh:mm:ss+01:00 typ-modyfikacji Integer TAK Identyfikator typu dokonanych zmian z słownika TYP_MODYFIKACJI_DANYCH. data-migracji DateTime TAK Data zarejestrowania informacji w Systemie Wykonawcy jako gotowej do pobrania. Data powinna być podana w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO-8601 dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-ddthh:mm:ss+01:00 Przykład: Wywołanie metody listaaktualnychharmonogramow z parametrami data-od = i datado = powinno przekazać aktualną listę harmonogramów, których data przewidzianej realizacji należy do przedziału obustronnie domkniętego [ , ]. Dane podstawowe harmonogramu (dane, które charakteryzują dany harmonogram i mogą modyfikacji w trakcie realizacji Umowy): 14

16 data odpady-typ mgo-ids pojazd-id Poprzez harmonogram rozumiemy: Listę Miejsc Gromadzenia Odpadów wraz z rodzajem frakcji do odbioru oraz planowaną datą realizacji harmonogramu. Harmonogramy mogą ulegać zmianie najpóźniej na 24 godziny przed planowanym odbiorem. W sytuacji, gdy zmienione zostały dane harmonogramu należy przesłać: aktualne dane po zmianie, wartość data-modyfikacji, czyli chwilę w której zaszły zmiany, wartość data-migracji, czyli chwilę w której zmiany zostały zarejestrowane w Systemie Wykonawcy, jako typ-modyfikacji podać wartość 1. UWAGA: Dopuszczalne są zmiany tylko dla harmonogramów, które nie zostały jeszcze zrealizowane i do chwili rozpoczęcia ich realizacji nie upłynęły jeszcze 24 godziny. Niedopuszczalna jest modyfikacja danych harmonogramów, które zostały już zrealizowane. W sytuacji, gdy przesyłane są dane o nowym harmonogramie należy przesłać: aktualne dane nowego pojemnika, wartość data-modyfikacji, czyli chwilę w której został utworzony nowy harmonogram, wartość data-migracji, czyli chwilę w której zmiany zostały zarejestrowane w Systemie Wykonawcy, jako typ-modyfikacji podać wartość 2. W sytuacji, gdy dany harmonogram został zarchiwizowany (np. na skutek zmiany planów i usunięcia go z zaplanowanego wcześniej grafiku) należy przesłać: aktualne dane nowego pojemnika, wartość data-modyfikacji, czyli chwilę w której został zarchiwizowany dany harmonogram, wartość data-migracji, czyli chwilę w której zmiany zostały zarejestrowane w Systemie Wykonawcy, jako typ-modyfikacji podać wartość 3. Ważne jest rozróżnienie dwóch dat: data-modyfikacji i data-migracji. W systemach rozproszonych może dojść do sytuacji, że z uwagi na czasowy brak komunikacji z serwerem data modyfikacji danych nie musi być datą tożsamą z datą zarejestrowania ich w Systemie Wykonawcy. Z punktu widzenia Zamawiającego odbierającego dane z Systemu Wykonawcy istotne jest posiadanie informacji kiedy dane zostały faktycznie zarejestrowane w Systemie Wykonawcy jako nowe i gotowe do pobrania. Tabela 14 Przykładowa struktura XML odpytania usługi listaaktualnychharmonogramow. listaaktualnychharmonogramow XML Przykład i struktura odpytania usługi <zapytanielistaaktualnychharmonogramow> <data-do> :00</data-do> 15

17 <data-od> :00</data-od> <haslo>f/r5jy2]pt]%aevc</haslo> <sektor-nr>1</sektor-nr> </zapytanielistaaktualnychharmonogramow> Tabela 15 Przykładowa struktura XML odpowiedzi z metody listaaktualnychharmonogramow. listaaktualnychharmonogramow XML - Przykład i struktura <listaaktualnychharmonogramow xmlns:xs=" <zmianaharmonogramu id="1"> <harm-id>6</harm-id> <data> :00</data> <odpady-typ>3</odpady-typ> <mgo-ids> <mgo-id>12</mgo-id> <mgo-id>13</mgo-id> <mgo-id>14</mgo-id> <mgo-id>15</mgo-id> </mgo-ids> <pojazd-id>54</pojazd-id> <data-modyfikacji> t15:34:24+01:00</data-modyfikacji> <typ-modyfikacji>2</typ-modyfikacji> <data-migracji> t15:34:23+01:00</data-migracji> </zmianaharmonogramu> <zmianaharmonogramu id="2"> <harm-id>14</harm-id> <data> :00</data> <odpady-typ>3</odpady-typ> <mgo-ids> <mgo-id>40</mgo-id> <mgo-id>43</mgo-id> <mgo-id>47</mgo-id> <mgo-id>51</mgo-id> </mgo-ids> <pojazd-id>12</pojazd-id> <data-modyfikacji> t14:00:32+01:00</data-modyfikacji> <typ-modyfikacji>2</typ-modyfikacji> <data-migracji> t11:23:24+01:00</data-migracji> </zmianaharmonogramu> </listaaktualnychharmonogramow> Metoda listaodbiorow Funkcja zwraca listę odbiorów pojemników wykorzystywanych przez Wykonawcę do realizacji Umowy dla danego sektora. Lista zawiera zdarzenia (odbiory lub brak odbioru) pojemników, dla których wartość pola datamigracji należy do przedziału obustronnie domkniętego [data-od, data-do]. Tabela 16 Parametry wywołania usługi listaodbiorow. Nazwa Parametru Typ danych Opis 16

18 login String Login użytkownika. haslo String Hasło użytkownika. sektor-nr Integer Numer rejonu, dla którego realizowane są odbiory. data-od 1 DateTime Data migracji danych (na podstawie pola data-migracji), od której interesują Odbiorcę informacje dotyczące zdarzeń odbioru odpadów. Data, od której interesują Odbiorcę zmiany, które zaszły dla Pojemnika. Data podana jest w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO-8601 dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-ddthh:mm:ss+01:00 data-do 1 DateTime Data migracji danych (na podstawie pola data-migracji), do której interesują Odbiorcę informacje dotyczące zdarzeń odbioru odpadów. Data, do której interesują Odbiorcę zmiany, które zaszły dla Pojemnika. Data podana jest w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO-8601 dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-ddthh:mm:ss+01:00 1 zakładamy, że data-od <= data-do. Tabela 17 Atrybuty plików XML zawierających wyniki wywołania metody listaodbiorow. Atrybut Typ danych Czy wymagane Opis odbior-id Integer TAK Identyfikator zdarzenia w Systemie Wykonawcy. data DateTime TAK Data odebrania/nieodebrania pojemnika. Data powinna być podana w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-ddthh:mm:ss+01:00 mgo-id Integer TAK Identyfikator MGO z Systemu Wykonawcy, z którego dokonano odbioru odpadów. wsp-geo-szer Decimal NIE Współrzędne geograficzne odbicia/odbioru. Szerokość geograficzna. Wartość z zakresu [ , ] w formacie: [- ]deg.ddddd. Wymagana dokładność zgodna z formatem to 4 miejsca po przecinku. wsp-geo-dl Decimal NIE Współrzędne geograficzne odbicia/odbioru. Długość geograficzna. Wartość z zakresu [ , ] w formacie: [- ]deg.ddddd. Wymagana dokładność zgodna z formatem to 4 miejsca po przecinku. pojemnik-id Integer TAK Identyfikator pojemnika z Systemu Wykonawcy. rfid String TAK Kod RFID pojemnika. RFID musi mieć postać zapisanego w kodzie szesnastkowym unikalnego kodu binarnego identyfikator. RFID zapisany w kodzie szesnastkowym powinien mieć maksymalną długość 24 znaków. Identyfikator nie powinien być dodatkowo kodowany w żaden inny sposób. odpady-typ Integer TAK Identyfikator typu frakcji z słownika TYPY_ODPADÓW. 17

19 datamodyfikacji DateTime TAK Data modyfikacji danych dotyczących zdarzenia odbioru odpadów w Systemie Wykonawcy. Data powinna być podana w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-ddthh:mm:ss+01:00 typ-modyfikacji Integer TAK Typ dokonanych zmian z słownika TYP_MODYFIKACJI_DANYCH. Odbiorów nie można archiwizować. data-migracji DateTime TAK Data zarejestrowania informacji w Systemie Wykonawcy jako gotowej do pobrania. Data powinna być podana w formacie Data i Czas z przesunięciem względem czasu UTC zgodnie ze standardem ISO dla strefy czasowej Warszawa, Polska (CET): yyyy-mm-ddthh:mm:ss+01:00 status Integer TAK Identyfikator statusu odbioru z słownika STATUS_ODBIORU. uwagi String NIE Lista identyfikatorów z słownika UWAGI. notatka String NIE Dodatkowe uwagi. W sytuacji, gdy zmienione zostały dane zdarzenia odbioru odpadów należy przesłać: aktualne dane po zmianie, wartość data-modyfikacji, czyli chwilę w której zaszły zmiany, wartość data-migracji, czyli chwilę w której zmiany zostały zarejestrowane w Systemie Wykonawcy, jako typ-modyfikacji podać wartość 1. W sytuacji, gdy przesyłane są dane o nowym zdarzeniu odbioru odpadów należy przesłać: aktualne dane nowego pojemnika, wartość data-modyfikacji, czyli chwilę w której został utworzony nowy harmonogram, wartość data-migracji, czyli chwilę w której zmiany zostały zarejestrowane w Systemie Wykonawcy, jako typ-modyfikacji podać wartość 2. Ważne jest rozróżnienie dwóch dat: data-modyfikacji i data-migracji. W systemach rozproszonych może dojść do sytuacji, że z uwagi na czasowy brak komunikacji z serwerem data modyfikacji danych nie musi być datą tożsamą z datą zarejestrowania ich w Systemie Wykonawcy. Z punktu widzenia Zamawiającego odbierającego dane z Systemu Wykonawcy istotne jest posiadanie informacji kiedy dane zostały faktycznie zarejestrowane w Systemie Wykonawcy jako nowe i gotowe do pobrania. Tabela 18 Przykładowa struktura XML odpytania usługi listaodbiorow. listaodbiorow XML Przykład i struktura odpytania usługi <zapytanielistaodbiorow> <data-do> t06:34:20+01:00</data-do> <data-od> t05:30:23+01:00</data-od> <haslo>f/r5jy2]pt]%aevc</haslo> 18

20 <sektor-nr>1</sektor-nr> </zapytanielistaodbiorow> Tabela 19 Przykładowa struktura XML odpowiedzi z metody listaodbiorow. listaodbiorow XML - Przykład i struktura <listaodbiorow xmlns:xs=" <odbior id="1"> <odbior-id>342</odbior-id> <data> t05:12:54+01:00</data> <mgo-id>12</mgo-id> <wsp-geo-szer> </wsp-geo-szer> <wsp-geo-dl> </wsp-geo-dl> <pojemnik-id>4512</pojemnik-id> <rfid> ec2e805</rfid> <odpady-typ>0</odpady-typ> <data-modyfikacji> t05:12:54+01:00</data-modyfikacji> <typ-modyfikacji>2</typ-modyfikacji> <data-migracji> t05:12:59+01:00</data-migracji> <status>1</status> <notatka>opóźnienie wynikające z dużego natężenia ruchu</notatka> </odbior> <odbior id="2"> <odbior-id>7286</odbior-id> <data> t05:23:20+01:00</data> <mgo-id>29</mgo-id> <wsp-geo-szer> </wsp-geo-szer> <wsp-geo-dl> </wsp-geo-dl> <pojemnik-id>541</pojemnik-id> <rfid> ec2e817</rfid> <odpady-typ>0</odpady-typ> <data-modyfikacji> t05:23:20+01:00</data-modyfikacji> <typ-modyfikacji>2</typ-modyfikacji> <data-migracji> t05:27:12+01:00</data-migracji> <status>2</status> <uwagi> <uwaga>4</uwaga> <uwaga>8</uwaga> </uwagi> </odbior> </listaodbiorow> 19

21 Początkowe zasilenie danymi Systemu Odbiorcy Lista posesji Zamawiający przekazuje lub udostępnia Wykonawcom listę posesji wraz z unikatowymi identyfikatorami, z których Wykonawcy dokonują odbioru odpadów komunalnych z ramach realizacji Umowy. Plik taki zawiera co najmniej następujące kolumny: Tabela 20 Struktura listy posesji. Nazwa Kolumny Typ danych Id posesji Integer Nazwa kontrahenta String Numer kontrahenta Integer Miasto String Ulica String Nr domu String Nr lokalu String Obręb String Arkusz String Nr działki String Sektor Integer Typ nieruchomości Integer, identyfikator typu nieruchomości na podstawie słownika TYPY_NIERUCHOMOŚCI Lista posesji przesyłana lub udostępniania jest w formie pliku.xls na podane przez Wykonawcę dane kontaktowe. Lista posesji powinna być przesłana do Wykonawcy na wskazane przez niego dane kontaktowe. Słowniki Słowniki, które są używane w celu wymiany informacji zapewniane są przez Zamawiającego i przekazywane do Wykonawcy w formie plików.csv z użyciem średnika jako znaku oddzielającego pola. Wykonawcy mają obowiązek posługiwać się dostarczonymi słownikami. Słowniki powinny być przesłane do Wykonawcy na wskazane przez niego dane kontaktowe. Lista MGO Początkowa lista MGO zostanie pobrana od Wykonawcy jako odpowiedź na odpytanie usługi listzmianmgo z odpowiednimi parametrami. W takiej sytuacji wszystkie MGO uważane są za nowo utworzone i dla każdego MGO należy wypełnić wymagane dane. Istotne jest wypełnienie pól: wartość data-modyfikacji, czyli chwilę w której zostały nadane nowe dane dla MGO. Data ta musi być datą rozpoczęcia usługi w celu realizacji Umowy, wartość data-migracji, czyli chwilę w której zmiany zostały zarejestrowane w Systemie Wykonawcy. Data ta musi być datą rozpoczęcia usługi w celu realizacji Umowy, jako typ-modyfikacji podać wartość 2. 20

22 Lista Pojemników Początkowa lista Pojemników zostanie pobrana od Wykonawcy jako odpowiedź na odpytanie usługi listazmianpojemnikow z odpowiednimi parametrami. W takiej sytuacji wszystkie Pojemniki uważane są za nowo utworzone i dla każdego Pojemnika należy wypełnić wymagane dane. Istotne jest wypełnienie pól: wartość data-modyfikacji, czyli chwilę w której zostały nadane nowe dane dla Pojemnika. Data ta musi być datą uruchomienia usługi w celu realizacji Umowy, wartość data-migracji, czyli chwilę w której zmiany zostały zarejestrowane w Systemie Operatora. Data ta musi być datą uruchomienia usługi w celu realizacji Umowy, jako typ-modyfikacji podać wartość 2. Lista Harmonogramów Początkowa lista Harmonogramów zostanie pobrana od Wykonawcy jako odpowiedź na odpytanie usługi listaaktualnychharmonogramów z odpowiednimi parametrami. W takiej sytuacji wszystkie Harmonogramy uważane są za nowo utworzone i dla każdego Harmonogramu należy wypełnić wymagane dane. Istotne jest wypełnienie pól: wartość data-modyfikacji, czyli chwilę w której zostały nadane nowe dane dla Harmonogramu. Data ta musi być datą rozpoczęcia usługi w celu realizacji Umowy, wartość data-migracji, czyli chwilę w której zmiany zostały zarejestrowane w Systemie Wykonawcy. Data ta musi być datą rozpoczęcia usługi w celu realizacji Umowy, jako typ-modyfikacji podać wartość 2. Aktualizacja danych w trakcie realizacji Umowy W trakcie realizacji Umowy przez Operatora dopuszczalne są zmiany w Słownikach, zmiana danych uwierzytelniających po stronie web serwisu oraz aktualizowanie listy posesji udostępnianej przez Zamawiającego. Dopuszczalne zmiany, dotyczące przekazu danych do Wykonawcy to: lista posesji udostępniana przez Zamawiającego (przesłana w formie pliku.xsl na podane przez Wykonawcę dane kontaktowe), dodanie nowych wpisów w słownikach (przesłane w formacie.csv na podane przez Wykonawcę dane kontaktowe), lista zewnętrznych źródeł do synchronizacji czasu (przesłana w formacie.csv na podane przez Wykonawcę dane kontaktowe). Zmiany, za które odpowiedzialny jest Wykonawca: zmiana danych uwierzytelniających (hasło, użytkownik) dla usług web serwisu (przesłane zaszyfrowanym em na dane kontaktowe Zamawiającego), certyfikaty uwierzytelniające dostęp do usług web serwisu (przesyłane zaszyfrowanym em na dane kontaktowe podane przez Zamawiającego). 21

23 Zarówno Zamawiający jak i Wykonawca wprowadzając zmiany w wyżej wskazanych zakresach powinni przesłać niezbędne informacje drugiej stronie z tygodniowym wyprzedzeniem przed wprowadzeniem zmian. W trakcie takiej wymiany informacji powinno być jasno wyjaśnione, od jakiej daty planowane zmiany wejdą w życie. Załącznik nr 1 Słowniki Słownik typu odpadów Tabela 21 Słownik typu odpadów. Słownik typu odpadów (TYPY_ODPADÓW) Identyfikator Nazwa Opis 1 ZM Odpady zmieszane 2 PAP Frakcja typu Papier 3 TWS Frakcja typu Tworzywa sztuczne 4 SZK Frakcja typu Szkło 5 BIO Frakcja typu Odpady ulegające biodegradacji 6 GAB Odpady wielkogabarytowe 7 CHO Drzewka Świąteczne Przykładowy plik CSV dla słownika TYPY_ODPADÓW: Tabela 22 Plik CSV dla słownika TYPY_ODPADÓW. "1";"ZM";"Odpady zmieszane" "2";"PAP"";"Frakcja typu Papier" "3";"TWS";"Frakcja typu Tworzywa sztuczne" "4";"SZK";"Frakcja typu Szkło" "5";"BIO";"Frakcja typu Odpady ulegające biodegradacji" "6";"GAB";"Odpady wielkogabarytowe" "7";"CHO";"Drzewko Świąteczne" Słownik typów pojemników Tabela 23 Słownik typu pojemników. Słownik typów pojemników (TYPY_POJEMNIKÓW) Identyfikator Nazwa Opis 1 P0012 pojemnik 0,12 m3 2 P0024 pojemnik 0,24 m3 3 P0036 pojemnik 0,36 m3 4 P0077 pojemnik 0,77 m3 5 P0110 pojemnik 1,1 m3 22

24 6 P0250 pojemnik 2,5 m3 7 P0350 pojemnik 3,5 m3 8 P0500 pojemnik 5 m3 9 K0400 kontener 4 m3 10 K0500 kontener 5 m3 11 K0600 kontener 6 m3 12 K0700 kontener 7 m3 13 K0800 kontener 8 m3 14 K1000 kontener 10 m3 15 K1200 kontener 12 m3 16 K1400 kontener 14 m3 17 K1500 kontener 15 m3 18 K1600 kontener 16 m3 19 K1700 kontener 17 m3 20 K2000 kontener 20 m3 21 K2700 kontener 27 m3 22 K3300 kontener 33 m3 23 D0130 pojemnik typu dzwon 1,3 m3 24 D0150 pojemnik typu dzwon 1,5 m3 25 D0170 pojemnik typu dzwon 1,7 m3 26 D0200 pojemnik typu dzwon 2,0 m3 27 D0250 pojemnik typu dzwon 2,5 m3 28 D0350 pojemnik typu dzwon 3,5 m3 29 Z0030 pojemnik podziemny 0,3 m3 30 Z0080 pojemnik podziemny 0,8 m3 31 Z0130 pojemnik podziemny 1,3 m3 32 Z0300 pojemnik podziemny 3,0 m3 33 Z0500 pojemnik podziemny 5,0 m3 34 LUZ odbiór luzem w formie wystawki 35 W0008 Worek 80L 36 W0012 Worek 120L Przykładowy plik CSV dla słownika TYPY_POJEMNIKÓW: Tabela 24 Plik CSV dla słownika TYPY_POJEMNIKÓW. "1";"P0012";"pojemnik 0,12 m3" "2";"P0024";"pojemnik 0,24 m3" "3";"P0036";"pojemnik 0,36 m3" "4";"P0077";"pojemnik 0,77 m3" "5";"P0110";"pojemnik 1,1 m3" "6";"P0250";"pojemnik 2,5 m3" 23

25 "7";"P0350";"pojemnik 3,5 m3" "8";"P0500";"pojemnik 5 m3" "9";"K0400";"kontener 4 m3" "10";"K0500";"kontener 5 m3" "11";"K0600";"kontener 6 m3" "12";"K0700";"kontener 7 m3" "13";"K0800";"kontener 8 m3" "14";"K1000";"kontener 10 m3" "15";"K1200";"kontener 12 m3" "16";"K1400";"kontener 14 m3" "17";"K1500";"kontener 15 m3" "18";"K1600";"kontener 16 m3" "19";"K1700";"kontener 17 m3" "20";"K2000";"kontener 20 m3" "21";"K2700";"kontener 27 m3" "22";"K3300";"kontener 33 m3" "23";"D0130";"pojemnik typu dzwon 1,3 m3" "24";"D0150";"pojemnik typu dzwon 1,5 m3" "25";"D0170";"pojemnik typu dzwon 1,7 m3" "26";"D0200";"pojemnik typu dzwon 2,0 m3" "27";"D0250";"pojemnik typu dzwon 2,5 m3" "28";"D0350";"pojemnik typu dzwon 3,5 m3" "29";"Z0030";"pojemnik podziemny 0,3 m3" "30";"Z0080";"pojemnik podziemny 0,8 m3" "31";"Z0130";"pojemnik podziemny 1,3 m3" "32";"Z0300";"pojemnik podziemny 3,0 m3" "33";"Z0500";"pojemnik podziemny 5,0 m3" "34";"LUZ";"odbiór luzem w formie wystawki" "35";"W0008";"Worek 80L" "36";"W0012";"Worek 120L" Słownik częstotliwości odbioru odpadów Tabela 25 Słownik częstotliwości odbioru odpadów. Słownik częstotliwości odbioru odpadów (TYPY_CZESTOŚCI_ODB) Identyfikator Nazwa Opis 1 T/1 Odbiór odpadów raz w tygodniu 2 T/2 Odbiór odpadów dwa razy w tygodniu 3 T/3 Odbiór odpadów trzy razy w tygodniu 4 T/4 Odbiór odpadów cztery razy w tygodniu 5 T/5 Odbiór odpadów pięć razy w tygodniu 6 T/6 Odbiór odpadów sześć razy w tygodniu 7 2T Odbiór odpadów raz na dwa tygodnie 8 4T Odbiór odpadów raz na cztery tygodnie 9 52T Odbiór odpadów raz na 52 tygodnie 10 M/1 Odbiór odpadów raz w miesiącu 11 26T Odbiór odpadów raz na pół roku 12 2R Odbiór dwa razy w roku 24

26 Przykładowy plik CSV dla słownika TYPY_CZESTOŚCI_ODB: Tabela 26 Plik CSV dla słownika TYPY_CZĘSTOŚCI_ODB. "1";"T/1";"Odbiór odpadów raz w tygodniu" "2";"T/2";"Odbiór odpadów dwa razy w tygodniu" "3";"T/3";"Odbiór odpadów trzy razy w tygodniu" "4";"T/4";"Odbiór odpadów cztery razy w tygodniu" "5";"T/5";"Odbiór odpadów pięć razy w tygodniu" "6";"T/6";"Odbiór odpadów sześć razy w tygodniu" "7";"2T";"Odbiór odpadów raz na dwa tygodnie" "8";"4T";"Odbiór odpadów raz na cztery tygodnie" "9";"52T";"Odbiór odpadów raz na 52 tygodnie" "10";"M/1";"Odbiór odpadów raz w miesiącu" "11";"26T";"Odbiór odpadów raz na pół roku" "12";"2R";"Odbiór dwa razy w roku" Słownik typu nieruchomości Tabela 27 Słownik typu nieruchomości. Słownik typu nieruchomości (TYPY_NIERUCHOMOŚCI) Identyfikator Nazwa Opis 1 Z Zamieszkała 2 N Niezamieszkała 3 M Mieszana Przykładowy plik CSV dla słownika TYPY_NIERUCHOMOŚCI: Tabela 28 Plik CSV dla słownika TYPY_NIERUCHOMOŚCI. "1";"Z";"Zamieszkała" "2";"N";"Niezamieszkała" "3";"M";"Mieszana" Słownik typu zabudowy Tabela 29 Słownik typu zabudowy. Słownik typu zabudowy (TYPY_ZABUDOWY) Identyfikator Nazwa Opis 1 J Jednorodzinna 2 W Wielorodzinna (pow. 2 lokali) 25

27 Przykładowy plik CSV dla słownika TYPY_ZABUDOWY: Tabela 30 Plik CSV dla słownika TYPY_ZABUDOWY. "1";"J";"Jednorodzinna" "2";"W";"Wielorodzinna (pow. 2 lokali)" Słownik statusów odbiorów odpadów Tabela 31 Słownik statusów odbiorów odpadów. Słownik statusów odbiorów odpadów (STATUS_ODBIORU) Identyfikator Nazwa Opis 1 OPO Odbiór pojemnika 2 BPO Brak odbioru Przykładowy plik CSV dla słownika STATUS_ODBIORU: Tabela 32 Plik CSV dla słownika STATUS_ODBIORU. "1";"OPO";"Odbiór pojemnika" "2";"BPO";"Brak odbioru" Słownik uwag Tabela 33 Słownik uwag. Słownik uwag (UWAGI) Identyfikator Nazwa Opis 1 AWP Awaria pojazdu 2 USP Uszkodzony pojemnik 3 BPO Brak pojemnika 4 PNW Pojemnik niewystawiony 5 BTR Brak/uszkodzony transponder 6 NPO Niezgodny pojemnik 7 UDM Uniemożliwiony dojazd do MGO 8 BDO Brak dostępu do pojemnika 9 GNZ Gromadzenie odpadów niezgodne z Regulaminem 10 ZNZ Ostrzeżenie selektywna zbiórka niezgodna z Regulaminem 11 NOD Odpady Niewłaściwe 12 PPO Pusty pojemnik 13 PSP Przesyp 26

28 14 BDE Brak deklaracji 15 INE Inne Przykładowy plik CSV dla słownika UWAGI: Tabela 34 Plik CSV dla słownika UWAGI. "1";"AWP";"Awaria pojazdu" "2";"USP";"Uszkodzony pojemnik" "3";"BPO";"Brak pojemnika" "4";"PNW";"Pojemnik niewystawiony" "5";"BTR";"Brak/uszkodzony transponder" "6";"NPO";"Niezgodny pojemnik" "7";"UDM";"Uniemożliwiony dojazd do MGO" "8";"BDO";"Brak dostępu do pojemnika" "9";"GNZ";"Gromadzenie odpadów niezgodne z Regulaminem" "10";"ZNZ";"Ostrzeżenie selektywna zbiórka niezgodna z Regulaminem" "11";"NOD";"Odpady niewłaściwe" "12";"PPO";"Pusty pojemnik" "13";"PSP";"Przesyp" "14";"BDE";"Brak deklaracji" "15";"INE";"Inne" Słownik typów modyfikacji danych Tabela 35 Słownik typu modyfikacji danych. Słownik typów modyfikacji danych (TYPY_MODYFIKACJI_DANYCH) Identyfikator Nazwa Opis 1 MOD Modyfikacja istniejących danych 2 UTW Utworzenie nowej instancji 3 ARC Archiwizacja Przykładowy plik CSV dla słownika TYPY_MODYFIKACJI_DANYCH: Tabela 36 Plik CSV dla słownika TYPY_MODYFIKACJI_DANYCH. "1";"MOD";"Modyfikacja istniejących danych" "2";"UTW";"Utworzenie nowej instancji" "3";"ARC";"Archiwizacja" Załącznik nr 2 - Pliki XSD Poniżej przedstawiono pliki.xsd opisujące strukturę plików.xml, które powinien przekazywać System Wykonawcy w odpowiedzi na zapytania Systemu Przekazywania Zgłoszeń. 27

29 ListaZmianMgo Tabela 37 Plik xsd opisujący strukturę zapytania do usługi listazmianmgo. listazmianmgo.xsd - zapytanie <xs:schema version="1.0" xmlns:xs=" <xs:element name="zapytanielistazmianmgo" type="zapytanielistazmianmgo"/> <xs:complextype name="zapytanielistazmianmgo"> <xs:sequence> <xs:element name="data-do" type="xs:datetime"/> <xs:element name="data-od" type="xs:datetime"/> <xs:element name="haslo" type="xs:string"/> <xs:element name="login" type="xs:string"/> <xs:element name="sektor-nr" type="xs:int"/> </xs:sequence> </xs:complextype> </xs:schema> Tabela 38 Plik xsd opisujący strukturę odpowiedzi z usługi listazmianmgo. listazmianmgo.xsd - odpowiedź <xs:schema version="1.0" xmlns:xs=" <xs:element name="listaposesji" type="poslist"/> <xs:element name="listazmianmgo" type="listazmianmgo"/> <xs:complextype name="listazmianmgo"> <xs:sequence> <xs:element name="zmianamgo" type="zmianamgo" minoccurs="0" maxoccurs="unbounded"/> </xs:sequence> </xs:complextype> <xs:complextype name="zmianamgo"> <xs:sequence> <xs:element name="mgo-id" type="xs:int"/> <xs:element name="typ-mgo" type="xs:int"/> <xs:element name="typ-zabud" type="xs:int"/> <xs:element name="pos-ids" type="poslist" minoccurs="0"/> <xs:element name="data-modyfikacji" type="xs:datetime"/> <xs:element name="typ-modyfikacji" type="xs:int"/> <xs:element name="data-migracji" type="xs:datetime"/> <xs:element name="czest-odb" type="xs:int"/> </xs:sequence> <xs:attribute name="id" type="xs:int" use="required"/> </xs:complextype> <xs:complextype name="poslist"> <xs:sequence> 28

30 <xs:element name="pos-id" type="xs:int" minoccurs="0" maxoccurs="unbounded"/> </xs:sequence> </xs:complextype> </xs:schema> ListaZmianPojemnikow Tabela 39 Plik xsd opisujący strukturę zapytania do usługi listazmianpojemnikow. listazmianpojemnikow.xsd - zapytanie <xs:schema version="1.0" xmlns:xs=" <xs:element name="zapytanielistazmianpojemnikow" type="zapytanielistazmianpojemnikow"/> <xs:complextype name="zapytanielistazmianpojemnikow"> <xs:sequence> <xs:element name="data-do" type="xs:datetime"/> <xs:element name="data-od" type="xs:datetime"/> <xs:element name="haslo" type="xs:string"/> <xs:element name="login" type="xs:string"/> <xs:element name="sektor-nr" type="xs:int"/> </xs:sequence> </xs:complextype> </xs:schema> Tabela 40 Plik xsd opisujący strukturę odpowiedzi z usługi listazmianpojemnikow. listazmianpojemnikow.xsd - odpowiedź <xs:schema version="1.0" xmlns:xs=" <xs:element name="listazmianpojemnikow" type="listazmianpojemnikow"/> <xs:complextype name="listazmianpojemnikow"> <xs:sequence> <xs:element name="zmianapojemnika" type="zmianapojemnika" minoccurs="0" maxoccurs="unbounded"/> </xs:sequence> </xs:complextype> <xs:complextype name="zmianapojemnika"> <xs:sequence> <xs:element name="pojemnik-id" type="xs:int"/> <xs:element name="mgo-id" type="xs:int"/> <xs:element name="rfid" type="xs:string"/> <xs:element name="odpady-typ" type="xs:int"/> <xs:element name="pojemnik-typ" type="xs:int"/> <xs:element name="data-modyfikacji" type="xs:datetime"/> <xs:element name="typ-modyfikacji" type="xs:int"/> <xs:element name="data-modyfikacji" type="xs:datetime"/> </xs:sequence> <xs:attribute name="id" type="xs:int" use="required"/> 29