PHPackages mbilkin/moysklad - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. mbilkin/moysklad ActiveLibrary mbilkin/moysklad ================ PHP SDK Moysklad API 1.2 v1.5.1-alpha.6(2y ago)00MITPHPPHP >=7.3 Since Sep 22Pushed 2y agoCompare [ Source](https://github.com/mbilkin/moysklad)[ Packagist](https://packagist.org/packages/mbilkin/moysklad)[ Docs](https://github.com/cdekmarketteam/moysklad)[ RSS](/packages/mbilkin-moysklad/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (1)Dependencies (6)Versions (8)Used By (0) PHP SDK Moysklad API 1.2 ======================== [](#php-sdk-moysklad-api-12) Данная библиотека предназначена для удобной работы с API Remap версии 1.2 МоегоСклада. Она содержит набор функций, позволяющий совершать базовые операции над сущностями (создание, чтение, изменение, удаление). Установка --------- [](#установка) - `composer require mbilkin/moysklad` - `composer dump-autoload` Пример работы ------------- [](#пример-работы) ### 1. Начало работы [](#1-начало-работы) Основной класс, посредством которого осуществляется работа с SDK: `MoySklad\ApiClient`. Для того, чтобы начать работу, требуется создать экземпляр этого класса, передав в конструктор поля: - адрес хоста API (`api.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-работа-с-сущностями) #### 2.1. Получение сущностей [](#21-получение-сущностей) Для доступа к эндпоинтам отдельных сущностей используется метод `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. Создание сущностей [](#22-создание-сущностей) Чтобы отправить запрос к API на создание сущности, достаточно создать объект класса, заполнить необходимые поля, и затем при помощи соответствующего клиента вызвать метод `create()`, передав в качестве параметра созданный объект: ``` $product = new Product(); $product->name = 'Новый продукт'; $product = $api->entity()->product()->create($product); ``` После выполнения кода и при успешном создании вернется объект product, с заполенными полями, полученными из ответа API (`id`, `href` и др.). #### 2.3. Изменение сущностей [](#23-изменение-сущностей) Для изменения уже созданной сущности используются метод `editById()` или `editByEntity()` клиента сущности: ``` $product->name = 'new name'; $product = $api->entity()->product()->update($product); ``` #### 2.4. Вложенные сущности [](#24-вложенные-сущности) Работа с вложенными сущностями производится при помощи специальных методов клиентов сущностей. Например, метод получения аккаунтов или аккаунта контрагента: ``` $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/) ### Health Score 16 — LowBetter than 5% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity0 Limited adoption so far Community13 Small or concentrated contributor base Maturity29 Early-stage or recently created project Bus Factor1 Top contributor holds 56.4% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~28 days Recently: every ~42 days Total 7 Last Release 791d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/469bf2a692fc9d534935b2cfcd3a38499226fcd3c91b7f3cf1fd683f70aa7c56?d=identicon)[mbilkin](/maintainers/mbilkin) --- Top Contributors [![Flicster](https://avatars.githubusercontent.com/u/17875665?v=4)](https://github.com/Flicster "Flicster (79 commits)")[![va-fursenko](https://avatars.githubusercontent.com/u/16989618?v=4)](https://github.com/va-fursenko "va-fursenko (38 commits)")[![mbilkin](https://avatars.githubusercontent.com/u/23665467?v=4)](https://github.com/mbilkin "mbilkin (10 commits)")[![ustasby](https://avatars.githubusercontent.com/u/503334?v=4)](https://github.com/ustasby "ustasby (5 commits)")[![EvilDevRu](https://avatars.githubusercontent.com/u/3668960?v=4)](https://github.com/EvilDevRu "EvilDevRu (3 commits)")[![mixo](https://avatars.githubusercontent.com/u/10971541?v=4)](https://github.com/mixo "mixo (3 commits)")[![vaiil](https://avatars.githubusercontent.com/u/3755615?v=4)](https://github.com/vaiil "vaiil (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)") ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/mbilkin-moysklad/health.svg) ``` [![Health](https://phpackages.com/badges/mbilkin-moysklad/health.svg)](https://phpackages.com/packages/mbilkin-moysklad) ``` ### Alternatives [ec-cube/ec-cube EC-CUBE EC open platform. 78527.0k1](/packages/ec-cube-ec-cube)[concrete5/core Concrete core subtree split 19159.3k48](/packages/concrete5-core)[open-dxp/opendxp Content & Product Management Framework (CMS/PIM) 7310.3k29](/packages/open-dxp-opendxp)[webit/w-firma-api wFirma.pl API 1820.2k](/packages/webit-w-firma-api)[cdekmarketteam/moysklad PHP SDK Moysklad API 1.2 162.6k](/packages/cdekmarketteam-moysklad)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 255.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)