Novinky

Depoto – WMS

Na tomto serveru běží verze v2026.10.14.2 (sestaveno 14. 10. 2026) . Níže jsou změny, které se týkají klientů a integrací a na tomto serveru už běží.

· v2026.10.14

Prodané položky: řazení podle součtů a správné filtry

Typ změny
oprava chyby, změna výchozího řazení
Dotčené pole
soldItems (argumenty sort, direction, filters) a export prodaných položek
Nutná akce klienta
kdo spoléhá na pořadí výpisu bez zadaného řazení, zadá sort a direction výslovně.

Výpis soldItems se řadí podle skutečně sečtených hodnot — quantity, priceAll, priceAllWithoutVat a profit — nebo podle vrácených polí name, type, ean a code. Dosud se řadil podle hodnot jednoho náhodného řádku skupiny a řazení podle priceAll a priceAllWithoutVat končilo chybou. Bez zadaného řazení i směru jsou nově první nejprodávanější položky (quantity sestupně), stejně jako v exportu. Neznámý název řazení (například id) se nebere jako chyba: řadí se podle množství, vzestupně. Celkový počet položek nově respektuje filtr companies. Kombinace datumových filtrů dateCreated, dateBill a processStatusUpdated a kombinace filtrů customer a customerFulltext se už navzájem nepřepisují — ve výpisu ani v exportu. Výpis se zároveň počítá jedním průchodem místo dvou, takže je u firem s velkým objemem objednávek rychlejší; výpis bez dolní hranice data ale zůstává pomalý.

· v2026.10.14

Rychlejší výpis objednávek řazený podle ID

Typ změny
zrychlení
Dotčené pole
orders
Nutná akce klienta
žádná.

Výpis objednávek jedné firmy bez filtrů, řazený podle id, se u firem s velkým počtem objednávek načítá výrazně rychleji. Vrácené objednávky, jejich pořadí ani celkový počet se nemění.

· v2026.10.14

DPD: telefon a dlouhé jméno příjemce

Typ změny
oprava chyby
Dotčené pole
dopravce DPD, telefon a jméno v doručovací adrese
Nutná akce klienta
žádná.

Do DPD se z telefonu příjemce posílají jen číslice a znaky + a # — DPD dosud odmítal zásilku například kvůli čárce nebo pomlčce v čísle. Jméno příjemce delší než 35 znaků se rozdělí v mezeře mezi slovy do druhého řádku jména, místo aby DPD zásilku odmítl.

· v2026.10.14

PPL: zásilky na německý DHL Packstation

Typ změny
nová podpora, nová validace
Dotčené pole
dopravce PPL, customData doručovací adresy
Nutná akce klienta
u zásilek na DHL Packstation v Německu posílat číslo zákazníka DHL v customData adresy.

Zásilka přes PPL na německý DHL Packstation potřebuje číslo zákazníka DHL (Postnummer). Posílá se v customData doručovací adresy jako {"dhlPostNumber": "…"} a musí mít 6 až 10 číslic. Adresa s výdejním místem v Německu, jejíž ulice začíná slovem „Packstation“, bez tohoto čísla skončí při vytvoření balíku srozumitelnou chybou — PPL by takovou zásilku stejně odmítl.

· v2026.10.13.3

Exporty objednávek a prodané položky podle skladu

Typ změny
oprava chyby
Dotčené pole
exporty objednávek a hromadný tisk dokladů; filtry depots a suppliers v soldItems
Nutná akce klienta
žádná; exporty s těmito filtry doporučujeme vytvořit znovu.

Exporty objednávek a hromadný tisk dokladů už při filtrování podle skladu, štítků nebo plateb nevypisují objednávku vícekrát. Filtry depots a suppliers u prodaných položek (i v jejich exportu) nově vracejí položky podle skutečných skladových pohybů — dosud nevracely nic. Vratka se počítá ke skladu, na který se zboží vrátilo.

· v2026.10.13

Objednávky jen z přiřazených pokladen

Typ změny
zpřísnění oprávnění
Dotčené pole
orders, order, createOrder, updateOrder, createOrderItem, updateOrderItem, deleteOrderItem a zrušení rezervace
Nutná akce klienta
žádná, pokud uživatel API nemá přiřazené pokladny nebo pracuje jen s jejich objednávkami.

