Загрузка клиентов из файла CSV

Примечание

Если у вас уже подготовлен файл загрузки данных в формате CSV, то переходите к разделу ниже «Загрузка (импорт) клиентов».

Если у вас имеется список клиентов, например, в какой-либо учетной системе, или файле Excel, то можно загрузить этих клиентов в веб-сервис «Точки СВ». Для этих целей нужно предварительно подготовить файл загрузки данных в формате CSV.

Формат файла CSV

Имеется возможность загружать клиентов (импортировать) в веб-сервис «Точки СВ» из файла в формате CSV. CSV — это текстовый файл, описывающий табличные данные в виде строк с символами-разделителями. Описание формата CSV можно посмотреть в этой статьеopen in new window. Важно, чтобы файл CSV был в кодировкеopen in new window UTF-8 или UTF-16. Формат CSV поддерживается следующими программным обеспечением (ПО):

  • Microsoft Excel;
  • Google Таблицы — рекомендуется использовать именно это ПО.

Рекомендуется использовать именно Google Таблицы, т.к. это ПО при экспорте в формат CSV выгружает файл сразу в кодировке UTF-8.

Предупреждение

Не рекомендуется использовать ПО Microsoft Excel для выгрузки файлов в формат CSV, т.к. оно выгружает файл в устаревшей кодировке Win-1251. Т.е. такой файл потребуется дополнительно конвертировать в кодировку UTF-8 или UTF-16.

Структура CSV-файла загрузки клиентов

