50% OFF with code BLACKFRIDAY5020% OFF with code BLACKFRIDAY20
Integrazioni e APITutti i piani

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"}'

ParteValore
Metodo e percorsoPOST /api/v1/orders/{order_id}/status
IntestazioneAuthorization: Bearer ck_live_…, da una chiave con accesso Orders
CorpoJSON: { "status": "accepted" }
order_idL'ID dell'ordine. Arriva come data.order_id nel webhook degli ordini.
status consentitiaccepted, food_ready, dispatched, in_transit, completed
Da sapereL'annullamento non è disponibile qui. Un annullamento rimborsa i punti fedeltà, rimette a magazzino i piatti e disdice qualsiasi partner di consegna, quindi resta nella dashboard. Vedi Annullare un ordine. Anche pending_payment appartiene al gateway di pagamento e non si può impostare.

La risposta

CampoSignificato
oktrue se è andata a buon fine.
order_idL'ordine che hai aggiornato.
previous_statusCosa era l'ordine prima.
statusLo stato che ha adesso.
changedtrue 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
400missing_status, unsupported_status, invalid_json, missing_order_idIl corpo non è valido, oppure lo stato non è nell'elenco consentito.
401missing_api_key, invalid_api_keyNessuna chiave, oppure una chiave sbagliata o revocata.
403scope_deniedLa chiave non ha accesso Orders.
404order_not_foundNessun ordine con quell'ID sul tuo account.
429rate_limitedTroppe richieste in questo minuto.
503lookup_failed, update_failedMenuthere non ha potuto leggere o scrivere l'ordine. Riprova.

Domande

Cosa succede se la mia cassa (POS) riprova dopo un timeout?
Niente di grave. Se l'ordine ha già quello stato, la chiamata restituisce changed: false e non scrive nulla.
Il cliente riceve un messaggio quando cambio lo stato?
L'ordine passa attraverso i suoi normali stati, quindi i flussi che partono su quegli stati vengono eseguiti. Vedi Aggiornamenti degli ordini ai clienti.

Non lo trovi? Scrivi a help@mail.menuthere.com o chatta con noi, dalle 9 alle 21.Centro assistenzaPrezzimenuthere.com