Uživatel s přiřazenými pokladnami nově vidí a upravuje jen objednávky těchto pokladen. Seznam orders se na ně omezí sám; filtr checkouts s jinou pokladnou, detail cizí objednávky i její úprava skončí chybou Error 403: Forbidden.. Stejně se odmítne filtr depots nebo onlyDepots se skladem, který uživatel přiřazený nemá. Omezení seznamu a filtrů platí už od verze v2026.10.12.2, detail a úpravy od této verze. Uživatelů bez přiřazených pokladen a skladů se změna netýká.

· v2026.10.13

Stav expedice: počet položek a kusů

Typ změny
nová volba v administraci
Dotčené pole
stránka Stav expedice
Nutná akce klienta
žádná.

Stav expedice umí místo počtu objednávek zobrazit počet položek nebo kusů k expedici. Přepíná se volbou „Zobrazit“ ve filtru; výchozí zůstává počet objednávek.

· v2026.10.13

Filtry objednávek podle skladu počítají jen se zbožím

Typ změny
oprava chyby
Dotčené pole
filtry depots a onlyDepots v orders
Nutná akce klienta
výsledky filtru onlyDepots načtené 13. 10. 2026 mezi 12:40 a 13:40 načíst znovu.

Filtry depots a onlyDepots už nepočítají s evidenční rezervací sady (virtuálního produktu), která sama žádné zboží nedrží. Objednávka se sadou, jejíž položky se přesunuly na jiný sklad, se proto nově vrátí podle skladu, kde zboží skutečně leží. U onlyDepots navíc nezáleží na pořadí zadaných skladů. Verze v2026.10.13 měla ve filtru onlyDepots chybu: zhruba hodinu mohl vracet i objednávky s rezervací na jiném skladu a některé správné vynechat. Opravila ji verze v2026.10.13.2.

· v2026.10.08

Nový dopravce Pošta bez hranic

Typ změny
nový dopravce
Dotčené pole
dopravce pbh
Nutná akce klienta
žádná; kdo chce dopravce používat, vyplní přístupové údaje z klientského portálu Pošty bez hranic.

Pošta bez hranic je jeden účet pro více cílových dopravců — tarify pokrývají Balíkovnu (na adresu, do boxu a na poštu) a One by Allegro (na adresu, výdejní místo a box). V nastavení dopravce se vyplňuje clientId a apiKey. Volba labelMode určuje štítek: pbh (výchozí) tiskne štítek Pošty bez hranic a zásilky se vozí do jejího skladu, courier tiskne rovnou štítek cílového dopravce ve formátu pdf nebo zpl (labelFormat) — tuto službu musí Pošta bez hranic na účtu povolit a každý štítek se účtuje, dokud se balík nesmaže. Režim courier zatím nebyl vyzkoušen na ostrém účtu, první zásilky a jejich storno si proto zkontrolujte. U tarifů na výdejní místo a do boxu je povinné výdejní místo, dobírka je v měně země doručení.

· v2026.10.07.5

Dobropisová položka v rezervaci

Typ změny
oprava chyby
Dotčené pole
položky se záporným quantity v createOrder, updateOrder a createOrderItem; vystavení dokladu přes updateOrder
Nutná akce klienta
žádná.

Rezervaci se zápornou (dobropisovou) položkou lze vyfakturovat přes updateOrder: položka nic nerezervuje a při vystavení dokladu se naskladní stejně jako u přímého dokladu. Dosud taková rezervace končila při vystavení dokladu chybou Nesouhlasí počet kusů.

· v2026.10.07.3

Limit velikosti exportů a tiskových sestav

Typ změny
nové omezení
Dotčené pole
createExport, createExportOrder, createExportSale, createExportStock
Nutná akce klienta
velké exporty rozdělit na menší rozsahy (kratší období, užší filtr).

Export nebo tisková sestava s více než 50 000 záznamy se nově nevytvoří. Mutace vrátí chybu s počtem záznamů, které by export obsahoval (u velmi velkých rozsahů jen s údajem „více než“), a nic se nezařadí do fronty. Menší exporty fungují beze změny.

· v2026.10.07.3

Událost `product.availability` po každé změně zásoby

Typ změny
oprava chyby
Dotčené pole
událost product.availability
Nutná akce klienta
žádná; počítejte s vyšším počtem událostí.

