moysklad-client

JavaScript клиент для комфортной работы с API сервиса МойСклад.

moysklad-client

JavaScript клиент для работы с API SaaS сервиса МойСклад.

ВНИМАНИЕ! Библиотека находится на стадии становления и пока не покрыта тестами, поэтому будьте осторожны при использовании функционала обновления данных, т.к. есть вероятность наличия ошибок.

Приветствуются любые предложения касательно интерфейса и расширения функциональности библиотеки.

Информацию об ошибках, вопросы и предложениях просьба оставлять в разделе Issues

Пример кода в синхронном режиме:

var client  = require('moysklad-client').createClient(),
 
// Получаем самый большой заказ за 2013 год. 
var order = client.from('customerOrder')
    .select({
        applicable: true,
        moment: client.between(new Date(2013, 0, 1), new Date(2013, 11, 31))
    })
    .orderBy('sum.sum', 'desc')
    .first();
 
// Привязываем ленивую загрузку, после чего можно будет обращаться к связанным сущностям, напр. order.sourceAgent.name 
client.createLazyLoader().attach(order);
 
// Клиент оформивший заказ 
var agent = order.sourceAgent;
 
console.log('Лучший клиент 2013 года - ' + agent.name);
console.log('оформил заказ на сумму ' + order.sum.sum / 100 + ' руб.');
 
// Давйте сделаем хорошему клиенту скидку 3%! 
agent.discount = 3;
 
// Сохраним контрагента с измененной скидкой в МойСклад 
client.save(agent);
  1. Установка пакета:

    $ npm install moysklad-client --save-dev
  2. Подключение:

    var client = require('moysklad-client').createClient();

Настройка библиотеки для других сред описана в разделе документации Быстрый старт

  • Взаимодействие с МойСклад на любой платформе и среде где может выполнятся JavaScript код.
  • Поддержка синхронного (браузер, Google Script, Taist) и асинхронного (node.js) режима разработки.
  • Поддержка всех возможностей API МойСклад.
  • Реализована полная объектная модель сервиса на основе официальной схемы данных.
  • Описание объектной модели отделено от программного кода библиотеки, что сокращает расходы на поддержку при обновлениях МойСклад.

Полная документация представлена в разделе Wiki

Все изменения отмечаются в разделе Releases