Dobijanje liste porudžbina

GET/api/crm/v2/ordersv2

operationId: orders.default

Ауторизација

api-token + language + role

Parametri upita

cursorinteger

Позиција од које се чита страница: pagination.next_cursor — напред, pagination.previous_cursor — назад; за прву страницу не шаљите. Ово је граница поређења, а не веза на ред: ред на који показује вредност можда не постоји, па застарела веза ипак отвара страницу са истог места. Грешка 346 се враћа само ако вредност не може да се протумачи као позитиван цео број.

Пример: 84512

directionstring

Смер курса; last отвара крај листе и игнорише курсор

Vrednosti:nextpreviouslast

Подразумевано: next

date_creation_fromstring

Пример: 25/04/2024

date_creation_tostring

Пример: 26/04/2024

chain_idinteger

branch_idinteger

phone_format_idinteger

phone_numberstring

emailstring

order_statusstring (OrderStatus)

Статус поруџбине: на путу, завршен, паковање, у кухињи, необрађен, спреман за слање, чека слање у кухињу, чека преправку, отказан, потврђен, припремљен

Vrednosti:in_transitdoneassemblyin_kitchennot_processedready_to_transitwait_to_kitchenwait_remadecanceledconfirmedcooked

Пример: confirmed

platformstring (OrderPlatform)

Платформа за наручивање

Vrednosti:androidapifbiosvksite

delivery_methodstring (OrderDelivery)

Način isporuke: kurir ili lično preuzimanje

Vrednosti:courierpickup

payment_statusstring (OrderPayment)

Статус плаћања: није плаћено, у току, плаћено

Vrednosti:not_paidwaitingpaid

order_numberinteger

client_branch_profile_idinteger

client_account_idinteger

operator_idinteger

courier_idinteger

promo_codestring

Филтрирање поруџбина по промо коду (тачно поклапање са промо кодом примењеним на акције поруџбине)

Пример: Promo1

hide_completed_ordersstring

Vrednosti:true

Пример: true

downloadstring

Vrednosti:yes

Пример: yes

Одговори

object

statusstringобавезно

Vrednosti:successerror

Пример: success

dataobject

filtersobject

date_creation_fromobject (FilterDateFrom)

valuestringможе бити null

Пример: 2026-08-01 00:00:00

typestringобавезно

Пример: date

modestring (FilterMode)

Как интерфейс обрађује филтер; обичан филтер нема mode. force_shown — увек је приказан, не може се сакрити. value_required — улазна тачка у одељак: увек је приказан, нема празну вредност (док вредност није изабрана, листа је празна; опција „све“ не постоји), општи ресет га не чисти.

Vrednosti:force_shownvalue_required

Пример: value_required

date_creation_toobject (FilterDateTo)

valuestringможе бити null

Пример: 2026-08-31 23:59:59

typestringобавезно

Пример: date

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

date_creation_rangeobject (FilterDateRange)

Gotovi periodi filtera po datumu; donja granica se računa u korisničkoj vremenskoj zoni. value — period kojem odgovaraju trenutni *_from i *_to; null — proizvoljan period. default — period koji server automatski postavlja u zahtev bez datuma: koristi se pri prvom učitavanju sekcije i pri resetovanju filtera. Gornja granica perioda uvek odgovara trenutnom danu korisnika, zato je option ne sadrži: nije potrebno slati *_to za gotov period, server je postavlja automatski. Period duži od godinu dana se skraćuje sa strane novije granice.

valuestring (DateRange) може бити null

Готов период филтера по датуму. Нема сопственог параметра захтева: доња граница је већ израчуната у option и поставља се у *_from. Горња граница се не шаље ни у одговору, ни у захтеву — увек је једнака тренутном дану корисника и поставља је сервер.

Vrednosti:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Пример: today

defaultstring (DateRange) обавезно

Vrednosti:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Пример: today

typestringобавезно

Пример: select

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

optionarray of objectобавезно

valuestring (DateRange) обавезно

