❗ Данная библиотека находится на стадии альфа-тестирования и ещё не готова к использованию в продакшене.

moysklad-ts это полностью типизированный клиент МойСклад.

npm

npm i moysklad-ts

pnpm add moysklad-ts

yarn add moysklad-ts

bun add moysklad-ts

import { Moysklad } from "https://esm.sh/moysklad-ts";

Библиотека требует Node.js версии 18 и выше, либо другой соответствующей среды исполнения, в которой доступен fetch API.

import { Moysklad } from "moysklad-ts";

const moysklad = new Moysklad({
  auth: {
    token: "123"
  }
});

// Получить контрагента с владельцем
const counterparty = await moysklad.counterparty.get("5427bc76-b95f-11eb-0a80-04bb000cd583", {
  expand: { owner: true }, // результат полностью типизирован
});

// Получить все отгрузки с контрагентом
const demands = await moysklad.demand.all({
  expand: { agent: true },
});

// Получить первую отгрузку контрагента
const demand = await moysklad.demand.first({
  filter: {
    agent: moysklad.client.buildUrl(["entity", "counterparty", "5427bc76-b95f-11eb-0a80-04bb000cd583"]).toString(),
  }, // автокомплит для всех опций запроса
});

Большинство методов интуитивно понятны и описаны с помощью JSDoc. Так что основной ресурс для изучения API - это документация МойСклад.

Все методы в классе Moysklad разделены на эндпоинты, которые соответствуют разделам API МойСклад (на английском).

Например, чтобы получить всех контрагентов (counteryparty) используйте moysklad.counterparty.all(). Или чтобы получить входящий платёж (paymentin), вызовите moysklad.paymentIn.get("id").

• composeDateTime - создаёт строку с датой в формате МойСклад
• parseDateTime - парсит строку с датой из формата МойСклад
• Moysklad.client.buildUrl - создаёт URL для запроса к API МойСклад

Пожалуйста, прочитайте contributing guidelines прежде чем начать работу над проектом. Спасибо!

Проект находится под лицензией GPL-3.0.