Адрес
Ваш путеводитель по интеграции V5!
Конечная точка импорта «Адрес» позволяет добавлять адреса поставщиков и клиентов, которые затем можно использовать для доставки и получения товаров . Адреса также можно добавлять в качестве « адресов объектов », используемых для переводов.
Связанные руководства по интеграции:
В этом руководстве основное внимание будет уделено использованию конечной точки «Адрес» как посредством импорта CSV, так и с использованием JSON через API V5.
Содержание
1. Схема центра управления
С точки зрения того, как мы можем связать конечную точку адреса с тем, что мы видим в Центре управления V5, мы рассмотрим здесь таблицу «Клиент». Таблица «Поставщик» будет работать точно так же, поскольку и поставщики, и клиенты разделяют одну и ту же конечную точку «Клиент».
2. API-ссылки
Дополнительную информацию об определениях для этого класса базы данных «Адрес» можно найти по следующей ссылке:
3. Руководство по заполнению адресного поля
3.1. Первичные ключи
Для импорта через конечную точку «Адрес» первичный ключ:
Имя – уникальное имя для этого адреса.
3.2. Обязательные поля
Другие поля, необходимые для создания действительной записи в V5:
Тип – тип адреса; для использования с клиентами значение должно быть 0, а для использования в качестве адреса сайта для переводов (modlink) – 1.
Client_Code – Если добавляется адрес клиента, это необходимо для привязки к клиенту/поставщику.
3.3. Дополнительные поля
Строка 1 – Первая строка адреса.
Line2 – Вторая строка адреса.
Строка 3 – третья строка адреса.
Город – город, в котором находится указанный адрес.
Штат – штат, в котором находится указанный адрес.
Страна – страна, в которой находится указанный адрес.
Почтовый индекс (Zip) – это почтовый код адреса.
Контактное лицо – контактное лицо, указывающее адрес.
Тел. – Номер телефона, указанный в адресе.
Электронная почта – адрес электронной почты, связанный с данным адресом.
Здесь также можно добавить адреса доставки (если они отличаются от адреса, введенного с использованием указанных выше данных) и контакты/данные для экстренного отзыва, но в нашем примере мы будем использовать только указанные выше точки данных.
4. Пример набора данных
В этой части мы попытаемся добавить адрес клиенту, указанному на панели CC выше. Этот клиент был добавлен в систему ранее с помощью конечной точки « Клиент ».
5. Методология
5.1. JSON — Импорт
Импорт конечной точки/URI адреса –
http://host:port/V5-API/api/integrate/import/address
Образцы:
Используя конечную точку «Адрес», мы можем структурировать файл импорта для вышеуказанных дополнений следующим образом:
Этот пример JSON-файла можно скачать здесь.
После того, как мы разместили это в системе, мы увидим, что этот адрес был добавлен к клиенту «CUS01»:
5.2. CSV – Импорт
Поскольку клиентам/поставщикам может быть назначено несколько адресов, давайте просто добавим еще один адрес к клиенту «CUS01», к которому мы добавили его в примере JSON выше.
Для импорта CSV нам сначала необходимо создать заголовочный файл для нашего импорта.
Имя файла с определением заголовка/столбцов: “address.csvh”
Завершенные заголовочные файлы следует разместить в папке: “<installdir>\SG Control Center\gateway\import\column_defs”
Имя импортируемого CSV-файла: “address-datetime.csv”
CSV-файлы для импорта следует разместить в папке: "<каталог установки>\SG Control Center\gateway\import"
Образцы:
Заголовочный файл:
Пример файла заголовка можно увидеть ниже. Мы будем использовать те же поля, что и для импорта JSON.
Для получения более подробной информации о структуре этих файлов, пожалуйста, посетите главную страницу интеграции . Пример заголовочного файла можно скачать здесь.
Файл импорта CSV:
Затем мы можем использовать определенный порядок точек данных в заголовке для структурирования нашего файла импорта. Обратите внимание, что эта первая строка может быть проигнорирована Центром управления и, таким образом, может быть сохранена в файле при отправке на импорт. Пример импорта на основе наших требований выше будет выглядеть следующим образом:
Этот пример файла импорта можно скачать здесь.
Затем мы можем поместить этот файл в нашу папку импорта, как определено выше, и после завершения импорта мы увидим, что этот адрес был добавлен к тому же клиенту.