Událost product.availability nově přijde i po změnách, které ji dosud neposlaly: po smazání nebo obnovení skladového dokladu, po automatickém přesunu rezervace na jiný skladový záznam a po uvolnění rezervace při vystavení dokladu. Napojené systémy se tak o změně dostupnosti dozvědí hned, ne až s další událostí téhož produktu. Událost přijde i po přesunu rezervace v rámci jednoho skladu, kdy se dostupnost produktu na skladě nezmění.

· v2026.10.07.3

SPS a DHL Express: opravy údajů o zásilce

Typ změny
oprava napojení dopravce
Dotčené pole
dopravci sps a dhl_express
Nutná akce klienta
žádná.

U zásilek SPS se s dobírkou nově posílá i její měna a hodnota pojištění se přepočítává na eura, ve kterých ji SPS čte. U DHL Express se deklarovaná hodnota zásilky zaokrouhluje na dvě desetinná místa.

· v2026.09.30.2

Verze serveru a stránka novinek

Typ změny
nový veřejný endpoint a stránka
Dotčené pole
GET /status/version, stránka /changelog
Nutná akce klienta
žádná.

Server nově říká, jaká verze na něm běží: GET /status/version vrací bez přihlášení version, release, commit a builtAt. Verze se jmenují podle dne nasazení (vRRRR.MM.DD, další nasazení téhož dne mají příponu .2, .3 atd.). Na stránce /changelog jsou změny, které se týkají klientů a integrací — vždy jen ty, které na daném serveru už běží.

· v2026.09.30

Pořadí rezervací podle priority objednávky

Typ změny
změna chování rezervací
Dotčené pole
priority a dateExpedition objednávky
Nutná akce klienta
žádná; ověřte jen, že vyšší číslo priority u vás opravdu znamená přednost.

Když zboží nestačí pro všechny objednávky, rozhoduje o pořadí rezervací nejdřív priority objednávky (vyšší číslo má přednost), potom dřívější dateExpedition a nakonec stáří objednávky. Dosud se priorita a datum expedice posuzovaly dohromady, takže si dvě objednávky mohly nárokovat tentýž kus. Rezervace se nově samy přesouvají i po naskladnění na existující skladový záznam, po výdeji a po změně priority nebo data expedice objednávky. Položky už vychystané nebo s pevně zvolenou šarží se kvůli jiné objednávce nepřesouvají.

· v2026.09.28.2

Obnovení hesla už uživatele samo nepřihlásí

Typ změny
změna chování
Dotčené pole
stránka obnovení hesla
Nutná akce klienta
žádná.

Dokončení obnovy hesla už uživatele do aplikace nepřihlásí automaticky. Zobrazí se potvrzení o změně hesla s odkazem do aplikace, kde se přihlásí novým heslem.

· v2026.09.28

Zápis jen do vlastní firmy a firem jí podřízených

Typ změny
zpřísnění oprávnění
Dotčené pole
mutace skladových dokladů (createProductMovePack, updateProductMovePack, deleteProductMovePack, updateProductMove, deleteProductMove), objednávek (updateOrder, createOrderItem, updateOrderItem), balíků (createPackage, updatePackage) a refreshProductDepots
Nutná akce klienta
žádná, pokud uživatel API zapisuje jen do své firmy a do firem jí podřízených a na řádky objednávky dává produkty, sazby DPH a poukazy firmy té objednávky.

Zápisové mutace nově přijmou jen záznamy (sklady, produkty, objednávky, štítky) firmy přihlášeného uživatele a firem jí podřízených. Odkaz na záznam nadřazené, sesterské nebo cizí firmy skončí chybou Error 403: Forbidden. a nic se neuloží. Produkt, sazba DPH a poukaz na řádku objednávky musí navíc patřit firmě té objednávky nebo firmám jí podřízeným — i když objednávku upravuje uživatel nadřazené firmy. Mutace refreshProductDepots nově vyžaduje oprávnění k úpravě produktů. Kontrola skladů v createProductMovePack platí už od verze v2026.09.27.2. Čtení se nemění.

· v2026.09.27.2

Výdejka nevydá méně, než se žádá

Typ změny
změna chování při nedostatku zboží
Dotčené pole
createProductMovePack (typ out)
Nutná akce klienta
ošetřit chybu Není tolik kusů skladem. u výdejek bez určeného skladového záznamu.

