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
<?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