@opsregistry/adapter-tkkit

Адаптер ТК КИТ для универсальных логистических операций opsregistry.

Пакет принимает единый формат @opsregistry/contracts и преобразует его в запросы официального API ТК КИТ. Это дает приложению общий интерфейс расчета доставки для разных перевозчиков, а различия API остаются внутри адаптера.

Возможности

• it.identity.authenticate - подготовка доступа по Bearer-токену.
• logistics.shipment.quote - расчет доставки через /1.1/order/calculate.
• logistics.shipment.list - список заказов за период через /1.0/order/get-list.
• logistics.shipment.track - статус и история движения через /1.0/order/status/get.
• Поиск кодов городов через /1.1/tdd/search/by-name.
• Несколько грузовых мест.
• Дополнительные услуги, забор, доставка и страхование.

Доступ

Расчет сейчас работает через API с Bearer-токеном.

import { createAdapter } from '@opsregistry/adapter-tkkit';

const kit = createAdapter({
	accessToken: process.env.TKKIT_ACCESS_TOKEN,
	insuranceAgentCode: process.env.TKKIT_INSURANCE_AGENT_CODE
});

const quote = await kit.quoteShipment({
	origin: { city: 'Самара' },
	destination: { city: 'Москва' },
	deliveryMode: 'terminal_terminal',
	packages: [
		{ weightKg: 10, lengthCm: 100, widthCm: 20, heightCm: 20 },
		{ weightKg: 5, lengthCm: 20, widthCm: 20, heightCm: 50 }
	]
});

console.log(quote.options);

Известный код города передается в externalIds.tkkitCityCode.

Список заказов из личного кабинета:

const shipments = await kit.listShipments({
	dateFrom: '2026-07-01T00:00:00Z',
	dateTo: '2026-07-10T00:00:00Z',
	pageSize: 10
});

console.log(shipments.items);

API КИТ ограничивает период списка заказов 90 днями.

Отследить груз можно по номеру экспедиторской расписки:

const tracking = await kit.trackShipment({
	trackingNumber: 'ТБЛЕКБ0010000111'
});

console.log(tracking.status, tracking.events);

logistics.shipment.create пока не реализована.