RetailCRM pro

2021-06-08 12:30:12 Глобальная настройка «Разрешить редактировать каталог»

В 8 версии системы настройка «Разрешить редактировать каталог» теперь отображается не в общих системных настройках (Настройки → Системные → Склад), а в настройках каждого магазина. Теперь, выбрав магазин и перейдя на вкладку «Каталог», можно выбрать необходимый тип управления каталогом.

Значение из глобальной настройки перенесено в локальное. Например, если раньше стояла глобальная настройка «Разрешить редактирование каталога», то для всех отдельных магазинов будет такая локальная настройка.

Связанная настройка «Разрешить использовать общий артикул для всех торговых предложений», которая при выключенном редактировании каталога была скрыта, теперь всегда отображается в системных настройках склада. Открыть/Комментировать

2021-06-04 10:43:23 Новая версия PHP API-клиента

Мы выпустили новую версию PHP API-клиента. Эта версия написана с нуля и сильно отличается от старого клиента. Наиболее заметные отличия:

• минимальная версия PHP для работы с клиентом — 7.3

• взаимодействие с клиентом теперь приближено к структуре API. Клиент разделён на блоки, из каждого блока можно отправить соответствующие запросы. Данные передаются не в массивах, а в виде DTO. Подробнее: https://github.com/retailcrm/api-client-php/blob/v6.0.0/doc/usage/sending_a_request.md

• для работы с сетью используются реализации по стандарту PSR-18, PSR-7 и PSR-17. Таким образом разработчики могут полностью контролировать слой взаимодействия с HTTP, который используется API-клиентом. Подробнее: https://github.com/retailcrm/api-client-php/blob/v6.0.0/doc/customization/different_psr_implementations.md

• улучшена DocBlock-документация для методов API в клиенте. Поддерживающие DocBlock IDE и редакторы кода будут показывать короткий пример использования метода

• изменена логика обработки исключений. Новые исключения иерархичны и позволяют обрабатывать как ошибки API, так и проблемы на уровне runtime. Подробнее: https://github.com/retailcrm/api-client-php/blob/v6.0.0/doc/usage/error_handling.md

• API-клиент использует кодогенерацию для ускорения операций сериализации и десериализации в боевом окружении. В некоторых кейсах это даёт пятикратный прирост производительности этих операций. Подробнее: https://github.com/retailcrm/api-client-php/blob/v6.0.0/doc/compilation_prompt.md

• новый API-клиент лучше адаптирован для использования совместно с фреймворками. Так, например, используя внедрение зависимостей фреймворка можно унифицировать инициализацию клиента в приложении. Подробнее: https://github.com/retailcrm/api-client-php/blob/v6.0.0/doc/usage/instantiation.md

Инструкцию по установке нового API-клиента можно найти на странице README или в описании версии на Packagist: https://github.com/retailcrm/api-client-php и https://packagist.org/packages/retailcrm/api-client-php

Старая версия API-клиента останется доступной, в неё будут вноситься исправления, но новые возможности в неё добавляться не будут. Открыть/Комментировать

2021-05-28 17:24:09 Поля для работы с Программой лояльности в заказах

В методы, возвращающие заказ (Order), GET /api/v5/orders, GET /api/v5/orders/{externalId}, POST /api/v5/orders/create, POST /api/v5/orders/{externalId}/edit добавлены поля с информацией по ПЛ:

privilegeType — при передаче в запросе создания/редактирования заказа позволяет установить тип привилегии:

• personal_discount — персональная скидка клиента
• loyalty_level — расчет скидки или начисление бонусов исходя из настроек уровня ПЛ клиента
• loyalty_event — расчет скидки по событию ПЛ
• none — не применять скидки ПЛ к заказу

