Click & Collect APIClick & Collect API

Kunden bestellen Produkte in der BEEP!-App und holen sie im Store ab. Diese Endpoints verwalten den gesamten Click & Collect Workflow.

Customers order products in the BEEP! app and pick them up in store. These endpoints manage the entire Click & Collect workflow.

POST /api/v1/submitClickCollectOrder

Erstellt eine Click & Collect Bestellung. Der Store erhält eine Push-Benachrichtigung in der Manager-App.

Creates a Click & Collect order. The store receives a push notification in the manager app.

Parameter	Typ	Pflicht	Beschreibung
storeId	string	Ja	Store-ID
userId	string	Ja	Kunden-ID
items	array	Ja	Produkte: [{ productId, quantity }]
pickupTime	string	Nein	Gewünschte Abholzeit (ISO 8601)
note	string	Nein	Kundennachricht (max. 250 Zeichen)

POST /api/v1/updateClickCollectStatus

Aktualisiert den Status einer Bestellung. Der Kunde wird per Push-Notification informiert.

Updates the status of an order. The customer is notified via push notification.

Parameter	Typ	Pflicht	Beschreibung
orderId	string	Ja	Bestell-ID
status	string	Ja	"confirmed", "ready", "picked_up", "cancelled"

AblaufFlow

1. Bestellung: Kunde wählt Produkte in der App → submitClickCollectOrder
2. Bestätigung: Store bestätigt → updateClickCollectStatus("confirmed")
3. Bereit: Ware kommissioniert → updateClickCollectStatus("ready") → Push an Kunden
4. Abholung: Kunde holt ab → updateClickCollectStatus("picked_up")