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>