Preskoči na glavno vsebino

Tvorba ponuky/objednávky z dopytu/ponuky - REST API

REST API - tvorba ponuky z dopytu / tvorba objednávky z ponuky

Avtor: Petr Pech

Cez REST API je možné z dopytu vytvoriť ponuku a z dopytu aj ponuky vytvoriť objednávku. Slúžia na to elementy nabidni a objednej, ktoré uvediete v tele importovaného dokladu.


Vytvorenie ponuky z dopytu

Do tela prijatého dopytu pridáte element nabidni:

<?xml version="1.0"?>
<winstrom version="1.0">
<poptavka-prijata>
<id>code:POP0001/2024</id>
<nabidni>
<!-- nepovinný externí identifikátor vytvořené nabídky -->
<id>ext:NABIDKA</id>
<!-- typ dokladu vytvořené nabídky; pokud není zadaný, bere se z nastavení -->
<typDokl>code:NAV</typDokl>
</nabidni>
</poptavka-prijata>
</winstrom>


Vytvorenie objednávky z dopytu alebo ponuky

Obdobne slúži element objednej. Uviesť ho možno tak pri prijatom dopyte, ako aj pri vydanej ponuke:

<?xml version="1.0"?>
<winstrom version="1.0">
<poptavka-prijata>
<id>code:POP0001/2024</id>
<objednej>
<!-- nepovinný externí identifikátor vytvořené objednávky -->
<id>ext:OBJEDNAVKA</id>
<!-- typ dokladu vytvořené objednávky; pokud není zadaný, bere se z nastavení -->
<typDokl>code:OBP</typDokl>
</objednej>
</poptavka-prijata>
</winstrom>

Ak je typ prijatej objednávky predefinovaný na type vydanej ponuky, alebo na samotnej ponuke, nie je potrebné typDokl posielať vôbec. Požiadavka potom môže vyzerať takto:

<?xml version="1.0" encoding="utf-8"?>
<winstrom version="1.0">
<nabidka-vydana>
<id>code:NAV-0001/2024</id>
<objednej></objednej>
</nabidka-vydana>
</winstrom>

⚠️ Ak typ dokladu nie je zadaný ani prednastavený, server vráti 400 s kódom typDoklMustBeSet a hlásením, že typ dokladu musí byť zadaný alebo prednastavený.

ℹ️ Telo požiadavky musí byť vždy obalené koreňovým elementom winstrom (prijímaný je aj flexibee). Bez neho server vráti 400 s kódom importXmlInvalidStartTag.


Súvisiace

Ste s tem dobili odgovor na svoje vprašanje?