> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Импорт данных о доставке

> В этой статье объясняется, как использовать CSV-файл в Shop для массового импорта или обновления информации о доставке существующих заказов (перевозчик, трек-номер, URL отслеживания).

# Импорт данных о доставке

## Возможности

* Эта функция применяется только к **существующим заказам** в вашем магазине и используется для обновления их статуса отправки и логистической информации. **Она не создает новые заказы в магазине!**
* Вы можете обновить: статус отправки, перевозчика, трек-номер и URL отслеживания.
* Для заказов с **физическими товарами** : после успешного импорта заказы будут помечены как **Отправлен**, а логистическая информация станет видна покупателям.
* Для заказов с **виртуальными/цифровыми товарами** : заказы просто помечаются как **Отправлен** без необходимости указывать трек-номер или ссылку для отслеживания.

***

## Перед началом работы

Чтобы процесс выполнения заказов прошел без сбоев, сначала выполните следующую настройку:

* Создайте свой магазин, добавьте товары, настройте шаблоны доставки и способы оплаты (COD / PayPal).
* Рекомендуется ознакомиться с рабочим процессом **Заказы → Выполнение / Отметить как оплаченный (COD) / Возвраты и возмещения** . [Ознакомиться с процессом обработки заказов](/ru/documentation/shop/orders/index).

***

## Скачать шаблон

На странице **Shop → Заказы** нажмите **Импортировать информацию о доставке** , чтобы открыть модальное окно, затем нажмите **Шаблон**.

<Frame caption="Select Import Shipping Info on the Orders page. The demo shop shown has no orders.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/shop-orders-import-entry-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=ad2beb5c8a3520b83d431432801b79d0" alt="Страница заказов магазина с выделенной кнопкой «Импортировать информацию о доставке»." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/shop-orders-import-entry-annotated.svg" />
</Frame>

<Frame caption="Download the CSV template before filling in shipping information for existing orders.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/shop-shipping-import-dialog-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=7af210f242490ff42d20fc5ae0b8323d" alt="Диалоговое окно импорта информации о доставке с выделенной кнопкой скачивания шаблона." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/shop-shipping-import-dialog-annotated.svg" />
</Frame>

**Примечания по заполнению шаблона:**

* Поддерживается только формат CSV.
* Максимальный размер файла: **15 МБ**, не более **1000 строк**.
* Разрешено загружать только **один файл за раз** .

***

## Поля в шаблоне импорта доставки

