ID objednávky ve vašem obchodě, nejvýše 255 znaků. Čísla se ukládají jako řetězce. Ukládá se jako external_id. Můžete ho poslat také jako external_id nebo order_id.

Kontaktní e-mail kupujícího. Ukládá se malými písmeny. Emailit podle ní najde kontakt a připíše objednávku e-mailu odeslanému na tuto adresu. Přijímá se také customer.email.

Kontakt kupujícího (con_...). Pokud žádný kontakt nemá toto ID, Emailit kontakt dohledá podle email.

Křestní jméno kupujícího, nejvýše 191 znaků. Použije se, když Emailit kontakt vytváří. Přijímá se také customer.first_name.

Příjmení kupujícího, nejvýše 191 znaků. Použije se, když Emailit kontakt vytváří. Přijímá se také customer.last_name.

placed (výchozí hodnota), paid, fulfilled, canceled nebo refunded. Když má objednávka poprvé stav paid, fulfilled, canceled nebo refunded, Emailit nastaví odpovídající paid_at, fulfilled_at, canceled_at nebo refunded_at na aktuální čas. Zrušené objednávky se do tržeb nepočítají.

Třípísmenný kód ISO 4217. Výchozí hodnota je měna workspace v nastavení E-commerce. Částky se nikdy nepřevádějí: reporty seskupují tržby podle měny.

Celková částka objednávky. Povinná u nové objednávky bez položek. Bez ní Emailit spočítá součet částek položek minus discount plus shipping a tax, nikdy méně než 0.

Částky jsou čísla nebo číselné řetězce, nesmí být záporné a ukládají se s nejvýše 4 desetinnými místy.

Částka před slevou, dopravou a daní. Pokud objednávka obsahuje položky, výchozí hodnota je součet jejich částek.

Výše slevy jako kladné číslo.

Cena dopravy.

Výše daně.

Vrácená částka. Výchozí hodnota je 0, nebo total, když je status refunded. Tržby jsou total minus refunded_amount.

Až 20 kuponů nebo slevových kódů použitých v objednávce. Kód, který bez ohledu na velikost písmen odpovídá kódu kuponu ve workspace, se označí jako uplatněný touto objednávkou. Přijímají se také coupon_code a discount_codes.

ID košíku nebo pokladny ve vašem obchodě, ze kterého objednávka vznikla. Košík s tímto ID přejde do stavu converted.

Kdy byla objednávka zadána: datum a čas ve formátu ISO 8601, nebo unixové časové razítko v sekundách (fungují i milisekundy). Výchozí hodnota je aktuální čas. Nesmí být víc než 24 hodin v budoucnosti. Přijímá se také created_at.

Až 250 položek objednávky. Přijímá se také line_items. Každá položka má:

• product_id (string nebo number): ID produktu ve vašem obchodě. Položky bez title, url, image_url nebo categories je převezmou z katalogu. Přijímá se také id.

• variant_id, sku (string): nejvýše 255 znaků.

• title (string): nejvýše 500 znaků. Povinné, když položka nemá product_id ani sku. Přijímá se také name.

• quantity (integer): 1 nebo více. Výchozí hodnota je 1.

• price (number nebo string): jednotková cena. Výchozí hodnota je 0. Přijímá se také unit_price.

• total (number nebo string): celková částka položky. Výchozí hodnota je price krát quantity.

• categories (string[]): až 50 názvů kategorií.

• url, image_url (string): URL s http nebo https.

Vaše vlastní data ve tvaru dvojic klíč–hodnota, nejvýše 16 KB jako JSON. Při úpravách se odeslané klíče sloučí s uloženým objektem.

Výchozí hodnota true: když contact_id ani email neodpovídá žádnému kontaktu, Emailit vytvoří kontakt z email, first_name a last_name a vyvolá contact.created. Nový kontakt není přihlášený k žádnému seznamu kontaktů, takže ho kampaně nezasáhnou. Nastavte na false, pokud se kontakt nikdy vytvářet nemá: objednávka se pak propojí jen s kontaktem, který už existuje.

Nastavte na true spolu s audience_id, když kupující souhlasil se zasíláním marketingových sdělení. Emailit pak kontakt přihlásí k tomuto seznamu kontaktů, pokud v něm už není. Výchozí hodnota je false.

Seznam kontaktů (aud_...), ke kterému se kupující přihlásí, když je accepts_marketing true. Pokud seznam neexistuje nebo je dosažený limit odběratelů vašeho tarifu, objednávka se přesto uloží a kontakt se nepřihlásí.

Kampaňový e-mail (eml_...), ze kterého kupující přišel, pokud to váš obchod sleduje. Použije se jen u nových objednávek a čtou se jen ID začínající na eml_. Objednávka se tomuto e-mailu připíše, když jde o e-mail z kampaně tohoto workspace a buď má proklik v okně pro proklik před objednávkou, nebo byl v tomto okně odeslán. Jinak Emailit objednávku připíše obvyklým způsobem. Přijímá se také attribution.email_id.

ID objednávky (ord_...), nebo ID objednávky ve vašem obchodě (external_id). ID z obchodu, která obsahují speciální znaky, zakódujte pro URL.

