Подготовка заказов из CSV на стороне магазина
Версия 2.7
Назначение промежуточной загрузки
Если магазин выгружает заказы в CSV, используйте файл как вход для собственного обработчика интеграции. Сначала загрузите строки во внутренний буфер и проверьте их перед запросами к RouteDesk. Эта схема позволяет оператору увидеть ошибки и исправить исходную таблицу до выпуска этикеток. Состав столбцов определяется выгрузкой магазина и вашей схемой сопоставления.
Формат файла и разбор
Определите в настройках импортёра кодировку и разделитель. Для новых шаблонов удобно использовать UTF-8 и явно согласованный разделитель. Применяйте CSV-парсер, который обрабатывает кавычки, удвоенные кавычки и переносы строки внутри поля. Для проверки используйте адрес с разделителем и текст в кавычках. Простое деление строки по запятым может сдвинуть столбцы и привести к ошибочному сопоставлению адреса.
Пробный разбор
Сформируйте предварительный отчёт с числом принятых и отклонённых строк, номером строки и причиной ошибки. Проверьте дубли локального номера заказа внутри файла. Убедитесь, что почтовый индекс читается как текст и сохраняет исходные символы. Проверьте единицы размеров и веса. Если город и индекс не согласованы, сначала исправьте данные магазина, чтобы не переносить конфликт в запрос выпуска.
Проверка перед отправкой
Согласуйте среду, организацию, склад и список строк, готовых к отправке. Сохраните снимок строки и локальный идентификатор задания перед вызовом создания. Назначьте Idempotency-Key конкретному намерению выпуска. При тайм-ауте повторяйте исходное тело и ключ. Если оператор изменил строку после ошибки, установите результат прежней попытки, затем решите, требуется ли отдельное действие.
Что передать на разбор
Дежурному полезны имя партии, номер строки, обезличенный код причины и время обработки. Если проблема в кавычках или кодировке, соберите маленький синтетический файл с тем же дефектом. Для поддержки RouteDesk добавьте идентификаторы запросов, которые дошли до платформы. Храните исходный рабочий файл в согласованном месте: он может содержать адреса и контакты получателей.
Сопоставление колонок при смене выгрузки
Отмечайте версию шаблона в локальном журнале партии. Перед использованием нового формата проверьте обязательные для вашей процедуры столбцы и единицы измерения. Если имя колонки изменилось, попросите оператора выбрать соответствие и сохранить его. Обработка по позиции столбца опасна, когда поставщик выгрузки меняет порядок полей без предупреждения.
Оценка предварительного результата
Покажите оператору несколько разобранных строк с безопасно замаскированными контактами. Сравните исходную запись с нормализованными данными, особенно если поля содержат перенос строки или несколько частей адреса. Проверьте, что пустое поле отличается от нулевого значения и что преобразование таблицы не добавляет новый заказ без явной строки в источнике.