enjoyform/moysklad

PHP SDK Moysklad API 1.2

dev-master 2021-02-24 08:09 UTC

This package is not auto-updated.

Last update: 2023-12-27 21:42:53 UTC


README

Данная библиотека предназначена для удобной работы с API Remap версии 1.2 МоегоСклада. Она содержит набор функций, позволяющий совершать базовые операции над сущностями (создание, чтение, изменение, удаление).

Установка

  • composer require cdekmarketteam/moysklad
  • composer dump-autoload

Пример работы

1. Начало работы

Основной класс, посредством которого осуществляется работа с SDK: MoySklad\ApiClient.

Для того, чтобы начать работу, требуется создать экземпляр этого класса, передав в конструктор поля:

  • адрес хоста API (online.moysklad.ru)
  • флаг принудительного соединения по https
  • логин в формате [имя пользователя]@[название компании] и пароль или готовый token для доступа к API:
use MoySklad\ApiClient;

$api = new ApiClient('host', true, [
    'login' => 'your_login',
    'password' => 'your_password',
]);

//or

$api = new ApiClient('host', true, [
   'token' => 'your_token',
]);

2. Работа с сущностями

2.1. Получение сущностей

Для доступа к эндпоинтам отдельных сущностей используется метод ApiClient->entity(), который возвращает базовый клиент для сущностей. Этот объект позволяет получить клиент для работы с конкретной сущностью. Например, чтобы получить список всех контрагентов или одного контрагента, достаточно выполнить следующий код:

$counterpartyList = $api->entity()->counterparty()->getList();
$counterparty = $api->entity()->counterparty()->get('id');

Список возможных фильтров:

  • EntityFilter - фильтр по сущности, можно назначить нескольким полям
  • Limit - лимит для пагинации, максимальное значение 1000
  • Offset - позиция начала отображения
  • Order - сортировка, может быть назначена по нескольким полям
  • Search - фильтр поиска, который принимает только значение
  • StandardFilter - стандартный фильтр поле|значение, можно назначить нескольким полям Работа с фильтрами:
    use MoySklad\Util\Param\Limit;
    use MoySklad\Util\Param\Offset;
    use MoySklad\Util\Param\Order;
    use MoySklad\Util\Param\Search;
    use MoySklad\Util\Param\EntityFilter;
    use MoySklad\Util\Param\StandardFilter;
    

$params = [

Limit::eq(50),
Offset::eq(10),
Order::asc('name'),
Order::desc('date'),
Search::eq('some interesting thing'),
EntityFilter::eq('product', $product),
EntityFilter::neq('pricetype', $pricetype),
StandardFilter::eq('region_id', $regionId),
StandardFilter::gte('created', $createdDate),
StandardFilter::like('name', 'ame'),

];

$counterpartyList = $api->entity()->counterparty()->getList($params);

Массив фильтров передается аргументом при вызове методов клиентов сущностей, там где это возможно.

#### 2.2. Создание сущностей
Чтобы отправить запрос к API на создание сущности, достаточно создать объект класса, заполнить необходимые поля, 
и затем при помощи соответствующего клиента вызвать метод `create()`, передав в качестве параметра созданный объект:

$product = new Product(); $product->name = 'Новый продукт';

$product = $api->entity()->product()->create($product);

После выполнения кода и при успешном создании вернется объект product, с заполенными полями, полученными из ответа API (`id`, `href` и др.).

#### 2.3. Изменение сущностей
Для изменения уже созданной сущности используются метод `editById()` или `editByEntity()` клиента сущности:

$product->name = 'new name'; $product = $api->entity()->product()->update($product);


#### 2.4. Вложенные сущности
Работа с вложенными сущностями производится при помощи специальных методов клиентов сущностей. 
Например, метод получения аккаунтов или аккаунта контрагента:

$counterpartyAccountsList = $api->entity()->counterparty()->getAccountsList('counterparty_id');

$counterpartyAccount = $api->entity()->counterparty()->getAccount('counterparty_id', 'account_id');

Полностью аналогично производится работа с остальными методами. 

В некоторых сущностях имеются свойства - вложенные сущности (например у контрагента есть полный адрес), 
такие вложенные сущности, как полный адрес, при ответе с API заполняются только метаданными, 
для того чтобы заполнить ее основные свойства необходимо вызвать метод `fetch()`:

$counterparty = $api->entity()->counterparty()->get('id'); $addressCity = $counterparty->legalAddressFull->city; // null

$counterparty->legalAddressFull->fetch(); $addressCity = $counterparty->legalAddressFull->city; // название города

Метод `fetch()` есть у каждой сущности, его можно использовать и для простого обновления сущности.

## Дальнейшее знакомство
Список доступных методов и сущностей, 
а также накладываемые ограничения по работе с API можно узнать в 
[Moysklad API 1.2 Doc](https://dev.moysklad.ru/doc/api/remap/1.2/)