Vždy order.

ID objednávky v Emailitu (ord_...).

ID objednávky ve vašem obchodě: id, které jste poslali.

Kontakt kupujícího (con_...), nebo null, když objednávka není propojená s žádným kontaktem.

Kontaktní e-mail kupujícího, malými písmeny.

placed, paid, fulfilled, canceled nebo refunded.

Třípísmenný kód ISO 4217 měny částek.

Součet položek před slevou, dopravou a daní.

Výše slevy.

Cena dopravy.

Výše daně.

Celková částka objednávky. Tržby v reportech jsou total minus refunded_amount a zrušené objednávky se nepočítají.

Dosud vrácená částka. 0, když se nic nevrátilo.

Kupony nebo slevové kódy použité v objednávce.

ID košíku nebo pokladny ve vašem obchodě, ze kterého objednávka vznikla.

Jak se objednávka dostala do Emailitu: api, js (měřicí skript) nebo import (hromadný import).

Kdy byla objednávka zadána, ve formátu ISO 8601 v UTC.

Kdy Emailit poprvé uložil objednávku s daným stavem. Nastaví se jednou a při další změně stavu se nevymaže.

Kampaňový nebo automatizační e-mail, kterému je objednávka připsaná, nebo null. Nastaví se jednou, při prvním uložení objednávky. Viz Jak se objednávky připisují e-mailům.

• email_id (string): e-mail, kterému je objednávka připsaná.

• campaign_id, campaign_name (string nebo null): jeho kampaň.

• variant_id (string nebo null): verze A/B testu (cvr_...), kterou kupující dostal.

• automation_id, automation_name (string nebo null): jeho automatizace.

• type (string): click, nebo open.

• touched_at (string nebo null): kdy proklik nebo otevření nastalo.

Položky objednávky. Každá má product_id (ID produktu ve vašem obchodě), variant_id, sku, title, quantity, unit_price, total, categories, url a image_url.

Vaše vlastní data ve tvaru dvojic klíč–hodnota.

Kdy Emailit objednávku uložil a kdy se naposledy změnila, ve formátu ISO 8601 v UTC.

ID objednávky (ord_...), nebo ID objednávky ve vašem obchodě.

placed, paid, fulfilled, canceled nebo refunded. Když objednávka poprvé dostane stav paid, fulfilled, canceled nebo refunded, odpovídající paid_at, fulfilled_at, canceled_at nebo refunded_at se nastaví na aktuální čas. Zrušené objednávky se do tržeb nepočítají.

Celková dosud vrácená částka, ne částka tohoto vrácení. Nesmí být záporná. Tržby jsou total minus refunded_amount. Pokud nastavíte status na refunded bez refunded_amount a dřív se nic nevrátilo, za vrácenou se považuje celá částka total.

Klíče, které se sloučí s metadaty objednávky. Nejvýše 16 KB jako JSON.

Číslo stránky pro stránkování (nejméně 1, výchozí hodnota 1).

Počet objednávek, které se vrátí (nejméně 1, nejvýše 100, výchozí hodnota 25).

Hledá v ID objednávky ve vašem obchodě nebo v e-mailové adrese kupujícího bez ohledu na velikost písmen.

Jen objednávky tohoto kontaktu (con_...).

Jen objednávky s touto e-mailovou adresou kupujícího, bez ohledu na velikost písmen.

Jen objednávky v tomto stavu: placed, paid, fulfilled, canceled nebo refunded.

Jen objednávky připsané této kampani (cmp_...).

Jen objednávky připsané této automatizaci (aut_...).

true pro objednávky připsané nějakému e-mailu, false pro objednávky, které připsané nejsou.

Jen objednávky zadané v tento čas nebo později. Datum, nebo datum a čas ve formátu ISO 8601; cokoli jiného vrací 422.

Jen objednávky zadané v tento čas nebo dříve. Datum, nebo datum a čas ve formátu ISO 8601; cokoli jiného vrací 422.

all (výchozí) vyžaduje shodu všech filtrů key.condition. U or stačí shoda kteréhokoli z nich. Viz Filtrování a řazení.

Klíč řazení: placed_at (výchozí), total nebo created_at.

Směr řazení: asc, nebo desc (výchozí).

1 až 1 000 objednávek, každá s poli endpointu Vytvoření nebo úprava objednávky.

Výchozí hodnota true: žádné přiřazení tržeb a žádné události objednávek. Nastavte na false, pokud se objednávky mají zpracovat jako objednávky posílané jednotlivě: nové objednávky se připíšou e-mailům a vyvolají order.placed, upravené objednávky vyvolají order.updated.

Počet nových objednávek.

Počet objednávek, které už byly uložené a upravily se.

Objednávky, které se neuložily. Každá položka má index objednávky ve vašem poli orders a errors s klíči podle cesty k poli, například orders.4.currency. Objednávka, která prošla validací, ale nepodařilo se ji uložit, má pod orders.<index> chybu could not be stored.

ID objednávky (ord_...), nebo ID objednávky ve vašem obchodě.