Obține lista comenzilor

GET/api/crm/v2/ordersv2

operationId: orders.default

Autorizare

api-token + language + role

Parametri de interogare

cursorinteger

Poziția de la care se citește pagina: pagination.next_cursor — înainte, pagination.previous_cursor — înapoi; pentru prima pagină nu transmiteți nimic. Aceasta este o limită de comparație, nu un link către un rând: rândul indicat de valoare poate să nu existe, astfel încât un link expirat va deschide totuși pagina din același loc. Eroarea 346 este returnată doar dacă valoarea nu poate fi interpretată ca un număr întreg pozitiv.

Exemplu: 84512

directionstring

Direcția de citire de la cursor; last deschide sfârșitul listei și ignoră cursorul

Valori:nextpreviouslast

Implicit: next

date_creation_fromstring

Exemplu: 25/04/2024

date_creation_tostring

Exemplu: 26/04/2024

chain_idinteger

branch_idinteger

phone_format_idinteger

phone_numberstring

emailstring

order_statusstring (OrderStatus)

Stare comandă: în drum, finalizat, în asamblare, la bucătărie, neprocesat, gata de expediere, așteaptă trimiterea la bucătărie, așteaptă refacere, anulat, confirmat, pregătit

Valori:in_transitdoneassemblyin_kitchennot_processedready_to_transitwait_to_kitchenwait_remadecanceledconfirmedcooked

Exemplu: confirmed

platformstring (OrderPlatform)

Platforma de comandă

Valori:androidapifbiosvksite

delivery_methodstring (OrderDelivery)

Metoda de livrare: curier sau ridicare personală

Valori:courierpickup

payment_statusstring (OrderPayment)

Stare plată: neplătit, în așteptare, plătit

Valori:not_paidwaitingpaid

order_numberinteger

client_branch_profile_idinteger

client_account_idinteger

operator_idinteger

courier_idinteger

promo_codestring

Filtrarea comenzilor după cod promoțional (potrivire exactă cu codul promoțional aplicat promoțiilor comenzii)

Exemplu: Promo1

hide_completed_ordersstring

Valori:true

Exemplu: true

downloadstring

Valori:yes

Exemplu: yes

Răspunsuri

object

statusstringobligatoriu

Valori:successerror

Exemplu: success

dataobject

filtersobject

date_creation_fromobject (FilterDateFrom)

valuestringpoate fi null

Exemplu: 2026-08-01 00:00:00

typestringobligatoriu

Exemplu: date

modestring (FilterMode)

Cum interfața procesează filtrul; filtrul obișnuit nu are mode. force_shown — este întotdeauna afișat, nu poate fi ascuns. value_required — punct de intrare în secțiune: este întotdeauna afișat, nu poate avea valoare goală (până când nu este selectată o valoare, lista este goală; nu există opțiunea „toate”), resetarea generală nu îl curăță.

Valori:force_shownvalue_required

Exemplu: value_required

date_creation_toobject (FilterDateTo)

valuestringpoate fi null

Exemplu: 2026-08-31 23:59:59

typestringobligatoriu

Exemplu: date

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

date_creation_rangeobject (FilterDateRange)

Perioade predefinite pentru filtrul de dată; limita inferioară este calculată în fusul orar al utilizatorului. value — perioada pentru care corespund valorile curente *_from și *_to; null — perioadă personalizată. default — perioada pe care serverul o setează în cererile fără date: aceasta se aplică la prima încărcare a secțiunii și la resetare. Limita superioară a perioadei este întotdeauna egală cu ziua curentă a utilizatorului, de aceea option nu o conține: nu este necesar să transmiteți *_to pentru o perioadă predefinită, serverul o setează automat. O perioadă mai lungă de un an este tăiată dinspre limita recentă.

valuestring (DateRange) poate fi null

Perioadă de filtrare predefinită după dată. Nu are propriul parametru de interogare: limita inferioară este deja calculată în option și este transmisă în *_from. Limita superioară nu este transmisă nici în răspuns, nici în cerere — este întotdeauna egală cu ziua curentă a utilizatorului și este setată de server.

