Pomocník systému OBERON
Off-line internetový obchod - formáty súborov
Ďalšie možnosti produktu > Súvisiace produkty > Internetové obchody > Off-line internetový obchod > Off-line internetový obchod - formáty súborov

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.

Základné informácie

Obrázok č. 1: Export vzorového súboru typu XML

Hlavička XML súboru

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

Súbor vo formáte XML musí obsahovať hlavičku, ktorá identifikuje súbor v systéme OBERON. Štruktúra hlavičky (názvy tagov musia byť zhodné). Vzorovú hlavičku obsahuje vzorový súbor XML, ktorý možno získať exportom z OBERON-u (pozri Základné informácie vyššie).

Formát CSV

Hlavička súboru vo formáte CSV sa skladá z dvoch riadkov, ktoré sa nachádzajú na začiatku súboru importu.

Príklad:
1050|text|11.05.2020|Demo reštaurácia API|Máj/2020 Beta2|506
1|Import objednávok
Riadok č. 1:
  1. Identifikátor typu súboru v programe OBERON - Agenda firmy, číselné vyjadrenie
  2. Identifikátor typu súboru - pomenovanie, je určené len pre prehľadnosť pri otvorení súboru v textovom editore (napr. Poznámkovom bloku)
  3. Dátum vytvorenia súboru
  4. Názov firmy, z údajov ktorej bol súbor vytvorený
  5. Verzia OBERON-u, v ktorej bol súbor vytvorený
  6. Číslo verzie databázy firmy

Riadok č. 2 sa líši podľa druhu údajov, ktoré sa nachádzajú v súbore.

Export skladových kariet

Formáty súborov:

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,&nbsp;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

Export skladových kariet vo formáte CSV.
Nastavenie exportu - riadok č. 2
1|Export skladových položiek|1|Všetky|0|
          
Popis hodnôt:
  1. Typ exportu podľa nastavení programu OBERON Center
  2. Textová hodnota typu exportu
  3. Nastavenie exportu - napr. či všetky záznamy alebo len zmenené
  4. Textová hodnota nastavenia exportu
  5. 0 - Obrázky sa neexportujú, 1 - obrázky sú exportované
Riadok hlavičky objednávky:
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|
           Popis hodnôt:
  1. ID - jedinečný identifikátor skladovej karty v evidencii systému OBERON
  2. ID Skladu - jedinečný identifikátor skladu, v ktorom sa skladová karta nachádza
  3. ID Dodávateľa - jedinečný identifikátor dodávateľa
  4. Číslo skladovej karty
  5. Názov skladovej karty
  6. Merná jednotka
  7. Množstvo na skladovej karte
  8. Sadzba DPH
  9. Čiarový kód skladovej karty
  10. Kód na Pokladnici OBERON
  11. Názov skladovej karty v internetovom obchode
  12. Hlavná kategória
  13. Popis položky pre internetový obchod
  14. Doba dodania
  15. Výrobca
  16. Novinka
  17. Výpredaj
  18. Nedostupná v internetovom obchode
  19. WWW produktu
  20. Zľava pre internetový obchod
  21. Platnosť zľavy do dátumu (dd.mm.rrrr)
  22. Katalógové označenie
  23. Záručná doba - text (napr. 2 dni)
  24. Záručná doba - čas hodnota z textu (2)
  25. Umiestnenie v sklade
  26. Skladová skupina
  27. Hmotnosť - jednotková
  28. KP - klasifikácia produkcie
  29. Príznak, či je možné uplatniť zľavu na položku
  30. Ak sú na položku uplatnené 'Zľavy a akcie', tak je tu uvedený text zobrazujúci sa pri predaji, napr. ku 6-tim fľašiam dať 1 pohár zdarma
  31. Jednotková nákupná cena bez DPH
  32. Predajná cena 1 bez DPH
  33. Predajná cena 1 s DPH
  34. Predajná cena 2 bez DPH
  35. Predajná cena 2 s DPH
  36. Predajná cena 3 bez DPH
  37. Predajná cena 3 s DPH
  38. Predajná cena 4 bez DPH
  39. Predajná cena 4 s DPH
  40. Obrázok malý; Obrázok veľký - jednotlivé názvy obrázkov sú oddelené znakom bodkočiarka (;) Ascii znak 59. V súčasnosti program podporuje len dva obrázky

Import objednávok

Formáty súborov:

Obecný formát XML

Formát XML je základný 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.

