Kaspi.kz-тегі Магазиннен API көмегімен тапсырыстарымның тізімін қалай алады?
Жаңартылды
31.07.2024
Ол үшін API-сұрату жіберіңіз. Кез келген, мысалы, Postman, Insomnia, Paw, Swagger, SoapUI сияқты сервисті пайдалануға немесе есеп жүйеңізбен біріктіруді баптауға болады.
Параметр
Мәні
page[number]
Сұрату нәтижесі бар бет нөмірі
Бір бетте ең көп 100 тапсырыс болуы мүмкін
0-ден бастап қажетті беттің нөмірін көрсетіңіз
page[size]
Жауаптағы бір бетте болатын тапсырыс саны
Ең көбі — 100
filter[orders][state]
Тапсырыс күйi
NEW
SIGN_REQUIRED
PICKUP
DELIVERY
KASPI_DELIVERY
ARCHIVE
жаңа
құжаттарға қол қою керек
өзі алып кету
сіздің жеткізу
Kaspi Жеткізу
архивте
filter[orders][creationDate]
Тапсырыс жасалған күн
Миллисекундпен көрсетіледі
[$ge]
[$le]
бастапқы мәні
соңғы мәні
filter[orders][status]
Тапсырыс мәртебесі
APPROVED_BY_BANK
ACCEPTED_BY_MERCHANT
COMPLETED
CANCELLED
CANCELLING
KASPI_DELIVERY_RETURN_REQUESTED
RETURNED
сатушы оны қабылдауға тиіс
қабылданды
аяқталды
күші жойылды
күшін жою барысында
қайтаруды күтеді
қайтарылды
filter[orders][deliveryType]
Жеткізу тәсілі
Егер filter [orders] [state] PICKUP DELIVERY, KASPI_DELIVERY немесе PICKUP тең болмаса ғана, пайдаланыңыз
PICKUP
DELIVERY
өзі алып кету
жеткізу
filter[orders][signatureRequired]
Құжаттарға қол қою
Егер filter [orders] [state] SIGN_REQUIRED тең болмаса, пайдаланыңыз
true
false
қажет
талап етілмейді
include[orders]
Тапсырыс туралы қосымша деректер
user
Тапсырысты ресімдеген сатып алушы туралы ақпарат
Сұрату мысалы қараңыз
GET
https://kaspi.kz/shop/api/v2/orders?page[number]=0&page[size]=20&filter[orders][state]=NEW
&filter[orders][creationDate][$ge]=1478736000000&filter[orders][creationDate][$le]=1479945600000
&filter[orders][status]=APPROVED_BY_BANK&filter[orders][deliveryType]=PICKUP
&filter[orders][signatureRequired]=false&include[orders]=user
Content-Type:application/vnd.api+json
X-Auth-Token: <token>
Жауапта сіз әр тапсырыс туралы ақпарат аласыз.
Атрибут
Мәні
code
Тапсырыс нөмірі
totalPrice
Тапсырыстың жалпы сомасы, теңге
customer
Сатып алушының аты-жөні мен телефон нөмірі
deliveryMode
Жеткізу тәсілі
DELIVERY_LOCAL
қала бойынша — Kaspi Жеткізу немесе сатушының күшімен
DELIVERY_PICKUP
"isKaspiDelivery": true
DELIVERY_REGIONAL_TODOOR
"isKaspiDelivery": true
Kaspi Postomat-қа жеткізу
Kaspi Жеткізу
DELIVERY_PICKUP
"isKaspiDelivery": false
DELIVERY_REGIONAL_PICKUP
өзі алып кету
облыс бойынша тапсырыс беру аймағымен қоймаға дейін жеткізу, сатып алушы өзі алып кетеді
paymentMode
Тапсырыс құнын төлеу тәсілі
PAY_WITH_CREDIT
PREPAID
Зат сатып алуға Кредит
қолма-қол ақшасыз төлем
signatureRequired
Кредитке қол қою
true
false
қажет
қажеті жоқ
creditTerm
Зат сатып алуға Кредит мерзімі
preOrder
Алдын ала тапсырыспен ресімделген
true
false
иә
жоқ
state
Тапсырыс күйі
NEW
SIGN_REQUIRED
PICKUP
DELIVERY
KASPI_DELIVERY
ARCHIVE
жаңа
құжаттарға қол қою керек
өзі алып кету
сіздің жеткізу
Kaspi Жеткізу
архивте
creationDate
Тапсырыс жасалған күн
Миллисекундпен көрсетіледі
approvedByBankDate
Банктің тапсырысты мақұлдаған күні
Миллисекундпен көрсетіледі
plannedDeliveryDate
Жоспарлы жеткізу күні
Миллисекундпен көрсетіледі
reservationDate
Алдын ала тапсырыспен жеткізу күні
Миллисекундпен көрсетіледі
status
Тапсырыс мәртебесі
APPROVED_BY_BANK
ACCEPTED_BY_MERCHANT
COMPLETED
CANCELLED
CANCELLING
KASPI_DELIVERY_RETURN_REQUESTED
RETURNED
сатушы оны қабылдауға тиіс
қабылданды
аяқталды
күші жойылды
күшін жою барысында
қайтаруды күтеді
қайтарылды
deliveryCost
Жеткізу құны
id
Бірегей код
waybill
Жүкқұжатқа сілтеме
Kaspi Жеткізу үшін басып шығару және тапсырыстарға бекіту керек
courierTransmissionPlanningDate
Kaspi Жеткізу курьеріне тапсырысты беретін жоспарлы күн