API napojení

Pro automatické pokládání objednávek přímo do našeho systému, bez nutnosti využívat B2B rozhranní, je připraveno API rozhranní s jednoduchou technickou specifikací, kde stačí zasílat informace o objednávce ve formátu kód produktu; množství.

Jako registrovaný zákazník můžete v našem systému zakládat objednávky bezobslužně skrze objednávkový automat. K obsluze slouží jednoduché REST API.

POST http://www.spvelkoobchod.cz/import/<token>

Systém přijímá data v proměnné order ve formátu XML následující struktury:

<?xml version="1.0"?>
<xml>
  <Options>
    <Currency>EUR</Currency>
    <Transport_ID>1</Transport_ID>
  </Options>
  <Items>
    <Item>
      <code>1214</code>
      <amount>8</amount>
    </Item>
    <Item>
      <code>5841214</code>
      <amount>1</amount>
    </Item>
    <Item>
      <code>02000230</code>
      <amount>3</amount>
    </Item>
  </Items>
</xml>

Po zpracování je na výstup zobrazen JSON obsahující výsledný status a případně výčet produktů, které nebyly vloženy do objednávky. Vzor výstupu:

{"status":"OK","items":[]}

Všechny požadované produkty byly vloženy do objednávky, objednávka byla přijata v plném rozsahu.

{"status":"OK","items":[{"code":"02012121","amount":2},{"code":"09212121","amount":1},{"code":"12943423","amount":3}]}

Z požadovaných produktů nebyly některé vůbec nebo zcela objednány a jejich seznam je součástí odpovědi. Hodnota "amount" znamená počet NEOBJEDNANÝCH kusů. 

{"status":"NOT OK"}

Žádný z produktů nebyl vložen do objednávky - objednávka nebyla založena. Pravděpodobně chyba v integraci.