# Bestell-Events

> Erstmals gespeicherte Bestellungen und gespeicherte Bestellungen, die sich geändert haben.



## order.placed

> Wird gesendet, wenn eine Bestellung zum ersten Mal gespeichert wird. Enthält die Artikel und die Kampagnen- oder Automatisierungs-E-Mail, der die Bestellung zugeordnet ist. Alpha: nur für das Emailit-Team zugänglich.

# order.placed

Wird gesendet, wenn Emailit eine Bestellung zum ersten Mal speichert: über [Bestellung erstellen oder aktualisieren](/de/docs/api-reference/orders/create/), über das Tracking-Skript oder über [Bestellungen gesammelt importieren](/de/docs/api-reference/orders/batch/) mit `historical` auf `false`. Historische Importe senden es nicht. Dasselbe Event kann eine Automatisierung starten. Siehe [Commerce](/de/docs/commerce/).

> **Commerce ist in der Alpha:** Commerce steht nur dem Emailit-Team offen, solange wir es testen. Siehe [Wer Commerce nutzen kann](/de/docs/commerce/#who-can-use-commerce).

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe [Webhook-Anfragen](/de/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"
    }
  }
}
```

## Felder

- `event_id` (string): Event-ID (`evt_…`). Eine wiederholte Anfrage enthält dieselbe ID. Damit können Sie Events überspringen, die Sie bereits verarbeitet haben. Sie können das Event auch mit [Event abrufen](/de/docs/api-reference/events/get/) nachschlagen.

- `type` (string): Immer `order.placed`.

- `object` (object): Die Bestellung, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

- `data.object` (object): Noch einmal dasselbe Objekt, in der Form, die die [Events-API](/de/docs/api-reference/events/get/) in `data` zurückgibt.

### Bestell-Objekt

Dasselbe Objekt, das [Bestellung abrufen](/de/docs/api-reference/orders/get/) zurückgibt.

- `id` (string): Bestell-ID (`ord_…`).

- `object` (string): Immer `order`.

- `external_id` (string): Die Bestell-ID in Ihrem Shop.

- `contact_id` (string | null): Der Kontakt des Käufers (`con_…`) oder `null`.

- `email` (string | null): Die E-Mail-Adresse des Käufers, in Kleinbuchstaben.

- `status` (string): `placed`, `paid`, `fulfilled`, `canceled` oder `refunded`.

- `currency` (string): Dreistelliger Code nach ISO 4217 für die Beträge.

- `subtotal, discount, shipping, tax` (number | null): Die Beträge der Bestellung oder `null`, wenn sie nicht gesendet wurden.

- `total` (number): Bestellsumme.

- `refunded_amount` (number): Bisher erstatteter Betrag.

- `coupon_codes` (string[]): In der Bestellung verwendete Gutschein- oder Rabattcodes.

- `cart_id` (string | null): Die Warenkorb- oder Checkout-ID in Ihrem Shop, aus der die Bestellung stammt.

- `source` (string): `api`, `js` (das Tracking-Skript) oder `import`.

- `placed_at` (string): Zeitpunkt, zu dem die Bestellung aufgegeben wurde, im Format ISO 8601 in UTC.

- `paid_at, fulfilled_at, canceled_at, refunded_at` (string | null): Zeitpunkt, zu dem die Bestellung in Emailit zum ersten Mal diesen Status hatte.

- `attribution` (object | null): Die E-Mail, der die Bestellung zugeordnet ist, oder `null`: `email_id`, `campaign_id`, `campaign_name`, `variant_id`, `automation_id`, `automation_name`, `type` (`click` oder `open`) und `touched_at`. Siehe [Wie Bestellungen E-Mails zugeordnet werden](/de/docs/commerce/#how-orders-are-credited-to-emails).

- `items` (object[]): Positionen, jeweils mit `product_id`, `variant_id`, `sku`, `title`, `quantity`, `unit_price`, `total`, `categories`, `url` und `image_url`.

- `metadata` (object): Ihre eigenen Schlüssel-Wert-Daten aus der Bestellung.

- `created_at, updated_at` (string): Zeitpunkt, zu dem Emailit die Bestellung gespeichert hat, und Zeitpunkt ihrer letzten Änderung, im Format ISO 8601 in UTC.

---
Quelle: https://emailit.com/de/docs/webhooks/events/order/order-placed/

## order.updated

> Wird gesendet, wenn sich eine gespeicherte Bestellung ändert, zum Beispiel ihr Status oder durch eine Rückerstattung. Wenn sich der Status geändert hat, enthält das Event den vorherigen Status. Alpha: nur für das Emailit-Team zugänglich.

# order.updated

Wird gesendet, wenn sich eine Bestellung ändert, die Emailit bereits gespeichert hat:

- Sie ändern ihren Status, ihre Rückerstattung oder ihre Metadaten mit [Bestellung aktualisieren](/de/docs/api-reference/orders/update/).
- Sie senden dieselbe Bestellung erneut mit [Bestellung erstellen oder aktualisieren](/de/docs/api-reference/orders/create/), oder das Tracking-Skript sendet sie erneut.
- [Bestellungen gesammelt importieren](/de/docs/api-reference/orders/batch/) mit `historical` auf `false` aktualisiert sie. Historische Importe senden das Event nicht.

Wenn sich der Status geändert hat, enthält das Event außerdem `previous_status`.

> **Commerce ist in der Alpha:** Commerce steht nur dem Emailit-Team offen, solange wir es testen. Siehe [Wer Commerce nutzen kann](/de/docs/commerce/#who-can-use-commerce).

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe [Webhook-Anfragen](/de/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"
  }
}
```

## Felder

- `event_id` (string): Event-ID (`evt_…`). Eine wiederholte Anfrage enthält dieselbe ID. Damit können Sie Events überspringen, die Sie bereits verarbeitet haben. Sie können das Event auch mit [Event abrufen](/de/docs/api-reference/events/get/) nachschlagen.

- `type` (string): Immer `order.updated`.

- `object` (object): Die Bestellung nach der Änderung. Sie hat dieselben Felder wie in [`order.placed`](/de/docs/webhooks/events/order/placed/#order-object) und [Bestellung abrufen](/de/docs/api-reference/orders/get/).

- `previous_status` (string): Der Status der Bestellung vor der Änderung. Nur vorhanden, wenn sich der Status geändert hat. Das Feld steht neben `object`, nicht darin.

- `data` (object): Noch einmal `object` und `previous_status`, in der Form, die die [Events-API](/de/docs/api-reference/events/get/) in `data` zurückgibt.

---
Quelle: https://emailit.com/de/docs/webhooks/events/order/order-updated/
