Как работает модель API Zonos + Japan Post
Купцы с Verified Account для Japan Post обращаются непосредственно к Zonos. Zonos использует свои собственные учетные данные Japan Post и включает ваш номер Later Pay на каждой этикетке, чтобы почтовые расходы выставлялись на ваш счет.
В одном запросе GraphQL Zonos:
- Проверяет вашу Verified Account и номера Later Pay.
- Вызывает Japan Post Label API (код 52) от вашего имени для генерации этикетки и номера отслеживания.
- Создает Declaration ID для предоплаты пошлины в США.
- Связывает Declaration ID с номером отслеживания через
declarationShipmentCreate. - Возвращает этикетку, номер отслеживания и запись о доставке вам.
Вам не нужны собственные учетные данные Japan Post API (CTID / пароль CT). Вам нужны номера Later Pay для Japan Post (後納お客様番号), подключенные к вашей Zonos Verified Account.
Какая у вас установка?
Все обращаются к Zonos для создания как этикетки, так и манифеста, поэтому вы никогда не предоставляете собственные учетные данные Japan Post (CTID / пароль CT). То, что меняется в зависимости от установки, - это какие заголовки API Zonos вы передаете. Найдите вашу строку ниже, а затем используйте соответствующую вкладку в разделе Endpoint и аутентификация каждого потока.
| ↕ | Онлайн-торговец↕ | Платформа доставки (BYOA)↕ | 3PL / партнер логистики / реселлер↕ |
|---|---|---|---|
| Кто вы | Бренд, отправляющий ваши заказы | Платформа, через которую многие торговцы создают этикетки | Партнер, отправляющий от имени многих торговцев-клиентов |
| Verified Account, который вы настроили | Одна Verified Account (ваша) | Каждый торговец настраивает свою; вы отправляете от их имени | Одна Verified Account, используемая для всех ваших отправителей |
| Заголовки API Zonos для передачи | credentialToken (ваш) только | credentialToken (ваш) + accountKey (каждого торговца) | credentialToken (ваш) только |
| Чей номер Later Pay для учета почтовых расходов | Ваш | Каждого торговца | Ваш |
| На кого Zonos выставляет счет за пошлины | Вам | Каждому торговцу | Вам |
BYOA (Bring Your Own Account): каждый торговец имеет свой Verified Account для Japan Post, и платформа создает этикетки от имени этого торговца, передав ключ учетной записи торговца, вместо того чтобы отправлять под собственной учетной записью платформы.
Два потока API
Существует два паттерна интеграции в зависимости от того, как вы отправляете посылки.
Создание одной доставки
Основной цепочка. Один запрос GraphQL берет доставку от необработанных входных данных (стороны, товары, упаковка) полностью до печатной этикетки Japan Post. Используйте это, если вы отправляете посылки по отдельности по мере поступления заказов.
Пакетная отправка (консолидация)
Поток пакетной отправки с отложенным платежом. Откройте консолидацию утром, прикрепите к ней доставки в течение дня, используя цепочку одной доставки, затем закройте консолидацию в конце дня, чтобы получить один лист отправки Japan Post, охватывающий весь пакет. Используйте это, если вы рассчитываетесь с Japan Post за почтовые расходы в одной транзакции в конце дня, а не по парцелям.
Уже используете Japan Post My Page API?
Если вы в настоящее время создаете этикетки с помощью Japan Post My Page API (ctCode=52), вы можете сохранить эту интеграцию и добавить Zonos для этикеток с предоплаченной пошлиной в США. См. Using Zonos with the My Page API для сопоставления полей и контрольного списка проверки.
Создание этикеток через API
Интегрируйте вашу систему фулфилмента с GraphQL API Zonos для создания этикеток Japan Post с предоплаченными пошлинами.
Этот раздел предназначен для команд инженеров, которые разрабатывают программный workflow для этикеток Japan Post с использованием Verified Accounts. Если вы малый или средний отправитель без ресурсов разработки, см. Создание этикеток в Dashboard вместо этого.