Čo je balenie v ABRA Flexi?

Balenie je z technického pohľadu viac merných jednotiek príslušnej položky naraz. Vo Flexi to nie je inak. Balením sa vo Flexi rozumie násobok mernej jednotky.

Keďže balenie sa vždy viaže ku konkrétnej cenovej položke, práve cenníková položka je miestom, kde balenie nastaviť. Každá položka môže mať definovaných až 5 typov balenia.

Teraz si ukážeme, ako vytvoriť balenie pomocou REST API, a ďalej ako balenie použiť na základných dokladoch.

Tvorba cez REST API

Predstavme si situáciu, keď chceme predávať skrutky aj v balení po 100 kusoch. Máme teda v ABRA Flexi už položku ŠROUBUNI4X50.

Teraz musíme pomocou REST API vytvoriť balenie. Na tvorbu záznamu využijeme metódu POST. Endpoint pre tvorbu balenia je /cenik.xml (.json). kde taktiež nájdeme popis potrebných polí pre tvorbu balenia (analogicky pre 2. – 5. balenie):

baleniNazev1 - názov/označenie balenia
baleniMj1 - počet merných jednotiek v balení
baleniEan1 - EAN balenia (identifikátor balenia)

Ukážeme si na príklade:

POST https://demo.flexibee.eu/c/demo/cenik.xml

Telo požiadavky v XML:

<?xml version="1.0"?>
  <winstrom version="1.0">
    <cenik>  
     <id>code:ŠROUBUNI4X50</id>
     <baleniNazev1>ŠROUBUNI4X50BAL100</baleniNazev1>
     <baleniMj1>100</baleniMj1>
     <baleniEan1>8591230432100</baleniEan1>
    </cenik>
</winstrom>

Po úspešnom vytvorení balenia je odpoveď API aktualizácia cenníka code:ŠROUBUNI4X50. Vytvorili sme 1. balenie s názvom ŠROUBUNI4X50BAL100, ktoré obsahuje 100 ks položky ŠROUBUNI4X50. Cena balenia je vypočítaná automaticky vynásobením predajnej ceny položky, teda 90 Kč.

Teraz môžeme balenie použiť na dokladoch.

Použitie cez REST API

Na vloženie balenia na doklad je nutné balenie identifikovať. Identifikácia je možná pomocou zadaného EANu alebo podľa poradia na cenníkovej položke. Balenie v našom príklade má ID = 1, EAN = 8591230432100. Balenie nie je možné identifikovať pomocou poľa "Kód alebo názov".

Poznámka: EAN musí byť jedinečný. V prípade, že v ABRA Flexi nemáte jedinečné EANy, systém pri vyhľadávaní balenia nájde prvú zhodu a tú vyhodnotí ako správnu. Nie je možné zabezpečiť iný stav, pokiaľ EANy nie sú jedinečné.

Predstavme si teda príklad, keď si zákazník objedná 3 balenia našich skrutiek. Na tvorbu objednávky opäť využijeme metódu POST. Endpoint pre tvorbu je /objednavka-prijata.xml (.json). Polia potrebné na určenie balenia na položke objednávky sú uvedené opäť v popise evidencie položka prijatej objednávky:

baleniId - identifikácia balenia pomocou ID (poradie v definícii cenníkovej položky) alebo EANu
mnozBaleni - množstvo objednaných balení

Príklad:

POST https://demo.flexibee.eu/c/demo/objednavka-prijata.xml

Telo požiadavky:

<winstrom version="1.0">
  <objednavka-prijata>
    <typDokl>code:OBP</typDokl>
    <firma>code:WINSTROM</firma>
    <polozkyDokladu>
     <objednavka-prijata-polozka>
      <cenik>code:ŠROUBUNI4X50</cenik>
      <sklad>code:SKLAD</sklad>
      <typPolozkyK>typPolozky.katalog</typPolozkyK>
      <baleniId>1</baleniId>
      <!--analogicky dle EAN
       <baleniId>ean:8591230432100<baleniId>
      -->
     <mnozBaleni>3</mnozBaleni>
    </objednavka-prijata-polozka>
   </polozkyDokladu>
 </objednavka-prijata>
</winstrom>

Pomocou tejto požiadavky sme vytvorili objednávku na 3 balenia po 100 ks položky ŠROUBUNI4X50. Celková cena a počet kusov položky objednávky sa vypočíta automaticky, teda 300 ks skrutiek za 270 Kč (300 ks x 0,90 Kč).

Analogicky ako v prijatej objednávke sa s balením pracuje aj v ďalších obchodných a skladových dokladoch, teda s využitím uvedených dvoch polí – baleniID a mnozBaleni. Ak využijete realizáciu objednávky, nemusíme sa ďalej o balenie starať, realizácia spracuje balenie automaticky. Dôjde k fakturácii 3 balení a k výdaju 300 ks skrutiek.

Na príklade realizácie objednávky skladovým dokladom si ukážeme výdaj skrutiek.

POST https://demo.flexibee.eu/c/demo/objednavka-prijata.xml

Telo požiadavky:

<?xml version="1.0"?>
<winstrom version="1.0">
  <objednavka-prijata>
   <id>code:OBP0004/2021</id>
   <realizaceObj type="skladovy-pohyb">
   <polozkyObchDokladu>
    <polozka>
      <cisRad>1</cisRad>
      <mj>300</mj>
    </polozka>
   </polozkyObchDokladu>
  </realizaceObj>
 </objednavka-prijata>
</winstrom>

Uvedený príklad vytvorí výdajku na 300 ks položky ŠROUBUNI4X50. Systém automaticky vyhodnotí, že sa jednalo o balenie. Teda pri realizácii je nutné zadať celkové množstvo zdrojovej položky.