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

1. Установка пакета:

   $ npm install moysklad-client --save

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

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

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

Особенности

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

Документация

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

Версии

Все изменения в разделе Releases