Súbor so vzorovou štruktúrou objednávky vo formáte XML platný od 01.01.2025 možno získať na základe exportu z knihy Objednávky prijaté (pozri Základné informácie vyššie).

Obecný formát CSV

Formát súboru CSV je textový súbor so štandardnou kódovou stránkou pre stredoeurópske jazyky, typ Windows-1250.
Hodnoty v riadkoch súboru sú oddelené oddeľovacím znakom | (stredník), Ascii znak č. 124. Oddeľovače riadkov sú znaky CRLF - CR (Ascii 13) LF (Ascii 10).

Prvý riadok je hlavička súboru. Druhý riadok je nastavenie súboru, ktoré sa líši podľa typu súboru a dát.

Nastavenia pre import objednávok:
1|Import objednávok
Samotné 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.

Príklad hlavičky objednávky:
Hlavička objednávky je pevnej dĺžky, kde počet hodnôt hlavičky musí byť vždy 34. V prípade, že nie je hodnota známa, je napriek tomu nutné oddeľovač použiť.
Riadok hlavičky objednávky:
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
Popis hodnôt:
  1. Číslo objednávky - toto číslo bude v evidencii importované do poľa 'Externý doklad'
  2. Dátum evidencie (vytvorenia)
  3. Dátum rezervácie
  4. Základ dane pri nulovej sadzbe DPH
  5. Základ dane pri zníženej sadzbe DPH
  6. Základ dane pri základnej sadzbe DPH
  7. Suma dane v zníženej sadzbe DPH
  8. Suma dane vo základnej sadzbe DPH
  9. Celková suma dokladu (s DPH), povinný údaj
  10. Poznámka na objednávke
  11. Text pred položkami
  12. Príjemca objednávky
  13. Meno objednávateľa
  14. Členenie - toto členenie musí vyplývať z nastavení členenia firmy
  15. Používateľ, ktorý objednávku pridal (napr. importoval)
  16. Obchodný partner - Názov firmy alebo meno
  17. Obchodný partner - Ulica
  18. Obchodný partner - PSČ
  19. Obchodný partner - Obec
  20. Obchodný partner - IČO
  21. Obchodný partner - DIČ
  22. Obchodný partner - IČDPH
  23. Spôsob dopravy
  24. Vozidlo - napr. pomenovanie, továrenská značka, vodič
  25. EVČ vozidla podľa spôsobu dopravy
  26. Popis tovaru na dopravu
  27. Dátum nakládky tovaru
  28. Miesto nakládky riadok č. 1 - napr. pomenovanie miesta
  29. Miesto nakládky riadok č. 2 - napr. ulica umiestnenia skladu
  30. Miesto nakládky riadok č. 3 - napr. obec umiestnenia skladu
  31. Miesto nakládky riadok č. 4
  32. Miesto zaclenia
  33. Poznámka pre nakládku
  34. Dátum vykládky
  35. Miesto vykládky riadok č. 1 - napr. pomenovanie miesta
  36. Miesto vykládky riadok č. 2 - napr. ulica dodania tovaru
  37. Miesto vykládky riadok č. 3 - napr. PSČ, obec dodania
  38. Miesto vykládky riadok č. 4 - napr. GPS súradnice
  39. Miesto vyclenia tovaru
  40. Poznámka pre vykládku


Príklad položky objednávky:
Položka objednávky je pevnej dĺžky, kde počet hodnôt položky musí byť vždy 8 Číselné hodnoty, ktoré nie sú známe, obsahujú hodnotu 0 (nula).
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        
       
  1. Číslo skladovej karty - v prípade, že sa nezhoduje so žiadnou existujúcou skladovou kartou, v evidencii je importovaná položka neskladová (neskladovú položku nie je možné preniesť, napr. do výdajky).
  2. Názov položky - nemusí sa zhodovať s názvom skladovej karty, v takom prípade je však pri nájdení zhody podľa čísla prepísaný názvom na skladovej karte.
  3. Merná jednotka
  4. Sadzba DPH
  5. Množstvo
  6. Cena za MJ bez DPH
  7. Cena za MJ s DPH
  8. Suma celkom bez DPH
  9. Suma celkom s DPH
  10. Zľava v percentách
  11. Celková cena za položku pred zľavou - pri zľave sa z celkovej sumy s DPH pred zľavou spätne dopočítavajú všetky ostatné sumy
Príbuzné témy
Off-line internetový obchod (export/import súborov)
Nastavenie komunikácie OBERON-u s off-line internetovým obchodom

EXALOGIC, s.r.o., www.exalogic.sk

20. 1. 2025