Уже создаёте этикетки с помощью 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 обрабатывает слой таможни США для посылок, направляемых в Соединённые Штаты.
Для посылки, направляемой в США, вы отправляете посылку в рабочий процесс 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.
Zonos обрабатывает это для вас
Вы не отправляете учётные данные Japan Post или код операции (ctCode, ctId, ctPw), дату отправки (sendDate) или примечания к DDP декларации. Zonos устанавливает их автоматически при вызове My Page.
Каждая таблица показывает, куда идёт параметр 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, ECOMMERCE_GOODS, COMMERCIAL_GOODS, COMMERCIAL_SAMPLE, RETURNED_GOODS, GIFT, DOCUMENTS или OTHER.
senderInstruction
nonDelivery.option
RETURN_AFTER_RETENTION, RETURN_IMMEDIATELY, FORWARD или ABANDON. Zonos разделяет единую инструкцию My Page «return» на два значения.
fw_TransType
nonDelivery.transportMethod
AIR или MOST_ECONOMICAL.
noCm
isNonCommercial
true / false.
damges
declaredValue
Застрахованная стоимость. Должна быть в JPY, целые иены.
Это преобразования, которые чаще всего требуют внимания:
Уровень сервиса заменяет sendType + transType. Выберите один уровень сервиса Zonos japan_post.*, который соответствует почтовому сервису и транспорту, которые вы отправляете сегодня как два отдельных параметра.
Застрахованная стоимость (declaredValue) должна быть в JPY, целые иены. Другие валюты или дробные иены будут отклонены.
Вес отправляется в Japan Post в граммах. Укажите weight + weightUnit на коробе; Zonos конвертирует.
Описания товаров для таможни ограничены 85 полуширинными символами.
Все поля адреса должны быть на английском (латинском) языке.
Когда вы создаёте этикетку для США через Zonos, убедитесь, что всё прошло успешно:
Рабочий процесс возвращает номер отслеживания и метку. Проверьте shipmentCreateWorkflow.trackingDetails.number и shipmentCartons[].label.url в ответе.
Был создан ID декларации и связан. Посылка предоплачена таможней только в том случае, если ID декларации связан с номером отслеживания — Zonos это делает в одном запросе.
DDP напечатан на этикетке. Откройте возвращённую этикетку и подтвердите наличие маркировки DDP.
Посылка появляется в вашем Zonos Dashboard под вашим проверенным аккаунтом.
Для пакетной отправки убедитесь, что консолидация закрывается и возвращает квитанцию отправки Japan Post (код 61). См. Пакетная отправка (консолидация).
Сравните с этикеткой My Page. Создайте одну и ту же посылку обоими способами и подтвердите совпадение уровня сервиса, веса, объявленной стоимости и деталей товара на напечатанной этикетке.
Протестируйте перед запуском в боевой режим
Проверьте полный рабочий процесс на контрольной посылке перед отправкой боевого объёма США через Zonos. Ваша интеграция My Page остаётся в силе для всего остального.
Использование Zonos с API My Page
Использование 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 обрабатывает слой таможни США для посылок, направляемых в Соединённые Штаты.
Если вы интегрируетесь в первый раз, начните с Создание одной посылки.
Как Zonos встраивается
Для посылки, направляемой в США, вы отправляете посылку в рабочий процесс Zonos
CreateDeclarationShipmentGraphQL вместо прямого вызова My Page. В одном запросе Zonos:ctCode=52) от вашего имени, используя номера отложенного платежа вашего проверенного аккаунта, чтобы почтовые услуги по-прежнему выставлялись на ваш счёт Japan Post.CreateDeclarationShipmentобъединяет семь шагов. Одни и те же данные, которые вы уже собираете для запросаctCode=52, распределяются между ними:partyCreateWorkflowORIGINиDESTINATIONстороны.itemCreateWorkflow(позиции внутриshipmentCartons).cartonsCreateWorkflow.shipmentCreateWorkflow.Вы не отправляете учётные данные Japan Post или код операции (
ctCode,ctId,ctPw), дату отправки (sendDate) или примечания к DDP декларации. Zonos устанавливает их автоматически при вызове My Page.Как ваши поля My Page сопоставляются с Zonos
Каждая таблица показывает, куда идёт параметр Japan Post My Page
ctCode=52в рабочем процессе Zonos. Для полных деталей поля, типов и требуемых полей см. Создание одной посылки.Сервис и обработка →
shipmentCreateWorkflowsendType+transTypeserviceLevel(иshipmentRatingCreateWorkflow.serviceLevelCode)japan_post.air.parcel. Должен быть уровень сервисаjapan_post.*.pkgTypecontentsTypeSALE_OF_GOODS,ECOMMERCE_GOODS,COMMERCIAL_GOODS,COMMERCIAL_SAMPLE,RETURNED_GOODS,GIFT,DOCUMENTSилиOTHER.senderInstructionnonDelivery.optionRETURN_AFTER_RETENTION,RETURN_IMMEDIATELY,FORWARDилиABANDON. Zonos разделяет единую инструкцию My Page «return» на два значения.fw_TransTypenonDelivery.transportMethodAIRилиMOST_ECONOMICAL.noCmisNonCommercialtrue/false.damgesdeclaredValuetotalWeightcartonsCreateWorkflow.weight+weightUnitОтправитель →
partyCreateWorkflow(сторонаORIGIN)from_namperson.firstName+person.lastNamefrom_companyNameperson.companyNamefrom_postallocation.postalCodefrom_add1/from_add2/from_add3location.line1/location.line2/location.localityfrom_preflocation.administrativeAreaCodefrom_telperson.phoneПолучатель →
partyCreateWorkflow(сторонаDESTINATION)Параметры получателя
to_*сопоставляются со сторонойDESTINATIONтак же, как поля отправителя.to_namperson.firstName+person.lastNameto_companyNameperson.companyNameto_couCdlocation.countryCodeUSилиPR.to_add1/to_add2/to_add3location.line1/location.line2/location.localitylocation.postalCode/location.administrativeAreaCode/person.phoneТовары →
itemCreateWorkflowitem_pkgcustomsDescriptionitem_hsCodehsCodeitem_numquantityitem_weightmeasurements(вес за единицу)item_costamountitem_curUnitcurrencyCodeПреобразования, которые нужно учитывать
Это преобразования, которые чаще всего требуют внимания:
sendType+transType. Выберите один уровень сервиса Zonosjapan_post.*, который соответствует почтовому сервису и транспорту, которые вы отправляете сегодня как два отдельных параметра.declaredValue) должна быть в JPY, целые иены. Другие валюты или дробные иены будут отклонены.weight+weightUnitна коробе; Zonos конвертирует.Проверьте ваши этикетки США
Когда вы создаёте этикетку для США через Zonos, убедитесь, что всё прошло успешно:
shipmentCreateWorkflow.trackingDetails.numberиshipmentCartons[].label.urlв ответе.Проверьте полный рабочий процесс на контрольной посылке перед отправкой боевого объёма США через Zonos. Ваша интеграция My Page остаётся в силе для всего остального.
Связанные материалы
CreateDeclarationShipment.Была ли эта страница полезной?