NWMS API: доставка и служебные API

GET/api/delivery/apiship/cities

Поиск городов для калькулятора доставки. Нужен orders.view.

query	Поиск по названию города, max 100.
region	Поиск по региону, max 100.
providerKey	Фильтр по службе доставки, например `cdek`.
limit	1-50, по умолчанию 20.

GET /api/delivery/apiship/cities?query=Москва&providerKey=cdek&limit=20

GET/api/delivery/apiship/pickup-points

Список ПВЗ через ApiShip /lists/points. Нужен orders.view и активный ApiShip account для домена.

cityGuid/city	Фильтр по GUID города или названию.
providerKey	Ключ службы доставки.
type[]	1 ПВЗ, 2 постамат, 3 почта, 4 терминал.
cod/paymentCard	0 или 1.
offset/limit	`limit` максимум 200, по умолчанию 100.
stateCheckOff	boolean, по умолчанию передается как 1.

POST/api/delivery/apiship/calculate

Расчет вариантов доставки через ApiShip calculator. Нужен orders.view.

{
  "to": {
    "countryCode": "RU",
    "city": "Москва",
    "cityGuid": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
    "addressString": "Москва, ул. Машкова 21",
    "index": "105066"
  },
  "places": [
    {
      "width": 20,
      "height": 45,
      "length": 30,
      "weight": 1500
    }
  ],
  "assessedCost": 1000,
  "codCost": 0,
  "pickupDate": "2026-04-30",
  "pickupTypes": [1, 2],
  "deliveryTypes": [1, 2],
  "providerKeys": ["cdek"],
  "pointOutId": 140803,
  "includeFees": false,
  "timeout": 20000
}

Если from не передан, адрес отправителя собирается из настроек активного ApiShip account.

{
  "ok": true,
  "variants": [
    {
      "channel": "door",
      "providerKey": "cdek",
      "tariffId": 19,
      "tariffName": "Экспресс лайт склад-дверь",
      "deliveryCost": 370,
      "daysMin": 2,
      "daysMax": 3
    }
  ],
  "raw": {},
  "from": {},
  "to": {}
}

GET/api/order-delivery-payments

Read-only список строк оплат доставки rw_order_delivery_payments. Нужен orders.view.

Фильтры	`odp_id`, `odp_order_id`, `odp_track_id`, `odp_status_id`, `odp_payment_order_id`, `odp_etalon_order_id`, `odp_transaction_id`, `odp_cod_act_id`.
Даты	`created_from`, `created_to` в формате `YYYY-MM-DD`.
Сортировка	`sort_by`: `odp_id`, `odp_order_id`, `odp_track_id`, `odp_delivery_sum`, `odp_delivery_tax`, `odp_cod_sum`, `odp_cod_agent_sum`, `odp_status_id`, `odp_payment_order_id`, `created_at`. `sort_dir=asc\|desc`.
Пагинация	`per_page` максимум 250.

POST/api/openclaw/messages

Callback для входящих сообщений OpenClaw. Не использует Sanctum; проверяет Bearer token из config('openclaw.reply_token').

{
  "chatId": "wms:123",
  "text": "Ответ ассистента",
  "threadId": "thread-1",
  "replyToId": "local-message-id",
  "metadata": {
    "inboundMessageId": "msg-1",
    "externalMessageId": "ext-1"
  }
}

chatId	Обязателен, max 64. Система пробует варианты с префиксом `wms:` и без него.
text	Обязателен, max 20000.
threadId/replyToId	Необязательные строки max 191.
metadata	Необязательный объект. Используется для dedupe и восстановления чата.

{
  "ok": true,
  "id": 123
}

Доставка и служебные API