Клиент (Поставщики и покупатели)
Ваш путеводитель по интеграции V5!
Конечная точка импорта «Клиент» может использоваться для создания как поставщиков, так и клиентов в системе отслеживания V5, которую затем можно использовать для получения Заказы и корабль Заказы на продажу соответственно.
Сопутствующие руководства по интеграции:
В этом руководстве основное внимание будет уделено использованию этой конечной точки «Клиент» как посредством импорта CSV, так и с использованием JSON через API V5.
Содержание
1. Макеты центра управления
С точки зрения того, как мы можем связать конечную точку клиента с тем, что мы видим в Центре управления V5, это будет относиться как к «Поставщики'И'Клиентов' окна. Итак, для поставщиков:
И для клиентов:
2. API-ссылки
Чтобы узнать больше об определениях этого «Клиента» и связанного с ним класса базы данных, перейдите по следующей ссылке:
3. Руководство для клиентов
3.1. Первичные ключи
Для импорта через конечную точку «Клиент» первичный ключ:
Code – Уникальный код поставщика или клиента.
3.2. Обязательные поля
Другие поля, необходимые для создания действительной записи в V5:
Тип – тип клиента, это должно быть 0 для поставщиков и 1 для клиентов.
3.3. Дополнительные поля
Другие параметры, которые мы можем добавить из класса базы данных «Клиент», следующие:
Имя – Наименование поставщика/заказчика.
ПодписьТребуется – 0 или 1, указывающие, требуется ли подпись при получении/отправке клиенту.
Также есть некоторые дополнительные поля, которые специфичны для Поставщики:
Вебсайт – Сайт поставщика.
Название_валюты – установить валюту, которую использует поставщик.
И для Клиентов:
Описание_набора_меток – позволяет назначить набор этикеток для использования с продукцией данного клиента.
4. Пример набора данных
В этой статье мы рассмотрим импорт 1 поставщика и 1 клиента, чтобы увидеть, как наши методологии импорта будут работать на практике.
5. Методология
5.1. JSON — Импорт
Конечная точка/URI импорта «Клиента» –
http://host:port/V5-API/api/integrate/import/client
Образцы:
Используя конечную точку «Клиент», мы можем структурировать файл импорта для добавления поставщика и клиента, как показано ниже:
Этот образец файла JSON можно загрузить здесь.
После того, как мы разместили это в системе, мы увидим, что новый поставщик был добавлен:
Вместе с новым клиентом:
5.2. CSV – Импорт
Для импорта CSV нам сначала необходимо создать заголовочный файл для нашего импорта.
Имя файла определения заголовка/столбца: «клиент.csvh»
Готовые заголовочные файлы должны быть размещены в: “ \SG Control Center\gateway\import\column_defs”
Импортировать имя файла CSV: «клиент-дата-время.csv»
CSV для импорта должны быть размещены в: “ \SG Control Center\шлюз\импорт»
Образцы:
Заголовочный файл:
Пример файла заголовка можно увидеть ниже. Как и выше, мы добавим клиента и поставщика с теми же параметрами:
Для получения дополнительной информации о том, как мы структурируем эти файлы, см. главная страница интеграции. Этот образец заголовочного файла можно загрузить здесь.
Файл импорта CSV:
Затем мы можем использовать определенный порядок точек данных в заголовке для структурирования нашего файла импорта. Обратите внимание, что эта первая строка может быть проигнорирована Центром управления и, таким образом, может быть сохранена в файле при отправке на импорт. Пример импорта на основе наших требований выше будет выглядеть следующим образом:
Этот пример файла импорта можно загрузить здесь.
Затем мы можем поместить этот файл в нашу папку импорта, как определено выше, и после завершения импорта мы снова увидим, что наш поставщик:
И были созданы клиенты:
