Betrieb

Retrieve the store#

get/store

Recht:

store:read

Tarif:

jeder Tarif

Open, closed or paused right now, the next opening, order types, the statuses the restaurant uses, lead times, minimum order, opening and delivery hours, upcoming special days, contact details, address and location.

Antwort200

OK

• objectstringPflicht

  Always store.

  Werte:"store"

• idstring (uuid)Pflicht

  The restaurant.

• namestringPflicht

  Name.

• slugstringPflicht

  Its address: <slug>.flavoso.com.

• timezonestringPflicht

  IANA time zone of all local times.

• currencystringPflicht

  ISO 4217.

• statusstringPflicht

  Right now: open, closed (outside hours or a closed special day), or paused.

  Werte:"open""closed""paused"

• paused_untilstring (date-time)Pflichtkann null sein

  End of the running pause; null without one.

• pause_notestringPflichtkann null sein

  Reason of the running pause.

• next_opening_atstring (date-time)Pflichtkann null sein

  Next opening while closed (looks two weeks ahead); null while open.

• preordersbooleanPflicht

  Guests may order for a later time, also while closed.

• order_typesobjectPflicht

  Which order types guests can choose.

  Felder darin (3)

  • pickupbooleanPflicht

    Pickup.

  • deliverybooleanPflicht

    Delivery.

  • dine_inbooleanPflicht

    Ordering at the table via QR code (Pro and up).

• order_statusesstring[]Pflicht

  Statuses this restaurant uses, in order, plus completed and cancelled.

• lead_timesobjectPflicht

  How long the kitchen needs; the earliest pickup or delivery time.

  Felder darin (2)

  • pickup_minutesintegerPflicht

    Minutes until pickup, 0 to 240.

  • delivery_minutesintegerPflicht

    Minutes until delivery, 0 to 360.

• min_orderintegerPflicht

  Minimum order value for delivery (0 = none). Integer amount in the smallest currency unit (cents).

• always_openbooleanPflicht

  No weekly schedule is set: online orders are taken around the clock (special days and pauses still apply) and no reservation times are offered.

• opening_hoursWeekWindow[]Pflicht

  The weekly opening windows; a weekday without windows is closed.

  Felder darin (3)

  • weekdayintegerPflicht

    0 = Monday … 6 = Sunday.

    0 to 6

  • openstringPflicht

    Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • closestringPflicht

    Closing. Earlier than open: the window runs past midnight. Equal to open: until midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

• delivery_hoursWeekWindow[]Pflicht

  Weekly delivery windows; empty means delivery follows opening_hours.

  Felder darin (3)

  • weekdayintegerPflicht

    0 = Monday … 6 = Sunday.

    0 to 6

  • openstringPflicht

    Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • closestringPflicht

    Closing. Earlier than open: the window runs past midnight. Equal to open: until midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

• closuresClosure[]Pflicht

  Upcoming special days (today and later).

  Felder darin (5)

  • objectstringPflicht

    Always closure.

    Werte:"closure"

  • datestring (date)Pflicht

    The day. A date YYYY-MM-DD in the restaurant's time zone.

  • closedbooleanPflicht

    Closed all day.

  • hoursTimeWindow[]Pflicht

    The windows of that day when not closed (at most two).

    Felder darin (2)

    • openstringPflicht

      Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

      pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

    • closestringPflicht

      Closing; earlier than open runs past midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

      pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • notestringPflichtkann null sein

    Note, e.g. the reason.

• contactobjectPflicht

  Public contact details.

  Felder darin (3)

  • phonestringPflichtkann null sein

    Phone.

  • emailstringPflichtkann null sein

    E-mail.

  • websitestringPflichtkann null sein

    Website.

• addressobjectPflichtkann null sein

  The address as far as it is known. Restaurants type it freely; postal code and city are only split out when a line starts with a postal code.

  Felder darin (4)

  • linestringPflichtkann null sein

    Street and number (or the whole address when it cannot be split).

  • postal_codestringPflichtkann null sein

    Postal code, when it can be read from the address.

  • citystringPflichtkann null sein

    City, when it can be read from the address.

  • countrystringPflichtkann null sein

    ISO 3166-1 alpha-2, as in GET /me.

