Как загружать заказы
- Перейдите в Dashboard -> Orders -> Manage -> Upload orders.
- Загрузите CSV template со страницы загрузки и заполните его данными своих заказов.
- Загрузите завершенный CSV-файл.
- Проверьте экран подтверждения — стоимость доставки рассчитывается для каждой строки, и любые ошибки или предупреждения отображаются inline.
- Нажмите Create orders для отправки всех заказов со статусом Ready.
Формат CSV
Загрузите CSV template непосредственно со страницы загрузки в Dashboard. Template включает все обязательные и дополнительные столбцы — обязательные столбцы отмечены звездочкой (*) в строке заголовка.
Обязательные столбцы
Каждая строка представляет один заказ. Обязательная информация для каждой строки разделена на три категории:
Получатель — Имя, адрес электронной почты, номер телефона и адрес доставки получателя, включая страну назначения. Почтовый код и область/провинция требуются только для стран, чей формат адреса их использует — для страны без почтовых кодов (например, Гонконг или Танзания) просто оставьте ячейку пустой. Для стран со списком штатов/провинций используйте признанное имя региона или код (например, "Dubayy" или "DU" для Дубая), чтобы перевозчики могли оценить пункт назначения.
Товары — Минимум: название товара, количество и цена. Указание HS-кода и страны происхождения повышает точность классификации и может сократить время обработки на экране подтверждения.
Доставка — Код уровня обслуживания, который соответствует перевозчику, настроенному на вашем счете (например, fedex.international_priority, ups_worldwide_expedited). Столбец Shipping Amount является дополнительным: введите сумму (допускается 0) для использования в качестве стоимости доставки заказа или оставьте его пустым, и для вашего уровня обслуживания будет рассчитана смета тарифа перевозчика. Расчетные строки занимают на экране подтверждения несколько дополнительных секунд, и финальный тариф перевозчика при создании ярлыка может отличаться от сметы. Некоторые пункты назначения невозможно оценить автоматически (ошибка "service not available for destination country") — введите сумму доставки только на эти строки; пустые и заполненные строки могут свободно смешиваться в одном файле.
Дополнительные столбцы
Налоговый идентификатор получателя — Используйте столбцы Tax ID Type и Tax ID Number для включения налогового идентификатора получателя в заказ. Тип должен быть одним из кодов ниже (без учета регистра). Укажите оба столбца вместе; тип без номера (или наоборот) помечается как ошибка на экране подтверждения. Налоговый идентификатор сохраняется в получателе заказа и передается перевозчику при создании ярлыка. Для заказов с несколькими товарами используется налоговый идентификатор из первой строки заказа.
Используйте страна-специфичный код, если он существует; для любой страны, которой нет в списке, используйте TIN.
| Страна / Регион↕ | Код↕ | Налоговый идентификатор↕ |
|---|---|---|
| Аргентина | CUIL | CUIL или CUIT |
| Аргентина/Испания/Перу | DNI | Национальный номер удостоверения/налога |
| Австралия | OSR | AUSid GST регистрация |
| Австралия/Новая Зеландия | LVG | Иностранный зарегистрированный поставщик (товары малой стоимости) |
| Бразилия | CNP | CNPJ (налоговый ID федерального предприятия) |
| Бразилия | CPF | CPF (реестр налогоплательщиков физических лиц) |
| Канада | GST | GST/HST регистрационный номер |
| Чили | RUN | Rol Único Tributario (RUT/RUN) |
| Европейский Союз | EU_EORI | EU EORI номер |
| Европейский Союз | IOSS | Import One-Stop Shop номер |
| Франция | FTPC | French customs VAT (товары малой стоимости) |
| Индия | PAN | Постоянный номер счета |
| Индонезия | NPWP | Номер идентификации налогоплательщика |
| Мексика | RFC | Registro Federal de Contribuyentes |
| Мексика | CURP | CURP (физические лица) |
| Норвегия | VOEC | VAT on E-Commerce scheme номер |
| Норвегия | VOEC_NO | Норвежский номер VAT |
| Саудовская Аравия | SA_VAT | Саудовский номер VAT |
| Южная Африка | TRN | Номер налоговой справки |
| Южная Корея | PCC | Personal customs clearance code |
| Объединенные Арабские Эмираты | UAE_TRN | Номер налоговой регистрации |
| Соединенное Королевство | GB_EORI | UK EORI номер |
| Соединенное Королевство | HMRC | UK VAT регистрация (иностранные продавцы) |
| Соединенные Штаты | EIN | Employer Identification Number |
| Соединенные Штаты | SSN | Social Security Number |
| Соединенные Штаты | STA | State tax ID |
| Любая страна | EORI | Economic operator registration ID |
| Любая другая страна | TIN | Общий номер идентификации налогоплательщика |
Дополнительные специальные коды (FED, FTZ, DUN и счета отсрочки пошлин и налогов DAN/TAN/DTF) принимаются, когда ваш представитель Zonos направляет вас их использовать.
Duty Paid By — Дополнительно DDP или DDU для каждого заказа. Оставьте это пусто для поведения по умолчанию: DDP везде, где пункт назначения его поддерживает, с автоматическим переходом на DDU, где это не поддерживается. Явный DDP строг — строки с ошибкой вместо отката — и DDU делает получателя ответственным за пошлины и налоги при доставке. Экран подтверждения и загрузка результатов показывают, какой из них фактически приземлился на каждый заказ, с оранжевым значком на строках DDU. Для заказов с несколькими товарами первое указанное значение побеждает, и конфликтующие значения являются ошибкой.
Количество картонов — Если заказ поставляется в несколько идентичных коробок, установите Carton Quantity вместе со столбцами Carton Length/Width/Height/Weight. Столбцы картонов описывают одну коробку (вес — это вес одной упакованной коробки), а количество умножает его — например, 360 единиц, упакованных по 30 в коробку, будут использовать размеры коробки, вес одной полной коробки и количество картонов 12. Пусто означает 1. Заказы со смешанными размерами коробок не могут быть описаны в CSV — оставьте столбцы картонов пусто на этих заказах, и Zonos упакует их автоматически на основе весов товаров.
Советы
- Используйте точные коды уровня обслуживания, показанные в ваших параметрах перевозчика. Строки с неизвестными кодами уровня обслуживания будут показаны с предупреждением на экране подтверждения.
- Территории США отличаются: Виргинские острова США используют свой собственный код страны (
VI) и отправляются как международные, в то время как Пуэрто-Рико используетUSи отправляется как внутренние. - Перевозчики (особенно UPS) отказываются от адресов доставки P.O. Box — строки с "P.O. Box" в строке адреса могут не пройти оценку с общей ошибкой доступности обслуживания. Где возможно, используйте почтовый адрес.
- Типографская пунктуация из Word или Excel (фигурные кавычки, короткие/длинные тире) исправляется автоматически. Вопросительные знаки, появляющиеся там, где должны быть буквы с ударениями, указывают, что файл потерял свою кодировку — эти строки помечаются, чтобы вы могли повторно введите текст.
- Для стран назначения, которые требуют код штата или провинции (например, Бразилия, США, Канада), убедитесь, что поле штата заполнено правильным кодом ISO.
Order IDявляется обязательным и должен быть уникален во всем вашем счете, включая предыдущие загрузки — ID, который когда-либо использовался раньше (даже в файле предыдущего сезона или отмененном заказе), отклоняется при создании заказа. Повторное использование файла? Добавьте суффикс к ID (напримерACALB-33для тома 33). ID появляется на экране подтверждения и переносится в созданный заказ как ссылка продавца.
Проверка экрана подтверждения
После загрузки отображается экран подтверждения с рассчитанным расчетом стоимости доставки для каждого заказа перед созданием чего-либо. Экран показывает:
| Столбец↕ | Описание↕ |
|---|---|
| Order ID | Ссылка ID из вашего CSV. |
| Items | Название товара и количество. |
| Recipient | Имя получателя. |
| Country | Страна назначения. |
| Duty paid by | Выбрана ли цена DDP (вы платите пошлины и налоги) или DDU (получатель платит при доставке, показывается с оранжевым значком). |
| Service level | Уровень обслуживания доставки, используемый для оценки. |
| Item total | Объявленная стоимость товара. |
| Shipping | Рассчитанная стоимость доставки. |
| Duties | Рассчитанные пошлины. |
| Taxes | Рассчитанные налоги. |
| Fees | Комиссии Zonos. |
| LC total | Общая стоимость доставки (пошлины + налоги + комиссии). |
| Grand total | Итого, включая стоимость товара и стоимость доставки. |
| Status | Ready, Warning или Error. |
Строки могут показывать пошлины $0, налоги и комиссии, когда пункт назначения не взимает импортные сборы при объявленной стоимости отправки (она находится ниже порога минимальной стоимости страны) — стоимость доставки действительно равна нулю, а не отсутствует, и доставка — единственная стоимость для этих заказов.
Кнопка Create orders отображает количество заказов, которые будут отправлены (например, Create 17 orders). Включены только строки со статусом Ready или Warning — строки с ошибками исключены.
Используйте Download results CSV для экспорта полного расчета предложения (выбранный тариф, стоимость товара, доставка, пошлины, налоги, комиссии и итоги для каждого заказа) — полезно для расчета цены своим клиентам перед созданием любых заказов. Нажмите Start over для отмены загрузки и начала заново с исправленным файлом.
Когда вы оставляете Shipping Amount пусто, столбец уровня обслуживания показывает тариф, соответствующий уровню обслуживания вашего CSV. Если запрашиваемый уровень обслуживания недоступен для пункта назначения, выбирается ближайший доступный тариф и помечается значком Different service level — или, когда существует несколько вариантов, раскрывающийся список Select a rate позволяет вам выбрать перед созданием заказа.
Ошибки и предупреждения
Проблемы помечаются inline на экране подтверждения.
Ошибки
Строки с ошибками исключаются при нажатии Create orders. Исправьте проблему в CSV и повторно загрузите, чтобы включить эти строки. Общие ошибки включают:
- Low-value orders not allowed — Стоимость заказа ниже минимального порога для вашего магазина.
- Invalid state code — Код штата или провинции недействителен для страны назначения. Требуется для таких стран, как Бразилия, США и Канада.
- Missing required field — Обязательный столбец пуст или не может быть проанализирован.
- Order ID already exists — Каждый заказ ID должен быть уникален во всем вашем счете, включая заказы из предыдущих загрузок. Строки с уже использованными ID не проходят при создании, а остальная часть файла успешна — повторно загрузите только неудачные строки со свежими ID (суффикс как
-33работает хорошо).
Предупреждения
Строки с предупреждениями включены в отправку. Проверьте их перед нажатием Create orders. Общие предупреждения включают:
- Service level not configured — Код уровня обслуживания в вашем CSV не подключен к вашему счету. Заказ будет создан, но может не пройти оценку правильно. Проверьте ваши параметры перевозчика или обновите код уровня обслуживания в CSV.
Ограничения и пакетная обработка
Текущий лимит загрузки составляет 200 заказов на CSV. Заказы отправляются пакетами по 50 за вызов API — если ваша загрузка содержит более 50 готовых заказов, они обрабатываются несколькими пакетами автоматически.
Скоро: Будущее обновление удалит лимит 200 заказов и добавит фоновую обработку заданий для более крупных загрузок.
Массовая загрузка заказов
Создайте до 200 заказов одновременно, загрузив CSV-файл.Вместо того чтобы создавать заказы по одному, вы можете загрузить CSV-файл для массового создания заказов непосредственно из Dashboard. Это хороший вариант, когда вам нужно обработать большое количество отправок одновременно. Стоимость доставки рассчитывается на лету для каждой строки и отображается на экране подтверждения перед отправкой любых заказов, так что вы можете проверить полный расчет затрат для всего пакета перед фиксацией.