Импорт посылок из CSV-файла
Описание процесса импорта нескольких посылок одновременно и примеры CSV-файлов для загрузки.
Для загрузки допустимы текстовые файлы формата CSV со значениями, разделенными запятой.
В первой строке файла должны содержаться названия полей посылки; в каждой последующей строке - отдельная посылка со значениями, соответствующими названиям колонок из первой строки.
Обязательные поля посылки:
| Параметр | Тип | Описание |
|---|---|---|
| trackNumber | String | Трек-номер посылки |
| courierId | Int | Цифровой идентификатор службы доставки. Для автоматического определения службы доставки передайте значение -1. При автоматическом определении службы доставки с Вашего лимита посылок по тарифу будет списана 1/5 часть посылки за каждый запрос на определение службы доставки. Т.о., например, при добавлении 5 посылок с автоматическим определением службы доставки, Ваш лимит посылок по тарифу уменьшится на 6 посылок: 5 добавленных посылок + 1 посылка за 5 автоматических определений службы доставки. |
Необязательные поля посылки:
| Параметр | Тип | Описание |
|---|---|---|
| destinationCountry | String (ISO 3166-1 alpha-2) | Двухбуквенный код страны назначения посылки |
| departureAddress | String | Адрес отправления |
| destinationAddress | String | Адрес доставки |
| orderId | String | Int | Номер заказа |
| recipientName | String | Имя получателя |
| recipientEmail | String | E-mail получателя |
| recipientPhone | String | Номер телефона получателя |
| comment | String | Комментарий-примечание к посылке |
Обязательные дополнительные поля посылки:
Для отслеживания посылки через некоторые службы доставки также необходимо передавать дополнительную информацию в отдельных столбцах CSV-файла. Подробнее читайте в разделе «Дополнительные поля».
Пример CSV-файла
trackNumber,courierId,destinationCountry,departureAddress,destinationAddress,orderId,recipientName,recipientEmail,recipientPhone,comment
505010120238,3,ua,Адрес отправления 1,Адрес назначения 1,111111,Имя Получателя,test@recipient.email,79999991212,Комментарий 1
80542162976480,4,ru,Адрес отправления 2,Адрес назначения 2,222222,Имя Получателя 2,test@recipient.email,79999991213,Комментарий 2
20450427050768,93,ua,Адрес отправления 3,Адрес назначения 3,333333,Имя Получателя 3,test@recipient.email,79999991214,Комментарий 3