• locationobjectPflichtkann null sein

  Coordinates; null when not set.

  Felder darin (2)

  • latnumberPflicht

    Latitude.

  • lonnumberPflicht

    Longitude.

Fehler

• 400invalid_request: a parameter or the body is wrong, or it contains a query parameter or field the operation does not know. param names the field.
• 401unauthorized: missing, malformed, expired or revoked access token, or the app was disconnected or suspended.
• 403insufficient_scope, plan_required (with param when an order type is not in the plan) or account_inactive.
• 429rate_limited: more than 120 requests per minute on this connection. Wait Retry-After seconds.
• 500server_error. Safe to retry with the same Idempotency-Key.

Alle Fehlercodes

Change lead times, pre-orders and order types#

patch/store

Recht:

store:write

Tarif:

jeder Tarif

Changes only the fields you send; everything else stays as the restaurant set it. The same rules as the dashboard: lead times 0 to 240 minutes for pickup and 0 to 360 for delivery, and an order type can only be switched on when the restaurant's plan includes it (plan_required, ordering at the table needs Pro).

Opening hours are changed with PUT /store/hours, special days with /store/closures, a pause with /store/pause. A change produces store.updated.

Rumpfapplication/json

• lead_timesobject

  Kitchen lead times.

  Felder darin (2)

  • pickup_minutesinteger

    Minutes until pickup.

    0 to 240

  • delivery_minutesinteger

    Minutes until delivery.

    0 to 360

• order_typesobject

  Switch order types on or off. Switching on needs a plan that includes the type.

  Felder darin (3)

  • pickupboolean

    Pickup.

  • deliveryboolean

    Delivery.

  • dine_inboolean

    Ordering at the table (Pro and up).

• preordersboolean

  Allow orders for a later time.

Antwort200

The store after the change.

• objectstringPflicht

  Always store.

  Werte:"store"

• idstring (uuid)Pflicht

  The restaurant.

• namestringPflicht

  Name.

• slugstringPflicht

  Its address: <slug>.flavoso.com.

• timezonestringPflicht

  IANA time zone of all local times.

• currencystringPflicht

  ISO 4217.

• statusstringPflicht

  Right now: open, closed (outside hours or a closed special day), or paused.

  Werte:"open""closed""paused"

• paused_untilstring (date-time)Pflichtkann null sein

  End of the running pause; null without one.

• pause_notestringPflichtkann null sein

  Reason of the running pause.

• next_opening_atstring (date-time)Pflichtkann null sein

  Next opening while closed (looks two weeks ahead); null while open.

• preordersbooleanPflicht

  Guests may order for a later time, also while closed.

• order_typesobjectPflicht

  Which order types guests can choose.

  Felder darin (3)

  • pickupbooleanPflicht

    Pickup.

  • deliverybooleanPflicht

    Delivery.

  • dine_inbooleanPflicht

    Ordering at the table via QR code (Pro and up).

• order_statusesstring[]Pflicht

  Statuses this restaurant uses, in order, plus completed and cancelled.

• lead_timesobjectPflicht

  How long the kitchen needs; the earliest pickup or delivery time.

  Felder darin (2)

  • pickup_minutesintegerPflicht

    Minutes until pickup, 0 to 240.

  • delivery_minutesintegerPflicht

    Minutes until delivery, 0 to 360.

• min_orderintegerPflicht

  Minimum order value for delivery (0 = none). Integer amount in the smallest currency unit (cents).

• always_openbooleanPflicht

  No weekly schedule is set: online orders are taken around the clock (special days and pauses still apply) and no reservation times are offered.

• opening_hoursWeekWindow[]Pflicht

  The weekly opening windows; a weekday without windows is closed.

  Felder darin (3)

  • weekdayintegerPflicht

    0 = Monday … 6 = Sunday.

    0 to 6

  • openstringPflicht

    Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • closestringPflicht

    Closing. Earlier than open: the window runs past midnight. Equal to open: until midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

