PHPackages omkod/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. [API Development](/categories/api) 4. / 5. omkod/moysklad ActiveLibrary[API Development](/categories/api) omkod/moysklad ============== PHP SDK Moysklad API 1.2 1.0.3(2y ago)08MITPHPPHP >=7.3 Since Apr 1Pushed 2y agoCompare [ Source](https://github.com/omkod/moysklad)[ Packagist](https://packagist.org/packages/omkod/moysklad)[ Docs](https://github.com/omkod/moysklad)[ RSS](/packages/omkod-moysklad/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (4)Dependencies (6)Versions (5)Used By (0) PHP SDK Moysklad API 1.2 ======================== [](#php-sdk-moysklad-api-12) Данная библиотека предназначена для удобной работы с API Remap версии 1.2 МоегоСклада. Она содержит набор функций, позволяющий совершать базовые операции над сущностями (создание, чтение, изменение, удаление). Установка --------- [](#установка) - `composer require cdekmarketteam/moysklad` - `composer dump-autoload` Пример работы ------------- [](#пример-работы) ### 1. Начало работы [](#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-работа-с-сущностями) #### 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 20 — LowBetter than 14% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity4 Limited adoption so far Community13 Small or concentrated contributor base Maturity39 Early-stage or recently created project Bus Factor1 Top contributor holds 56.8% 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 ~0 days Total 4 Last Release 768d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/0ebf6af78101333a81b0615fd05ec9722bfdab8557ff8ae9838ff27d232634c1?d=identicon)[aman1792](/maintainers/aman1792) --- 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)")[![aman1792](https://avatars.githubusercontent.com/u/10086783?v=4)](https://github.com/aman1792 "aman1792 (9 commits)")[![ustasby](https://avatars.githubusercontent.com/u/503334?v=4)](https://github.com/ustasby "ustasby (5 commits)")[![mixo](https://avatars.githubusercontent.com/u/10971541?v=4)](https://github.com/mixo "mixo (3 commits)")[![EvilDevRu](https://avatars.githubusercontent.com/u/3668960?v=4)](https://github.com/EvilDevRu "EvilDevRu (3 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![vaiil](https://avatars.githubusercontent.com/u/3755615?v=4)](https://github.com/vaiil "vaiil (1 commits)") ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/omkod-moysklad/health.svg) ``` [![Health](https://phpackages.com/badges/omkod-moysklad/health.svg)](https://phpackages.com/packages/omkod-moysklad) ``` ### Alternatives [tencentcloud/tencentcloud-sdk-php TencentCloudApi php sdk 3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[dsc/mercado-livre Client para integração com API do Mercado Livre 8138.7k](/packages/dsc-mercado-livre)[webit/w-firma-api wFirma.pl API 1820.2k](/packages/webit-w-firma-api)[eversign/eversign-php-sdk The official PHP SDK Wrapper for the Eversign API 16161.5k](/packages/eversign-eversign-php-sdk)[mapado/rest-client-sdk Rest Client SDK for hydra API 1125.9k2](/packages/mapado-rest-client-sdk) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)