Λήψη λίστας πηγών πρόσθετων πωλήσεων

GET/api/crm/v2/additional_salesv2

operationId: additionalSales.default

Επιστρέφει μια λίστα πηγών πρόσθετων πωλήσεων του υποκαταστήματος με φίλτρο κατά τύπο πηγής (item, item_parameter, category). Για κάθε πηγή επιστρέφονται τα συνδεδεμένα προϊόντα, κατηγορίες και παράμετροι προϊόντων· η λίστα είναι ταξινομημένη και διαχωρισμένη σε σελίδες.

Εξουσιοδότηση

api-token + language + role

Παράμετροι ερωτήματος

branch_idinteger

Παράδειγμα: 1

link_typestring

Τιμές:itemitem_parametercategory

page_numberinteger

Παράδειγμα: 1

Απαντήσεις

object

statusstringυποχρεωτικό

Τιμές:successerror

Παράδειγμα: success

dataobjectυποχρεωτικό

filtersobject

branch_idobject (FilterSelectInteger)

valueinteger

Παράδειγμα: 8920

typestringυποχρεωτικό

Παράδειγμα: select

optionarray of object

valueintegerυποχρεωτικό

Παράδειγμα: 8920

namestringυποχρεωτικό

Παράδειγμα: Green Basket | Kaliningrad

modestring (FilterMode)

Πώς το περιβάλλον χειρίζεται το φίλτρο· το συνηθισμένο φίλτρο δεν έχει mode. Το force_shown — εμφανίζεται πάντα, δεν μπορεί να αποκρυφθεί. Το value_required — σημείο εισόδου στην ενότητα: εμφανίζεται πάντα, δεν έχει κενή τιμή (μέχρι να επιλεγεί τιμή, η λίστα είναι κενή· δεν υπάρχει επιλογή «όλα»), η γενική επαναφορά δεν το καθαρίζει.

Τιμές:force_shownvalue_required

Παράδειγμα: value_required

link_typeobject

typestringυποχρεωτικό

Παράδειγμα: radio

optionarray of string

listarray of object

link_itemobjectυποχρεωτικό

idintegerυποχρεωτικό

Παράδειγμα: 1

typestringυποχρεωτικό

Τιμές:itemitem_parametercategory

Παράδειγμα: item

namestringυποχρεωτικό

Παράδειγμα: Example item

strategystringμπορεί να είναι null

Η στρατηγική που δημιούργησε την πηγή· null — δημιουργήθηκε χειροκίνητα

Τιμές:sales_statisticsai_compatibilityai_prompt

Παράδειγμα: sales_statistics

related_objectsarray of objectυποχρεωτικό

idintegerυποχρεωτικό

Παράδειγμα: 1

typestringυποχρεωτικό

Τιμές:itemitem_parametercategory

Παράδειγμα: item

namestringυποχρεωτικό

Παράδειγμα: Recommended item

strategystringμπορεί να είναι null

Στρατηγική που δημιούργησε τη σύνδεση· null — προστέθηκε χειροκίνητα

Τιμές:sales_statisticsai_compatibilityai_prompt

Παράδειγμα: ai_compatibility

sortintegerυποχρεωτικό

Παράδειγμα: 1

idintegerυποχρεωτικό

Παράδειγμα: 1

paginationobject (Pagination)

max_countintegerυποχρεωτικό

Αριθμός στοιχείων ανά σελίδα

Παράδειγμα: 30

page_numberintegerυποχρεωτικό

Αριθμός τρέχουσας σελίδας· περιορίζεται ώστε η μετατόπιση να μην υπερβαίνει το 1000

Παράδειγμα: 1

has_nextbooleanυποχρεωτικό

Υπάρχει επόμενη σελίδα

Παράδειγμα: true

has_previousbooleanυποχρεωτικό

Υπάρχει προηγούμενη σελίδα

Παράδειγμα: false

<?php $client = new \GuzzleHttp\Client(); $response = $client->request('GET', 'https://foodsoul.ru/api/crm/v2/additional_sales', [ 'headers' => [ 'Authorization' => 'Bearer fs_api_YOUR_TOKEN', 'language' => 'el', 'role' => 'partner', ], ]); $data = json_decode((string) $response->getBody(), true);

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

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

{ "status": "success", "data": { "filters": { "branch_id": { "value": 8920, "type": "select", "option": [ { "value": 8920, "name": "Green Basket | Kaliningrad" } ], "mode": "value_required" }, "link_type": { "type": "radio", "option": [ "item" ] } }, "list": [ { "link_item": { "id": 1, "type": "item", "name": "Example item" }, "strategy": "sales_statistics", "related_objects": [ { "id": 1, "type": "item", "name": "Recommended item", "strategy": "ai_compatibility" } ], "sort": 1, "id": 1 } ], "pagination": { "max_count": 30, "page_number": 1, "has_next": true, "has_previous": false } } }