Как Zonos встраивается
Для посылки, направляемой в США, вы отправляете посылку в рабочий процесс Zonos CreateDeclarationShipment GraphQL вместо прямого вызова My Page. В одном запросе Zonos:
- Вызывает API меток Japan Post (
ctCode=52) от вашего имени, используя номера отложенного платежа вашего проверенного аккаунта, чтобы почтовые услуги по-прежнему выставлялись на ваш счёт Japan Post. - Создаёт ID декларации таможни США и связывает его с номером отслеживания.
- Добавляет маркировку DDP на метку.
- Возвращает метку Japan Post и номер отслеживания вам.
CreateDeclarationShipment объединяет семь шагов. Одни и те же данные, которые вы уже собираете для запроса ctCode=52, распределяются между ними:
- Отправитель / получатель →
partyCreateWorkflowORIGINиDESTINATIONстороны. - Товары →
itemCreateWorkflow(позиции внутриshipmentCartons). - Упаковка и вес →
cartonsCreateWorkflow. - Сервис, обработка и флаги таможни →
shipmentCreateWorkflow.
Как ваши поля My Page сопоставляются с Zonos
Каждая таблица показывает, куда идёт параметр Japan Post My Page ctCode=52 в рабочем процессе Zonos. Для полных деталей поля, типов и требуемых полей см. Создание одной посылки.
Сервис и обработка → shipmentCreateWorkflow
| Параметр My Page↕ | Поле Zonos↕ | Примечания↕ |
|---|---|---|
sendType + transType | serviceLevel (и shipmentRatingCreateWorkflow.serviceLevelCode) | Один уровень сервиса Zonos кодирует как почтовый сервис, так и режим транспорта — например, japan_post.air.parcel. Должен быть уровень сервиса japan_post.*. |
pkgType | contentsType | SALE_OF_GOODS, GIFT, DOCUMENTS, SAMPLE и т. д. |
senderInstruction | nonDelivery.option | RETURN, ABANDON или FORWARD. |
fw_TransType | nonDelivery.transportMethod | AIR или MOST_ECONOMICAL. |
noCm | isNonCommercial | true / false. |
damges | declaredValue | Застрахованная стоимость. Должна быть в JPY, целые иены. |
totalWeight | cartonsCreateWorkflow.weight + weightUnit | Отправляется в Japan Post в граммах. |
Отправитель → partyCreateWorkflow (сторона ORIGIN)
| Параметр My Page↕ | Поле Zonos↕ | Примечания↕ |
|---|---|---|
from_nam | person.firstName + person.lastName | |
from_companyName | person.companyName | |
from_postal | location.postalCode | |
from_add1 / from_add2 / from_add3 | location.line1 / location.line2 / location.locality | |
from_pref | location.administrativeAreaCode | Префектура. |
from_tel | person.phone |
Получатель → partyCreateWorkflow (сторона DESTINATION)
Параметры получателя to_* сопоставляются со стороной DESTINATION так же, как поля отправителя.
| Параметр My Page↕ | Поле Zonos↕ | Примечания↕ |
|---|---|---|
to_nam | person.firstName + person.lastName | |
to_companyName | person.companyName | |
to_couCd | location.countryCode | US или PR. |
to_add1 / to_add2 / to_add3 | location.line1 / location.line2 / location.locality | |
| Почтовый индекс / штат / телефон | location.postalCode / location.administrativeAreaCode / person.phone |
Товары → itemCreateWorkflow
| Параметр My Page↕ | Поле Zonos↕ | Примечания↕ |
|---|---|---|
item_pkg | customsDescription | Описание таможни товара. Полноширинные символы, макс. 85 символов. |
item_hsCode | hsCode | |
item_num | quantity | |
item_weight | measurements (вес за единицу) | |
item_cost | amount | Цена за единицу. |
item_curUnit | currencyCode |
Преобразования, которые нужно учитывать
Это преобразования, которые чаще всего требуют внимания:
- Уровень сервиса заменяет
sendType+transType. Выберите один уровень сервиса Zonosjapan_post.*, который соответствует почтовому сервису и транспорту, которые вы отправляете сегодня как два отдельных параметра. - Застрахованная стоимость (
declaredValue) должна быть в JPY, целые иены. Другие валюты или дробные иены будут отклонены. - Вес отправляется в Japan Post в граммах. Укажите
weight+weightUnitна коробе; Zonos конвертирует. - Описания товаров для таможни ограничены 85 полноширинными символами.
- Все поля адреса должны быть на английском (латинском) языке.
Проверьте ваши этикетки США
Когда вы создаёте этикетку для США через Zonos, убедитесь, что всё прошло успешно:
- Рабочий процесс возвращает номер отслеживания и метку. Проверьте
shipmentCreateWorkflow.trackingDetails.numberиshipmentCartons[].label.urlв ответе. - Был создан ID декларации и связан. Посылка предоплачена таможней только в том случае, если ID декларации связан с номером отслеживания — Zonos это делает в одном запросе.
- DDP напечатан на этикетке. Откройте возвращённую этикетку и подтвердите наличие маркировки DDP.
- Посылка появляется в вашей приборной панели Zonos под вашим проверенным аккаунтом.
- Для пакетной отправки убедитесь, что консолидация закрывается и возвращает квитанцию отправки Japan Post (код 61). См. Пакетная отправка (консолидация).
- Сравните с этикеткой My Page. Создайте одну и ту же посылку обоими способами и подтвердите совпадение уровня сервиса, веса, объявленной стоимости и деталей товара на напечатанной этикетке.
Связанные материалы
- Создание одной посылки — полный справочник по полям для рабочего процесса
CreateDeclarationShipment. - Пакетная отправка (консолидация) — объедините посылки дня в одну квитанцию отправки Japan Post.
Использование Zonos с API Japan Post My Page
Уже создаёте этикетки с помощью API Japan Post My Page? Сохраните вашу интеграцию — добавьте Zonos для предоплаченных этикеток США.
Это руководство предназначено для команд, которые уже интегрируются с API Japan Post My Page для создания этикеток (операция
ctCode=52). Для посылок в США, для которых теперь требуется предоплата таможенных платежей, вы создаёте этикетку через Zonos. Zonos расширяет рабочий процесс My Page: он вызывает API меток My Page (ctCode=52) от вашего имени, добавляет ID декларации таможни США и маркировку DDP, а затем возвращает вам метку My Page и номер отслеживания. Japan Post по-прежнему создаёт этикетку и выставляет счёт за почтовые услуги через ваш номер отложенного платежа.Короче говоря: вы продолжаете строить на основе My Page, а Zonos обрабатывает слой таможни США для посылок, направляемых в Соединённые Штаты.
Если вы интегрируетесь в первый раз, начните с Создание одной посылки.