Objednávky - TomAtomCZ/depotoPhpClient GitHub Wiki
Procesní stavy objednávek
ID | Název |
---|---|
recieved | Přijatá |
picking | Vyskladnění |
packing | Balení |
packed | Zabaleno |
dispatched | Předáno dopravci |
delivered | Doručeno |
returned | Nedoručeno (Vráceno) |
picking_error | Chyba vyskladnění |
cancelled | Zrušeno |
Změna procesního stavu objednávky vyvolá událost, k jejímuž odběru se můžete zaregistrovat.
Zaplaceno - ano/ne a návaznost na procesní stavy
Objednávku lze nastavit jako zaplacenou / nezaplacenou, resp. částečně zaplacenou / nezaplacenou.
V rámci paymentItems lze pro každou platbu zaslat isPaid true / false. True je výchozí stav, pokud isPaid nepošlete. Je dobré posílat parametr vždy a jeho hodnotu řešit v kódu.
isPaid je navázaný na procesní stavy objednávek a je důležité ho správně posílat. Např. pokud dojde k vytvoření objednávky na platbu kartou a isPaid chybí, objednávka je nastavena jako zaplacená a propadá k vyskladnění a následně expedici. Správně by tedy např. u platby kartou mělo být posláno false a v momentě, kdy je platba uhrazena poslat update objednávky s aktualizací isPaid = true. Obdobně u bankovních převodů, atp. Naopak true u dobírek, os. odběrů, platby na fakturu, atp.
Speciálním typem plateb jsou tzv. "platby se splatností", kdy by měl eshop posílat isPaid = false, ale objednávky by se měly expedovat ihned bez ohledu na platbu. V takovém případě je potřeba zaškrtnout v depotu u dané platby "expedovat neuhrazené".
Vystavení faktury
Fakturu je možné vystavit v rámci mutace createOrder či updateOrder posláním
$result = $depoto->mutation('createOrder',
[
'status' => 'bill', // 'reservation' = objednávka
'billNumber' => ..., // číslo faktury (volitelné) - pokud nevyplníte, vezme se následující číslo z číselné řady dané pokladny
'dateBill' => date("Y-m-d H:i:s"),
'dateDue' => ..., // datum splatnosti (volitelné)
'dateTax' => ..., // datum zdanitelného plnění (volitelné)
]
['data' => ['id']]);