Realizace objednávky

Přes REST API lze realizovat objednávku a to takto:

  • faktura vydaná (faktura-vydana)
  • faktura přijatá (faktura-prijata)
  • skladový pohyb (skladovy-pohyb)
  • prodejka (prodejka)

Lze určit typ dokladu (typDokl), datum vystavení (datVyst) a sklad (sklad). Pokud nejsou uvedeny, použije se výchozí typ dokladu z objednávky a aktuální datum.

Můžete také určit zda se mají při nedostatku zboží generovat požadavky na výdej (<generovatPozadavky>true</generovatPozadavky>)

Objednávku lze realizovat na několikrát (např. dle dostupnosti zboží). Informace o stavu realizace je možné získat z položek objednávky.

Realizace objednávky byla navrhovaná především pro čtečky čárového kódu. Proto je jedno zda je zadáno výrobní číslo nebo zboží (pouze EAN). EAN se uvádí buď přímo a nebo s prefixem ean:. Doporučujeme používat tento prefix při zadání EANu.

Vytvářenému dokladu je možné přiřadit externí identifikátor, pomocí kterého je možné ho ještě v průběhu stejného importu modifikovat.

Příklady XML

Základní jednoduchá realizace dle identifikace zboží:

<objednavka-prijata>
  <id>code:OBP0004/2012</id>
  <realizaceObj type="faktura-vydana"> 
    <polozkyObchDokladu>
      <polozka>
        <cenikNeboVyrobniCislo>123skl</cenikNeboVyrobniCislo> 
        
        <mj>1</mj>   
      </polozka>
    </polozkyObchDokladu>
  </realizaceObj>
</objednavka-prijata>

Realizace dle identifikace řádku v objednávce:

<objednavka-prijata>
  <id>code:OBP0004/2012</id>
  <realizaceObj type="faktura-vydana"> 
    <polozkyObchDokladu>
      <polozka>
        <cisRad>1</cisRad>  <!-- číslo řádky v objednávce -->
        <!-- lze také použít externí identifikátor řádku <id>extId...</id> -->
        <mj>1</mj>
      </polozka>
    </polozkyObchDokladu>
  </realizaceObj>
</objednavka-prijata>

Kompletní struktura XML:

<objednavka-prijata>
  <id>code:OBP0004/2012</id>
  <realizaceObj type="faktura-vydana">  <!-- faktura-vydana/prodejka/faktura-prijata/skladovy-pohyb-->
    <id>ext:...</id> <!-- nepovinné externí id vytvořeného dokladu -->
    <typDokl>...</typDokl>
    <sklad>...</sklad>
    <generovatPozadavky>true</generovatPozadavky> <!-- nepovinné -->
    <odpocetZaloh>true</odpocetZaloh> <!-- u vydané faktury říká zda se mají odpočítat navázané zálohy -->
    <cisDosle>...</cisDosle> <!-- u přijaté faktury povinné -->
    <datSplat>2013-01-01</datSplat> <!-- u přijaté faktury povinné -->
    <polozkyObchDokladu>
      <polozka>
        <!-- nasleduji tri zpusoby identifikace polozky -->
        <!-- <id>extId...</id> -->
        <!-- <cisRad>1</cisRad> -->
        <cenikNeboVyrobniCislo>123skl</cenikNeboVyrobniCislo>  <!-- EAN ceníku nebo výrobní číslo -->
        
        <mj>1</mj>    <!-- pokud se najde podle výrobního čísla z předcházející řádky je to vždy 1 -->
        <vyrobniCisla>   <!-- použito pokud se nenajde podle výrobního čisla - tj. u přijatých faktur je nutné zadat výrobní čísla vždy pokud jsou vyžadovány -->
          <vyrobniCislo>123</vyrobniCislo>
          <vyrobniCislo>456</vyrobniCislo>
        </vyrobniCisla>
      </polozka>
    </polozkyObchDokladu>
  </realizaceObj>
</objednavka-prijata>

Ukázka použití JSON:

{  
  "flexibee":{  
    "objednavka-prijata":{  
      "id":"code:OBP0004/2012",
      "realizaceObj@type":"faktura-vydana",
      "realizaceObj":{  
        "typDokl":"code:FAKTURA",
        "polozkyObchDokladu":[  
          {  
              "cisRad":1,
              "mj":"1"
          }
        ]
      }
    }
  }
}

Tvorba zálohy

Dále lze z objednávky přijaté vytvořit zálohovou fakturu.

<objednavka-prijata>
  <id>code:OBP0004/2012</id>
  <tvorbaZalohy> 
    <id>ext:...</id> <!-- nepovinné externí id vytvořeného dokladu -->
    <typDokl>...</typDokl>
    <castka>...</castka>   <!-- částka vytvářené zálohy -->
    <procent>...</procent> <!-- alternativní zadání částky zálohy zadáním procent z celkové částky objednávky -->
  </tvorbaZalohy>
</objednavka-prijata>