Řádek výdejky bez productDepot, na který není skladem dost kusů, nově skončí chybou Není tolik kusů skladem. a doklad nevznikne — dříve se vydalo méně kusů, případně vznikl prázdný doklad. Dva souběžné výdeje téhož zboží už navíc nemohou oba projít proti stejné zásobě: druhý skončí chybou a požadavek lze zopakovat.

· v2026.09.27

Záznam smazaný dřív v témže dokumentu GraphQL je pryč i pro další mutace

Typ změny
oprava chyby
Dotčené pole
mutace objednávek, položek objednávek, skladových dokladů a pohybů, balíků a plateb
Nutná akce klienta
žádná, pokud v jednom dokumentu neposíláte smazání a další mutaci téhož záznamu.

Mutace, která v jednom dokumentu GraphQL sáhne na záznam smazaný dřívější mutací téhož dokumentu, nově skončí chybou Error 404: Not found.. Dosud ho ještě našla — opakované smazání nebo úprava smazaného záznamu tak mohly rozhodit stav skladu.

· v2026.09.26.3

Spolehlivé číslování dokladů

Typ změny
oprava chyby a změna chování nastavení číselné řady
Dotčené pole
billNumber a vs objednávky; nextBillNumber v updateCheckout
Nutná akce klienta
žádná, pokud řadu dokladů pokladny nesnižujete.

Dvě souběžné expedice téže pokladny už nedostanou stejné číslo dokladu a na sebe čekají jen po dobu potvrzení té první. Číslo dokladu při expedici je bez mezer. Řadu dokladů pokladny lze nově jen zvýšit — pokus o snížení se ignoruje. Odpověď mutace i webhooky nesou číslo dokladu jako dosud; číslo zadané klientem se použije tak, jak přišlo.

· v2026.09.26.2

Spolehlivé číslování skladových dokladů a rezervací

Typ změny
oprava chyby a změna chování nastavení číselné řady
Dotčené pole
čísla výdejek, příjemek, převodek, rezervací a nákupních objednávek; nextReservationNumber v updateCheckout
Nutná akce klienta
žádná, pokud rezervační řadu pokladny nesnižujete a nespoléháte na rezervační číslo 0.

Souběžně vystavované doklady už nedostávají stejné číslo a vzájemně se nezablokují. Když se uložení dokladu nepovede, může v řadě vzniknout mezera. Rezervační řadu pokladny lze nově jen zvýšit — pokus o snížení se ignoruje. Řady začínají od 1: pokladna s nextReservationNumber = 0 vydá jako první číslo 1. Čísla zadaná klientem se použijí tak, jak přišla.

· v2026.09.24

Test nastavení dopravce

Typ změny
nová mutace
Dotčené pole
testCompanyCarrier
Nutná akce klienta
žádná.

Mutace testCompanyCarrier(id:) ověří nastavení dopravce: že jsou vyplněná povinná pole a že dopravce přijme přihlašovací údaje. U dopravců, kteří umí zásilku zrušit, navíc založí zkušební zásilku a hned ji stornuje — odhalí tak i účty, které se přihlásí, ale posílat nesmějí. Výsledek je v data (status, message, chybějící pole); po testu, který zásilku odeslal, je další test u téhož dopravce možný až po minutě.

· v2026.09.24

FedEx přes REST API

Typ změny
změna napojení dopravce
Dotčené pole
CompanyCarrier.options dopravce FedEx
Nutná akce klienta
vyplnit nové přístupové údaje z developer portálu FedEx.

FedEx vypíná původní SOAP rozhraní, napojení je proto nově přes REST API. V nastavení dopravce se vyplňuje clientId, clientSecret a accountNumber (pro testovací režim varianty …Test). Zakládání zásilek, štítky, sledování, rušení zásilek, svoz i nahrání vlastní faktury fungují přes nové API.

· v2026.09.24

Nastavení dopravce pro jednu objednávku

Typ změny
nové pole
Dotčené pole
carrierOptions v createOrder, updateOrder a na Order
Nutná akce klienta
žádná.

Objednávka může pro sebe přepsat vybrané položky nastavení dopravce — například popis obsahu, pojištění, formát štítku nebo údaje odesílatele. Posílá se jako řetězec s JSON objektem, stejně jako options u updateCompanyCarrier; hodnota nahrazuje celý přepis a prázdný řetězec ho zruší. Přístupové údaje a identitu účtu u dopravce objednávka přepsat nesmí, takový pokus skončí chybou a nic se neuloží.