• delivery_hoursWeekWindow[]Pflicht

  Weekly delivery windows; empty means delivery follows opening_hours.

  Felder darin (3)

  • weekdayintegerPflicht

    0 = Monday … 6 = Sunday.

    0 to 6

  • openstringPflicht

    Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • closestringPflicht

    Closing. Earlier than open: the window runs past midnight. Equal to open: until midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

• closuresClosure[]Pflicht

  Upcoming special days (today and later).

  Felder darin (5)

  • objectstringPflicht

    Always closure.

    Werte:"closure"

  • datestring (date)Pflicht

    The day. A date YYYY-MM-DD in the restaurant's time zone.

  • closedbooleanPflicht

    Closed all day.

  • hoursTimeWindow[]Pflicht

    The windows of that day when not closed (at most two).

    Felder darin (2)

    • openstringPflicht

      Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

      pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

    • closestringPflicht

      Closing; earlier than open runs past midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

      pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • notestringPflichtkann null sein

    Note, e.g. the reason.

• contactobjectPflicht

  Public contact details.

  Felder darin (3)

  • phonestringPflichtkann null sein

    Phone.

  • emailstringPflichtkann null sein

    E-mail.

  • websitestringPflichtkann null sein

    Website.

• addressobjectPflichtkann null sein

  The address as far as it is known. Restaurants type it freely; postal code and city are only split out when a line starts with a postal code.

  Felder darin (4)

  • linestringPflichtkann null sein

    Street and number (or the whole address when it cannot be split).

  • postal_codestringPflichtkann null sein

    Postal code, when it can be read from the address.

  • citystringPflichtkann null sein

    City, when it can be read from the address.

  • countrystringPflichtkann null sein

    ISO 3166-1 alpha-2, as in GET /me.

• locationobjectPflichtkann null sein

  Coordinates; null when not set.

  Felder darin (2)

  • latnumberPflicht

    Latitude.

  • lonnumberPflicht

    Longitude.

Fehler

• 400invalid_request: a parameter or the body is wrong, or it contains a query parameter or field the operation does not know. param names the field.
• 401unauthorized: missing, malformed, expired or revoked access token, or the app was disconnected or suspended.
• 403insufficient_scope, plan_required (with param when an order type is not in the plan) or account_inactive.
• 409invalid_transition (the status of the object does not allow this), stage_not_used (the restaurant does not use this status), external_id_taken (your app already uses this external_id for another object of the same kind in this restaurant), slot_unavailable (the time or the table is taken), idempotency_in_progress (a request with this Idempotency-Key is still running) or conflict (the same data was changed elsewhere at the same moment, three times in a row; retry unchanged after Retry-After seconds).
• 413payload_too_large: the body is larger than the operation takes, counted in bytes: 64 KB, 2 MB for PUT /menu. Split the request.
• 429rate_limited: more than 120 requests per minute on this connection. Wait Retry-After seconds.
• 500server_error. Safe to retry with the same Idempotency-Key.

Alle Fehlercodes

Retrieve opening and delivery hours#

get/store/hours

Recht:

store:read

Tarif:

jeder Tarif

The weekly schedule. Several windows on one weekday are a lunch break. A weekday without windows is closed. Special days are separate (/store/closures).

Antwort200

OK

• objectstringPflicht

  Always store_hours.

  Werte:"store_hours"

• always_openbooleanPflicht

  No weekly schedule: online orders around the clock, no reservation times.

• opening_hoursWeekWindow[]Pflicht

  Opening windows.

  Felder darin (3)

  • weekdayintegerPflicht

    0 = Monday … 6 = Sunday.

    0 to 6

  • openstringPflicht

    Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • closestringPflicht

    Closing. Earlier than open: the window runs past midnight. Equal to open: until midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

• delivery_hoursWeekWindow[]Pflicht

  Delivery windows; empty means the opening hours apply.

  Felder darin (3)

  • weekdayintegerPflicht

    0 = Monday … 6 = Sunday.

    0 to 6

  • openstringPflicht

    Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • closestringPflicht

    Closing. Earlier than open: the window runs past midnight. Equal to open: until midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

Fehler