Valori:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Exemplu: today

defaultstring (DateRange) obligatoriu

Valori:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Exemplu: today

typestringobligatoriu

Exemplu: select

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

optionarray of objectobligatoriu

valuestring (DateRange) obligatoriu

Valori:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Exemplu: today

date_fromstringobligatoriu

Exemplu: 25/08/2026

chain_idobject (FilterSelectInteger)

valueinteger

Exemplu: 8920

typestringobligatoriu

Exemplu: select

optionarray of object

valueintegerobligatoriu

Exemplu: 8920

namestringobligatoriu

Exemplu: Green Basket | Kaliningrad

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

branch_idobject (FilterSelectInteger)

valueinteger

Exemplu: 8920

typestringobligatoriu

Exemplu: select

optionarray of object

valueintegerobligatoriu

Exemplu: 8920

namestringobligatoriu

Exemplu: Green Basket | Kaliningrad

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

phone_format_idobject (FilterSelectInteger)

valueinteger

Exemplu: 8920

typestringobligatoriu

Exemplu: select

optionarray of object

valueintegerobligatoriu

Exemplu: 8920

namestringobligatoriu

Exemplu: Green Basket | Kaliningrad

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

phone_numberobject (FilterInput)

valuestring

Exemplu: example

typestringobligatoriu

Exemplu: integer or string

placeholderstring

Exemplu: string

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

emailobject (FilterInput)

valuestring

Exemplu: example

typestringobligatoriu

Exemplu: integer or string

placeholderstring

Exemplu: string

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

order_statusobject (FilterEnum)

Filtru-enumerație — listă plată de valori ale enumerației

valuestring

Exemplu: example

typestringobligatoriu

Exemplu: select

optionarray of string

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

platformobject (FilterEnum)

Filtru-enumerație — listă plată de valori ale enumerației

valuestring

Exemplu: example

typestringobligatoriu

Exemplu: select

optionarray of string

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

delivery_methodobject (FilterEnum)

Filtru-enumerație — listă plată de valori ale enumerației

valuestring

Exemplu: example

typestringobligatoriu

Exemplu: select

optionarray of string

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

payment_statusobject (FilterEnum)

Filtru-enumerație — listă plată de valori ale enumerației

valuestring

Exemplu: example

typestringobligatoriu

Exemplu: select

optionarray of string

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

order_numberobject (FilterId)

valueany

Exemplu: 0

typestringobligatoriu

Exemplu: integer

placeholderstring

Exemplu: integer

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

client_branch_profile_idobject (FilterId)

valueany

Exemplu: 0

typestringobligatoriu

Exemplu: integer

placeholderstring

Exemplu: integer

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

client_account_idobject (FilterId)

valueany

Exemplu: 0

typestringobligatoriu

Exemplu: integer

placeholderstring

Exemplu: integer

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

operator_idobject (FilterSelectInteger)

valueinteger

Exemplu: 8920

typestringobligatoriu

Exemplu: select

optionarray of object

valueintegerobligatoriu

Exemplu: 8920

namestringobligatoriu

Exemplu: Green Basket | Kaliningrad

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

courier_idobject (FilterSelectInteger)

valueinteger

Exemplu: 8920

typestringobligatoriu

Exemplu: select

optionarray of object

valueintegerobligatoriu

Exemplu: 8920

namestringobligatoriu

Exemplu: Green Basket | Kaliningrad

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

promo_codeobject (FilterInput)

valuestring

Exemplu: example

typestringobligatoriu

Exemplu: integer or string

placeholderstring

Exemplu: string

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

hide_completed_ordersobject (FilterBooleanCheckbox)

valueboolean

Для true передайте 1 в запросе, для false ничего не передавайте

Exemplu: false

typestringobligatoriu

Exemplu: checkbox

modestring (FilterMode)

Valori:force_shownvalue_required

Exemplu: value_required

downloadobject (FilterButtonDownloadCsv)

Buton de descărcare a selecției: la apăsare, transmiteți download=yes

valuestring

Exemplu: Download

typestringobligatoriu

Exemplu: button_download_csv

listarray of object

idintegerobligatoriu