| Столбец | Описание | Пример для физ. товаров | Пример для цифр. товаров |
| - | - | - | - |
| `Order_ID` | Уникальный идентификатор заказа, созданный системой. **Обязательно** | 100001250814000155 | 100001250814000153 |
| `Shipping_Carrier` | Название перевозчика, например SF, J\&T, DHL и т. д. Обязательно для физических товаров; оставьте пустым для цифровых | FedEx | (оставьте пустым) |
| `Tracking_Number` | Трек-номер. Обязательно для физических товаров; игнорируйте для цифровых заказов | 1234 5678 9012 | (оставьте пустым) |
| `Tracking_Url` | Ссылка для отслеживания доставки клиентом. Обязательно для физических товаров; оставьте пустым для цифровых | [https://www.fedex.com/wtrk/track/?trknbr=123456789012](https://www.fedex.com/wtrk/track/?trknbr=123456789012) | (оставьте пустым) |

***

## Загрузка и обработка

**1. Подготовка к загрузке**

Нажмите **Загрузить**, после чего откроется окно выбора файла.

<Frame caption="Select Upload after preparing your CSV. No file has been uploaded in this example.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/shop-shipping-import-upload-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=7925cc75da781ced1886554e7db26282" alt="Диалоговое окно импорта информации о доставке с выделенной кнопкой «Загрузить»." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/shop-shipping-import-upload-annotated.svg" />
</Frame>

Обратите внимание на требования в модальном окне загрузки:

* Формат CSV
* До **15 МБ** и **1000 строк**
* Только **один файл за раз**

***

**2. Выбор файла и начало загрузки**

Выберите CSV-файл и нажмите **Открыть**.

<Frame>
  <img src="https://mintcdn.com/lchnan/AlSk34JesCiO_ZYy/product-assets/ed0a81d5b7-shipping-info-filepicker.webp?fit=max&auto=format&n=AlSk34JesCiO_ZYy&q=85&s=8664bb427acb1a42a9b6e93791afcce9" alt="Окно выбора файла для выбора CSV-файла" width={760} data-path="product-assets/ed0a81d5b7-shipping-info-filepicker.webp" />
</Frame>

После успешной валидации шаблона импорт данных начнется автоматически, и отобразятся результаты (см. шаг 4). Если валидация завершится сбоем, появится сообщение об ошибке, и импорт будет отменен.

***

**3. Ошибка валидации файла**

Если CSV не соответствует требованиям к импорту, данные импортированы не будут.\
Вы получите понятное сообщение об ошибке, и вам потребуется исправить файл.

<Frame>
  <img src="https://mintcdn.com/lchnan/7IqVC2giQEcOq6-5/product-assets/25c9cd53e9-shipping-info-error-csv.webp?fit=max&auto=format&n=7IqVC2giQEcOq6-5&q=85&s=5a7f17fed2a17a0bf7ea2e3fde0fa6ae" alt="Предупреждение об ошибке валидации CSV" width={760} data-path="product-assets/25c9cd53e9-shipping-info-error-csv.webp" />
</Frame>

Ознакомьтесь с **правилами валидации на уровне файлов** ниже. Если проверки пройдены, начнется импорт данных (для больших файлов процесс может занять больше времени — пожалуйста, подождите).

<Frame>
  <img src="https://mintcdn.com/lchnan/6CxA7mK2t7klNAOL/product-assets/a936a5d2d4-shipping-info-file-uploading.webp?fit=max&auto=format&n=6CxA7mK2t7klNAOL&q=85&s=13fb57d6561f28a1ee0121e665e44cc9" alt="Статус обработки импорта CSV" width={760} data-path="product-assets/a936a5d2d4-shipping-info-file-uploading.webp" />
</Frame>

***

**4. Файл успешно импортирован**

После завершения импорта система отобразит:

* Количество успешно обработанных строк
* Количество строк с ошибками

Нажмите **Скачать отчет об ошибках** , чтобы получить CSV-файл, содержащий только ошибочные строки с указанием причин ошибок.

***

## Описания полей (столбцы шаблона)

| Столбец | Описание |
| - | - |
| `Order_ID` | Созданный системой уникальный идентификатор заказа для сопоставления с существующими заказами. |
| `Shipping_Carrier` | Название перевозчика, например SF, J\&T, DHL и т. д. |
| `Tracking_Number` | Трек-номер. Обязателен для заказов с физическими товарами; игнорируется для цифровых. |
| `Tracking_Url` | Ссылка для отслеживания, по которой клиенты переходят для просмотра статуса доставки. |
| `import status` | `failed` (по умолчанию) означает, что эта строка не была импортирована. |
| `error message` | Указывает конкретную причину сбоя импорта — например, «Order ID not found». |

***

## Проверка и отчет об ошибках

Система выполняет проверку как на уровне файла, так и на уровне строк:

**Проверка на уровне файла**

* Отсутствует или не совпадает заголовок → `Invalid template header`
* Формат, отличный от CSV → `Unsupported file type`
* Файл пуст или не содержит допустимых строк → `No valid entries found`
* Файл превышает лимит по размеру или количеству строк → `Maximum allowed size is 15 MB and 1,000 rows`
* Одновременная загрузка нескольких файлов → `Please upload only one file at a time`

**Проверка на уровне строк**

* Пустой, не найденный или несовпадающий `Order_ID` → `Order not found`
* Дублирующийся `Order_ID` в файле → `Duplicate Order ID; skipped`
* Отсутствующий или некорректный `Tracking_Number` для физических товаров → `Invalid Tracking Number`
* Для цифровых заказов поля логистики пропускаются, и заказ помечается как отправленный

**Пример отчета об ошибках (CSV):**

```csv theme={"theme":{"light":"github-light","dark":"github-dark"}}
Order_ID,Shipping_Carrier,Tracking_Number,Tracking_Url,Result,Reason
412341234,,,,Failed,"Missing shipping data"
634563456354635,,,,Failed,"Order not found"
```

> При возникновении сетевых или системных сбоев система может отобразить общее сообщение об ошибке — повторите попытку через несколько минут.

***

## Часто задаваемые вопросы

<Accordion title="Можно ли выполнить повторный импорт, если заказ уже помечен как отправленный (Shipped)?">
  Да. Вы можете снова загрузить этот заказ в следующем импорте, чтобы обновить логистическую информацию.
</Accordion>

<Accordion title="Требуются ли поля отслеживания для виртуальных или цифровых товаров?">
  Нет. Такие заказы помечаются как отправленные, а поля логистики игнорируются.
</Accordion>

<Accordion title="Какие способы оплаты поддерживаются в настоящее время?">
  Shop поддерживает **оплату при получении (COD)** и **PayPal Wallet**.
</Accordion>

<Accordion title="Excel преобразовал длинный Order_ID в экспоненциальный формат, например 1.23E+17. Как этого избежать?">
  Установите для столбца `Order_ID` тип **Текст** или добавьте апостроф (`'`) в начале значения в Excel, чтобы сохранить его корректно.
</Accordion>

<Accordion title="Что происходит со строками, содержащими ошибки при импорте?">
  Эти строки пропускаются, и формируется отчет об ошибках с указанием конкретных причин. Исправьте строки и загрузите их повторно.
</Accordion>

<Accordion title="Что произойдет, если один и тот же Order_ID встретится в файле несколько раз?">
  Дублирующиеся строки пропускаются. Оставляйте одну строку для каждого `Order_ID`. Чтобы обновить логистическую информацию для заказа, который уже имеет статус **Shipped**, загрузите его снова в следующем импорте отдельной строкой.
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.