Moysklad-client NPM

moysklad-client

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

ВНИМАНИЕ! Библиотека использует устаревший на текущий момент XML REST API сервиса МойСклад. Взамен МойСклад предлагает использовать новый JSON API интерфейс. Разработка библиотеки для нового API ведется в другом репозитории
ВНИМАНИЕ! Код не покрыт тестами, поэтому будьте осторожны при использовании функционала обновления данных, т.к. есть вероятность наличия ошибок.
Информацию об ошибках, вопросы и предложениях просьба оставлять в разделе 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);

Установка

Node.js

Установка пакета:
```
$ npm install moysklad-client --save
```

Подключение:

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

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

Особенности

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