Exemplu: 12863367

branch_idintegerobligatoriu

Exemplu: 9054

sms_statusstring (OrderSmsStatus) obligatoriu

Stare SMS

Valori:errorsuccessempty_fieldswrong_phonewrong_api_fieldsserver_not_availablenot_enough_moneywaitingneed_phoneoperators_not_connected_to_botssend_via_bots_failedsending_via_botssent_via_botssent_via_maxsent_via_telegramunsupported_sms_serviceapi_disabledwrong_sender_name

email_statusstring (OrderEmailStatus) obligatoriu

Stare email

Valori:errorwaitingsuccessneed_email

order_statusstring (OrderStatus) obligatoriu

Stare comandă: în drum, finalizat, în asamblare, la bucătărie, neprocesat, gata de expediere, așteaptă trimiterea la bucătărie, așteaptă refacere, anulat, confirmat, pregătit

Valori:in_transitdoneassemblyin_kitchennot_processedready_to_transitwait_to_kitchenwait_remadecanceledconfirmedcooked

Exemplu: confirmed

cart_totalnumberobligatoriu

Exemplu: 100.55

order_numberinteger

Exemplu: 1

date_creationstring (DataTimeFormatSQL) obligatoriu

Exemplu: 2024-05-02 08:31:16

date_preorderstring (DataTimeFormatSQL)

Exemplu: 2024-05-02 08:31:16

timestamp_countdownintegerobligatoriu

Exemplu: 1718625496

time_preorderinteger

Exemplu: 7160

seconds_for_timerinteger

Exemplu: -14500

last_order_doneboolean

Exemplu: true

minutes_to_doneinteger

Exemplu: 60

payment_statusstring (OrderPayment) obligatoriu

Stare plată: neplătit, în așteptare, plătit

Valori:not_paidwaitingpaid

payment_methodstring (OrderPaymentMethod)

Metoda de plată

Valori:cashonlinecard_upon_receipt

platformstring (Platform) obligatoriu

Valori:androidiosallmobile_appssitesocial_apps

Exemplu: all

operator_phone_format_idinteger (PhoneFormatId)

Codul țării: 1-🇷🇺(+7|8), 2-🇦🇿(+994|0), 3-🇧🇾(+375|80), 4-🇰🇿(+7|8), 6-🇷🇸(+381|0), 7-🇹🇷(+90|0), 8-🇺🇦(+380|0), 9-🇵🇹(+351|0), 10-🇰🇬(+996|0), 11-🇺🇸(+1), 12-🇫🇷(+33|0), 13-🇲🇩(+373|0), 15-🇪🇪(+372), 18-🇬🇪(+995), 19-🇺🇿(+998), 22-🇵🇱(+48|0), 23-🇹🇯(+992|8), 25-🇷🇴(+40|0), 44-🇨🇭(+41|0)

Exemplu: 1

operator_phone_numberstring

Exemplu: 9114579423

operator_emailstring

Exemplu: email@example.com

percent_rateintegerobligatoriu

Exemplu: 4

sender_namestring

Exemplu: John Doe

sender_phone_format_idinteger (PhoneFormatId)

Exemplu: 1

sender_phone_numberstring

Exemplu: 9114579423

sender_emailstring

Exemplu: email@example.com

recipient_namestring

Exemplu: John Doe

recipient_phone_format_idinteger (PhoneFormatId)

Exemplu: 1

recipient_phone_numberstring

Exemplu: 9114579423

address_zip_codestring

Exemplu: 236039

address_line_1string

Exemplu: Korablestroiteley st. 9 bld. 2

address_line_2string

Exemplu: Korablestroiteley st. 9 bld. 2

address_streetstring

Exemplu: Partizanskaya street

address_housestring

Exemplu: 20

address_buildingstring

Exemplu: 20

address_entrance_numberstring

Exemplu: 20

address_entrance_codestring

Exemplu: 1234

address_floorstring

Exemplu: 10

address_apartmentstring

Exemplu: 10

additional_changestring

Exemplu: 100

additional_personsstring

Exemplu: 2

additional_commentstring

Exemplu: Test order, remove

