1
0
mirror of synced 2024-11-24 22:36:06 +03:00
PHP client for RetailCRM API
Go to file
2014-11-07 11:31:33 +03:00
docs Separate doc in english 2014-11-07 11:24:50 +03:00
lib/RetailCrm Added skipMyChanges in ordersHistory 2014-11-06 17:19:20 +03:00
tests Added reference and statistic methods 2014-11-06 16:39:55 +03:00
.gitignore New version of PHP client for API v3. Not all methods implements 2014-11-06 02:44:52 +03:00
composer.json Removed docs 2014-11-06 14:10:48 +03:00
phpunit.xml.dist New version of PHP client for API v3. Not all methods implements 2014-11-06 02:44:52 +03:00
README.md Translate README to russian. 2014-11-07 11:31:33 +03:00

PHP-клиент для retailCRM API

PHP-клиент для работы с retailCRM API.

Обязательные требования

  • PHP версии 5.3 и выше
  • PHP-расширение cURL

Установка

  1. Установите composer

  2. Выполните в папке проекта:

composer require retailcrm/api-client-php ~3.0.0

В конфиг composer.json вашего проекта будет добавлена библиотека retailcrm/api-client-php, которая установится в папку vendor/. При отсутствии файла конфига или папки с вендорами они будут созданы.

Примеры использования

Получение информации о заказе

$client = new \RetailCrm\ApiClient(
    'https://demo.intarocrm.ru',
    'T9DMPvuNt7FQJMszHUdG8Fkt6xHsqngH'
);


try {
    $response = $client->ordersGet('M-2342');
} catch (\RetailCrm\Exception\CurlException $e) {
    echo "Сетевые проблемы. Ошибка подключения к retailCRM: " . $e->getMessage();
}

if ($response->isSuccessful()) {
    echo $response->order['totalSumm'];
    // или $response['order']['totalSumm'];
    // или 
    //    $order = $response->getOrder();
    //    $order['totalSumm'];
} else {
    echo sprintf(
        "Ошибка получения информации о заказа: [Статус HTTP-ответа %s] %s", 
        $response->getStatusCode(),
        $response->getErrorMsg()
    );
}

Создание заказа


$client = new \RetailCrm\ApiClient(
    'https://demo.intarocrm.ru',
    'T9DMPvuNt7FQJMszHUdG8Fkt6xHsqngH'
);

try {
    $response = $client->ordersCreate(array(
        'externalId' => 'some-shop-order-id',
        'firstName' => 'Vasily',
        'lastName' => 'Pupkin',
        'items' => array(
            //...
        ),
        'delivery' => array(
            'code' => 'russian-post',
        )
    ));
} catch (\RetailCrm\Exception\CurlException $e) {
    echo "Сетевые проблемы. Ошибка подключения к retailCRM: " . $e->getMessage();
}

if ($response->isSuccessful() && 201 === $response->getStatusCode()) {
    echo 'Заказ успешно создан. ID заказа в retailCRM = ' . $response->id;
        // или $response['id'];
        // или $response->getId();
} else {
    echo sprintf(
        "Ошибка создания заказа: [Статус HTTP-ответа %s] %s", 
        $response->getStatusCode(),
        $response->getErrorMsg()
    );
}