Vrednosti:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

Пример: today

date_fromstringобавезно

Пример: 25/08/2026

chain_idobject (FilterSelectInteger)

valueinteger

Пример: 8920

typestringобавезно

Пример: select

optionarray of object

valueintegerобавезно

Пример: 8920

namestringобавезно

Пример: Green Basket | Kaliningrad

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

branch_idobject (FilterSelectInteger)

valueinteger

Пример: 8920

typestringобавезно

Пример: select

optionarray of object

valueintegerобавезно

Пример: 8920

namestringобавезно

Пример: Green Basket | Kaliningrad

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

phone_format_idobject (FilterSelectInteger)

valueinteger

Пример: 8920

typestringобавезно

Пример: select

optionarray of object

valueintegerобавезно

Пример: 8920

namestringобавезно

Пример: Green Basket | Kaliningrad

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

phone_numberobject (FilterInput)

valuestring

Пример: example

typestringобавезно

Пример: integer or string

placeholderstring

Пример: string

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

emailobject (FilterInput)

valuestring

Пример: example

typestringобавезно

Пример: integer or string

placeholderstring

Пример: string

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

order_statusobject (FilterEnum)

Филтер-енум — раван списак вредности енума

valuestring

Пример: example

typestringобавезно

Пример: select

optionarray of string

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

platformobject (FilterEnum)

Филтер-енум — раван списак вредности енума

valuestring

Пример: example

typestringобавезно

Пример: select

optionarray of string

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

delivery_methodobject (FilterEnum)

Филтер-енум — раван списак вредности енума

valuestring

Пример: example

typestringобавезно

Пример: select

optionarray of string

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

payment_statusobject (FilterEnum)

Филтер-енум — раван списак вредности енума

valuestring

Пример: example

typestringобавезно

Пример: select

optionarray of string

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

order_numberobject (FilterId)

valueany

Пример: 0

typestringобавезно

Пример: integer

placeholderstring

Пример: integer

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

client_branch_profile_idobject (FilterId)

valueany

Пример: 0

typestringобавезно

Пример: integer

placeholderstring

Пример: integer

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

client_account_idobject (FilterId)

valueany

Пример: 0

typestringобавезно

Пример: integer

placeholderstring

Пример: integer

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

operator_idobject (FilterSelectInteger)

valueinteger

Пример: 8920

typestringобавезно

Пример: select

optionarray of object

valueintegerобавезно

Пример: 8920

namestringобавезно

Пример: Green Basket | Kaliningrad

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

courier_idobject (FilterSelectInteger)

valueinteger

Пример: 8920

typestringобавезно

Пример: select

optionarray of object

valueintegerобавезно

Пример: 8920

namestringобавезно

Пример: Green Basket | Kaliningrad

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

promo_codeobject (FilterInput)

valuestring

Пример: example

typestringобавезно

Пример: integer or string

placeholderstring

Пример: string

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

hide_completed_ordersobject (FilterBooleanCheckbox)

valueboolean

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

Пример: false

typestringобавезно

Пример: checkbox

modestring (FilterMode)

Vrednosti:force_shownvalue_required

Пример: value_required

downloadobject (FilterButtonDownloadCsv)

Дугме за преузимање избора: при клику пошаљите download=yes

valuestring

Пример: Download

typestringобавезно

Пример: button_download_csv

listarray of object

idintegerобавезно

Пример: 12863367

branch_idintegerобавезно

Пример: 9054

sms_statusstring (OrderSmsStatus) обавезно

Статус SMS

Vrednosti: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) обавезно

Статус email-a

Vrednosti:errorwaitingsuccessneed_email

order_statusstring (OrderStatus) обавезно

Vrednosti:in_transitdoneassemblyin_kitchennot_processedready_to_transitwait_to_kitchenwait_remadecanceledconfirmedcooked

Пример: confirmed

cart_totalnumberобавезно

Пример: 100.55

order_numberinteger

Пример: 1

