Vai al contenuto principale
GET
/
orders
/
list
Elenco ordini
curl --request GET \
  --url https://app.xmenu.it/api/orders/list \
  --header 'X-Api-Key: <api-key>'
{
  "success": true,
  "error": "<string>",
  "message": "<string>",
  "page": 123,
  "pagesize": 123,
  "total_count": 123,
  "more": true,
  "orders": [
    {
      "uid": "<string>",
      "token": "<string>",
      "date": "<string>",
      "date_iso": "2023-11-07T05:31:56Z",
      "number": 123,
      "order_number": "<string>",
      "client": {
        "uid": "<string>",
        "first_name": "<string>",
        "last_name": "<string>",
        "phone": "<string>",
        "email": "[email protected]"
      },
      "details": [
        {
          "product": {
            "uid": "<string>",
            "name": "<string>",
            "price": 123,
            "category": "<string>",
            "category_uid": "<string>",
            "offline_uid": "<string>",
            "ext_id": "<string>"
          },
          "options": [
            {
              "uid": "<string>",
              "name": "<string>",
              "type": "single",
              "values": [
                {
                  "uid": "<string>",
                  "name": "<string>",
                  "price_operator": "+",
                  "price_operand": 123,
                  "quantity": 123,
                  "offline_uid": "<string>",
                  "ext_id": "<string>"
                }
              ],
              "ext_id": "<string>"
            }
          ],
          "price": 123,
          "price_options": 123,
          "quantity": 123,
          "total": 123,
          "free_quantity": 123,
          "notes": "<string>"
        }
      ],
      "dmethod": "0",
      "fee": 123,
      "payment_method": "cash",
      "paid": true,
      "total": 123,
      "currency": "<string>",
      "closed": true,
      "subrestaurant_code": "<string>",
      "subrestaurant_uid": "<string>",
      "notes": "<string>",
      "pickup": {
        "date": "<string>",
        "date_iso": "2023-11-07T05:31:56Z"
      },
      "delivery": {
        "date": "<string>",
        "address": {
          "street": "<string>",
          "number": "<string>",
          "city": "<string>",
          "province": "<string>",
          "zip": "<string>",
          "country": "<string>",
          "place_id": "<string>",
          "lat": 123,
          "lng": 123,
          "kms": 123,
          "doorbell": "<string>",
          "floor": "<string>",
          "quarter": "<string>"
        },
        "date_iso": "2023-11-07T05:31:56Z",
        "deliverypoint": {
          "name": "<string>",
          "full_address": "<string>",
          "fee": 123
        }
      },
      "payment_method_sub": "cash",
      "coupon": {
        "code": "<string>",
        "discount": 123
      },
      "confirmation": {
        "confirmed": true,
        "countdown_time": 123,
        "countdown_started": "<string>",
        "closed": true,
        "date": "<string>",
        "date_iso": "2023-11-07T05:31:56Z",
        "text": "<string>",
        "countdown_started_iso": "2023-11-07T05:31:56Z",
        "countdown_end": "<string>",
        "countdown_end_iso": "2023-11-07T05:31:56Z",
        "timeout": true
      }
    }
  ]
}

Autorizzazioni

​
X-Api-Key
string
header
obbligatorio

Chiave API del ristorante. Può essere ottenuta da Strumenti > Accesso API nella dashboard xMenu.

Parametri della query

​
restuid
string

Identificatore univoco ristorante (non richiesto con autenticazione X-Client-Id)

​
page
integer
obbligatorio

Numero di pagina da recuperare

Intervallo richiesto: x >= 1
​
pagesize
integer
predefinito:100

Numero di risultati per pagina (default: 100, massimo: 100)

Intervallo richiesto: 1 <= x <= 100
​
date_from
string<date>

Ordini dalla data specificata (formato: YYYY-MM-dd)

​
date_to
string<date>

Ordini fino alla data specificata (formato: YYYY-MM-dd)

Risposta

Lista ordini recuperata con successo

​
success
boolean
obbligatorio

Risultato dell'operazione: true se ha avuto successo, false se è fallita

​
error
string

Codice errore se l'operazione è fallita.

Vedi Codici errore per i codici errore generali che possono verificarsi.

​
message
string

Descrizione leggibile dell'errore se l'operazione è fallita

​
page
integer

Numero di pagina corrente (1-n)

​
pagesize
integer

Numero massimo di elementi per pagina

​
total_count
integer

Conteggio totale dei risultati

​
more
boolean

false = ultima pagina; true = esistono ulteriori risultati

​
orders
object[]

Array di oggetti ordine