Включите печать ярлыков
Следуйте приведенным ниже шагам, чтобы позволить вашим клиентам получать ярлыки Zonos с вашей платформы.
Разрешить учетные данные API
API Zonos доступен с помощью credentialToken. Ваша платформа должна предоставить клиентам возможность ввести свой credentialToken из Панели управления Zonos в вашу платформу. Отсюда вы сможете делать запросы к Zonos от их имени.
Создать отправление
Чтобы получить label, вам необходимо создать shipment, с которым будет связан label. Zonos управляет этим процессом с помощью рабочего процесса, который создает shipments и labels в одном запросе. При выполнении этой мутации вам не нужно передавать serviceLevel, так как мы будем использовать serviceLevel, использованный из landedCost, связанного с order. Для orderId вы можете использовать идентификатор заказа Zonos или accountOrderNumber, который, вероятно, уже есть в вашей системе.
Когда отправление и ярлыки успешно созданы, мы вернем ярлыки как labelImage, который является BASE64_ENCODED_IMAGE, или как url, откуда можно получить ярлык.
Используйте этот рабочий процесс, когда вы создаете отправление для существующего заказа и не нужно изменять детали товара или стороны. Он поддерживает необязательные номера отслеживания, центры выполнения, выбор уровня обслуживания и страхование заявленной стоимости.
Mutation
mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {
shipmentCreateWorkflow(input: $input) {
id
status
trackingDetails {
number
}
serviceLevel {
id
name
carrier {
id
name
}
}
shipmentCartons {
id
carton {
id
width
length
height
weight
items {
item {
id
amount
description
}
}
}
label {
url
trackingNumber
id
documentFiling
}
}
}
}
Базовые переменные
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789abc"
}
}
С Центром Выполнения Заказов
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789def",
"fulfillmentCenter": "fulfillment_center_12345"
}
}
С пользовательским отслеживанием
{
"input": {
"generateLabel": false,
"orderId": "order_12345678-1234-1234-1234-123456789ghi",
"trackingNumbers": ["tracking_example_1", "tracking_example_2"]
}
}
С уровнем обслуживания
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789jkl",
"serviceLevel": "dhl.express_example"
}
}
С страхованием заявленной стоимости
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789mno",
"isDeclaredValue": true
}
}
Объявленная стоимость
Установите "isDeclaredValue": true, чтобы включить покрытие объявленной стоимости для всех товаров в вашей отправке. Zonos автоматически заявляет полную стоимость всех товаров, указанных в заказе; торговцы не могут изменить эту сумму. Это устанавливает максимальную ответственность, которую перевозчик примет в случае потери, повреждения или кражи во время транспортировки. Эта функция поддерживается только для отправок UPS, FedEx и DHL. Zonos автоматически обрабатывает реализацию, специфичную для перевозчика, когда вы включаете объявленную стоимость, включая соответствующие параметры в наших API-вызовах к этим перевозчикам, так что вам не нужно управлять различными требованиями перевозчиков.
Ограничения UPS: UPS покрывает только стоимости от 100 до 50,000 USD и обрабатывает объявленную стоимость на уровне коробки. Для отправок с несколькими коробками торговцы должны разделить отправку, чтобы назначить покрытие на каждую коробку. UPS также генерирует дополнительную страховую форму, которую необходимо распечатать вместе с ярлыками.
FedEx и DHL: Обрабатывают объявленную стоимость на уровне отправки без дополнительных ограничений.
Аннулирование отправления
В случае, если клиент хочет аннулировать отправление, вы можете использовать следующую мутацию, которая аннулирует все этикетки, связанные с отправлением.
Запрос
mutation {
shipmentStatusUpdate(
input: {
shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223"
status: VOIDED
note: "Voiding shipment"
}
) {
id
status
}
}
Создание отправлений с вашей платформы
Предоставьте клиентам возможность создавать отправления и ярлыки Zonos с вашей платформы.
Этот гид предназначен для разработчиков платформ доставки, которые хотят интегрировать возможности создания отправлений Zonos в свою платформу для своих клиентов. Если вы уже используете API Zonos и просто хотите создать отправления для существующих заказов, смотрите наш гид по созданию отправлений.
Если вы являетесь платформой доставки, которая поддерживает клиентов Zonos, отправляющих товары за границу, интеграция с Zonos для создания отправлений должна быть вашим приоритетом. Это позволит вам предложить наиболее бесшовный опыт для ваших торговцев и их клиентов, используя существующие функции вашей платформы, позволяя Zonos управлять созданием отправления, ярлыка и сопроводительной таможенной документации.
Преимущества использования Zonos для создания отправлений включают:
Этот гид проведет вас через шаги для реализации полной интеграции от начала до конца, которая позволит вам вызывать Zonos для отправлений с вашей платформы.