additional_greeting_cardstring

Exemplu: example

additional_discountstring

Exemplu: example

tokenstring

Exemplu: 72901fbe661d3e142ea9af5248856f20

delivery_methodstring (DeliveryMethod) obligatoriu

Metoda de livrare: no — nu, all — toate, courier — curier, pickup — ridicare personală

Valori:noallcourierpickup

phone_settingsobject

mask_enableboolean

Exemplu: true

formatboolean

Exemplu: true

internationalboolean

Exemplu: true

branch_namestring

Exemplu: Green Basket | Main

chain_namestringobligatoriu

Exemplu: Green Basket

city_namestringobligatoriu

Exemplu: Voronezh

courier_namestring

Exemplu: courier name

district_namestring

Exemplu: Voronezh-Uh

district_idinteger

Exemplu: 55329

application_uuidstring

Exemplu: 03addc0d-1051-4534-9ba8-792b763a274b

paginationobject (PaginationCursor)

max_countintegerobligatoriu

Numărul de elemente pe pagină

Exemplu: 30

cursorintegerobligatoriupoate fi null

Cursorul cu care a fost solicitată pagina curentă; null — pentru prima pagină

next_cursorintegerobligatoriupoate fi null

id al ultimei linii de pe această pagină: transmiteți-l cu direction=next pentru a merge înainte; null — dacă nu mai există nimic mai departe

Exemplu: 84512

previous_cursorintegerobligatoriupoate fi null

id-ul primei linii de pe această pagină: transmiteți-l cu direction=previous pentru a merge înapoi; null — dacă nu există nimic anterior

Exemplu: 84543

has_nextbooleanobligatoriu

Există o pagină următoare

Exemplu: true

has_previousbooleanobligatoriu

Există o pagină anterioară

Exemplu: false

