Naklonovat doklad v rámci stromu dokladů (podle vazeb položek)
Kód: clone_document_in_tree · Typy záznamů: všechny typy dokladů
Po změně stavu vytvoří kopie dokladu pod jinými doklady téhož stromu: pod potomky jeho předků. Typické použití je vratka založená k objednávce, kterou expedovaly dva dodací listy. Akce z ní vytvoří dvě vratky a každou naváže na ten dodací list, kterým zboží skutečně odešlo. Původní doklad zůstane beze změny.
Akce najde předky dokladu podle vazeb jeho položek. Mezi jejich potomky pak vybere cílové doklady podle Filtru potomků (cílové položky). Každou položku dokladu přiřadí cílovému dokladu, jehož položka pochází ze stejné položky předka. Kopie položky pak ukazuje na tuto cílovou položku jako na svůj původ a kopie dokladu se naváže na cílový doklad.
Když se jedna položka předka rozpadla do více cílových dokladů, množství se rozdělí postupně v pořadí stromu. Každý cílový doklad převezme nejvýš tolik, kolik obsahuje jeho položka po uplatnění Filtru cílových položek. Příklad: objednávka obsahuje 6 ks zboží, první dodací list vezl 2 ks a druhý 4 ks. Vratka na 5 ks se rozdělí na kopii se 2 ks pod prvním dodacím listem a kopii se 3 ks pod druhým. Má-li položka sériová čísla, kopie dostane přednostně ta, která jsou na cílové položce.
Množství, které žádný cílový doklad nepřevezme, se nenaklonuje. Jde například o dopravu, slevy a ručně přidané řádky bez vazby na předka, o množství nad rámec cílových dokladů nebo o podíl přeskočeného cílového dokladu. Akce takové řádky zapíše do auditního logu dokladu ve tvaru „nenaklonované / celkové množství“. Všechny kopie se nejdřív připraví a teprve potom uloží. Když se příprava některé z nich nezdaří, neuloží se žádná.
Parametry (názvy dle formuláře v administraci):
| Parametr | Význam |
|---|---|
| Filtr zdrojových položek (položky, které se naklonují) | které položky tohoto dokladu a v jakém množství se klonují. Podmínky se přidávají po jedné z nabídky Přidat filtr…. Bez podmínky se klonují všechny položky. Položky vyřazené filtrem se nikam nezapisují |
| Filtr předka (zdroj položek) | Typ předka, filtr a Maximální úroveň zanoření: přes které předky se cílové doklady hledají. Předci se vždy hledají podle vazeb položek. Když akce žádného předka nenajde, nic nevytvoří |
| Filtr potomků (cílové položky) | Typ potomka (povinné, jinak skončí změna stavu chybou konfigurace), Úroveň zanoření a filtr: pod které doklady se kopie zakládají |
| Filtr cílových položek (omezuje množství, které cílová položka převezme) | omezí, kolik může cílová položka převzít. Například podmínka na stav zpracování vrácení nechá cílové položce jen tu část, která ještě nebyla vrácena |
| Typ dokladu | povinné; typ kopií. Formulář předvyplní typ tohoto dokladu, pokud je v nabídce |
| Předvolby | hodnoty, které se kopiím předvyplní. Číselná řada je u kopie stejného typu nepovinná: bez ní kopie převezme číselnou řadu původního dokladu |
| Extra kontext | doplňující technické údaje předané při převodu dokladu (zápis ve formátu JSON) |
| Změna stavu | přechody pro workflow kopií; na každé kopii se provede první dostupný |
| Pokud dokument již existuje | Vytvořit nový (výchozí) = kopie vznikne vždy. Přeskočit (nic nevytvářet) = cílový doklad, který už má potomka typu kopie, kopii nedostane a jeho podíl nepřejde na ostatní cílové doklady |
| Filtr existujícího dokumentu | zobrazí se jen při volbě Přeskočit (nic nevytvářet); které existující potomky cílového dokladu brát v úvahu (číselná řada, stav, štítky…) |
Související dokumentace
- Akce
- Vytvořit nový dokument (následníka): založí jeden navazující doklad pod tímto dokladem
- Handlery
- Dokumentový model: vazby mezi doklady a položkami