· v2026.09.21

Odebrání starých názvů pořadových čísel

Typ změny
odebrané pole (nekompatibilní změna)
Dotčené pole
pathPosition, orderPosition na clearanceItems
Nutná akce klienta
používat pathIndex a orderIndex, jinak dotaz skončí chybou.

Pole pathPosition a orderPosition byla odebrána. Dotaz, který je vybírá, skončí chybou validace GraphQL — použijte pathIndex a orderIndex.

· v2026.09.16

Nové názvy pořadových čísel položek k vychystání

Typ změny
přejmenování pole (staré názvy dočasně fungují)
Dotčené pole
pathIndex, orderIndex na clearanceItems (dříve pathPosition, orderPosition)
Nutná akce klienta
přejít v dotazech na nové názvy.

Pořadové číslo položky na trase vychystání se nově jmenuje pathIndex a pořadí podle řádků objednávky orderIndex. Hodnoty se nezměnily, slovo „position“ zůstává jen skladové pozici. Staré názvy pathPosition a orderPosition zatím fungují dál, ale v další verzi se odeberou.

· v2026.09.08

Stabilní řazení položek k vychystání

Typ změny
změna chování existujícího pole
Dotčené pole
clearanceItems na objednávce, skupině objednávek, balíku a položce
Nutná akce klienta
žádná, pokud nespoléháte na dosavadní pořadí položek.

clearanceItems se nově vrací vždy seřazené. Položky na nakreslené mapě skladu jdou dál podle trasy vychystání; ostatní abecedně podle pozice, položky bez pozice na konci. Stejné pozice se řadí podle expirace a šarže. Dva shodné dotazy tak vrátí vždy stejné pořadí.

· v2026.09.08

Volba konkrétní šarže u položky objednávky

Typ změny
nový argument
Dotčené pole
productDepots u položek v createOrder, updateOrder, createOrderItem, updateOrderItem
Nutná akce klienta
žádná; argument je volitelný.

Klient může určit, ze kterých konkrétních skladových záznamů (šarže, expirace) se má položka vyskladnit — seznam { productDepot, quantity }, jehož součet odpovídá množství položky. Takto zvolená rezervace se později sama nepřesouvá. Bez argumentu vybírá server jako dosud.

· v2026.08.31

Nový dopravce One by Allegro

Typ změny
nový dopravce
Dotčené pole
dopravce one
Nutná akce klienta
žádná; nové smlouvy místo WEDO se zakládají na One.

One by Allegro je nástupce WEDO. Jeden dopravce one pokrývá doručení na adresu i do výdejních boxů, včetně dobírky, štítků ve formátu PDF (A6, A4) nebo ZPL a sledování zásilky. V nastavení dopravce se vyplňuje apiKey a password; volitelně druh služby, doplňkové služby, popis obsahu a výchozí rozměry balíku. Adresa odesílatele musí odpovídat smluvnímu svozovému místu — když se liší od fakturační adresy firmy, vyplňte ji v polích sender…. Stávající účty WEDO fungují dál beze změny.

· v2026.08.27

DPD: napojení přes nové REST API (GeoAPI)

Typ změny
nová možnost nastavení dopravce
Dotčené pole
CompanyCarrier.options dopravce dpd
Nutná akce klienta
jen pokud od DPD dostáváte API klíč místo jména a hesla.

DPD přestalo vydávat přihlašovací údaje k původnímu SOAP rozhraní. Dopravce dpd proto umí druhé napojení přes REST GeoAPI. V nastavení dopravce zapněte volbu dpdRest a vyplňte apiKey (pro testovací režim apiKeyTest) a zákaznické číslo DPD customerDsw — to není totéž co dosavadní „zákaznické číslo“ ze SOAP napojení. Nové napojení potřebuje i id odesílací adresy customerAddressIt4emId; u stávajícího nastavení se převezme dosavadní id adresy. Obě hodnoty poskytne DPD.

Přes REST jde založit zásilku s dobírkou i bez ní, vytisknout štítek (vždy PDF A6), sledovat zásilku a objednat svoz. Zásilku ale nejde zrušit: smazání balíku v Depotu ji u DPD nestornuje, omylem založenou zásilku řešte s DPD (štítek zahoďte). Stávající napojení přes jméno a heslo běží dál beze změny.