order[bonusesCreditTotal] — возвращает количество начисленных бонусов
order[bonusesChargeTotal] — возвращает количество списанных бонусов
order[loyaltyLevel] — уровень ПЛ, который применен для заказа
order[loyaltyEventDiscount] — скидка по событию, которая применена для заказа
order[items][][bonusesChargeTotal — количество списанных бонусов на строку товара
order[items][][bonusesCreditTotal] — количество начисленных бонусов на строку товара
order[loyaltyEventDiscount] — скидка по событию программы лояльности

Подробнее:
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#post--api-v5-loyalty-calculate
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#get--api-v5-orders
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#post--api-v5-orders-create
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#get--api-v5-orders-externalId
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#post--api-v5-orders-externalId-edit Открыть/Комментировать

2021-05-28 17:17:17 Массив скидок на строчку товара при работе с Программой лояльности

В поле order[items][][discounts][] добавлены типы скидок order[items][][discounts][][type]:

• loyalty_level — скидка по уровню программы лояльности
• loyalty_event — скидка по событию программы лояльности
• bonus_charge — списание бонусов ПЛ

order[items][][discounts][][amount] возвращает сумму скидки в денежном эквиваленте.

Подробнее:
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#post--api-v5-loyalty-calculate
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#get--api-v5-orders
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#post--api-v5-orders-create
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#get--api-v5-orders-externalId
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#post--api-v5-orders-externalId-edit Открыть/Комментировать

2021-05-28 17:15:31 Использование API для интеграции с Программой лояльности

Подготовили статью по сценарию работы с API по основным методам:

• регистрация и активация участия
• расчет и оформление заказа с применением бонусов

Подробнее:
https://docs.retailcrm.ru/Developers/API/APIFeatures/LoyaltyAPI

Список программ лояльности

GET /api/v5/loyalty/loyalties — метод возвращает список программ лояльности и позволяет получить подходящую ПЛ для магазина.

Подробнее:
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#get--api-v5-loyalty-loyalties

Редактирование участия в программе лояльности

POST /api/v5/loyalty/account/{id}/edit — метод позволяет отредактировать данные по участию в ПЛ.

Подробнее:
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#post--api-v5-loyalty-account-id-edit

Начисление бонусов участию в программе лояльности

POST /api/v5/loyalty/account/{id}/bonus/credit — метод позволяет начислить бонусы участию в программе лояльности. Есть возможность задать дату активации с помощью параметра activationDate и дату сгорания бонусов параметром expireDate. По умолчанию сгорание и активация бонусов произойдет в соответсвии с настройками ПЛ.

Подробнее:
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#post--api-v5-loyalty-account-id-bonus-credit

История бонусного счета

GET /api/v5/loyalty/account/{id}/bonus/operations — метод позволяет получить историю бонусного счета для участия в программе лояльности за определенный период времени. Диапазон времени задается параметрами фильтра createdAtFrom и createdAtTo.

Подробнее:
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#get--api-v5-loyalty-account-id-bonus-operations Открыть/Комментировать

2021-05-20 17:35:38 Добавление веса товара в callback-методы сохранения и расчета стоимости доставок

В callback-методы сохранения и расчета стоимости доставок добавлена информация о весе товара. Теперь эти callback-методы содержат информацию как о весе упаковок в целом save[packages][][weight], так и о весе каждого товара из этих упаковок save[packages][][items][][weight].

Подробнее:
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#callback_post--configuration_actions__save_
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#callback_post--configuration_actions__calculate_ Открыть/Комментировать

2021-05-19 14:59:12 Дата и время изменения товара в API

В метод GET /api/v5/store/products добавлено новое поле products[][updatedAt] — дата редактирования товара в системе.

При реализации постоянной трансляции изменений во внешнюю систему рекомендуется использовать комбинацию фильтров:

• filter[sinceUpdatedAt] — нижнее ограничение по дате изменения товара
• filter[sinceId] — ID товара

Пример:

1. Первый запрос /api/v5/store/products?filter[sinceUpdatedAt]=2021-01-01 00:00:00
2. Второй запрос /api/v5/store/products?filter[sinceUpdatedAt]=2021-01-01 00:00:00&filter[sinceId]=2863, где 2863 — ID последнего товара в ответе на первый запрос
3. Последующий запрос /api/v5/store/products?filter[sinceUpdatedAt]=2021-01-01 00:00:00&filter[sinceId]=LAST_ID_FROM_PREV_REQUEST

Выборка производится, пока в ответе есть изменившиеся товары. Обратите внимание, что скрипт при следующей синхронизации должен передавать в filter[sinceUpdatedAt] дату начала прошлой синхронизации, чтобы не потерять изменения, произошедшие в момент синхронизации.

Подробнее:
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#get--api-v5-store-products Открыть/Комментировать

2021-05-18 14:50:04 Массив скидок на строчку товара

В методы, возвращающие заказ (Order), GET /api/v5/orders, GET /api/v5/orders/{externalId}, POST /api/v5/orders/create, POST /api/v5/orders/{externalId}/edit добавлено новое поле:

• orders[][items][][discounts] — массив скидок на строку c полями type (тип скидки) и amount (сумма скидки)

Пример:
{
"discounts": [
{
"type": "manual_product",
"amount": 10
},
{
"type": "manual_order",
"amount": 1999
}
],
"initialPrice": 20000,
"discountTotal": 2009,
"quantity": 1,
}

Подробнее:
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#get--api-v5-orders
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#post--api-v5-orders-create
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#get--api-v5-orders-externalId
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#post--api-v5-orders-externalId-edit Открыть/Комментировать

2021-04-21 13:08:27 Фильтр по каталогам в API

В параметры методов GET /api/v5/store/inventories, GET /api/v5/store/product-groups, GET /api/v5/store/products и GET /api/v5/store/products/properties добавлено новое поле filter[catalogs].

Теперь можно фильтровать данные по идентификаторам каталогов, получаемым в методе GET /api/v5/reference/sites. Обращаем внимание, что на фильтр по каталогам распространяется такое же ограничение API-ключей, как и на фильтр по магазинам.

Подробнее:
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#get--api-v5-reference-sites
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#get--api-v5-store-inventories
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#get--api-v5-store-product-groups
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#get--api-v5-store-products
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#get--api-v5-store-products-properties Открыть/Комментировать

2021-04-21 13:07:20 ID каталога в API

В ответ метода GET /api/v5/reference/sites добавлены новые поля:

• sites[][catalogId] — идентификатор каталога, используемого магазином
• sites[][isCatalogMainSite] — флаг, который показывает, является ли магазин владельцем каталога (в случае true) или использует каталог от другого магазина (в случае false)

Подробнее:
https://docs.retailcrm.ru/Developers/API/APIVersions/APIv5#get--api-v5-reference-sites Открыть/Комментировать