Landed Cost•

ГлавнаяДля логистических компаний Landed Cost Интеграция отправлений на платформе

Создавайте отправления с вашей платформы

Предоставьте клиентам возможность создавать отправления и этикетки Zonos с вашей платформы.

Это руководство предназначено для разработчиков платформ доставки, которые хотят интегрировать возможности создания отправлений Zonos в свою платформу для своих клиентов. Если вы уже используете Zonos API и вам просто нужно создавать отправления для существующих заказов, см. наше руководство по созданию отправлений.

Если вы платформа доставки, которая поддерживает клиентов Zonos, отправляющих товары за границу, интеграция с Zonos для создания отправлений должна быть главным приоритетом. Это позволит вам предложить наиболее беспрепятственный опыт для ваших продавцов и их клиентов, используя существующие функции вашей платформы, позволяя Zonos управлять созданием отправления, этикетки и вспомогательной таможенной документацией.

Преимущества использования Zonos для создания отправлений:

Оплата пошлин и налогов третьей стороной — Мы гарантируем, что для транспортных расходов используется ваш номер счета перевозчика или номер счета перевозчика вашего продавца, в то время как счета за пошлины и налоги приходят в Zonos.
Гибкость — Вместо выполнения работ по разработке, чтобы убедиться, что вы можете генерировать соответствующие этикетки с вашей платформой, интегрируйтесь с нашим API и оставьте постоянно меняющееся трансграничное соответствие нам.
Точная таможенная документация — Когда вы используете Zonos для создания этикеток, мы гарантируем, что правильные детали передаются перевозчику, чтобы посылка быстро прошла таможню.

Это руководство проведет вас через этапы реализации полной сквозной интеграции, которая позволит вам вызывать Zonos для отправлений с вашей платформы.

Включите печать этикеток

Выполните следующие шаги, чтобы позволить вашим клиентам получать этикетки Zonos с вашей платформы.

Разрешить учетные данные API

Создайте отправление

Чтобы получить label, вы должны создать shipment, с которым будет связан label. Zonos управляет этим процессом с помощью рабочего процесса, который создает shipments и labels в одном запросе. При выполнении этой мутации вам не нужно передавать serviceLevel, так как мы будем использовать serviceLevel, используемый из landedCost, который привязан к order. Для orderId вы можете использовать ID заказа Zonos или accountOrderNumber, который, вероятно, уже находится в вашей системе.

Когда отправление и этикетки успешно созданы, мы вернем этикетки как labelImage, которая является BASE64_ENCODED_IMAGE, или как url, откуда можно получить этикетку.

Используйте этот рабочий процесс при создании отправления для существующего заказа и когда вам не нужно изменять детали товаров или сторон. Он поддерживает дополнительные номера отслеживания, центры выполнения, выбор уровня обслуживания и страховку объявленной стоимости.

Продавцы Shopify

Shopify передает нулевое значение для person в исходной стороне. В результате orderId одного будет недостаточно для продавцов Shopify — используйте вместо этого вкладку Расширенное создание отправления и предоставьте полные детали стороны, включая person.

1mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {

2 shipmentCreateWorkflow(input: $input) {

3 id

4 status

5 trackingDetails {

6 number

7 }

8 serviceLevel {

9 id

10 name

11 carrier {

12 id

13 name

14 }

15 }

16 shipmentCartons {

17 id

18 carton {

19 id

20 width

21 length

22 height

23 weight

24 items {

25 item

26 id

27 amount

28 description

32 label

33 url

34 trackingNumber

35 id

36 documentFiling

Параметры переменных:

С центром выполнения: Добавьте "fulfillmentCenter": "fulfillment_center_12345" для указания исходного местоположения
С пользовательским отслеживанием: Установите "generateLabel": false и добавьте "trackingNumbers": ["tracking_1", "tracking_2"]
С уровнем обслуживания: Добавьте "serviceLevel": "dhl.express_example" для выбора конкретного сервиса перевозчика
Со страховкой объявленной стоимости: Добавьте "isDeclaredValue": true для включения покрытия объявленной стоимости
Со специальными услугами: Смотрите руководство по специальным услугам для батарей, сухого льда, опасных грузов и опций подписания.

Объявленная стоимость

Установите "isDeclaredValue": true для включения покрытия объявленной стоимости для всех товаров в вашем отправлении. Zonos автоматически заявляет полную стоимость всех товаров, поданных в заказ; продавцы не могут изменить эту сумму. Это устанавливает максимальную ответственность, которую перевозчик примет в случае потери, повреждения или кражи при доставке. Эта функция поддерживается только для отправлений UPS, FedEx и DHL. Zonos автоматически обрабатывает специфическую для перевозчика реализацию при включении объявленной стоимости, включая соответствующие параметры в наших вызовах API этим перевозчикам, поэтому вам не нужно управлять различными требованиями перевозчиков.

Ограничения UPS: UPS охватывает только стоимости от 100 до 50 000 USD и обрабатывает объявленную стоимость на уровне коробки. Для многокоробковых отправлений продавцы должны разделить отправление, чтобы указать покрытие для каждой коробки. UPS также генерирует дополнительную форму страховки, которая должна быть напечатана вместе с этикетками.

FedEx и DHL: Обработка объявленной стоимости на уровне отправления без дополнительных ограничений.

Специальные услуги

Используйте specialServices на коробке для указания требований специальной обработки для батарей, сухого льда, опасных грузов или требований подписания. Смотрите руководство по специальным услугам для полных деталей и примеров.

Разблокировка ShipStation UPS: Многокусковые отправления не поддерживаются. Когда заказ отправляется в несколько коробок, поле reference дублируется, что вызывает сбой сопоставления номера заказа на бэкенде. Продавцам, нуждающимся в многокусковых отправлениях, следует создавать этикетку в Zonos Dashboard. На однокусковые отправления это не влияет.

Отмените отправление

В случае, если клиент хочет отменить shipment, вы можете использовать следующую мутацию, которая отменит все labels, привязанные к shipment.

1mutation {

2 shipmentStatusUpdate(

3 input: {

4 shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"

5 status: VOIDED

6 note: "Voiding shipment"

7 }

8 ) {

9 id

10 status

11 }

12}

GraphQL API ReferenceTypes, inputs, and operations used in this guide

INPUTS

CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput

MUTATIONS

cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate

Записаться на демонстрацию

Создавайте отправления с вашей платформы

Включите печать этикеток

Разрешить учетные данные API

Создайте отправление

Отмените отправление

Была ли эта страница полезной?