PHPackages                             wardenyarn/mawiapi - 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. wardenyarn/mawiapi

ActiveLibrary[API Development](/categories/api)

wardenyarn/mawiapi
==================

API for Mawisoft Salesmax CRM

1.0.2(4y ago)04MITPHP

Since Feb 3Pushed 4y ago1 watchersCompare

[ Source](https://github.com/three-cos/mawiapi)[ Packagist](https://packagist.org/packages/wardenyarn/mawiapi)[ RSS](/packages/wardenyarn-mawiapi/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (4)Versions (4)Used By (0)

API Salesmax
============

[](#api-salesmax)

- [Подготовка](#%D0%9F%D0%BE%D0%B4%D0%B3%D0%BE%D1%82%D0%BE%D0%B2%D0%BA%D0%B0)
- [Установка](#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0)
- [Инициализация](#%D0%98%D0%BD%D0%B8%D1%86%D0%B8%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F)
- [Клиенты](#%D0%9A%D0%BB%D0%B8%D0%B5%D0%BD%D1%82%D1%8B)
- [Сделки](#%D0%A1%D0%B4%D0%B5%D0%BB%D0%BA%D0%B8)
- [Продукты](#%D0%9F%D1%80%D0%BE%D0%B4%D1%83%D0%BA%D1%82%D1%8B)
- [Контактные лица](#%D0%9A%D0%BE%D0%BD%D1%82%D0%B0%D0%BA%D1%82%D0%BD%D1%8B%D0%B5-%D0%BB%D0%B8%D1%86%D0%B0)
- [Платежи](#%D0%9F%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%B8)
- [Счета](#%D0%A1%D1%87%D0%B5%D1%82%D0%B0)
- [События в календаре](#%D0%A1%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D1%8F-%D0%B2-%D0%BA%D0%B0%D0%BB%D0%B5%D0%BD%D0%B4%D0%B0%D1%80%D0%B5)
- [Документы](#%D0%94%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D1%8B)
- [Лицензия](#%D0%9B%D0%B8%D1%86%D0%B5%D0%BD%D0%B7%D0%B8%D1%8F)

Подготовка
----------

[](#подготовка)

Актуальный документ с описанием параметров вызова API можно получить отправив запрос в техподдержку Mawisoft . Эта бибилиотека была создана опираясь на [данный документ](https://github.com/three-cos/mawiapi/blob/master/src/Docs/API%20CRM%20SalesMax%206.8.docx).

Установка
---------

[](#установка)

```
composer require wardenyarn/mawiapi
```

### Инициализация

[](#инициализация)

```
use Wardenyarn\MawiApi\MawiSoftApi;
use Wardenyarn\MawiApi\Exceptions\MawiApiException;

$host = 'your_company'; // из http://your_company.mawisoft.ru
$login = 'admin@your_company.ru';
$password = 'secret';

try {
    $api = new MawiSoftApi($host, $login, $password);
} catch (MawiApiException $e) {
    echo $e->getMessage();
}
```

**Лимит на возвращаемые записи**

```
// Default: 20
$api->setLimit(100);
```

**Кол-во записей на один запрос**

```
// Default: 20
$api->setPageSize(50);
```

#### Клиенты

[](#клиенты)

```
// Создание
$client_id = $api->setClient([
    'name' => 'new client',
    ...
]);

// Редактирование
$client_id = $api->editClient($client_id, [
    'name' => 'client edited',
    ...
]);

// Получение записи
$client = $api->getClient($client_id);
echo $client->name;

// Получение $api->limit записей с возможностью фильтрации
$filter = ['name' => 'ОAО'];
foreach ($api->getClients($filter) as $client) {
    echo $client->name; // ОАО Агропром, ОАО Рыбторг, ОАО Главпочтамп
}

// Назначение категории
$api->setClientCategory($client_id, $category_id);

// Исключение из категории
$api->removeClientCategory($client_id, $category_id);

// Добавить платежный реквизит
$api->setClientCustomer($client_id, $customer);

// Получение всех платежных реквизитов
$customers = $api->getClientCustomers($client_id);
```

#### Сделки

[](#сделки)

```
use Wardenyarn\MawiApi\Entities\Proposal;

// Создание
$proposal_id = $api->setProposal($client_id, $user_id, $product_id, Proposal::VAT_18, [
    'price' => 9000,
    ...
]);

// Редактирование
$proposal_id = $api->editProposal($proposal_id, $user_id, $product_id, Proposal::VAT_20, [
    'price' => 10000,
    ...
]);

// Получение
$proposal = $api->getProposal($proposal_id);
echo $proposal->price;

// Получение $api->limit записей с возможностью фильтрации
$filter = ['clientName' => 'MegaClient'];
foreach ($api->getProposals($filter) as $proposal) {
    echo $proposal->price;
}

// Товары в сделках
foreach ($api->getProposalItems($filter) as $proposalItem) {
    echo $proposalItem->description;
}
```

#### Продукты

[](#продукты)

```
use Wardenyarn\MawiApi\Entities\Product;

// Создание
$product_id = $api->setProduct(Product::TYPE_SIMPLE, [
    'name' => 'new product',
    ...
]);

// Редактирование
$product_id = $api->editProduct($product_id, [
    'name' => 'edited product',
    ...
]);

// Получение
$product = $api->getProduct($product_id);
echo $product->name;

// Получение $api->limit записей с возможностью фильтрации
$filter = ['name' => 'BFG-9000'];
foreach ($api->getProducts($filter) as $product) {
    echo $product->name;
}

// Получение $api->limit отгруженных продуктов с возможностью фильтрации
foreach ($api->getShippedProducts($filter) as $shipped_product) {
    echo $shipped_product->name;
}

// Получение $api->limit не отгруженных продуктов с возможностью фильтрации
// Внимание! Получает все записи одним запросом
foreach ($api->getUnshippedProducts($filter) as $unshipped_product) {
    echo $unshipped_product->name;
}

// Получение $api->limit отгрузок с возможностью фильтрации
foreach ($api->getShippings($filter) as $shipping) {
    echo $shipping->date;
}

// Получение отгрузки
$shipping = $api->getShipping($id);

// Список категорий продуктов
$shipping = $api->getProductCategories();
```

#### Контактные лица

[](#контактные-лица)

```
// Получение $api->limit записей с возможностью фильтрации
$filter = ['name' => 'Name'];
foreach ($api->getPeople($filter) as $person) {
    echo $person->name;
}

// Создание
$person_id = $api->setPerson($clientId, [
    'name' => 'John Doe',
    ...
]);

// Редактирование
$person_id = $api->editPerson($person_id, [
    'name' => 'Jane Doe',
    ...
]);

// Получение Юр. Лица
$seller = $api->getSeller($seller_id);

// Получение списка сотрудников
$department_id = -1; // Все сотрудники
foreach ($api->getUsers($department_id) as $user) {
    echo $user->name;
}
```

#### Платежи

[](#платежи)

```
// Получение $api->limit записей с возможностью фильтрации
$filter = ['clientName' => 'Umbrella Corp.'];
foreach ($api->getPayments($filter) as $payment) {
    echo $payment->sum;
}

// Получение
$payment = $api->getPayment($payment_id);

// Напоминание о задолженности
$paymentPrint = $api->getPaymentPrint($payment_id);
```

#### Счета

[](#счета)

```
// Получение $api->limit записей с возможностью фильтрации
$filter = ['clientName' => 'Tyrell Corporation'];
foreach ($api->getInvoices($filter) as $invoice) {
    echo $invoice->sum;
}

// Создание
$invoice_id = $api->setInvoice($client_id, $userId, $payerId, $customerId, [
    'price' => 1000,
    'measureUnit' => 'шт.',
    ...
]);

// Получение
$invoice = $api->getInvoice($invoice_id);
```

#### События в календаре

[](#события-в-календаре)

```
use Wardenyarn\MawiApi\Entities\Event;

// Создание
$event_id = $api->setEvent(Event::TYPE_EMAIL, $clientId, $userId, $params);

// Отчет по событию
$report_id = $api->setReport($event_id, $message, bool $success);

// Получение $api->limit записей с возможностью фильтрации
$filter = ['date' => date('Ymd')];
foreach ($api->getEvents($filter) as $event) {
    echo $event->title;
    echo $event->event->description;
}
```

#### Документы

[](#документы)

```
// Получение $api->limit записей с возможностью фильтрации
$filter = ['from' => date('d.m.Y'), 'to' => date('d.m.Y')];
foreach ($api->getDocuments($filter) as $document) {
    echo $document->description;
}

// Получение
$document = $api->getDocument($id);

// Скачивание документа
$api->downloadDocument($document_id, $storage_dir);
```

Лицензия
--------

[](#лицензия)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~1 days

Total

3

Last Release

1563d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0a83548c16b634397f088cede03f6cdc43590e0ac82a4561d2993f001e8e2c9e?d=identicon)[WardenYarn](/maintainers/WardenYarn)

---

Top Contributors

[![three-cos](https://avatars.githubusercontent.com/u/10752823?v=4)](https://github.com/three-cos "three-cos (5 commits)")

---

Tags

wardenyarnmawisoftsalesmax

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/wardenyarn-mawiapi/health.svg)

```
[![Health](https://phpackages.com/badges/wardenyarn-mawiapi/health.svg)](https://phpackages.com/packages/wardenyarn-mawiapi)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[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)