API: aggiornare lo stato di un ordine
POST /api/v1/orders/{order_id}/status permette alla tua cassa (POS) di dire a Menuthere quando la cucina ha accettato un ordine e quando è uscito. Serve una chiave con accesso Orders. Inviare uno stato che l'ordine ha già non cambia nulla, quindi riprovare è sicuro.
- Dove
- Ask Menuthere support for a key
- Piano
- La dashboard non lo blocca in base al piano.
- Aggiornato
La richiesta
curl -X POST 'https://menuthere.com/api/v1/orders/ORDER_ID/status' -H 'Authorization: Bearer ck_live_YOUR_KEY' -H 'Content-Type: application/json' -d '{"status":"accepted"}'
| Parte | Valore |
|---|---|
| Metodo e percorso | POST /api/v1/orders/{order_id}/status |
| Intestazione | Authorization: Bearer ck_live_…, da una chiave con accesso Orders |
| Corpo | JSON: { "status": "accepted" } |
| order_id | L'ID dell'ordine. Arriva come data.order_id nel webhook degli ordini. |
| status consentiti | accepted, food_ready, dispatched, in_transit, completed |
La risposta
| Campo | Significato |
|---|---|
| ok | true se è andata a buon fine. |
| order_id | L'ordine che hai aggiornato. |
| previous_status | Cosa era l'ordine prima. |
| status | Lo stato che ha adesso. |
| changed | true se lo stato è cambiato. false se l'ordine lo aveva già, e in tal caso non è stato scritto nulla. |
Una modifica riuscita invia anche un evento order.status_updated al tuo webhook, così un secondo sistema, come un tablet, la vede a sua volta. La tua modifica non fallisce mai perché il tuo endpoint webhook non risponde.
Errori
| Stato | `error` | Significato |
|---|---|---|
| 400 | missing_status, unsupported_status, invalid_json, missing_order_id | Il corpo non è valido, oppure lo stato non è nell'elenco consentito. |
| 401 | missing_api_key, invalid_api_key | Nessuna chiave, oppure una chiave sbagliata o revocata. |
| 403 | scope_denied | La chiave non ha accesso Orders. |
| 404 | order_not_found | Nessun ordine con quell'ID sul tuo account. |
| 429 | rate_limited | Troppe richieste in questo minuto. |
| 503 | lookup_failed, update_failed | Menuthere non ha potuto leggere o scrivere l'ordine. Riprova. |
Domande
Cosa succede se la mia cassa (POS) riprova dopo un timeout?
Il cliente riceve un messaggio quando cambio lo stato?
Vedi anche
Non lo trovi? Scrivi a [email protected] o chatta con noi, dalle 9 alle 21.Centro assistenzaPrezzimenuthere.com