Включение печати этикеток
Следуйте приведенным ниже шагам, чтобы ваши клиенты могли получать Zonos этикетки через вашу платформу.
Разрешение учетных данных API
Zonos API доступен через credentialToken. Ваша платформа должна предоставить клиентам возможность вводить их credentialToken через Zonos Dashboard в вашу платформу. Отсюда вы сможете отправлять запросы к Zonos от их имени.
Создание отправления
Чтобы получить label, вам требуется создать shipment, к которому будет привязан этот label. Zonos управляет этим процессом с помощью рабочего процесса, который создаёт shipments и labels в одном запросе. При выполнении этой мутации вам не нужно передавать serviceLevel, так как мы будем использовать serviceLevel, взятое из landedCost, привязанного к заказу. Для orderId вы можете использовать идентификатор заказа Zonos или accountOrderNumber, который, вероятно, уже присутствует в вашей системе.
Когда отправление и этикетки будут успешно созданы, мы вернем этикетки в виде labelImage, который является BASE64_ENCODED_IMAGE, или в виде url, по которому можно получить этикетку.
Используйте этот рабочий процесс, когда создаёте отправление для существующего заказа и не требуется изменять детали позиций или сторон. Он поддерживает необязательные номера отслеживания, центры выполнения, выбор уровня сервиса и страхование объявленной стоимости.
Изменение
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 возможности создания отправлений в их платформу для своих клиентов. Если вы уже используете Zonos API и просто нужно создавать отправления для существующих заказов, см. наше руководство по созданию отправлений.
Если вы являетесь платформой доставки, которая поддерживает клиентов Zonos, отправляющихся за границу, интеграция с Zonos для создания отправлений должна быть одним из главных соображений. Это позволит вам предложить максимально бесшовный опыт для ваших продавцов и их клиентов, используя существующие функции вашей платформы, в то время как Zonos будет управлять созданием отправления, этикетки и сопроводительной таможенной документации.
Преимущества использования Zonos для создания отправлений включают:
Этот гид проведет вас по шагам реализации полной сквозной интеграции, которая позволит вызывать Zonos для отправлений прямо из вашей платформы.