SelSup Developers

Асноўны працоўны паток · Кіраўнікі

Заказы і паступная сінхранізацыя

Стварэнне замоў у вэб-краме, прадухіленне дублікавання, старонкавыя экспарты і апрацоўка змененых замоў.

4 раздзелыКіраўніцтва распрацоўшчыкам
→

надзейная інтэграцыя аддзяляе пачатковае загрузку, паток змен і ўзгадненне. exterOrderId падключае парадак SelSup да вашай сістэмы.

Інтэрнэт-крамы, кіраванне замовамі і сістэмы дастаўкі

01

Стварэнне замовы ў інтэрнэт-краме

Карта захоўваць прадукты ў SelSup прадуктId перад стварэннем заказаў. Не вырашаць прадукцыі з зменным назвай дысплея падчас заяўкі.

Пашліце нумар знешняга заказаў у exterOrderId і праверце яго ў базе дадзеных перад паўторнай спробай. organizationId асабліва важна ў шматарганізацыйных рахунках.

Уключыце прадуктId, колькасць і цана, патрабуецца вашай логікі прадавец-каналу для кожнага прадмета.

!
Перапрабаванне 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 і exterOrderId. Завершыць кожную апрацаваную старонку атэматычна, перш чым перайсці на наступную старанку.

  1. 1

    Захоп мяжы экспарту

    Захаваць час пачатку, каб змены, якія адбываюцца падчас поўнага сканавання, будуць адзначаны паступным праход.

  2. 2

    Працэдура кожнай старонкі

    Пазбягайце паралельных старонак з аднаго дыяпазону, калі адрозненне і асноўныя запісы могуць змяняцца.

  3. 3

    Выканайце пераменны прапуск

    Пасля поўнай загрузкі, запытайце замовы, змененыя з захаванай мяжы з невялікім перакладам.

Сродкі API канечныя пункты

GET/api/order/findЗагад аб пошуку

03

Зменаў працэсу без прабелаў

Выкарыстоўвайце фільтр modifiedDate, калі ён прысутнічае ў бягучым дагаворы пошуку.

Пераклад вокнаў часу на некалькі хвілін і дэдуплікуюць з id і мадыфікаванайDate. Гэта абараняе ад затрымкі напісання і ад адрозненняў гадзінніка.

Замяніць рэпрэзентацыю мясцовага парадку, таму што статус, адрас, элементы, коды маркіроўкі або сувязныя дадзеныя могуць змяняцца.

i
Працаванне часу

Захоўваць курсор у UTC з дапамогай дакладнай дакладнасці API. Не закругляць секунды або выкарыстоўваць сервер-меснавае час без кампенсацыі.

Змененыя паказанні · 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}Загрузіць заказ па ID

04

Выкарыстанне няўдач і неадпаведнасцяў

  1. 1

    Падтверджэнне перад адпраўкай

    Праверце арганізацыю, тып замовы, склад, рынак, колькасць і кошт кожнага прадмета.

  2. 2

    Асобныя пераходныя і пастаянныя памылкі

    Недахопы дадзеных трэба выправіць, у той час як недахопу сеткі трэба кантраляванае паўторнае паспрабаванне пасля праверкі вынікаў.

  3. 3

    Перыядычна пагаджацца

    Параўноўвайце статус і ўтрыманне заказаў на працягу перасякальнага перыяду незалежна ад асноўнага патоку змен.

!
Код памылкі, не тэкст

Пераклад на error. localMessage лакалізаваны для ўладальніка токен і можа змяняцца.