Адрес
Ваш путеводитель по интеграции V5!
Конечную точку импорта «Адрес» можно использовать для добавления адресов поставщикам и клиентам, которые затем можно использовать для доставка и получение. Адреса также можно добавлять как 'адреса сайта', которые используются для Трансферы.
Связанные руководства по интеграции:
В этом руководстве основное внимание будет уделено использованию конечной точки «Адрес» как посредством импорта CSV, так и с использованием JSON через API V5.
Содержание
1. Схема центра управления
С точки зрения того, как мы можем связать конечную точку адреса с тем, что мы видим в Центре управления V5, мы рассмотрим здесь таблицу «Клиент». Таблица «Поставщик» будет работать точно так же, поскольку и поставщики, и клиенты разделяют одну и ту же конечную точку «Клиент».
2. API-ссылки
Дополнительную информацию об определениях для этого класса базы данных «Адрес» можно найти по следующей ссылке:
3. Руководство по заполнению адресного поля
3.1. Первичные ключи
Для импорта через конечную точку «Адрес» первичный ключ:
Имя – Уникальное имя для этого адреса
3.2. Обязательные поля
Другие поля, необходимые для создания действительной записи в V5:
Тип – тип адреса, это должно быть 0 для использования с Клиентами и 1 для использования в качестве адреса сайта для Трансферов (modlink).
Код_клиента – При добавлении адреса клиента необходимо привязать его к заказчику/поставщику.
3.3. Дополнительные поля
Line1 – Первая строка адреса.
Line2 – Вторая строка адреса.
Line3 – Третья строка адреса.
Город – Город, в котором расположен адрес.
Область – Штат, в котором находится адрес.
Страна – Страна, в которой находится адрес.
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 нам сначала необходимо создать заголовочный файл для нашего импорта.
Имя файла определения заголовка/столбца: «адрес.csvh»
Готовые заголовочные файлы должны быть размещены в: “ \SG Control Center\gateway\import\column_defs”
Импортировать имя файла CSV: «адрес-дата-время.csv»
CSV для импорта должны быть размещены в: “ \SG Control Center\шлюз\импорт»
Образцы:
Заголовочный файл:
Пример файла заголовка можно увидеть ниже. Мы будем использовать те же поля, что и для импорта JSON.
Для получения дополнительной информации о том, как мы структурируем эти файлы, см. главная страница интеграции. Этот образец заголовочного файла можно загрузить здесь.
Файл импорта CSV:
Затем мы можем использовать определенный порядок точек данных в заголовке для структурирования нашего файла импорта. Обратите внимание, что эта первая строка может быть проигнорирована Центром управления и, таким образом, может быть сохранена в файле при отправке на импорт. Пример импорта на основе наших требований выше будет выглядеть следующим образом:
Этот пример файла импорта можно загрузить здесь.
Затем мы можем поместить этот файл в нашу папку импорта, как определено выше, и после завершения импорта мы увидим, что этот адрес был добавлен к тому же клиенту.