curl -X GET 'https://foodsoul.ru/api/crm/v2/orders' \
  -H 'Authorization: Bearer fs_api_YOUR_TOKEN' \
  -H 'language: ro' \
  -H 'role: partner'

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://foodsoul.ru/api/crm/v2/orders', [
    'headers' => [
        'Authorization' => 'Bearer fs_api_YOUR_TOKEN',
        'language' => 'ro',
        'role' => 'partner',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch("https://foodsoul.ru/api/crm/v2/orders", {
    method: "GET",
    headers: {
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "ro",
        "role": "partner"
    },
})
const data = await response.json()

import requests

response = requests.request(
    "GET",
    "https://foodsoul.ru/api/crm/v2/orders",
    headers={
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "ro",
        "role": "partner",
    },
)
data = response.json()

Răspuns 200

{
  "status": "success",
  "data": {
    "filters": {
      "date_creation_from": {
        "value": "2026-08-01 00:00:00",
        "type": "date",
        "mode": "value_required"
      },
      "date_creation_to": {
        "value": "2026-08-31 23:59:59",
        "type": "date",
        "mode": "value_required"
      },
      "date_creation_range": {
        "value": "today",
        "default": "today",
        "type": "select",
        "mode": "value_required",
        "option": [
          {
            "value": "today",
            "date_from": "25/08/2026"
          }
        ]
      },
      "chain_id": {
        "value": 8920,
        "type": "select",
        "option": [
          {
            "value": 8920,
            "name": "Green Basket | Kaliningrad"
          }
        ],
        "mode": "value_required"
      },
      "branch_id": {
        "value": 8920,
        "type": "select",
        "option": [
          {
            "value": 8920,
            "name": "Green Basket | Kaliningrad"
          }
        ],
        "mode": "value_required"
      },
      "phone_format_id": {
        "value": 8920,
        "type": "select",
        "option": [
          {
            "value": 8920,
            "name": "Green Basket | Kaliningrad"
          }
        ],
        "mode": "value_required"
      },
      "phone_number": {
        "value": "example",
        "type": "integer or string",
        "placeholder": "string",
        "mode": "value_required"
      },
      "email": {
        "value": "example",
        "type": "integer or string",
        "placeholder": "string",
        "mode": "value_required"
      },
      "order_status": {
        "value": "example",
        "type": "select",
        "option": [
          "string"
        ],
        "mode": "value_required"
      },
      "platform": {
        "value": "example",
        "type": "select",
        "option": [
          "string"
        ],
        "mode": "value_required"
      },
      "delivery_method": {
        "value": "example",
        "type": "select",
        "option": [
          "string"
        ],
        "mode": "value_required"
      },
      "payment_status": {
        "value": "example",
        "type": "select",
        "option": [
          "string"
        ],
        "mode": "value_required"
      },
      "order_number": {
        "value": 0,
        "type": "integer",
        "placeholder": "integer",
        "mode": "value_required"
      },
      "client_branch_profile_id": {
        "value": 0,
        "type": "integer",
        "placeholder": "integer",
        "mode": "value_required"
      },
      "client_account_id": {
        "value": 0,
        "type": "integer",
        "placeholder": "integer",
        "mode": "value_required"
      },
      "operator_id": {
        "value": 8920,
        "type": "select",
        "option": [
          {
            "value": 8920,
            "name": "Green Basket | Kaliningrad"
          }
        ],
        "mode": "value_required"
      },
      "courier_id": {
        "value": 8920,
        "type": "select",
        "option": [
          {
            "value": 8920,
            "name": "Green Basket | Kaliningrad"
          }
        ],
        "mode": "value_required"
      },
      "promo_code": {
        "value": "example",
        "type": "integer or string",
        "placeholder": "string",
        "mode": "value_required"
      },
      "hide_completed_orders": {
        "value": false,
        "type": "checkbox",
        "mode": "value_required"
      },
      "download": {
        "value": "Download",
        "type": "button_download_csv"
      }
    },
    "list": [
      {
        "id": 12863367,
        "branch_id": 9054,
        "sms_status": "error",
        "email_status": "error",
        "order_status": "confirmed",
        "cart_total": 100.55,
        "order_number": 1,
        "date_creation": "2024-05-02 08:31:16",
        "date_preorder": "2024-05-02 08:31:16",
        "timestamp_countdown": 1718625496,
        "time_preorder": 7160,
        "seconds_for_timer": -14500,
        "last_order_done": true,
        "minutes_to_done": 60,
        "payment_status": "not_paid",
        "payment_method": "cash",
        "platform": "all",
        "operator_phone_format_id": 1,
        "operator_phone_number": "9114579423",
        "operator_email": "email@example.com",
        "percent_rate": 4,
        "sender_name": "John Doe",
        "sender_phone_format_id": 1,
        "sender_phone_number": "9114579423",
        "sender_email": "email@example.com",
        "recipient_name": "John Doe",
        "recipient_phone_format_id": 1,
        "recipient_phone_number": "9114579423",
        "address_zip_code": "236039",
        "address_line_1": "Korablestroiteley st. 9 bld. 2",
        "address_line_2": "Korablestroiteley st. 9 bld. 2",
        "address_street": "Partizanskaya street",
        "address_house": "20",
        "address_building": "20",
        "address_entrance_number": "20",
        "address_entrance_code": "1234",
        "address_floor": "10",
        "address_apartment": "10",
        "additional_change": "100",
        "additional_persons": "2",
        "additional_comment": "Test order, remove",
        "additional_greeting_card": "example",
        "additional_discount": "example",
        "token": "72901fbe661d3e142ea9af5248856f20",
        "delivery_method": "no",
        "phone_settings": {
          "mask_enable": true,
          "format": true,
          "international": true
        },
        "branch_name": "Green Basket | Main",
        "chain_name": "Green Basket",
        "city_name": "Voronezh",
        "courier_name": "courier name",
        "district_name": "Voronezh-Uh",
        "district_id": 55329,
        "application_uuid": "03addc0d-1051-4534-9ba8-792b763a274b"
      }
    ],
    "pagination": {
      "max_count": 30,
      "cursor": 0,
      "next_cursor": 84512,
      "previous_cursor": 84543,
      "has_next": true,
      "has_previous": false
    }
  }
}

Solicitările sunt trimise către foodsoul.ru — acesta este gazda acestui portal, nu se poate alege alta.