მიიღეთ შეკვეთების სია

GET/api/crm/v2/ordersv2

operationId: orders.default

ავტორიზაცია

api-token + language + role

მოთხოვნის პარამეტრები

cursorinteger

გვერდის წაკითხვის პოზიცია: pagination.next_cursor — წინ, pagination.previous_cursor — უკან; პირველ გვერდზე არ გადმოაგზავნოთ. ეს არის შედარების საზღვარი და არა ბმული სტრიქონზე: სტრიქონი, რომელსაც მნიშვნელობა მიუთითებს, შეიძლება არ არსებობდეს, ამიტომ მოძველებული ბმულიც კი გახსნის გვერდს იმავე ადგილიდან. შეცდომა 346 ბრუნდება მხოლოდ იმ შემთხვევაში, თუ მნიშვნელობა არ შეიძლება აღიქმებოდეს როგორც დადებითი მთელი რიცხვი.

მაგალითი: 84512

directionstring

კურსორის მიმართულებით წაკითხვა; last ხსნის სიის ბოლოს და იგნორირებს კურსორს

მნიშვნელობები: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)

შეკვეთის სტატუსი: გზაშია, შესრულებულია, შეკრება, სამზარეულოშია, არ დამუშავებულა, გაგზავნისთვის მზადაა, სამზარეულოში გაგზავნის მოლოდინშია, გადაკეთების მოლოდინშია, გაუქმებულია, დადასტურებულია, მომზადებულია

მნიშვნელობები:in_transitdoneassemblyin_kitchennot_processedready_to_transitwait_to_kitchenwait_remadecanceledconfirmedcooked

მაგალითი: confirmed

platformstring (OrderPlatform)

შეკვეთის პლატფორმა

მნიშვნელობები:androidapifbiosvksite

delivery_methodstring (OrderDelivery)

მიწოდების მეთოდი: კურიერი ან თვითგატანა

მნიშვნელობები:courierpickup

payment_statusstring (OrderPayment)

გადახდის სტატუსი: არ გადახდილია, მოლოდინშია, გადახდილია

მნიშვნელობები:not_paidwaitingpaid

order_numberinteger

client_branch_profile_idinteger

client_account_idinteger

operator_idinteger

courier_idinteger

promo_codestring

შეკვეთების ფილტრი პრომოკოდის მიხედვით (ზუსტი დამთხვევა შეკვეთაზე გამოყენებულ აქციის პრომოკოდთან)

მაგალითი: Promo1

hide_completed_ordersstring

მნიშვნელობები:true

მაგალითი: true

downloadstring

მნიშვნელობები:yes

მაგალითი: yes

პასუხები

object

statusstringსავალდებულო

მნიშვნელობები: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 — განყოფილების შესვლის წერტილი: ყოველთვის ნაჩვენებია, ცარიელი მნიშვნელობა არ აქვს (სანამ მნიშვნელობა არ არის არჩეული, სია ცარიელია; ვარიანტი „ყველა“ არ არსებობს), საერთო გასუფთავება მას არ აშორებს.

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

date_creation_toobject (FilterDateTo)

valuestringშეიძლება იყოს null

მაგალითი: 2026-08-31 23:59:59

typestringსავალდებულო

მაგალითი: date

modestring (FilterMode)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

date_creation_rangeobject (FilterDateRange)

მზადყოფილი თარიღის ფილტრის პერიოდები; ქვედა ზღვარი გამოითვლება მომხმარებლის დროის სარტყელში. value — პერიოდი, რომელსაც შეესაბამება მიმდინარე *_from და *_to; null — თვითნებური პერიოდი. default — პერიოდი, რომელსაც სერვერი იყენებს თარიღების გარეშე მოთხოვნაში: ასევე გამოიყენება განყოფილების პირველ ჩატვირთვაზე და მას უბრუნდება სეტინგების განულებისას. პერიოდის ზედა ზღვარი ყოველთვის უდრის მომხმარებლის მიმდინარე დღეს, ამიტომ option მას არ შეიცავს: მზადყოფილი პერიოდისთვის *_to გადაცემა საჭირო არ არის, სერვერი თავად ადგენს მას. ერთი წელზე გრძელი პერიოდი იჭრება ახალი ზღვრის მხრიდან.

valuestring (DateRange) შეიძლება იყოს null

მზადყოფილი თარიღის ფილტრის პერიოდი. მას არ აქვს საკუთარი მოთხოვნის პარამეტრი: ქვედა ზღვარი უკვე გამოთვლილია option-ში და გამოიყენება როგორც *_from. ზედა ზღვარი არ გადმოიცემა არც პასუხში, არც მოთხოვნაში — ის ყოველთვის უდრის მომხმარებლის მიმდინარე დღეს და განისაზღვრება სერვერის მიერ.

მნიშვნელობები:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

მაგალითი: today

defaultstring (DateRange) სავალდებულო

მნიშვნელობები:todaythree_daysweektwo_weeksmonthquarterhalf_yearyear

მაგალითი: today

typestringსავალდებულო

მაგალითი: select

modestring (FilterMode)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

optionarray of objectსავალდებულო

valuestring (DateRange) სავალდებულო

მნიშვნელობები: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)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

branch_idobject (FilterSelectInteger)

valueinteger

მაგალითი: 8920

typestringსავალდებულო

მაგალითი: select

optionarray of object

valueintegerსავალდებულო

მაგალითი: 8920

namestringსავალდებულო

მაგალითი: Green Basket | Kaliningrad

modestring (FilterMode)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

phone_format_idobject (FilterSelectInteger)

