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']]);