Загрузка заказов из файла

Файлом заливают то, чего нельзя получить по API: холодную базу от прошлого продавца, выгрузку из старой системы, список возвратов от курьерской службы. Мастер из трёх шагов не даёт сделать самую дорогую ошибку — запустить десять тысяч строк, не увидев, куда они лягут.

Когда грузят файлом

• Переезд. Заказы из прошлой CRM или из Excel, в котором отдел жил до вас.
• Холодная база. Клиенты, которым звонят повторно через месяцы. Такие строки кладут сразу в рабочий статус, минуя очередь прозвона.
• Сверка с логистикой. Файл выкупов или возвратов от службы доставки, который надо превратить в заказы.
• Разовый партнёр. Тот, кому проще прислать таблицу, чем подключаться к API.

Строки идут через тот же конвейер приёма, что и заявки от партнёров: телефоны приводятся к международному виду, работают чёрные списки, дубли и антифрод. Поэтому часть строк файла может не пройти — и это правильное поведение, а не сбой загрузки. Подробности проверок — в статье Антифрод.

Файл: форматы и пределы

Первая строка считается заголовками. Файл без шапки тоже загрузится — просто «заголовками» окажутся данные первой строки, и вы увидите это на следующем шаге. Значения Excel приводятся к тому виду, в каком их ожидал увидеть человек: телефон, сохранённый как число и превратившийся в 9.96555e+11, вернётся в нормальный вид, а сумма не приедет с хвостом .0.

Колонки

Система сама узнаёт колонки по названиям шапки — «Телефон», «ФИО», «Город», «Сумма» и десяткам их вариантов — и сообщает, сколько узнала. Совпадения берутся только точные: колонка «Сумма выплаты», принятая за «Сумму заказа», молча испортит десять тысяч заказов, и лучше выбрать её руками.

Что стоит знать про сопоставление:

• Телефон обязателен. Без него кнопка Загрузить не работает: заказ без номера некому звонить.
• Одно поле — одна колонка. Второе «ФИО» выбрать не получится, поле уже занято.
• Лишние колонки оставляйте в положении Не загружать. Даты, служебные пометки и суммы партнёра переносить обычно не нужно.
• Товары можно передать двумя способами: колонкой Товары одной строкой в формате LeadVertex [950|1|1500][951|3|4500] — код товара, количество, сумма — или парой Товар (алиас или артикул) и Количество.
• Внешний номер стоит указывать всегда, когда он есть в файле: по нему система узнаёт повторную заливку того же файла и не создаёт вторые заказы.
• Свои поля проекта тоже доступны для выбора — те, что заведены в НастройкиПоля.

Три решения перед запуском

Загрузка и ошибки

Строки обрабатываются кусками по 500 и после каждого куска сохраняются: только записанное можно остановить. Отсюда три следствия, полезных на практике. Загрузку можно поставить на паузу и продолжить позже. Обновление страницы её не рвёт — незаконченное задание открывается само. А если вкладку закрыть совсем, через полторы минуты файл подхватит сервер и дотянет до конца.

Счётчиков три, и смотреть надо на все. Создано — новые заказы. Пропущено — то, что осознанно не создано: дубли при включённой настройке, повторная заливка того же внешнего номера, остаток отменённой загрузки. С ошибкой — строки, которые разобрать не удалось.

Каждая ошибка привязана к номеру строки из вашего файла — нумерация начинается с двойки, потому что первая строка это шапка. Кнопка Скачать проблемные строки отдаёт их файлом: чинить в Excel и заливать заново удобнее, чем править по одной. Ошибка в одной строке не трогает соседние и не останавливает остальные девять тысяч.

• «Не удалось разобрать телефон» — чаще всего в колонку попал не тот столбец или номера обрезаны Excel.
• «Товар не найден в каталоге» — код товара из файла не совпадает с каталогом. Что делать с товарами — в статье Каталог.
• Сообщения антифрода — чёрный список, стоп-слово, дубль при выбранном «Отклонять».

Повтор с новым сопоставлением

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

1. 1Откройте законченную загрузку — из мастера или щелчком по строке в Прошлые загрузки.
2. 2Нажмите Повторить с другим сопоставлением — кнопка стоит рядом с разбором ошибок и появляется, когда непрошедшие строки есть. Мастер вернётся на шаг колонок с прежним выбором.
3. 3Поправьте сопоставление и запустите снова. Заголовков у колонок теперь нет — ориентируйтесь на настоящие значения рядом с каждым выбором.

Номера строк в новой загрузке сохраняются от исходного файла, так что отчёт об ошибках по-прежнему сходится с вашим Excel. Уже созданные заказы повтор не удаляет: если внешний номер был сопоставлен, они узнаются и просто пропускаются; если нет — проверьте результат в списке заказов прежде, чем повторять целиком.