• 400invalid_request: a parameter or the body is wrong, or it contains a query parameter or field the operation does not know. param names the field.
• 401unauthorized: missing, malformed, expired or revoked access token, or the app was disconnected or suspended.
• 403insufficient_scope, plan_required (with param when an order type is not in the plan) or account_inactive.
• 429rate_limited: more than 120 requests per minute on this connection. Wait Retry-After seconds.
• 500server_error. Safe to retry with the same Idempotency-Key.

Alle Fehlercodes

Replace opening and/or delivery hours#

put/store/hours

Recht:

store:write

Tarif:

jeder Tarif

Each list you send replaces that whole schedule; a list you leave out stays as it is. At most two windows per weekday, times HH:MM; a window may run past midnight (18:00–02:00). Weekdays missing from a list are closed.

An empty opening_hours list means the restaurant has no weekly schedule: online orders are taken around the clock and no reservation times are offered. An empty delivery_hours list means delivery follows the opening hours. A change produces store.updated.

Rumpfapplication/json

• opening_hoursWeekWindow[]

  At most two windows per weekday. Empty: no weekly schedule.

  max 14 items

  Felder darin (3)

  • weekdayintegerPflicht

    0 = Monday … 6 = Sunday.

    0 to 6

  • openstringPflicht

    Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • closestringPflicht

    Closing. Earlier than open: the window runs past midnight. Equal to open: until midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

• delivery_hoursWeekWindow[]

  At most two windows per weekday. Empty: delivery follows the opening hours.

  max 14 items

  Felder darin (3)

  • weekdayintegerPflicht

    0 = Monday … 6 = Sunday.

    0 to 6

  • openstringPflicht

    Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • closestringPflicht

    Closing. Earlier than open: the window runs past midnight. Equal to open: until midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

Antwort200

OK

• objectstringPflicht

  Always store_hours.

  Werte:"store_hours"

• always_openbooleanPflicht

  No weekly schedule: online orders around the clock, no reservation times.

• opening_hoursWeekWindow[]Pflicht

  Opening windows.

  Felder darin (3)

  • weekdayintegerPflicht

    0 = Monday … 6 = Sunday.

    0 to 6

  • openstringPflicht

    Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • closestringPflicht

    Closing. Earlier than open: the window runs past midnight. Equal to open: until midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

• delivery_hoursWeekWindow[]Pflicht

  Delivery windows; empty means the opening hours apply.

  Felder darin (3)

  • weekdayintegerPflicht

    0 = Monday … 6 = Sunday.

    0 to 6

  • openstringPflicht

    Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • closestringPflicht

    Closing. Earlier than open: the window runs past midnight. Equal to open: until midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

Fehler

• 400invalid_request: a parameter or the body is wrong, or it contains a query parameter or field the operation does not know. param names the field.
• 401unauthorized: missing, malformed, expired or revoked access token, or the app was disconnected or suspended.
• 403insufficient_scope, plan_required (with param when an order type is not in the plan) or account_inactive.
• 409invalid_transition (the status of the object does not allow this), stage_not_used (the restaurant does not use this status), external_id_taken (your app already uses this external_id for another object of the same kind in this restaurant), slot_unavailable (the time or the table is taken), idempotency_in_progress (a request with this Idempotency-Key is still running) or conflict (the same data was changed elsewhere at the same moment, three times in a row; retry unchanged after Retry-After seconds).
• 413payload_too_large: the body is larger than the operation takes, counted in bytes: 64 KB, 2 MB for PUT /menu. Split the request.
• 429rate_limited: more than 120 requests per minute on this connection. Wait Retry-After seconds.
• 500server_error. Safe to retry with the same Idempotency-Key.

Alle Fehlercodes

List special days#

get/store/closures

Recht:

store:read

Tarif:

jeder Tarif

