Демо-режим: дані статичні, дії не зберігаються.

API

REST API для автоматичного оформлення замовлень з вашої CRM / сайту

Доступ

Base URL

https://b2b.nb.ua/api/v1

Авторизація

Authorization: Bearer <token>

Ліміт

120 запитів / хв

Керувати токеном

Ендпоінти

GET/productsТовари, ціни, залишки

GET/products/{sku}Один товар

GET/stockТільки залишки (легкий)

POST/ordersСтворити замовлення

GET/ordersСписок замовлень

GET/orders/{id}Статус, ТТН

DELETE/orders/{id}Скасувати (якщо нове)

GET/balanceБаланс і кредит

GET/np/cities?q=Пошук міст НП

GET/np/warehouses?city=Відділення НП

Приклад: створити замовлення

curl -X POST https://b2b.nb.ua/api/v1/orders \
  -H "Authorization: Bearer nb_live_••••" \
  -H "Content-Type: application/json" \
  -d '{
  "external_id": "SHOP-10045",
  "scheme": "dropship",          // direct | dropship
  "payment": "cod",              // cod | credit | invoice
  "cod_amount": 22900,
  "delivery": {
    "carrier": "np",             // np | pickup
    "type": "warehouse",         // warehouse | postomat | courier
    "city_ref": "db5c88f0-391c-11dd-90d9-001a92567626",
    "warehouse_ref": "1ec09d88-e1c2-11e3-8c4a-0050568002cf"
  },
  "recipient": { "last_name": "Бондар", "first_name": "Ігор", "phone": "380501112233" },
  "items": [ { "sku": "STARLINK-MINI", "qty": 1 } ],
  "comment": "Дзвонити перед відправкою"
}'

Відповідь

{
  "id": 8522,
  "status": "new",
  "total": 19500,
  "credit_used": 0,
  "available_after": 31795
}

Webhook (зміна статусу)

POST https://your-site.ua/nb-webhook
X-NB-Signature: sha256=…
{ "event": "order.status", "id": 8522, "external_id": "SHOP-10045", "status": "shipped", "ttn": "20451012345678" }