Format XML do importu kosztorysu
Jak przygotować plik XML z listą materiałów do wczytania w module kosztorysowania. Opisana struktura jest otwarta — wygenerujesz ją z arkusza kalkulacyjnego lub z eksportu zestawienia materiałów z dowolnego programu projektowego.
Ogólna struktura pliku
Plik musi być poprawnym dokumentem XML zapisanym w kodowaniu UTF-8 (dopuszczalny jest BOM). Korzeń dokumentu to element <pozycje>, a każda pozycja materiałowa to element <pozycja>z danymi zapisanymi jako atrybuty XML.
<?xml version="1.0" encoding="UTF-8"?>
<pozycje>
<pozycja
slup="T1"
nazwa="Uchwyt przelotowy ASXSn COT-37"
typ="COT-37"
jm="szt"
ilosc="12"
/>
<pozycja
slup="T2"
nazwa="Przewód AsXSn 4x70+25mm2"
typ="ASXSN-4x70"
jm="m"
ilosc="450"
/>
<pozycja
slup="T1"
nazwa="Zacisk dwustronny ZD-50"
kod="ZD-50"
jm="szt"
ilosc="4"
/>
</pozycje>Atrybuty elementu <pozycja>
| Atrybut | Wymagany | Opis | Przykład |
|---|---|---|---|
| nazwa | tak | Pełna nazwa materiału lub elementu. Używana do automatycznego mapowania kategorii i dopasowania cen. | Uchwyt przelotowy COT-37 |
| jm | tak | Jednostka miary. Akceptowane wartości: szt, m, mb, kg, kpl i inne. | szt |
| ilosc | tak | Ilość materiału. Liczba całkowita lub dziesiętna – dopuszczalny zarówno przecinek, jak i kropka jako separator dziesiętny. | 12 lub 450,5 |
| typ | nie | Kod katalogowy materiału (preferowany). Używany do wyszukiwania ceny w bazie cenników. Odpowiada symbolowi katalogowemu producenta. | COT-37 |
| kod | nie | Alternatywny atrybut kodu katalogowego. Używany gdy brak atrybutu typ. System sprawdza kolejno: typ → kod → indeks → symbol → code. | ZD-50 |
| indeks / symbol / code | nie | Dodatkowe alternatywy dla kodu katalogowego. Przydatne przy eksporcie z różnych systemów. | COT37 |
| slup | nie | Oznaczenie słupa/punktu montażowego w projekcie linii. Informacyjny – nie wpływa na kalkulację, ale pomaga w identyfikacji pozycji. | T1, T2, S3 |
Jak działa automatyczne dopasowanie cen
Po wczytaniu pliku system próbuje dopasować każdą pozycję do ceny z aktywnych cenników dostawców. Dopasowanie odbywa się w dwóch krokach:
Dokładne dopasowanie (wysoka pewność)
Kod katalogowy + jednostka miary muszą dokładnie pasować do pozycji w cenniku. Spacje w kodzie są ignorowane — COT 37 i COT37 traktowane tak samo.
Dopasowanie po kodzie (średnia pewność)
Jeśli jednostka się nie zgadza, system dopasowuje tylko po kodzie katalogowym. Cena zostanie przypisana, ale warto zweryfikować ją ręcznie.
Brak dopasowania – wycena ręczna
Pozycja zostaje dodana bez ceny. Przed kalkulacją należy uzupełnić cenę ręcznie w edytorze materiałów.
Automatyczne mapowanie kategorii
System rozpoznaje kategorię materiału na podstawie słów kluczowych w nazwie i kodzie. Poniżej lista rozpoznawanych fraz:
| Kategoria | Podkategoria | Rozpoznawane frazy |
|---|---|---|
| Osprzęt do linii nn | zaciski | zacisk, slip, sliw |
| Osprzęt do linii nn | uchwyty | uchwyt |
| Osprzęt do linii nn | osprzęt stalowy | hak, klamerka, taśma, śruba |
| Osprzęt do linii nn | złączki | złączka, sj |
| Osprzęt do linii nn | aparaty | rozłącznik, sz |
| Osprzęt do linii SN | izolatory | izolator |
| Osprzęt do linii SN | uchwyty | so115, so85 |
| Osprzęt do linii SN | zaciski | sew, slw |
| Przewody i kable | niskie napięcie | asxsn |
| Przewody i kable | średnie napięcie | bll, blx, excel, axces |
| Przewody i kable | przewody | przewód, kabel |
| Żerdzie | betonowe | żn, słup, strunobetonowa |
| Elementy ustojów | prefabrykowane | płyta |
| Konstrukcje | do słupów | poprzecznik, obejma, wysięgnik |
| Uziemienia | materiały | pręt, uziemia, bednarka |
Pozycje niedopasowane do żadnej kategorii trafiają do kategorii Inne / Nieokreślona.
Kompletny przykład pliku
Przykład pliku XML reprezentującego zestawienie materiałów dla odcinka linii napowietrznej nN:
<?xml version="1.0" encoding="UTF-8"?> <pozycje> <!-- Przewód główny --> <pozycja slup="T1" nazwa="Przewód AsXSn 4x70+25mm2" typ="ASXSN-4x70" jm="m" ilosc="480" /> <!-- Osprzęt nośny --> <pozycja slup="T1" nazwa="Uchwyt przelotowy AsXSn COT-37" typ="COT-37" jm="szt" ilosc="8" /> <pozycja slup="T2" nazwa="Uchwyt odciągowy AsXSn DA-37" typ="DA-37" jm="szt" ilosc="4" /> <pozycja slup="T3" nazwa="Uchwyt narożny AsXSn KT-37" typ="KT-37" jm="szt" ilosc="2" /> <!-- Zaciski --> <pozycja slup="T1" nazwa="Zacisk dwustronny ZD-95" typ="ZD-95" jm="szt" ilosc="6" /> <pozycja slup="T1" nazwa="Zacisk jednostronny ZJ-50" typ="ZJ-50" jm="szt" ilosc="4" /> <!-- Konstrukcje --> <pozycja slup="T1" nazwa="Poprzecznik stalowy PS-600" typ="PS-600" jm="szt" ilosc="4" /> <!-- Słupy --> <pozycja slup="T1" nazwa="Żerdź betonowa ŻN-10/400" typ="ZN10" jm="szt" ilosc="5" /> <!-- Uziemienie --> <pozycja slup="T1" nazwa="Bednarka stalowa 30x4" kod="BED304" jm="m" ilosc="120" /> </pozycje>
Wskazówki i typowe problemy
Podawaj kody katalogowe producenta
Im dokładniejszy kod w atrybucie typ lub kod, tym większa szansa na automatyczne dopasowanie ceny z cennika. Kod powinien odpowiadać symbolowi z katalogu producenta (np. COT-37, ZD-95).
Spójne jednostki miary
Używaj tych samych jednostek co w cenniku producenta. Dla osprzętu to zazwyczaj szt, dla przewodów m lub mb. Rozbieżność jednostek obniża pewność dopasowania do poziomu średniego.
Duplikaty pozycji
Jeśli ta sama pozycja (identyczna nazwa + kod + jednostka) pojawi się więcej niż raz, system pominie duplikat i zgłosi ostrzeżenie. Połącz ilości przed eksportem.
Brak atrybutów nazwa / jm / ilosc
Te trzy atrybuty są wymagane. Pozycje z brakującymi wartościami zostaną pominięte i pojawią się w liście ostrzeżeń po imporcie.
Eksport z programu projektowego
Jeżeli Twój program do projektowania linii potrafi wyeksportować zestawienie materiałów do XML, wystarczy dopasować nazwy atrybutów do opisanych wyżej. Import akceptuje pliki bez dodatkowych modyfikacji, o ile struktura się zgadza.
Gotowy plik? Zaimportuj do kosztorysu
Wczytaj plik XML w module kosztorysowania – system automatycznie dopasuje materiały do cenników i obliczy koszt inwestycji.
Przejdź do kosztorysu →