Přeskočit na hlavní obsah

Fakturace skladového pohybu přes REST API

Jak fakturovat příjemku či výdejku pomocí API

Ota Rádl avatar
Autor: Ota Rádl
Aktualizováno před více než 2 lety

Přes REST API lze od verze 2021.9 fakturovat příjemku či výdejku.

Při faktury je nutné uvést pole skladovyDokl pro identifikaci typu skladového dokladu, volitelně lze uvést prenestSlevu s hodnotou true pokud má být použita sleva z objednávky.

Způsob volání

Požadavky zasíláme metodou POST nebo PUT na evidenci dané faktury např.:

POST https://demo.flexibee.eu/c/demo/faktura-vydana.xml

Příklady použití

Fakturace příjemky

<winstrom version="1.0"> 
<faktura-prijata>
<id>ext:FAP</id>
<typDokl>code:FAKTURA</typDokl>
<cisDosle>123</cisDosle>
<datSplat>2021-07-14</datSplat>
<fakturuj>
<skladovyDokl>ext:PRIJEMKA123</skladovyDokl>
</fakturuj>
</faktura-prijata>
</winstrom>

Fakturace výdejky

<winstrom version="1.0"> 
<faktura-vydana>
<id>ext:FAV</id>
<typDokl>code:FAKTURA</typDokl>
<fakturuj>
<skladovyDokl>ext:VYDEJ123</skladovyDokl>
</fakturuj>
</faktura-vydana>
</winstrom>

Fakturace výdejky s aplikací slevy z objednávky

<winstrom version="1.0"> 
<faktura-vydana>
<id>ext:FAV</id>
<typDokl>code:FAKTURA</typDokl>
<fakturuj>
<skladovyDokl>ext:VYDEJ123</skladovyDokl>
<prenestSlevu>true</prenestSlevu>
</fakturuj>
</faktura-vydana>
</winstrom>

Příklad v JSON

{
"winstrom": {
"faktura-vydana": {
"id": "ext:FAV",
"typDokl": "code:FAKTURA",
"fakturuj": {
"skladovyDokl": "ext:VYDEJ123"
}
},
"@version": "1.0"
}
}

Hromadná fakturace příjemek / výdejek

API dále umožňuje hromadnou fakturaci. Hromadnou fakturaci zajistíme opakováním volání služby fakturuj

Příklad v JSON

Příklad fakturace dvou skladových příjemek do jedné faktury přijaté včetně doprovodných informací pro fakturu:

{
"winstrom": {
"faktura-prijata": [
{
"id": "ext:ESHOP:1234",
"typDokl": "code:FAKTURA",
"firma": "641",
"datVyst": "2022-09-16",
"duzpPuv": "2022-09-16",
"datSplat": "2022-09-30",
"duzpUcto": "2022-09-16",
"varSym": "703000106",
"szbDphSniz": 15.0,
"szbDphSniz2": 0.0,
"szbDphZakl": 21.0,
"formaUhradyCis": "code:HOTOVĚ",
"uvodTxt": "XXX",
"popis": "",
"cisDosle": "1",
"fakturuj": {
"skladovyDokl": "1",
"prenestSlevu": true
}
},
{
"id": "ext:ESHOP:1234",
"fakturuj": {
"skladovyDokl": "2",
"prenestSlevu": true
}

},
{
"id": "ext:ESHOP:1234",
"@removeExternalIds": "ext:ESHOP",
"fakturuj": {
"skladovyDokl": "3",
"prenestSlevu": true
}
}
],
"@version": "1.0"
}
}

Příklad v XML

<?xml version="1.0" encoding="UTF-8" ?>
<winstrom version='1.0'>
<faktura-prijata>
<id>ext:ESHOP:1234</id>
<typDokl>10</typDokl>
<firma>641</firma>
<datVyst>2022-09-16</datVyst>
<duzpPuv>2022-09-16</duzpPuv>
<datSplat>2022-09-30</datSplat>
<duzpUcto>2022-09-16</duzpUcto>
<varSym>1</varSym>
<popis></popis>
<cisDosle>1</cisDosle>
<fakturuj>
<skladovyDokl>1</skladovyDokl>
<prenestSlevu>true</prenestSlevu>
</fakturuj>
</faktura-prijata>
<faktura-prijata>
<id>ext:ESHOP:1234</id>
<fakturuj>
<skladovyDokl>2</skladovyDokl>
<prenestSlevu>true</prenestSlevu>
</fakturuj>
</faktura-prijata>
<faktura-prijata removeExternalIds='ext:ESHOP'>
<id>ext:ESHOP:1234</id>
<fakturuj>
<skladovyDokl>3</skladovyDokl>
<prenestSlevu>true</prenestSlevu>
</fakturuj>
</faktura-prijata>
</winstrom>

Dostali jste odpověď na svou otázku?