# Události objednávek > Poprvé uložené objednávky a uložené objednávky, které se změnily. ## order.placed > Odesílá se, když se objednávka poprvé uloží. Obsahuje položky a e-mail z kampaně nebo automatizace, kterému je objednávka připsaná. Alfaverze: otevřená jen týmu Emailitu. # order.placed Odesílá se, když Emailit poprvé uloží objednávku: z endpointu [Vytvoření nebo úprava objednávky](/cs/docs/api-reference/orders/create/), z měřicího skriptu nebo z endpointu [Hromadný import objednávek](/cs/docs/api-reference/orders/batch/) s `historical` nastaveným na `false`. Historické importy ji neodesílají. Stejná událost může spustit automatizaci. Viz [E-commerce](/cs/docs/commerce/). > **E-commerce je v alfaverzi:** Dokud E-commerce testujeme, je otevřené jen týmu Emailitu. Viz [Kdo může E-commerce používat](/cs/docs/commerce/#who-can-use-commerce). Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz [Požadavky webhooků](/cs/docs/webhooks/webhook-requests/). ```json { "event_id": "evt_381an2bijq9dF40JdqYLuJT43Z4", "type": "order.placed", "object": { "object": "order", "id": "ord_3aMEK4No62Zw8S1fcHNznAnnbfp", "external_id": "1042", "contact_id": "con_3EwrXnu9OaQWlfI1AyPUUEoYjQs", "email": "ada@example.com", "status": "paid", "currency": "USD", "subtotal": 107, "discount": 10.7, "shipping": 5, "tax": 0, "total": 101.3, "refunded_amount": 0, "coupon_codes": [ "WELCOME-7KQ2M9XA" ], "cart_id": "c-58f1a2", "source": "api", "placed_at": "2026-10-08T14:32:10.000Z", "paid_at": "2026-10-08T14:32:11.204Z", "fulfilled_at": null, "canceled_at": null, "refunded_at": null, "attribution": { "email_id": "eml_3TSvDAUQi7vqxvAQ1UEVN7k4igq", "campaign_id": "cmp_3zNrBaNjAoPK1l0IL2GQ3pDkubN", "campaign_name": "October newsletter", "variant_id": null, "automation_id": null, "automation_name": null, "type": "click", "touched_at": "2026-10-08T09:41:52.000Z" }, "items": [ { "product_id": "8123456789", "variant_id": "42-blue", "sku": "TRS-BLU-42", "title": "Trail running shoe", "quantity": 1, "unit_price": 89, "total": 89, "categories": [ "Shoes", "Running" ], "url": "https://shop.example.com/products/trail-running-shoe", "image_url": "https://shop.example.com/images/trail-running-shoe.jpg" } ], "metadata": { "channel": "web" }, "created_at": "2026-10-08T14:32:11.204Z", "updated_at": "2026-10-08T14:32:11.204Z" }, "data": { "object": { "object": "order", "id": "ord_3aMEK4No62Zw8S1fcHNznAnnbfp", "external_id": "1042", "contact_id": "con_3EwrXnu9OaQWlfI1AyPUUEoYjQs", "email": "ada@example.com", "status": "paid", "currency": "USD", "subtotal": 107, "discount": 10.7, "shipping": 5, "tax": 0, "total": 101.3, "refunded_amount": 0, "coupon_codes": [ "WELCOME-7KQ2M9XA" ], "cart_id": "c-58f1a2", "source": "api", "placed_at": "2026-10-08T14:32:10.000Z", "paid_at": "2026-10-08T14:32:11.204Z", "fulfilled_at": null, "canceled_at": null, "refunded_at": null, "attribution": { "email_id": "eml_3TSvDAUQi7vqxvAQ1UEVN7k4igq", "campaign_id": "cmp_3zNrBaNjAoPK1l0IL2GQ3pDkubN", "campaign_name": "October newsletter", "variant_id": null, "automation_id": null, "automation_name": null, "type": "click", "touched_at": "2026-10-08T09:41:52.000Z" }, "items": [ { "product_id": "8123456789", "variant_id": "42-blue", "sku": "TRS-BLU-42", "title": "Trail running shoe", "quantity": 1, "unit_price": 89, "total": 89, "categories": [ "Shoes", "Running" ], "url": "https://shop.example.com/products/trail-running-shoe", "image_url": "https://shop.example.com/images/trail-running-shoe.jpg" } ], "metadata": { "channel": "web" }, "created_at": "2026-10-08T14:32:11.204Z", "updated_at": "2026-10-08T14:32:11.204Z" } } } ``` ## Pole - `event_id` (string): ID události (`evt_…`). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint [Načtení události](/cs/docs/api-reference/events/get/). - `type` (string): Vždy `order.placed`. - `object` (object): Objednávka, které se událost týká. Její pole jsou uvedena níže. - `data.object` (object): Stejný objekt ještě jednou, v podobě, v jaké ho vrací [API událostí](/cs/docs/api-reference/events/get/) v poli `data`. ### Objekt objednávky Stejný objekt, jaký vrací [Načtení objednávky](/cs/docs/api-reference/orders/get/). - `id` (string): ID objednávky (`ord_…`). - `object` (string): Vždy `order`. - `external_id` (string): ID objednávky ve vašem obchodě. - `contact_id` (string | null): Kontakt kupujícího (`con_…`), nebo `null`. - `email` (string | null): Kontaktní e-mail kupujícího, malými písmeny. - `status` (string): `placed`, `paid`, `fulfilled`, `canceled` nebo `refunded`. - `currency` (string): Třípísmenný kód ISO 4217 měny částek. - `subtotal, discount, shipping, tax` (number | null): Částky objednávky, nebo `null`, když nebyly odeslány. - `total` (number): Celková částka objednávky. - `refunded_amount` (number): Dosud vrácená částka. - `coupon_codes` (string[]): Kupony nebo slevové kódy použité v objednávce. - `cart_id` (string | null): ID košíku nebo pokladny ve vašem obchodě, ze kterého objednávka vznikla. - `source` (string): `api`, `js` (měřicí skript) nebo `import`. - `placed_at` (string): Kdy byla objednávka zadána, ve formátu ISO 8601 v UTC. - `paid_at, fulfilled_at, canceled_at, refunded_at` (string | null): Kdy měla objednávka v Emailitu daný stav poprvé. - `attribution` (object | null): Kampaňový nebo automatizační e-mail, kterému je objednávka připsaná, nebo `null`: `email_id`, `campaign_id`, `campaign_name`, `variant_id`, `automation_id`, `automation_name`, `type` (`click`, nebo `open`) a `touched_at`. Viz [Jak se objednávky připisují e-mailům](/cs/docs/commerce/#how-orders-are-credited-to-emails). - `items` (object[]): Položky objednávky, každá s `product_id`, `variant_id`, `sku`, `title`, `quantity`, `unit_price`, `total`, `categories`, `url` a `image_url`. - `metadata` (object): Vaše vlastní data z objednávky ve tvaru dvojic klíč–hodnota. - `created_at, updated_at` (string): Kdy Emailit objednávku uložil a kdy se naposledy změnila, ve formátu ISO 8601 v UTC. --- Zdroj: https://emailit.com/cs/docs/webhooks/events/order/order-placed/ ## order.updated > Odesílá se, když se uložená objednávka změní, například její stav nebo vrácení peněz. Když se změnil stav, událost obsahuje předchozí stav. Alfaverze: otevřená jen týmu Emailitu. # order.updated Odesílá se, když se změní objednávka, kterou Emailit už uložil: - Změníte její stav, vrácení peněz nebo metadata endpointem [Úprava objednávky](/cs/docs/api-reference/orders/update/). - Stejnou objednávku pošlete znovu endpointem [Vytvoření nebo úprava objednávky](/cs/docs/api-reference/orders/create/), nebo ji znovu pošle měřicí skript. - [Hromadný import objednávek](/cs/docs/api-reference/orders/batch/) s `historical` nastaveným na `false` ji upraví. Historické importy událost neodesílají. Když se změnil stav, událost obsahuje také `previous_status`. > **E-commerce je v alfaverzi:** Dokud E-commerce testujeme, je otevřené jen týmu Emailitu. Viz [Kdo může E-commerce používat](/cs/docs/commerce/#who-can-use-commerce). Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz [Požadavky webhooků](/cs/docs/webhooks/webhook-requests/). ```json { "event_id": "evt_3sRH2D1JwRBeo2uyN9p2NM4VX3i", "type": "order.updated", "object": { "object": "order", "id": "ord_3aMEK4No62Zw8S1fcHNznAnnbfp", "external_id": "1042", "contact_id": "con_3EwrXnu9OaQWlfI1AyPUUEoYjQs", "email": "ada@example.com", "status": "fulfilled", "currency": "USD", "subtotal": 107, "discount": 10.7, "shipping": 5, "tax": 0, "total": 101.3, "refunded_amount": 0, "coupon_codes": [ "WELCOME-7KQ2M9XA" ], "cart_id": "c-58f1a2", "source": "api", "placed_at": "2026-10-08T14:32:10.000Z", "paid_at": "2026-10-08T14:32:11.204Z", "fulfilled_at": "2026-10-09T11:05:43.019Z", "canceled_at": null, "refunded_at": null, "attribution": { "email_id": "eml_3TSvDAUQi7vqxvAQ1UEVN7k4igq", "campaign_id": "cmp_3zNrBaNjAoPK1l0IL2GQ3pDkubN", "campaign_name": "October newsletter", "variant_id": null, "automation_id": null, "automation_name": null, "type": "click", "touched_at": "2026-10-08T09:41:52.000Z" }, "items": [ { "product_id": "8123456789", "variant_id": "42-blue", "sku": "TRS-BLU-42", "title": "Trail running shoe", "quantity": 1, "unit_price": 89, "total": 89, "categories": [ "Shoes", "Running" ], "url": "https://shop.example.com/products/trail-running-shoe", "image_url": "https://shop.example.com/images/trail-running-shoe.jpg" } ], "metadata": { "channel": "web" }, "created_at": "2026-10-08T14:32:11.204Z", "updated_at": "2026-10-09T11:05:43.019Z" }, "previous_status": "paid", "data": { "object": { "object": "order", "id": "ord_3aMEK4No62Zw8S1fcHNznAnnbfp", "external_id": "1042", "contact_id": "con_3EwrXnu9OaQWlfI1AyPUUEoYjQs", "email": "ada@example.com", "status": "fulfilled", "currency": "USD", "subtotal": 107, "discount": 10.7, "shipping": 5, "tax": 0, "total": 101.3, "refunded_amount": 0, "coupon_codes": [ "WELCOME-7KQ2M9XA" ], "cart_id": "c-58f1a2", "source": "api", "placed_at": "2026-10-08T14:32:10.000Z", "paid_at": "2026-10-08T14:32:11.204Z", "fulfilled_at": "2026-10-09T11:05:43.019Z", "canceled_at": null, "refunded_at": null, "attribution": { "email_id": "eml_3TSvDAUQi7vqxvAQ1UEVN7k4igq", "campaign_id": "cmp_3zNrBaNjAoPK1l0IL2GQ3pDkubN", "campaign_name": "October newsletter", "variant_id": null, "automation_id": null, "automation_name": null, "type": "click", "touched_at": "2026-10-08T09:41:52.000Z" }, "items": [ { "product_id": "8123456789", "variant_id": "42-blue", "sku": "TRS-BLU-42", "title": "Trail running shoe", "quantity": 1, "unit_price": 89, "total": 89, "categories": [ "Shoes", "Running" ], "url": "https://shop.example.com/products/trail-running-shoe", "image_url": "https://shop.example.com/images/trail-running-shoe.jpg" } ], "metadata": { "channel": "web" }, "created_at": "2026-10-08T14:32:11.204Z", "updated_at": "2026-10-09T11:05:43.019Z" }, "previous_status": "paid" } } ``` ## Pole - `event_id` (string): ID události (`evt_…`). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint [Načtení události](/cs/docs/api-reference/events/get/). - `type` (string): Vždy `order.updated`. - `object` (object): Objednávka po změně. Má stejná pole jako v [`order.placed`](/cs/docs/webhooks/events/order/placed/#order-object) a v [Načtení objednávky](/cs/docs/api-reference/orders/get/). - `previous_status` (string): Stav objednávky před změnou. Uvádí se, jen pokud se stav změnil. Je vedle `object`, ne uvnitř. - `data` (object): `object` a `previous_status` ještě jednou, v podobě, v jaké je vrací [API událostí](/cs/docs/api-reference/events/get/) v poli `data`. --- Zdroj: https://emailit.com/cs/docs/webhooks/events/order/order-updated/