API Goodwix — настройка плана обмена резервами на складах и заказами из Goodwix

1. Условия использования API

  1. API Goodwix находится в открытом доступе, и его может использовать любая компания, которая хочет настраивать выгрузку и загрузку заказов и резервов на складах.
  2. Для использования API необходимо иметь аккаунт в Goodwix с созданным каталогом (пустым). При создании каталога для возможности выгрузки/загрузки резервов и заказов необходимо нажать на кнопку «Создать каталог для интеграции» и отметить галочкой пункт «Создать каталог для интеграции с внешней системой».

ВАЖНО! В интегрированном каталоге и складах, созданных при помощи интеграции, недоступны функции удаления и создания новых товаров. При необходимости удаления данных необходимо обратиться в службу поддержки. Редактирование информации о товарах (описания, характеристик и пр.) доступно.

2. Описание порядка использования API

  1. Выгрузка товаров, остатков и цен происходит по стандартному методу. Перейти по ссылке.
  2. Выгрузка покупателей — отправляются данные (название компании, ИНН, КПП) о всех ваших покупателях в Goodwix, для синхронизации в учетной системе.
  3. Загрузка заказов из Goodwix в учетную систему. В учетную систему загружаются все подтвержденные заказы, созданные на основе каталога и складов, выгруженных из учетной системы.
  4. Выгрузка изменений по складам, включая резервы. Из учетной системы принимаются все изменения по тем товарам, которые есть в каталоге.
  5. Выгрузка изменений по заказам, выгруженным из Goodwix. Из учетной системы принимаются все изменения по заказам при условии наличия товаров в заказе в каталоге Goodwix.

3. Описание API

Описание кода, запросов, ответов и атрибутов расположено в открытом доступе на app.swaggerhub.com.

Ссылка для доступа на Swaggerhub.

Файл API в формате YAML.

4. Стандартные ошибки синхронизации учетной системы и Goodwix

ОШИБКА 1: при попытке выгрузки остатков на складе выгружается товар, которого нет в каталоге Goodwix. Данные в Goodwix обновлены не будут.

ОШИБКА 2: при попытке выгрузки цен выгружается товар, которого нет в каталоге Goodwix. Данные о ценах обновлены не будут.

ОШИБКА 3: в заказ со стороны в учетной системе добавлен товар, которого нет в каталоге. Заказ не будет изменен.

ОШИБКА 4: в заказе со стороны в учетной системе изменен склад, и его нет на Сервисе. Заказ не будет изменен.

ОШИБКА 5: в заказе со стороны в учетной системе добавлены два идентичных товара с разной ценой или НДС. Заказ не будет изменен.

Уведомления об ошибках будут отправлены на почту, указанной при регистрации компании. В уведомлении будет информация о том, в каком разделе произошла ошибка и с какими товарами.

5. Описание подсистемы в 1С

Для планов обмена резервами и заказами с 1С: Управление торговлей 11 вы можете воспользоваться готовым решением внешней системы.

Данное решение подходит для стандартной конфигурации УТ 11 ПРОФ, начиная от версии 11.4.3.126

Документация по работе с подсистемой:

Интеграция 1С с сервисом Goodwix.pdf

Файл подсистемы в 1С для стандартной конфигурации Управление торговлей 11 ПРОФ.zip