valueinteger

მაგალითი: 8920

typestringსავალდებულო

მაგალითი: select

optionarray of object

valueintegerსავალდებულო

მაგალითი: 8920

namestringსავალდებულო

მაგალითი: Green Basket | Kaliningrad

modestring (FilterMode)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

phone_numberobject (FilterInput)

valuestring

მაგალითი: example

typestringსავალდებულო

მაგალითი: integer or string

placeholderstring

მაგალითი: string

modestring (FilterMode)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

emailobject (FilterInput)

valuestring

მაგალითი: example

typestringსავალდებულო

მაგალითი: integer or string

placeholderstring

მაგალითი: string

modestring (FilterMode)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

order_statusobject (FilterEnum)

ფილტრი-ჩამონათვალი — ბრტყელი ჩამონათვალი enum მნიშვნელობების

valuestring

მაგალითი: example

typestringსავალდებულო

მაგალითი: select

optionarray of string

modestring (FilterMode)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

platformobject (FilterEnum)

ფილტრი-ჩამონათვალი — ბრტყელი ჩამონათვალი enum მნიშვნელობების

valuestring

მაგალითი: example

typestringსავალდებულო

მაგალითი: select

optionarray of string

modestring (FilterMode)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

delivery_methodobject (FilterEnum)

ფილტრი-ჩამონათვალი — ბრტყელი ჩამონათვალი enum მნიშვნელობების

valuestring

მაგალითი: example

typestringსავალდებულო

მაგალითი: select

optionarray of string

modestring (FilterMode)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

payment_statusobject (FilterEnum)

ფილტრი-ჩამონათვალი — ბრტყელი ჩამონათვალი enum მნიშვნელობების

valuestring

მაგალითი: example

typestringსავალდებულო

მაგალითი: select

optionarray of string

modestring (FilterMode)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

order_numberobject (FilterId)

valueany

მაგალითი: 0

typestringსავალდებულო

მაგალითი: integer

placeholderstring

მაგალითი: integer

modestring (FilterMode)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

client_branch_profile_idobject (FilterId)

valueany

მაგალითი: 0

typestringსავალდებულო

მაგალითი: integer

placeholderstring

მაგალითი: integer

modestring (FilterMode)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

client_account_idobject (FilterId)

valueany

მაგალითი: 0

typestringსავალდებულო

მაგალითი: integer

placeholderstring

მაგალითი: integer

modestring (FilterMode)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

operator_idobject (FilterSelectInteger)

valueinteger

მაგალითი: 8920

typestringსავალდებულო

მაგალითი: select

optionarray of object

valueintegerსავალდებულო

მაგალითი: 8920

namestringსავალდებულო

მაგალითი: Green Basket | Kaliningrad

modestring (FilterMode)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

courier_idobject (FilterSelectInteger)

valueinteger

მაგალითი: 8920

typestringსავალდებულო

მაგალითი: select

optionarray of object

valueintegerსავალდებულო

მაგალითი: 8920

namestringსავალდებულო

მაგალითი: Green Basket | Kaliningrad

modestring (FilterMode)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

promo_codeobject (FilterInput)

valuestring

მაგალითი: example

typestringსავალდებულო

მაგალითი: integer or string

placeholderstring

მაგალითი: string

modestring (FilterMode)

მნიშვნელობები:force_shownvalue_required

მაგალითი: value_required

hide_completed_ordersobject (FilterBooleanCheckbox)

valueboolean

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

მაგალითი: false

typestringსავალდებულო

მაგალითი: checkbox

modestring (FilterMode)

მნიშვნელობები: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-ის სტატუსი

მნიშვნელობები: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) სავალდებულო

ელფოსტის სტატუსი

მნიშვნელობები:errorwaitingsuccessneed_email

order_statusstring (OrderStatus) სავალდებულო

მნიშვნელობები: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) სავალდებულო

გადახდის სტატუსი: არ გადახდილია, მოლოდინშია, გადახდილია

მნიშვნელობები:not_paidwaitingpaid

payment_methodstring (OrderPaymentMethod)

გადახდის მეთოდი

მნიშვნელობები:cashonlinecard_upon_receipt

platformstring (Platform) სავალდებულო

მნიშვნელობები: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) სავალდებულო

მიწოდების მეთოდი: no — არაა, all — ყველა, courier — კურიერი, pickup — თვითგატანა

მნიშვნელობები: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: გადააგზავნეთ იგი direction=next-თან ერთად, რათა გადახვიდეთ წინ; თუ მეტი აღარაფერია, მნიშვნელობაა null

მაგალითი: 84512

previous_cursorintegerსავალდებულოშეიძლება იყოს null

ამ გვერდზე პირველი სტრიქონის id: გადააგზავნეთ იგი პარამეტრით direction=previous, რომ დაბრუნდეთ უკან; თუ ადრე არაფერი იყო — null

მაგალითი: 84543

has_nextbooleanსავალდებულო

არის თუ არა შემდეგი გვერდი

მაგალითი: true

has_previousbooleanსავალდებულო

არის თუ არა წინა გვერდი

მაგალითი: false

curl -X GET 'https://foodsoul.pro/api/crm/v2/orders' \
  -H 'Authorization: Bearer fs_api_YOUR_TOKEN' \
  -H 'language: ka' \
  -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' => 'ka',
        '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": "ka",
        "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": "ka",
        "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
    }
  }
}

მოთხოვნები იგზავნება foodsoul.pro-ზე — ეს პორტალის ჰოსტია, სხვა არჩევა შეუძლებელია.