Přeskočit na hlavní obsah

Tvorba nabídky/objednávky z poptávky/nabídky - REST API

REST API - tvorba nabídky z poptávky / tvorba objednávky z nabídky

Autor: Petr Pech

Přes REST API lze z poptávky vytvořit nabídku a z poptávky i nabídky vytvořit objednávku. Slouží k tomu elementy nabidni a objednej, které uvedete do těla importovaného dokladu.


Vytvoření nabídky z poptávky

Do těla přijaté poptávky přidá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>


Vytvoření objednávky z poptávky nebo nabídky

Obdobně slouží element objednej. Uvést jej lze jak u přijaté poptávky, tak u vydané nabídky:

<?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>

Pokud je typ přijaté objednávky předdefinován na typu vydané nabídky, nebo na nabídce samotné, není potřeba typDokl posílat vůbec. Požadavek pak může vypadat 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>

⚠️ Pokud typ dokladu není zadán ani přednastaven, vrátí server 400 s kódem typDoklMustBeSet a hlášením, že typ dokladu musí být zadaný nebo přednastavený.

ℹ️ Tělo požadavku musí být vždy obaleno kořenovým elementem winstrom (přijímán je i flexibee). Bez něj vrátí server 400 s kódem importXmlInvalidStartTag.


Související

Dostali jste odpověď na svou otázku?