Táto téma Pomocníka obsahuje formáty súborov, ktoré sa používajú pri komunikácii systému OBERON s off-line internetovým obchodom.
Každý súbor importu alebo exportu obsahuje hlavičku identifikujúcu súbor systému OBERON a nastavenia konkrétneho súboru.
Formát XML
<?xml version="1.0" encoding="utf-8"?> <OBERON> <Header>
<DocumentType>1050</DocumentType> <!-- Identifikátor typu súboru v programe OBERON - Agenda firmy, číselné vyjadrenie -->
<DocumentTypeText>Import objednávok</DocumentTypeText> <!-- Identifikátor typu súboru - pomenovanie, je určené len pre prehľadnosť -->
<DocumentDateTime>10.05.2010 11:28</DocumentDateTime> <!-- Dátum vytvorenia súboru -->
<CompanyName>Demo reštaurácia</CompanyName> <!-- Názov firmy z údajov ktorej bol súbor vytvorený -->
<OBERONVersion>Apríl/2010</OBERONVersion> <!-- Verzia programu OBERON v akej bol vytvorený -->
<OBERONVersionDB>103</OBERONVersionDB> <!-- Číslo verzie databázy firmy -->
</Header>
<!--
Zoznam tagov nastavenia súboru (<Settings>) sa líši v závislosti od typu importovaného súboru.
Príklad súboru pre import objednávok:
-->
<Settings>
<Type>1</Type> <!-- Typ importu súboru -->
<TypeText>Všetky</TypeText> <!-- Textová hodnota typu importu súboru -->
</Settings>
<Data>
<OrdersReceived> <!-- Identifikátor skupiny objednávok - nový element -->
...
...
...
</OrdersReceived> <!-- ukončenie skupiny objednávok - nový element -->
</Data>
</OBERON>
Formát CSV
1050|text|11.05.2020|Demo reštaurácia API|Máj/2020 Beta2|506
1|Import objednávok
Obecný formát XML
Príklad XML súboru:
<?xml version="1.0" encoding="utf-8"?> <OBERON> <Header> <DocumentType>1000</DocumentType> <DocumentTypeText>Export skladových položiek pre internetový obchod</DocumentTypeText> <DocumentDateTime>09.12.2014 18:13:21</DocumentDateTime> <CompanyName>Demo Hotel</CompanyName> <User>System</User> <OBERONVersion>November/2014 Beta2</OBERONVersion> <OBERONVersionDB>232</OBERONVersionDB> <Description> </Description> </Header> <Settings> <Type>1</Type> <Type_Text>Export skladových položiek</Type_Text> <Export_StockCards_Settings>1</Export_StockCards_Settings> <Export_StockCards_Settings_Text>Všetky</Export_StockCards_Settings_Text> <Export_StockCards_Images>0</Export_StockCards_Images> </Settings> <Data> <StockCard IDNum="10775"> <IDNum_Stock>5</IDNum_Stock> <IDnumSupplier>0</IDnumSupplier> <Number>00010</Number> <Name>Tričko Respect</Name> <Unit>ks</Unit> <Amount>80</Amount> <VAT_Rate>20</VAT_Rate> <BarCodes> </BarCodes> <CashRegister_Code> </CashRegister_Code> <TreeCategories>\Akcia\|\Oblečenie\Dámske tričká\</TreeCategories> <IShop_Name>Tričko dámske - Respect</IShop_Name> <IShop_Description><![CDATA[Dámske tričko s potlačou Respect. Dievča so zbraňou vzbudzujúca rešpekt.]]></IShop_Description> <IShop_ExtendedDescription><![CDATA[<p>Veľmi kvalitné tričko univerzálneho strihu.</p> <p>Motív: technológia sieťotlače, motív nežehliť.</p>]]></IShop_ExtendedDescription> <IShop_DeliveryTerm>1 deň</IShop_DeliveryTerm> <IShop_Producer>BetaTextil, s.r.o.</IShop_Producer> <IShop_New>1</IShop_New> <IShop_SaleOut>0</IShop_SaleOut> <IShop_Unavailable>0</IShop_Unavailable> <IShop_WWW>www.betatextil.sk</IShop_WWW> <IShop_Discount>10</IShop_Discount> <IShop_Discount_Availability>15.12.2014</IShop_Discount_Availability> <Catalog>55478555</Catalog> <Guarantee_Period_Unit>3</Guarantee_Period_Unit> <Guarantee_Period_Value>2</Guarantee_Period_Value> <Stock_Location>Sklad B</Stock_Location> <Stock_Group>Tričká</Stock_Group> <Unit_Weight>0</Unit_Weight> <Unit_Weight_Unit>g</Unit_Weight_Unit> <Classification_Production> </Classification_Production> <Price_Discount_Flag>3</Price_Discount_Flag> <PriceActionIn_Text_Additional> </PriceActionIn_Text_Additional> <Price_Supply_Unit>3</Price_Supply_Unit> <Price1_WithoutVAT>12.5</Price1_WithoutVAT> <Price1_WithVAT>15</Price1_WithVAT> <Price2_WithoutVAT>11.667</Price2_WithoutVAT> <Price2_WithVAT>14</Price2_WithVAT> <Price3_WithoutVAT>10.833</Price3_WithoutVAT> <Price3_WithVAT>13</Price3_WithVAT> <Price4_WithoutVAT>10</Price4_WithoutVAT> <Price4_WithVAT>12</Price4_WithVAT> <IShop_Images>tricko-respect-damske.jpg|tricko-respect-damske2.jpg</IShop_Images> <IShop_FileRepository>Cenník pult_2014.pdf</IShop_FileRepository> <Variants> <Item IDNum="1"> <IDNumStock>5</IDNumStock> <IDNumStockCard>10775</IDNumStockCard> <Name>Farba: Čierna; Veľkosť: XL</Name> <Notice> </Notice> <CatalogNumber> </CatalogNumber> <Barcode>820044550555</Barcode> <Amount>50</Amount> <AmountMinimal>0</AmountMinimal> <AmountMaximal>0</AmountMaximal> <Attributes> <Item IDNum="1"> <Name>Farba</Name> <Notice> </Notice> <ValueType>16</ValueType> <Value>255;0;0;0</Value> <ValueColorName>Čierna</ValueColorName> </Item> <Item IDNum="2"> <Name>Veľkosť</Name> <Notice> </Notice> <ValueType>1</ValueType> <Value>XL</Value> </Item> </Attributes> </Item> <Item IDNum="2"> <IDNumStock>5</IDNumStock> <IDNumStockCard>10775</IDNumStockCard> <Name>Farba: Ružová; Veľkosť: XL</Name> <Notice> </Notice> <CatalogNumber> </CatalogNumber> <Barcode>820044550554</Barcode> <Amount>30</Amount> <AmountMinimal>0</AmountMinimal> <AmountMaximal>0</AmountMaximal> <Attributes> <Item IDNum="3"> <Name>Farba</Name> <Notice> </Notice> <ValueType>16</ValueType> <Value>255;255;128;255</Value> <ValueColorName>Ružová</ValueColorName> </Item> <Item IDNum="2"> <Name>Veľkosť</Name> <Notice> </Notice> <ValueType>1</ValueType> <Value>XL</Value> </Item> </Attributes> </Item> </Variants> <Parameters> <Item> <IDNumStock>5</IDNumStock> <IDNumStockCard>10775</IDNumStockCard> <Name>Materiál</Name> <Notice> </Notice> <ParameterUnit> </ParameterUnit> <ValueType>1</ValueType> <Value>100% bavlna, 185g/m2</Value> </Item> <Item> <IDNumStock>5</IDNumStock> <IDNumStockCard>10775</IDNumStockCard> <Name>Maximálna teplota prania</Name> <Notice> </Notice> <ParameterUnit>stupňov</ParameterUnit> <ValueType>5</ValueType> <Value>40</Value> </Item> </Parameters> </StockCard> </Data> </OBERON>
Obecný formát CSV
Nastavenie exportu - riadok č. 2Popis hodnôt:
1|Export skladových položiek|1|Všetky|0|
Popis hodnôt:
Riadok hlavičky objednávky:
- Typ exportu podľa nastavení programu OBERON Center
- Textová hodnota typu exportu
- Nastavenie exportu - napr. či všetky záznamy alebo len zmenené
- Textová hodnota nastavenia exportu
- 0 - Obrázky sa neexportujú, 1 - obrázky sú exportované
6826|82|0|00015|eShop karta 1|ks|-4|19|123456789012|0123|eShop karta 1|Kategoria 1|Podkategoria 1|<p>Popisny text 1 </p><br/><p>Popisny text 2</p><ul><li>vlastnost 1 </li><li>vlastnost 2 </li></ul>|7 dní|Terchová xxx|1|0|0|www.exalogic.sk|3|10. 10. 2010|1-1-home.jpg;1-1-large.jpg||roky|2|||g||0||0|4,664|5,55|4,42|5,26|4,21|5,01|4,076|4,85|
Obecný formát XML
Formát XML je univerzálny formát výmeny dát pre systém OBERON. Vzhľadom na túto skutočnosť je import objednávky univerzálny pre všetky druhy importu, teda aj pre internetový obchod. Pri internetovom obchode však nie je nutné prenášať všetky dáta, ale len údaje potrebné na správne vytvorenie objednávky v OBERON-e.
Formát platný od 01/2025
Formát platný do 12/2024
<?xml version="1.0" encoding="utf-8"?> <OBERON> <Header>
hlavička súboru (vid vyššie)
</Header>
<Settings>
<Type>1</Type> <!-- -->
<TypeText>Všetky</TypeText> <!-- -->
</Settings>
<Data>
<OrdersReceived> <!-- Identifikátor skupiny objednávok - Nový element -->
<Record> <!-- Zmena OrderRecieved od verzie Máj/2012 beta1 -->
<Document_Type>Objednávka</Document_Type> <!-- Typ dokumentu (objednávka/ponuka) -->
<Document_Number>2010VO0001</Document_Number> <!-- Číslo objednávky - číslo je importované v OBERON-e ako externý doklad -->
<Date_Document>12.9.2014</Date_Document> <!-- dátum vytvorenia (dd.mm.rrrr) - Aktualizovené z Date_Evidence -->
<Date_Reservation>1.9.2014</Date_Reservation> <!-- dátum rezervácie (dd.mm.rrrr) -->
<Notice>Poznámka k objednávke</Notice> <!-- Poznámka -->
<Text_BeforeItems>Text pred položkami</Text_BeforeItems> <!-- Text pred položkami -->
<Person_Registered>Jurko Mrkvička</Person_Registered> <!-- objednávku prijal meno - Aktualizované z Person_Accepted -->
<Person_Ordered>Maťko Kapusta</Person_Ordered> <!-- zadávateľ objednávky, objednávajúci meno -->
<Document_Classification>\Objednávky\E-Shop\</Document_Classification> <!-- členenie podľa členení oberon, nie je nutné zadať, ak firma objednávky nečlení -->
<Company> <!-- Informácie o partnerovi -->
<Name>EXALOGIC, s.r.o.</Name> <!-- Pomenovanie partnera/firmy -->
<IdentificationNumber>36421499</IdentificationNumber> <!-- IČO -->
<IdentificationNumber_Tax>2021861127</IdentificationNumber_Tax> <!-- DIČ -->
<IdentificationNumber_VAT>SK2021861127</IdentificationNumber_VAT> <!-- IČDPH -->
<Email></Email> <!-- Email obchodného partnera -->
<Phone_Number></Phone_Number> <!-- Mobilný telefón obchodného partnera-->
<Address_Residence> <!-- Adresa firmy -->
<Street_Name_Full>Bešeňová 189</Street_Name_Full> <!-- Plný názov ulice napr. Pod Mostom 15/7 -->
<Postal_Code>03483</Postal_Code> <!-- PSČ -->
<City>Liptovská Teplá</City> <!-- Obec -->
</Address_Residence>
</Company>
<Transportation> <!-- Informácie o doprave - Aktualizované z Shipping -->
<TransportationTechnique>kuriérska služba</TransportationTechnique> <!-- Typ dopravy, spôsob nap.r - kuriérska služba, osobný odber a iné --> <TransportationType>Nákladné - Ford</TransportationType> <!-- Druh vozidla prevážajúci tovar (automobil, nákladné auto, loď) -->
<TransportationEvidenceNumber>RK-525BE</TransportationEvidenceNumber> <!-- Evidenčná značka vozidla -->
<LoadingDate>12.9.2014</LoadingDate> <!-- Dátum nakládky (dd.mm.rrrr) -->
<LoadingNotice>Poznámka k nakládke</LoadingNotice> <!-- Poznámka k nakládke -->
<LoadingPlace_Name>Nakládka firmy</LoadingPlace_Name> <!-- Miesto nakládky -->
<LoadingPlace_Street>Mostová 12</LoadingPlace_Street> <!-- Ulica miesta nakládky -->
<LoadingPlace_City>Ružomberok</LoadingPlace_City> <!-- Obec miesta nakládky -->
<LoadingPlace_Country>Slovensko</LoadingPlace_Country> <!-- Krajina miesta nakládky -->
<LoadingPlace_Customs>Ružomberok</LoadingPlace_Customs> <!-- Miesto zaclenia -->
<UnloadingDate>12.9.2014</UnloadingDate> <!-- Dátum vykládky (dd.mm.rrrr) -->
<UnloadingNotice>Poznámka k vykládke</UnloadingNotice> <!-- Poznámka k vykládke -->
<UnloadingPlace_Name>Firma EXALOGIC</UnloadingPlace_Name> <!-- Miesto vykládky -->
<UnloadingPlace_Street>Bešeňová 189</UnloadingPlace_Street> <!-- Ulica miesta vykládky -->
<UnloadingPlace_City>Bešeňová</UnloadingPlace_City> <!-- Obec miesta vykládky -->
<UnloadingPlace_Country></UnloadingPlace_Country> <!-- Krajina miesta vykládky -->
<UnloadingPlace_Customs>Ružomberok</UnloadingPlace_Customs> <!-- Miesto vyclenia (odclenia) -->
</Transportation> <!-- Informácie o doprave - Aktualizované z Shipping -->
<Document_PriceValues> <!-- Informácie o celkovej sume objednávky, informácie sú povinné pre kontrolu rekapitulácie DPH na doklade -->
<CurrencyCode>0</CurrencyCode> <!-- Základ dane pri nulovej sadzbe DPH -->
<VAT_Rate_Lower>10</VAT_Rate_Lower> <!-- Základ dane pri nulovej sadzbe DPH -->
<VAT_Rate_Upper>19</VAT_Rate_Upper> <!-- Základ dane pri nulovej sadzbe DPH -->
<Price_VAT_Base_Zero>0</Price_VAT_Base_Zero> <!-- Základ dane pri nulovej sadzbe DPH -->
<Price_VAT_Base_Lower>0</Price_VAT_Base_Lower> <!-- Základ dane pri nižšej sadzbe DPH -->
<Price_VAT_Base_Upper>466.202</Price_VAT_Base_Upper> <!-- Základ dane pri vyššej sadzbe DPH -->
<Price_VAT_Lower>0</Price_VAT_Lower> <!-- Suma dane pri nižšej sadzbe DPH -->
<Price_VAT_Upper>88.538</Price_VAT_Upper> <!-- Suma dane pri vyššej sadzbe DPH -->
<Price_Total>554.74</Price_Total> <!-- Celková suma dokladu (s DPH) -->
</Document_PriceValues>
<!-- Položky objednávok - všetky položky sú kontrolované oproti evidovaným skladovým položkám podľa
čísla skladovej karty v prípade zhody je použitá skladová karta z evidencie. Ak nie je v skladovej evidencii nájdená zhoda
tak je položka importovaná ako neskladová. (Neskladovú položku nie je možné pridať na výdajku!)
-->
<Items>
<Item> <!-- Aktualizované z OrderRecieved_Item -->
<Number>00015</Number> <!-- číslo skladovej karty -->
<Name>eShop karta 1</Name> <!-- Názov skladovej karty -->
<Unit>ks</Unit> <!-- Merná jednotka -->
<VAT_Rate>19</VAT_Rate> <!-- Sadzba DPH -->
<Amount_Unit>1.000</Amount_Unit> <!-- Množstvo podľa základnej mernej jednotky -->
<Price_WithoutVAT_Unit>126.00</Price_WithoutVAT_Unit> <!-- Jednotková cena bez DPH -->
<Price_WithVAT_Unit>149.90</Price_WithVAT_Unit> <!-- Jednotková cena s DPH -->
<Price_WithoutVAT>126.00</Price_WithoutVAT> <!-- Celková cena položky bez DPH -->
<Price_WithVAT>149.90</Price_WithVAT> <!-- Celková cena s DPH -->
<Discount>0</Discount> <!-- Percento zľavy -->
<Price_WithVAT_WithoutDiscount>0</Price_WithVAT_WithoutDiscount> <!-- Celková cena s DPH bez zľavy -->
</Item>
<!-- Položka so zľavou -->
<Item>
<Number>00015</Number>
<Name>eShop karta 1</Name>
<Unit>ks</Unit>
<VAT_Rate>19</VAT_Rate>
<Amount_Unit>3.000</Amount_Unit>
<Price_WithoutVAT_Unit>95.29</Price_WithoutVAT_Unit>
<Price_WithVAT_Unit>113.40</Price_WithVAT_Unit>
<Price_WithoutVAT>340.202</Price_WithoutVAT>
<Price_WithVAT>404.84</Price_WithVAT>
<Discount>10</Discount>
<Price_WithVAT_WithoutDiscount>449.82</Price_WithVAT_WithoutDiscount>
</Item>
</Items>
</Record>
<!-- pokračovanie ďalších objednávok -->
<Record>
...
</Record>
</OrdersReceived> <!-- koniec skupiny objednávok - Nové od verzie Máj/2012 beta1 -->
</Data>
</OBERON>
Obecný formát CSV
1|Import objednávokSamotné objednávky spolu s položkami začínajú riadkom č. 3 súboru importu. Vždy v poradí hlavička objednávky a následne jej položky. Vzhľadom na zachovanie integrity dát systému OBERON sa v hlavičke sumy neuvádzajú, pretože sa automaticky dopočítavajú podľa importovaných položiek.
Riadok hlavičky objednávky:Popis hodnôt:
2010OP0001|05.06.2010|05.06.2010|0|0|423.992|0|80.558|504.55|Poznamka|pred položkami|prijemca|objednavatel|clenenie/podkategoria| Meno|Conex s.r.o.|Panenská 125|12345|Skalica|9874561230|6541237890|SK6541237890|vozidlo firmy| Ford|SK 123KK|súčasti WC|07.5.2010|WCex|Banícka 15|34567|Košice|Colny urad Košice| nakladať opatrne|08.5.2010|Conex s.r.o.|Panenská 125|12345|Skalica|Colný úrad Skalica|Vykladat opatrne
Položka bez zľavy:
00015|eShop karta 1|ks|19|1.000|126.00|149.90|126.000|149.90|0|149.90
Položka so zľavou:
00015|eShop karta 1|ks|19|3.000|95.29|113.40|340.202|404.84|10|449.82