date_creationstring (DataTimeFormatSQL) обавезно

Пример: 2024-05-02 08:31:16

date_preorderstring (DataTimeFormatSQL)

Пример: 2024-05-02 08:31:16

timestamp_countdownintegerобавезно

Пример: 1718625496

time_preorderinteger

Пример: 7160

seconds_for_timerinteger

Пример: -14500

last_order_doneboolean

Пример: true

minutes_to_doneinteger

Пример: 60

payment_statusstring (OrderPayment) обавезно

Статус плаћања: није плаћено, у току, плаћено

Vrednosti:not_paidwaitingpaid

payment_methodstring (OrderPaymentMethod)

Način plaćanja

Vrednosti:cashonlinecard_upon_receipt

platformstring (Platform) обавезно

Vrednosti:androidiosallmobile_appssitesocial_apps

Пример: all

operator_phone_format_idinteger (PhoneFormatId)

Код земље: 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)

Пример: 1

operator_phone_numberstring

Пример: 9114579423

operator_emailstring

Пример: email@example.com

percent_rateintegerобавезно

Пример: 4

sender_namestring

Пример: John Doe

sender_phone_format_idinteger (PhoneFormatId)

Пример: 1

sender_phone_numberstring

Пример: 9114579423

sender_emailstring

Пример: email@example.com

recipient_namestring

Пример: John Doe

recipient_phone_format_idinteger (PhoneFormatId)

Пример: 1

recipient_phone_numberstring

Пример: 9114579423

address_zip_codestring

Пример: 236039

address_line_1string

Пример: Korablestroiteley st. 9 bld. 2

address_line_2string

Пример: Korablestroiteley st. 9 bld. 2

address_streetstring

Пример: Partizanskaya street

address_housestring

Пример: 20

address_buildingstring

Пример: 20

address_entrance_numberstring

Пример: 20

address_entrance_codestring

Пример: 1234

address_floorstring

Пример: 10

address_apartmentstring

Пример: 10

additional_changestring

Пример: 100

additional_personsstring

Пример: 2

additional_commentstring

Пример: Test order, remove

additional_greeting_cardstring

Пример: example

additional_discountstring

Пример: example

tokenstring

Пример: 72901fbe661d3e142ea9af5248856f20

delivery_methodstring (DeliveryMethod) обавезно

Način isporuke: no — nema, all — svi, courier — kurir, pickup — preuzimanje

Vrednosti:noallcourierpickup

phone_settingsobject

mask_enableboolean

Пример: true

formatboolean

Пример: true

internationalboolean

Пример: true

branch_namestring

Пример: Green Basket | Main

chain_namestringобавезно

Пример: Green Basket

city_namestringобавезно

Пример: Voronezh

courier_namestring

Пример: courier name

district_namestring

Пример: Voronezh-Uh

district_idinteger

Пример: 55329

application_uuidstring

Пример: 03addc0d-1051-4534-9ba8-792b763a274b

paginationobject (PaginationCursor)

max_countintegerобавезно

Број ставки по страници

Пример: 30

cursorintegerобавезноможе бити null

Курсор са којим је затражена тренутна страница; null — за прву страницу

next_cursorintegerобавезноможе бити null

id poslednjeg reda na ovoj stranici: prosledite ga sa direction=next da biste prešli napred; null — ako nema više podataka

Пример: 84512

previous_cursorintegerобавезноможе бити null

id prvog reda na ovoj stranici: prosledite ga sa direction=previous da biste se vratili nazad; null — ako nema ničega ranije

Пример: 84543

has_nextbooleanобавезно

Да ли postoji sledeća stranica

Пример: true

has_previousbooleanобавезно

Да ли postoji prethodna stranica

Пример: false

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

<?php

$client = new \GuzzleHttp\Client();

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

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

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

import requests

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

Одговор 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
    }
  }
}

Zahtevi se šalju na foodsoul.pro — ovo je host ovog portala, nije moguće izabrati drugi.