Životní cyklus stavů objednávky

Pochopení životního cyklu objednávky ušetří spoustu tápání — hlavně kolem zákaznických e-mailů a fakturačních integrací, které často počítají se standardním chováním WooCommerce. S tímto pluginem vypadá průchod takto:

Životní cyklus

1. Zpracovává se — zákazník zaplatil (nebo vytvořil dobírkovou objednávku). Tento stav je spouštěč: plugin odešle objednávku do Messenger API.
2. Messenger — objednávka byla úspěšně předána Messengeru. Jde o vlastní stav pluginu. Od verze 2.7.0 se počítá mezi zaplacené stavy, takže přehledy tržeb a integrace kontrolující $order->is_paid() fungují správně.
3. Vyřízeno — nastaví se automaticky, jakmile Messenger přes tracking webhook nahlásí zásilku jako doručenou. Dřív ne.
4. Selhalo — nastaví se, když se odeslání do Messenger API nepovede, nebo když Messenger nahlásí zásilku jako trvale nedoručitelnou.

Stavy mezi tím (přiřazení kurýrovi, vyzvednutí, neúspěšný pokus o doručení…) stav objednávky nemění — zapisují se jako poznámky k objednávce, takže celá cesta zásilky je vidět v detailu objednávky.

Stavy hýbe tracking webhook

Kroky 3 a 4 nastanou jen tehdy, když má Messenger zaregistrovaný váš tracking webhook — URL zobrazenou v hlavičce nastavení pluginu (/wp-json/kbnt-messenger/v1/trackingstates/). Bez ní objednávky zůstanou ve stavu Messenger napořád. Viz Než začnete.

Co z toho plyne pro zákaznické e-maily

• Pro vlastní stav Messenger WooCommerce žádný e-mail neposílá — zákazník se o předání dopravci nedozví.
• E-mail „Vyřízená objednávka” odchází až po doručení — dávat do jeho šablony odkaz na sledování tedy nemá smysl, balík už zákazník drží v ruce.
• Messenger avizuje sám: v den doručení pošle příjemci SMS s časovým oknem a telefonem na kurýra (z telefonu, který plugin předává). Od verze 2.7.0 plugin Messengeru předává i e-mail zákazníka.

Pokud přesto chcete odkaz na sledování v e-mailu, hotový snippet najdete v častých dotazech.

Co z toho plyne pro fakturaci a další integrace

Cokoli navázané na Vyřízeno se spustí až po doručení — často dny po zaplacení. U fakturačních pluginů (Toret Fakturoid a podobné) doporučuji navázat vystavení faktury na stav Zpracovává se. Integrace kontrolující, jestli je objednávka zaplacená, fungují správně od verze 2.7.0, kdy se stav Messenger registruje mezi zaplacené stavy. Víc v častých dotazech.

Kde jsou uložená sledovací data

Po úspěšném předání plugin zobrazuje Messenger ID a odkaz na sledování v detailu objednávky v administraci a ukládá je do order meta:

Meta klíč	Obsah
_kbnt_messenger_order_id	ID zásilky v Messengeru
_kbnt_messenger_tracking_code	sledovací kód
_kbnt_messenger_tracking_url	URL pro sledování

Hodí se pro snippety a vlastní integrace — viz Filtry a akce pro vývojáře.