Produktereignisse: Ein Produkt ist ausverkauft, auf Bestellung, sein Lagerbestand hat sich geändert, oder es wurde gelöscht. Anfrageparameter, Auswahl der Benachrichtigung und Form der Antwort werden in der [Übersicht der E-shop API](https://www.bulkgate.com/de/dokumentation/eshop-api/eshop-api-uebersicht/) beschrieben.

## API-URL

| ENDPOINT                                                            | EREIGNIS DER BENACHRICHTIGUNG |
|:--------------------------------------------------------------------|:-----------------------------|
| `https://portal.bulkgate.com/api/1.0/eshop/product/out-of-stock`    | `product_out_of_stock`       |
| `https://portal.bulkgate.com/api/1.0/eshop/product/on-back-order`   | `product_on_back_order`      |
| `https://portal.bulkgate.com/api/1.0/eshop/product/update-quantity` | `product_update_quantity`    |
| `https://portal.bulkgate.com/api/1.0/eshop/product/delete`          | `product_delete`             |

> [!NOTE]
> Erreicht die Anfrage ihr Ziel nicht, wiederholen Sie sie auf dem [Backup-Server](https://www.bulkgate.com/de/dokumentation/api-verwaltung-und-tokens/backup-server/) `backup1.bulkgate.com`.

## Unterstützte HTTP-Methoden

- `POST` - `application/json`

```http
POST /api/1.0/eshop/product/out-of-stock HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json
```

## Produktvariablen

Die Angaben zum Produkt übergeben Sie in `variables` mit Variablen aus der Gruppe Produkt, z. B. `product_id`, `product_name`, `product_quantity` oder `product_sku`. Die vollständige Liste finden Sie in der [Übersicht der E-shop API](https://www.bulkgate.com/de/dokumentation/eshop-api/eshop-api-uebersicht/).

> [!TIP]
> Die Kundenbenachrichtigung wird nur gesendet, wenn `variables` die Telefonnummer des Kunden enthalten. Ohne sie wird nur die Benachrichtigung an die Administratoren gesendet.

## Beispielanfrage

```http-json
POST /api/1.0/eshop/product/out-of-stock HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json

{
  "application_id": 451,
  "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj",
  "variables": {
    "product_id": "318",
    "product_name": "BulkGate T-Shirt, Größe M",
    "product_sku": "BG-TSHIRT-M",
    "product_quantity": "0"
  }
}
```

## Antwort

```json
{
    "data": {
        "admin": [
            {
                "status": "accepted",
                "message_id": "tmpde1bcd4b1d1",
                "part_id": ["tmpde1bcd4b1d1"],
                "number": "420777777777",
                "channel": "sms"
            }
        ]
    }
}
```

Die Bedeutung der Schlüssel `customer` und `admin`, Fehler beim Senden und die Fehlertypen finden Sie in der [Übersicht der E-shop API](https://www.bulkgate.com/de/dokumentation/eshop-api/eshop-api-uebersicht/).