CSV-файл загрузки клиентов состоит из значений в следующей последовательности. Обратите внимание на примеры значений — они выполнены по правилам описания значений в формате CSV:

  • Разделителем значений колонок является символ запятой (,).
  • Значения, содержащие зарезервированные символы (двойная кавычка и запятая, новая строка) обрамляются двойными кавычками ("). Если в значении встречаются кавычки — они представляются в файле в виде двух кавычек подряд.
NНазвание колонкиОписаниеПример значения
1.IDИдентификатор клиента в формате UUIDopen in new window (может быть пустым).123e4567-e89b-12d3-a456-426655443322
2.NAMEНазвание клиента.Магазин ""Продукты 24""
3.COMMENTSОписание клиента (может быть пустым).Розничные продажи
4.ADDRESSАдрес клиента."Москва, ул. Онежская 19"
5.PHONEКонтактные телефоны."+7 999 000-00-00, +7 999 000-00-01"
6.LATITUDEШирота (может быть пустым).55.852283
7.LONGITUDEДолгота (может быть пустым).37.518407
8.RADIUSРадиус зоны посещения в метрах.50
9.SUBDIVISIONНазвание подразделения, за которым закреплен клиент (может быть пустым). См. после таблицы примечание.Северный округ (САО)
10.LISTНазвание списка клиентов (может быть пустым). См. после таблицы примечание.Список клиентов агента Иванова

Примечание

Если требуется, чтобы клиент был привязан к нескольким подразделениям или к нескольким спискам, то нужно в CSV-файле этого клиента указать несколько раз с разными названиями подразделений или списков. Или же создать несколько CSV-файлов, например, по одному на каждое подразделение и последовательно эти файлы загрузить.

Предупреждение

Порядок колонок в файле менять нельзя — порядок должен быть указан таким же, как описано в таблице выше.

Если в файле не указано значение в колонке ID, то сервер при загрузке файла сопоставляет клиентов из файла с уже имеющимися на сервере по наименованию (колонка NAME). Если наименования совпадают, то данные такого клиента на сервере обновляются. Если наименования различаются, то клиент загружается на сервер как новый. Но это правило действует только если не указано значение в колонке ID.

При загрузке клиентов с указанными значениями подразделений (параметр в таблице SUBDIVISION) сервер сначала ищет указанное подразделение по названию у себя в базе данных. Если такое подразделение не находится, то оно автоматически создаётся и клиент привязывается к этому подразделению. Аналогичное поведение при указанном значении списков (параметр в таблице LIST).

Данные на сервер из файла всегда загружаются в режиме обновления для однозначных значений клиентов (это все колонки кроме SUBDIVISION и LIST) и в режиме дополнения для списочных значений (колонки SUBDIVISION и LIST). Т.е. если сначала загрузить на сервер клиента со значением SUBDIVISION, например Подразделение N 1, а после загрузить этого же клиента со значением SUBDIVISION Подразделение N 2, то клиент будет в итоге привязан к двум подразделениям Подразделение N 1 и Подразделение N 2.

Пример файла загрузки клиентов

Ниже приводится пример файла загрузки клиентов. После загрузки этого файла на сервер в веб-сервисе появляется 5 клиентов, распределенных по подразделениям «Подразделение Москва» и «Подразделение Подольск». При этом дополнительно внутри каждого подразделения создаются списки клиентов «Список Розница» и «Список Косметика».

Данный файл можно скачать по этой ссылке: https://takwot.com/files/test/clients.csvopen in new window.

ID,NAME,COMMENTS,ADDRESS,PHONE,LATITUDE,LONGITUDE,RADIUS,SUBDIVISION,LIST
9ABCDFBA-9E94-11E7-80E8-0014D1110CD1,"Магазин ""Мастер ремонта"" ИП Востриков",Стройматериалы в розницу,"г. Москва, ул. Онежская 19",+7 988 000-00-01,55.852283,37.518407,50,Подразделение Москва,Список Розница
F51BECE0-67BD-11E8-80E4-0014D1110CD2,"Магазин ""Большой ремонт""",Стройматериалы в розницу,"г. Москва, Ковров переулок 8",+7 988 000-00-02,,,50,Подразделение Москва,Список Розница
AB403468-FFD8-11E6-80E2-0014D1110CD3,"ТК ""Сибирь"", ООО ""Стройкомплект"", Вольский",Стройматериалы оптом,"г. Подольск, Рабочая ул. 26",+7 988 000-00-03,55.434114,37.558823,50,Подразделение Подольск,Список Розница
E4EEF013-D610-11E5-80D4-0014D1110CD4,"Магазин ""Мастер ОК"", ИП Кошкина",Стройматериалы в розницу,"г. Подольск, ул. Дружбы 17",,55.429777,37.557691,50,Подразделение Подольск,Список Розница
70EF791E-F4DB-11E6-80E2-0014D1110CD5,"Магазин ""Альянс Косметик"", Давыдов",,"г. Москва, ул. Покровка 48",,55.763295,37.654817,50,Подразделение Москва,Список Косметика
1
2
3
4
5
6

Строка в заголовками в CSV-файле (ID, NAME и т.д.) может отсутствовать, но значения должны быть указаны обязательно в том порядке, как они указаны в таблице выше.

Загрузка (импорт) клиентов из файла CSV

Формат CSV

Описание формата CSV смотрите выше.

Чтобы начать загрузку клиентов из файла CSV нужно:

1. Открыть справочник клиентов.

2. В открывшемся окне нажать на кнопку «Создать клиента»:

Добавление клиента

3. Далее в открывшемся окне создания клиента нажать на кнопку «Создать массово из csv-файла»:

Кнопка загрузки клиентов из файла

4. В открывшемся окне нажмите на кнопку «Выберите файл» и затем выберите подготовленный CSV-файл. После этого у вас в нижней части окна будут выведены клиенты из выбранного файла:

Просмотр данных загрузки

5. Убедитесь, что в окне показаны корректные данные (идентификаторы клиентов не показываются для удобства просмотра). Выберите один из вариантов обработки конфликтов — когда загружаемые клиенты уже частично или полностью есть в базе данных на сервере:

  • Отменить всю транзакцию — загрузка файла будет полностью отменена как только будет обнаружен такой же клиент в базе данных.
  • Пропускать — уже имеющиеся в базе данных клиенты не будут обновляться данными из файла.
  • Обновлять — уже имеющиеся в базе данных клиенты будут обновляться новыми данными из файла.

После выбора подходящего варианта нажмите на кнопку «Загрузить».

По завершении корректной загрузки данных будет показано сообщение:

Результат загрузки - ОК

Если же произошли какие-либо какие-либо ошибки при загрузке файла будет показано окно с информацией об ошибке.

Результат загрузки - ошибка

Нажав на кнопку «Подробно» в этом окне можно увидеть более подробное описание ошибки. Например, такая ошибка выводится, если в файле был указан идентификатор клиента в неправильном формате:

Результат загрузки - ошибка - детали