Upcoming special days (today and later, in the restaurant's time zone): closed days and days with their own hours. At most 60.

Antwort200

OK

• objectstringPflicht

  Always list.

  Werte:"list"

• dataClosure[]Pflicht

  The items of this page.

  Felder darin (5)

  • objectstringPflicht

    Always closure.

    Werte:"closure"

  • datestring (date)Pflicht

    The day. A date YYYY-MM-DD in the restaurant's time zone.

  • closedbooleanPflicht

    Closed all day.

  • hoursTimeWindow[]Pflicht

    The windows of that day when not closed (at most two).

    Felder darin (2)

    • openstringPflicht

      Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

      pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

    • closestringPflicht

      Closing; earlier than open runs past midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

      pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • notestringPflichtkann null sein

    Note, e.g. the reason.

• has_morebooleanPflicht

  Whether another page follows.

• next_cursorstringPflichtkann null sein

  Pass as cursor (with the same filters) to get the next page; null on the last page.

Fehler

• 400invalid_request: a parameter or the body is wrong, or it contains a query parameter or field the operation does not know. param names the field.
• 401unauthorized: missing, malformed, expired or revoked access token, or the app was disconnected or suspended.
• 403insufficient_scope, plan_required (with param when an order type is not in the plan) or account_inactive.
• 429rate_limited: more than 120 requests per minute on this connection. Wait Retry-After seconds.
• 500server_error. Safe to retry with the same Idempotency-Key.

Alle Fehlercodes

Create or replace a special day#

post/store/closures

Recht:

store:write

Tarif:

jeder Tarif

Idempotency-Key

Sets what applies on one date instead of the weekly schedule: closed: true, or hours with that day's windows. A new special day answers 201; one on the same date is replaced and answers 200. Today or later only; at most 60 special days (limit_exceeded). A running pause is not affected. Produces store.updated.

Parameter

Rumpfapplication/json

• datestring (date)Pflicht

  Today or later. A date YYYY-MM-DD in the restaurant's time zone.

• closedboolean

  true: closed all day.

• hoursTimeWindow[]

  The windows of that day (one or two).

  max 2 items

  Felder darin (2)

  • openstringPflicht

    Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • closestringPflicht

    Closing; earlier than open runs past midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

• notestring

  Note, e.g. the reason.

  max 140 chars

Antwort200

A special day on this date was replaced.

• objectstringPflicht

  Always closure.

  Werte:"closure"

• datestring (date)Pflicht

  The day. A date YYYY-MM-DD in the restaurant's time zone.

• closedbooleanPflicht

  Closed all day.

• hoursTimeWindow[]Pflicht

  The windows of that day when not closed (at most two).

  Felder darin (2)

  • openstringPflicht

    Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • closestringPflicht

    Closing; earlier than open runs past midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

• notestringPflichtkann null sein

  Note, e.g. the reason.

Fehler

• 400invalid_request: a parameter or the body is wrong, or it contains a query parameter or field the operation does not know. param names the field.
• 401unauthorized: missing, malformed, expired or revoked access token, or the app was disconnected or suspended.
• 403insufficient_scope, plan_required (with param when an order type is not in the plan) or account_inactive.
• 409invalid_transition (the status of the object does not allow this), stage_not_used (the restaurant does not use this status), external_id_taken (your app already uses this external_id for another object of the same kind in this restaurant), slot_unavailable (the time or the table is taken), idempotency_in_progress (a request with this Idempotency-Key is still running) or conflict (the same data was changed elsewhere at the same moment, three times in a row; retry unchanged after Retry-After seconds).
• 413payload_too_large: the body is larger than the operation takes, counted in bytes: 64 KB, 2 MB for PUT /menu. Split the request.
• 422idempotency_key_reused (the key was used with a different request) or limit_exceeded (too many entries in one request, such as products in PUT /menu, or a limit of the restaurant is reached, such as 60 special days).
• 429rate_limited: more than 120 requests per minute on this connection. Wait Retry-After seconds.
• 500server_error. Safe to retry with the same Idempotency-Key.

Alle Fehlercodes

Delete a special day#

delete/store/closures/{date}

Recht:

store:write

Tarif:

jeder Tarif

Removes the special day on this date; the weekly schedule applies again. Produces store.updated.

Parameter

Antwort200

OK

• objectstringPflicht

  Always closure.

  Werte:"closure"

• datestring (date)Pflicht

  The date that was removed. A date YYYY-MM-DD in the restaurant's time zone.

• deletedbooleanPflicht

  Always true.

  Werte:true

Fehler

• 400invalid_request: a parameter or the body is wrong, or it contains a query parameter or field the operation does not know. param names the field.
• 401unauthorized: missing, malformed, expired or revoked access token, or the app was disconnected or suspended.
• 403insufficient_scope, plan_required (with param when an order type is not in the plan) or account_inactive.
• 404not_found: no such object in this restaurant (objects of other restaurants are never found).
• 409invalid_transition (the status of the object does not allow this), stage_not_used (the restaurant does not use this status), external_id_taken (your app already uses this external_id for another object of the same kind in this restaurant), slot_unavailable (the time or the table is taken), idempotency_in_progress (a request with this Idempotency-Key is still running) or conflict (the same data was changed elsewhere at the same moment, three times in a row; retry unchanged after Retry-After seconds).
• 429rate_limited: more than 120 requests per minute on this connection. Wait Retry-After seconds.
• 500server_error. Safe to retry with the same Idempotency-Key.

Alle Fehlercodes

Pause online ordering#

post/store/pause

Recht:

store:write

Tarif:

jeder Tarif

Idempotency-Key

Stops new online orders until the given time, exactly like the pause button in the dashboard. A pause always ends by itself; at most 12 hours. Without a body: 30 minutes. Send minutes or until, not both. Produces store.paused.

Parameter

Rumpfapplication/json

• minutesinteger

  Pause for this many minutes from now. Default 30.

  1 to 720

• untilstring (date-time)

  Pause until this instant (ISO 8601 with time zone, at most 12 hours ahead). Without a zone: 400.

• notestring

  Reason, shown to guests on the ordering page. Longer than 140 characters answers 400 with param.

  max 140 chars

Antwort200

OK

• objectstringPflicht

  Always store.

  Werte:"store"

• idstring (uuid)Pflicht

  The restaurant.

• namestringPflicht

  Name.

• slugstringPflicht

  Its address: <slug>.flavoso.com.

• timezonestringPflicht

  IANA time zone of all local times.

• currencystringPflicht

  ISO 4217.

• statusstringPflicht

  Right now: open, closed (outside hours or a closed special day), or paused.

  Werte:"open""closed""paused"

• paused_untilstring (date-time)Pflichtkann null sein

  End of the running pause; null without one.

• pause_notestringPflichtkann null sein

  Reason of the running pause.

• next_opening_atstring (date-time)Pflichtkann null sein

  Next opening while closed (looks two weeks ahead); null while open.

• preordersbooleanPflicht

  Guests may order for a later time, also while closed.

• order_typesobjectPflicht

  Which order types guests can choose.

  Felder darin (3)

  • pickupbooleanPflicht

    Pickup.

  • deliverybooleanPflicht

    Delivery.

  • dine_inbooleanPflicht

    Ordering at the table via QR code (Pro and up).

• order_statusesstring[]Pflicht

  Statuses this restaurant uses, in order, plus completed and cancelled.

• lead_timesobjectPflicht

  How long the kitchen needs; the earliest pickup or delivery time.

  Felder darin (2)

  • pickup_minutesintegerPflicht

    Minutes until pickup, 0 to 240.

  • delivery_minutesintegerPflicht

    Minutes until delivery, 0 to 360.

• min_orderintegerPflicht

  Minimum order value for delivery (0 = none). Integer amount in the smallest currency unit (cents).

• always_openbooleanPflicht

  No weekly schedule is set: online orders are taken around the clock (special days and pauses still apply) and no reservation times are offered.

• opening_hoursWeekWindow[]Pflicht

  The weekly opening windows; a weekday without windows is closed.

  Felder darin (3)

  • weekdayintegerPflicht

    0 = Monday … 6 = Sunday.

    0 to 6

  • openstringPflicht

    Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • closestringPflicht

    Closing. Earlier than open: the window runs past midnight. Equal to open: until midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

• delivery_hoursWeekWindow[]Pflicht

  Weekly delivery windows; empty means delivery follows opening_hours.

  Felder darin (3)

  • weekdayintegerPflicht

    0 = Monday … 6 = Sunday.

    0 to 6

  • openstringPflicht

    Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • closestringPflicht

    Closing. Earlier than open: the window runs past midnight. Equal to open: until midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

• closuresClosure[]Pflicht

  Upcoming special days (today and later).

  Felder darin (5)

  • objectstringPflicht

    Always closure.

    Werte:"closure"

  • datestring (date)Pflicht

    The day. A date YYYY-MM-DD in the restaurant's time zone.

  • closedbooleanPflicht

    Closed all day.

  • hoursTimeWindow[]Pflicht

    The windows of that day when not closed (at most two).

    Felder darin (2)

    • openstringPflicht

      Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

      pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

    • closestringPflicht

      Closing; earlier than open runs past midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

      pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • notestringPflichtkann null sein

    Note, e.g. the reason.

• contactobjectPflicht

  Public contact details.

  Felder darin (3)

  • phonestringPflichtkann null sein

    Phone.

  • emailstringPflichtkann null sein

    E-mail.

  • websitestringPflichtkann null sein

    Website.

• addressobjectPflichtkann null sein

  The address as far as it is known. Restaurants type it freely; postal code and city are only split out when a line starts with a postal code.

  Felder darin (4)

  • linestringPflichtkann null sein

    Street and number (or the whole address when it cannot be split).

  • postal_codestringPflichtkann null sein

    Postal code, when it can be read from the address.

  • citystringPflichtkann null sein

    City, when it can be read from the address.

  • countrystringPflichtkann null sein

    ISO 3166-1 alpha-2, as in GET /me.

• locationobjectPflichtkann null sein

  Coordinates; null when not set.

  Felder darin (2)

  • latnumberPflicht

    Latitude.

  • lonnumberPflicht

    Longitude.

Fehler

• 400invalid_request: a parameter or the body is wrong, or it contains a query parameter or field the operation does not know. param names the field.
• 401unauthorized: missing, malformed, expired or revoked access token, or the app was disconnected or suspended.
• 403insufficient_scope, plan_required (with param when an order type is not in the plan) or account_inactive.
• 409invalid_transition (the status of the object does not allow this), stage_not_used (the restaurant does not use this status), external_id_taken (your app already uses this external_id for another object of the same kind in this restaurant), slot_unavailable (the time or the table is taken), idempotency_in_progress (a request with this Idempotency-Key is still running) or conflict (the same data was changed elsewhere at the same moment, three times in a row; retry unchanged after Retry-After seconds).
• 413payload_too_large: the body is larger than the operation takes, counted in bytes: 64 KB, 2 MB for PUT /menu. Split the request.
• 429rate_limited: more than 120 requests per minute on this connection. Wait Retry-After seconds.
• 500server_error. Safe to retry with the same Idempotency-Key.

Alle Fehlercodes

Resume online ordering#

post/store/resume

Recht:

store:write

Tarif:

jeder Tarif

Idempotency-Key

Lifts a running pause early. Without a running pause there is nothing to do; the store is returned unchanged. Produces store.resumed.

Parameter

Antwort200

OK

• objectstringPflicht

  Always store.

  Werte:"store"

• idstring (uuid)Pflicht

  The restaurant.

• namestringPflicht

  Name.

• slugstringPflicht

  Its address: <slug>.flavoso.com.

• timezonestringPflicht

  IANA time zone of all local times.

• currencystringPflicht

  ISO 4217.

• statusstringPflicht

  Right now: open, closed (outside hours or a closed special day), or paused.

  Werte:"open""closed""paused"

• paused_untilstring (date-time)Pflichtkann null sein

  End of the running pause; null without one.

• pause_notestringPflichtkann null sein

  Reason of the running pause.

• next_opening_atstring (date-time)Pflichtkann null sein

  Next opening while closed (looks two weeks ahead); null while open.

• preordersbooleanPflicht

  Guests may order for a later time, also while closed.

• order_typesobjectPflicht

  Which order types guests can choose.

  Felder darin (3)

  • pickupbooleanPflicht

    Pickup.

  • deliverybooleanPflicht

    Delivery.

  • dine_inbooleanPflicht

    Ordering at the table via QR code (Pro and up).

• order_statusesstring[]Pflicht

  Statuses this restaurant uses, in order, plus completed and cancelled.

• lead_timesobjectPflicht

  How long the kitchen needs; the earliest pickup or delivery time.

  Felder darin (2)

  • pickup_minutesintegerPflicht

    Minutes until pickup, 0 to 240.

  • delivery_minutesintegerPflicht

    Minutes until delivery, 0 to 360.

• min_orderintegerPflicht

  Minimum order value for delivery (0 = none). Integer amount in the smallest currency unit (cents).

• always_openbooleanPflicht

  No weekly schedule is set: online orders are taken around the clock (special days and pauses still apply) and no reservation times are offered.

• opening_hoursWeekWindow[]Pflicht

  The weekly opening windows; a weekday without windows is closed.

  Felder darin (3)

  • weekdayintegerPflicht

    0 = Monday … 6 = Sunday.

    0 to 6

  • openstringPflicht

    Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • closestringPflicht

    Closing. Earlier than open: the window runs past midnight. Equal to open: until midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

• delivery_hoursWeekWindow[]Pflicht

  Weekly delivery windows; empty means delivery follows opening_hours.

  Felder darin (3)

  • weekdayintegerPflicht

    0 = Monday … 6 = Sunday.

    0 to 6

  • openstringPflicht

    Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • closestringPflicht

    Closing. Earlier than open: the window runs past midnight. Equal to open: until midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

    pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

• closuresClosure[]Pflicht

  Upcoming special days (today and later).

  Felder darin (5)

  • objectstringPflicht

    Always closure.

    Werte:"closure"

  • datestring (date)Pflicht

    The day. A date YYYY-MM-DD in the restaurant's time zone.

  • closedbooleanPflicht

    Closed all day.

  • hoursTimeWindow[]Pflicht

    The windows of that day when not closed (at most two).

    Felder darin (2)

    • openstringPflicht

      Opening. 24-hour local time "HH:MM" in the restaurant's time zone.

      pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

    • closestringPflicht

      Closing; earlier than open runs past midnight. 24-hour local time "HH:MM" in the restaurant's time zone.

      pattern ^([01][0-9]|2[0-3]):[0-5][0-9]$

  • notestringPflichtkann null sein

    Note, e.g. the reason.

• contactobjectPflicht

  Public contact details.

  Felder darin (3)

  • phonestringPflichtkann null sein

    Phone.

  • emailstringPflichtkann null sein

    E-mail.

  • websitestringPflichtkann null sein

    Website.

• addressobjectPflichtkann null sein

  The address as far as it is known. Restaurants type it freely; postal code and city are only split out when a line starts with a postal code.

  Felder darin (4)

  • linestringPflichtkann null sein

    Street and number (or the whole address when it cannot be split).

  • postal_codestringPflichtkann null sein

    Postal code, when it can be read from the address.

  • citystringPflichtkann null sein

    City, when it can be read from the address.

  • countrystringPflichtkann null sein

    ISO 3166-1 alpha-2, as in GET /me.

• locationobjectPflichtkann null sein

  Coordinates; null when not set.

  Felder darin (2)

  • latnumberPflicht

    Latitude.

  • lonnumberPflicht

    Longitude.

Fehler

• 400invalid_request: a parameter or the body is wrong, or it contains a query parameter or field the operation does not know. param names the field.
• 401unauthorized: missing, malformed, expired or revoked access token, or the app was disconnected or suspended.
• 403insufficient_scope, plan_required (with param when an order type is not in the plan) or account_inactive.
• 409invalid_transition (the status of the object does not allow this), stage_not_used (the restaurant does not use this status), external_id_taken (your app already uses this external_id for another object of the same kind in this restaurant), slot_unavailable (the time or the table is taken), idempotency_in_progress (a request with this Idempotency-Key is still running) or conflict (the same data was changed elsewhere at the same moment, three times in a row; retry unchanged after Retry-After seconds).
• 429rate_limited: more than 120 requests per minute on this connection. Wait Retry-After seconds.
• 500server_error. Safe to retry with the same Idempotency-Key.

Alle Fehlercodes