SelSup Developers

Аяқтан аяғына дейін жұмыс барысы · Кірістер

Тапсырмалар және кезең-кезеңмен қадамдастыру

Веб-дүкенде тапсырыстар жасау, дубликаттарды болдырмау, бетбелгіленген экспорттау және өзгертілген тапсырыстарды өңдеу.

4 бөлімдеріДамушы нұсқаулығы
→

Сенімді интеграция бастапқы жүктемені, өзгерістер ағынын және келісімді бөліп алады. externalOrderId SelSup тапсырысын жүйеге қосып береді.

Веб-магазиндар, тапсырыстарды басқару және жеткізу жүйелері

01

Веб- дүкеннен тапсырыс жасау

Өнімдерді SelSup productId-ке картада сақтау тапсырыстар жасалмас бұрын.

Сыртқы тапсырыс нөмірін externalOrderId-ге жіберіп, қайтадан тексеруден бұрын дерекқорыңызда тексеріңіз.

Әр өнім үшін өнімнің идентификаторы, мөлшері және сату-кеңес логикасы бойынша талап етілетін бағаны келтіріңіз.

!
POST- ды қайта сынау

Желідегі уақыт үзілгеннен кейін, алдымен сыртқы тапсырыс іздеңіз. Бірінші сұрау жауап жоғалғанға дейін орындалған болуы мүмкін, сондықтан бұдан кейін бұдан бұрын бұдан тыс тапсырманы жасамаңыз.

Шағын сауда тапсырысы · JSON
{
  "type": "RETAIL",
  "organizationId": 1,
  "externalOrderId": "SHOP-12345",
  "products": [
    {
      "productId": 1422585,
      "quantity": 2,
      "price": 1000
    }
  ]
}

Қатысушы API соңғы нүктелері

POST/api/order/Түйісті құруGET/api/product/findКарта өнімдері

02

Бастапқы тапсырыс бойынша экспорт

Қалыпты көлемдегі параметрлердегі тапсырыстарды оқу. Тек жетістікті есеп беру немесе соңғы санның келісу қажеттіліктері толық болған кезде count=true-ды қолдану.

SelSup ID мен сыртқы тапсырыс ID-ті сақтаңыз. Келесі бетке өту алдында әрбір өңделген бетті атомдық түрде жүктеңіз.

  1. 1

    Экспорт шегін түсіру

    Бастау уақытын сақтаңыз, сондықтан толық сканерлеу кезінде орын алатын өзгерістер үдемелі өту арқылы қабылданады.

  2. 2

    Әр бетті өңдеу

    Бір қатарға жататын параллельді беттерден аулақ болу керек, егер сұрыптау және негізгі жазбалар өзгеруі мүмкін.

  3. 3

    Қалпына келтіру пропускасын орындаңыз

    Толық жүктемеден кейін, сақталған шекарадан бастап өзгертілген тапсырыстарды сұраңыз.

Қатысушы API соңғы нүктелері

GET/api/order/findІздеу бұйрықтары

03

Процесс өзгерісі бос орындарсыз

Назардағы іздеу шартында болған кезде өзгертілген Күні сүзгісін қолданыңыз. Бүкіл бет табысты өңделгеннен кейін ғана курсорды алға жылжытыңыз.

Уақыт терезесін бірнеше минутпен біріктіріп, ID және modifiedDate арқылы көшіріп алу. Бұл жазу кешіктірілуінен және сағат айырмашылығынан қорғайды.

Жергілікті тапсырыс көрсетілімін ауыстыру, өйткені жай-күйі, мекенжайы, элементтері, таңбалау кодтары немесе осыған байланысты деректер өзгеруі мүмкін.

i
Уақытты басқару

Курсорды дәл API дәлдікті пайдалана отырып UTC-де сақтау. секундтарды дөңгелектеп немесе сервер-орындық уақытты ауыспаусыз пайдаланбаңыз.

Өмірдің өзгеруі · HTTP
GET /api/order/find?modifiedDate=2026-08-09T10:00:00Z&page=1&limit=100
Authorization: YOUR_API_TOKEN

Қатысушы API соңғы нүктелері

GET/api/order/findҮдемелі іздеуGET/api/order/{orderId}Тауарды жеке куәлікпен жүктеу

04

Жеделсіздіктер мен сәйкессіздіктерді басқару

  1. 1

    Жіберу алдында жарамдылық

    Әр өнімнің ұйымын, тапсырыс түрін, қоймасын, нарығын, мөлшерін және бағасын тексеріңіз.

  2. 2

    Өткінші және тұрақты қателерді бөлектеу

    Жарамсыз деректер түзетілуі қажет, ал желі қатесі нәтиже тексерілгеннен кейін қайта тексерілуі қажет.

  3. 3

    Мерзімді түрде келісу

    Негізгі өзгерістер ағынына қарамастан, бір-бірімен жабысып тұрған кезеңдегі мәртебелер мен тапсырыс мазмұнын салыстыру.

!
Қате коды, мәтін емес

error-тегі филиал. localMessage токен иелері үшін орналастырылған және өзгеруі мүмкін.