README

PHP клієнт для роботи з ELIT eConnector SOAP API (версія 1.75.0).

Вимоги

• PHP 8.1+
• Розширення ext-soap

Встановлення

composer require serdominus/elit-econnector

Або клонуйте репозиторій і встановіть залежності:

git clone https://github.com/serdominus/elit-econnector.git
cd elit-econnector
composer install

Швидкий старт

use Elit\EConnector\ElitConnector;
use Elit\EConnector\SendBasketItem;
use Elit\EConnector\Exception\ElitException;

// Ініціалізація (testMode: true = тестовий сервер)
$connector = new ElitConnector(
    company:  ElitConnector::COMPANY_CZ,
    login:    'your_login',
    password: 'your_password',
    testMode: false
);

// Отримати інформацію про товар
$item = $connector->getItem('NET 12 N 7439');
echo $item->description;

// Отримати ціну та залишки
$infoList = $connector->getItemInfo('NET 12 N 7439', qty: 1);

// Відправити замовлення
$success = $connector->sendBasket([
    new SendBasketItem('NET 12 N 7439', 2, 'MY-REF', false, '2024-12-31'),
]);

Константи компаній

Доступні методи

Товари

Накладні (Delivery Notes)

Рахунки-фактури (Loans)

Кредит-ноти

Замовлення

Відправка замовлень

Інше

SendBasketItem — параметри

new SendBasketItem(
    no:                    'NET 12 N 7439',  // Артикул (обов'язково)
    quantity:              2,                 // Кількість (обов'язково)
    yourReference:         'MY-REF-001',      // Примітка, макс. 20 символів
    cashAndCarry:          false,             // Самовивіз
    requestedDeliveryDate: '2024-12-31'       // Бажана дата доставки
);

Обробка помилок

use Elit\EConnector\Exception\ElitException;
use Elit\EConnector\Exception\AuthException;

try {
    $item = $connector->getItem('SOME-ITEM');
} catch (AuthException $e) {
    // Неправильні облікові дані або недостатньо прав
    echo "Авторизація: " . $e->getMessage();
} catch (ElitException $e) {
    // Інші помилки API
    echo "Помилка API: " . $e->getMessage();
}

Тестовий та production сервери

// Тестовий
$connector = new ElitConnector('ELIT_CZ', 'login', 'pass', testMode: true);

// Production
$connector = new ElitConnector('ELIT_CZ', 'login', 'pass', testMode: false);